Ereignisse und übermittelte Daten

Ereignisse:

• Übersicht der gesendeten Ereignisse
• Wann und wie oft Ereignisse gesendet werden

Aufbau der Daten:

• Konventionen für alle Felder
• Felder in jedem Ereignis
• Versionierung

Datenobjekte:

• Datenobjekt course
• Datenobjekt order mit quotation und items
• Datenobjekt index

Beispiel:

• Vollständiges Beispiel eines Ereignisses

Übersicht der gesendeten Ereignisse

*Das Ereignis semco_e_learning_index ist nur für Systeme mit E-Learning-Angebot relevant.

**Das Ereignis semco_orders_payment wird nur gesendet, wenn der Zahlungsschritt in Ihrer SEMCO-Konfiguration aktiv ist. Verlassen Sie sich in Ihrer Logik nicht darauf, dass dieses Ereignis auftritt.

Wann und wie oft Ereignisse gesendet werden

• Jeder Aufruf eines Schritts löst ein Ereignis aus – auch beim erneuten Laden derselben Seite. Insbesondere wird semco_orders_confirmation erneut gesendet, wenn der Besucher die Bestätigungsseite neu lädt oder später wieder öffnet. Verhindern Sie eine Doppelzählung deshalb in Ihrem eigenen Listener. Wie das geht, zeigt Prüfung und Korrekturmöglichkeiten bei Fehlern.
• Die Listen-Ereignisse semco_classes_index und semco_e_learning_index werden bei jedem Filter- und Seitenwechsel erneut gesendet. So können Sie nachvollziehen, wie ein Besucher zu einem Kurs gefunden hat, bevor er die Kursdetails geöffnet hat.
• Ereignisse werden nur einmalig gesendet und nicht zwischengespeichert: Ist der Empfänger zum Zeitpunkt des Ereignisses noch nicht registriert, geht das Ereignis verloren. Der Kurskalender wartet nicht darauf, dass Ihre Seite einen Empfänger registriert hat. Registrieren Sie den Listener deshalb so früh wie möglich, vorzugsweise bevor der iFrame geladen wird.

Konventionen für alle Felder

• Alle Feldnamen sind in snake_case geschrieben, also durchgängig klein und mit Unterstrichen.
• Datumsfelder entsprechen dem Format ISO 8601 und sind direkt mit new Date(...) in ein JavaScript-Datum umwandelbar.
• Alle Betragsfelder sind Zeichenketten ("199.00"), keine Zahlen. Wandeln Sie sie mit Number(...) um, bevor Sie damit rechnen.
• null bedeutet: an diesem Schritt beziehungsweise für diesen Kurs (noch) nicht verfügbar.

Felder in jedem Ereignis

Versionierung

Jedes Ereignis enthält im Feld version die Schema-Version, zum Beispiel 1.0.

Innerhalb einer Hauptversion – das ist die Ziffer vor dem Punkt – werden keine Felder entfernt und keine Felder umbenannt. Es können lediglich Felder hinzukommen. Ihre Auswertung bleibt damit funktionsfähig, solange die Hauptversion unverändert bleibt.

Wir empfehlen, in Ihrem Listener die Hauptversion zu prüfen und nur die von Ihnen unterstützte Hauptversion zu verarbeiten. Sobald SEMCO eine neue Hauptversion einführt, verarbeitet Ihr Listener die Ereignisse erst wieder, wenn Sie die geprüfte Hauptversion anpassen. Verfolgen Sie deshalb unsere Release Notes. Die Prüfung ist im Grundgerüst unter Tracking-Werkzeuge anbinden enthalten.

Datenobjekt course

Enthalten im Ereignis semco_classes_view sowie in allen Schritten des Buchungsablaufs.

Datenobjekt order mit quotation und items

Enthalten in allen Schritten des Buchungsablaufs. Welche Felder gefüllt sind, hängt vom erreichten Schritt ab.

*Auch bei Bestätigung kann quotation null sein, wenn kein Preis berechnet werden konnte.

Datenobjekt index

Enthalten in den Ereignissen semco_classes_index und semco_e_learning_index. Gedacht für die Auswertung von Listenaufrufen und Sucheinstiegen.

Die Werte sind die rohen URL-Parameter des Kurskalenders, etwa eine Kategorie-Kennung. Ist ein Filter nicht gesetzt, steht dort null. Sind gar keine Filter aktiv, übertragen beide Felder ein leeres Array [] statt eines leeren Objekts.

Vollständiges Beispiel eines Ereignisses

Beispielhafter Aufbau des Schrittes Bestätigung mit allen Datenobjekten:

{
  "event_name": "semco_orders_confirmation",
  "source": "semco-course-calendar",
  "version": "1.0",
  "timestamp": "2026-08-03T10:00:00+02:00",
  "locale": "de",
  "authenticated": false,
  "course": {
    "branch_company_name": "Musterakademie GmbH",
    "course_token": "ABC-123",
    "course_title": "Erste-Hilfe-Kurs",
    "course_start": "2026-09-01T00:00:00+02:00",
    "course_end": "2026-09-02T23:59:59+02:00",
    "course_category": "Sicherheit",
    "course_presence_format": "Präsenz",
    "course_format": "Tagesseminar",
    "course_level": null,
    "course_physical_location": "Raum 1, Musterstraße 1, 12345 Musterstadt",
    "course_virtual_location": null,
    "course_price": "199.00",
    "course_currency_symbol": "EUR",
    "course_early_bird_period_active": false
  },
  "order": {
    "is_group": false,
    "payment_option": "INVOICE",
    "quotation": {
      "gross_amount": "199.00",
      "net_amount": "167.23",
      "tax_amount": "31.77",
      "items": [
        {
          "amount": "199.00",
          "count": 1,
          "price": "199.00",
          "tax_amount": "31.77",
          "type_token": "COURSE"
        }
      ]
    }
  }
}