kuferweb für TYPO3

kuferweb ist die Brücke zwischen dem Kufer-Fachverfahren und der öffentlichen TYPO3-Website

Volkshochschulen, Bildungsträger und Akademien verwalten ihren Kursbetrieb seit Jahrzehnten in Fachsoftware, und in vielen Häusern heisst diese Software Kufer. Kufer bildet den vollständigen Kurs-Lebenszyklus ab: Dozentenverwaltung, Kursplanung, Raumbelegung, Teilnehmer, Abrechnung, Zertifikate. Für die Website bedeutet das eine Standardaufgabe: Der Kurskatalog, der im Backoffice gepflegt wird, soll auf der TYPO3-Website tagesaktuell sichtbar sein, inklusive Filtersuche, Detailansichten und Online-Anmeldung.

Die Zielgruppe ist klar umrissen: Weiterbildungseinrichtungen mit einem bestehenden Kufer-Mandanten, die ihre Website auf TYPO3 betreiben. Typisch ist eine Volkshochschule mit rund 2.500 Kursen pro Semester und einem halben Dutzend Dozenten, die ihre Kurse selbst in Kufer pflegen. Ohne eine saubere Integration bleibt der Website-Katalog veraltet, Doppelpflege wird zum Dauerzustand, und Anmeldungen landen in einem separaten System, das niemand mag.

Typische Einsatzszenarien

Ein erstes Szenario ist der automatisch aktualisierte Kurskatalog. Eine Volkshochschule mit 2.500 Kursen pro Semester möchte, dass jede Kursanlage, jede Preisänderung und jede Dozentenänderung ohne manuellen Eingriff auf der Website sichtbar wird. Ein stündlicher Sync-Job holt die aktuellen Kursdaten aus Kufer, schreibt sie in eine TYPO3-Tabelle und aktualisiert die Suche. Der Redakteur pflegt keine Kurse mehr im TYPO3-Backend.

Ein zweites Szenario ist die direkte Online-Anmeldung. Ein Bildungsträger mit Förderprogrammen möchte Interessenten direkt von der Kursdetailseite in einen Anmeldeprozess führen, der im Hintergrund die Kufer-API aufruft und den Teilnehmer in Kufer registriert. TYPO3 dient als Frontend, Kufer bleibt die Quelle der Wahrheit, die Redaktion sieht den neuen Anmeldestatus in ihrer gewohnten Oberfläche.

Ein drittes Szenario ist die Filtersuche mit fachspezifischen Facetten. Eine Akademie mit 40 Fachbereichen und mehreren Tausend Kursen möchte Interessenten die Suche über Kategorien, Orte, Termine, Dozenten und Preisklassen erlauben. Die Suche läuft auf der TYPO3-Seite gegen einen lokalen Index, der aus dem Kufer-Export aufgebaut wird - performant und unabhängig von der Verfügbarkeit der Fachanwendung.

Ein viertes Szenario ist die mehrsprachige Kursausgabe. Eine Sprachschule mit Standorten in Deutschland, Österreich und der Schweiz pflegt Kurse in Kufer nur in deutscher Sprache und möchte auf der Website eine mehrsprachige Darstellung für Interessenten anbieten. Die Integration übernimmt das Mapping auf TYPO3-Sprachvarianten, ergänzt die deutschen Kufer-Felder um manuelle Übersetzungen in der CMS-Redaktion und stellt sicher, dass Änderungen in Kufer nicht die lokalen Übersetzungen überschreiben.

Technische Architektur

kuferweb-Integrationen in TYPO3 sind fast immer Custom-Entwicklungen, weil die Datenstrukturen pro Kufer-Mandant variieren und die API-Versionen sich über die Jahre mehrfach geändert haben. Der Standard-Ansatz ist eine schlanke Extbase-Extension mit drei Säulen: Ein Service-Layer, der die Kufer-API kapselt, ein Persistenz-Layer, der Kurse in TYPO3-Tabellen spiegelt, und ein Präsentations-Layer, der Fluid-Templates für Liste, Filter und Detail bereitstellt.

Die Synchronisation läuft über einen TYPO3-Scheduler-Task. Für grosse Kataloge empfiehlt sich ein Delta-Import, der nur die seit dem letzten Lauf geänderten Kurse überträgt. Die Kufer-API liefert meist einen Timestamp oder eine Änderungskennung pro Kurs, die für die Delta-Erkennung genutzt wird.

Die Online-Anmeldung erfordert einen zusätzlichen API-Pfad und eine saubere Fehlerbehandlung. Die Kufer-API kann bei hoher Last langsam antworten, daher laufen Anmeldungen typischerweise asynchron: Das Formular legt den Anmelde-Request in einer Queue ab, ein Worker-Prozess überträgt ihn an Kufer, und der Teilnehmer erhält eine Bestätigungs-Mail, sobald Kufer die Registrierung quittiert hat.

Häufige Probleme und Lösungen

Das erste Problem ist die Feldabweichung zwischen Kufer-Mandanten. Was in Mandant A “Veranstaltungsnummer” heisst, ist in Mandant B “Kurscode” und in Mandant C “Belegnummer”. Die Lösung ist ein konfigurierbares Feld-Mapping in der TYPO3-Extension, das pro Installation angepasst wird und nicht hart im Code steht.

Das zweite Problem ist die Datenqualität im Kurskatalog. Redakteurinnen pflegen in Kufer nicht immer vollständige Texte - Kurzbeschreibungen fehlen, Bilder sind nicht hinterlegt, Zielgruppen nicht definiert. Auf der Website erscheinen diese Lücken dann als leere Felder. Die Lösung ist ein Validierungs-Layer bei der Synchronisation, der unvollständige Kurse im Backend markiert und die Redaktion zum Nachpflegen auffordert.

Das dritte Problem ist die Stornierungs- und Absagelogik. Wenn Kurse in Kufer abgesagt werden, sollen sie auf der Website verschwinden oder mindestens als abgesagt markiert werden. Die Lösung ist, abgesagte Kurse im Sync explizit auf einen Status zu setzen, der in der Liste ausgeblendet wird, und die Detailseite mit einem Redirect auf eine Kategorie-Übersicht zu versehen.

Ein viertes Problem ist die Belegungsanzeige in Echtzeit. Interessenten sehen auf der Website “noch 3 Plätze frei”, obwohl die Buchung im Hintergrund bereits auf die Warteliste gewechselt ist. Die Lösung ist, die Belegungsanzeige nicht aus dem Sync-Cache zu lesen, sondern bei jedem Aufruf der Detailseite einen kleinen Live-Call an Kufer abzusetzen - mit aggressivem Caching (30-60 Sekunden) und einem Fallback auf den letzten bekannten Cache-Wert, falls die API nicht antwortet.

Migration und Versions-Kompatibilität

kuferweb-Integrationen laufen in TYPO3 v11, v12 und v13, solange die API-Anbindung modern gebaut ist. Der häufigste Schmerzpunkt ist nicht die TYPO3-Version, sondern die Kufer-Version: Wenn die Volkshochschule ihren Kufer-Mandanten auf eine neue Version migriert, ändern sich gelegentlich API-Endpoints und Datenstrukturen, was eine Nachjustierung der TYPO3-Integration nötig macht.

Gosign baut kuferweb-Integrationen auf Basis der aktuellen Kufer-API, prüft vor Projektbeginn die Kompatibilität mit dem Kunden-Mandanten und setzt die Integration so modular auf, dass künftige API-Upgrades ohne grossflächigen Umbau funktionieren. KI-gestützt entsteht der API-Client-Code in Stunden statt Tagen, wodurch die Einführung auf den meisten Projekten in zwei bis drei Sprints realistisch wird.