Ein Abonnement anlegen

Klicken Sie in der Übersicht Subscriptions auf New. Es öffnet sich ein neues, leeres Abonnement mit drei Karten; diese Seite behandelt die erste, Details. Sie beantwortet die Frage: Wann soll das laufen?

Die Karte Details

Trigger identifier (Pflicht)

Der Code des Ereignisses, auf das Sie lauschen wollen, zum Beispiel $invoicing_invoice_finalized. Es ist ein Freitextfeld, muss also exakt richtig getippt sein — bei einem Tippfehler greift das Abonnement schlicht nie.

Die Seite Ereignistypen listet die möglichen Identifier nach Bereich und erklärt, wie die für Ihre eigenen Objekte aufgebaut sind.

Nehmen Sie den vollständigen Identifier

Tippen Sie den kompletten Identifier, samt letztem Teil (…_finalized, …_add, …_update). Ihn wegzulassen funktioniert in manchen Fällen und scheitert in anderen stillschweigend — der vollständige Identifier ist immer die sichere Wahl.

Name

Eine kurze Bezeichnung, damit Sie das Abonnement in der Übersicht wiedererkennen — etwa „Finale Rechnung an Exact Online schicken“. Optional, aber sehr zu empfehlen: Die Übersicht zeigt Identifier, und mehrere Abonnements teilen sich oft einen.

Trigger type (Pflicht)

Die Art des Ereignisses. Ein neues Abonnement startet auf Generic — das sollten Sie also bewusst setzen. Nehmen Sie das, was zum letzten Teil Ihres Identifiers passt:

Trigger type	Für Identifier, die enden auf
Create	_add, _added, _create, _created
Update	_change, _changed, _update, _updated
Delete	_delete, _deleted, _detach, _detached, _remove, _removed
Processed	_processed
Generic	alles Übrige — auch _finalized, _cancel, _split, die Hafenbesuchsereignisse und eingehende Webhooks
Hangfire	geplante Jobs, bei denen der Identifier die Job-ID ist

Hier danebenzuliegen ist der häufigste Grund, warum ein Abonnement nie läuft. Prüfen Sie es gegen die Seite Ereignistypen — dort steht der Typ zu jedem Ereignis.

Update braucht ein Vorher und ein Nachher

Steht der trigger type auf Update, läuft das Abonnement nur, wenn das Ereignis sowohl die alte als auch die neue Fassung des Datensatzes mitträgt. Ereignisse ohne Vorher-Zustand werden bei Update-Abonnements übersprungen.

Starts on / Ends on

Ein optionales Fenster, in dem das Abonnement aktiv ist. Außerhalb wird es ignoriert — das Ereignis passiert weiterhin, es passt nur nicht.

Beides sind Daten:

• Beide leer lassen für ein Abonnement, das immer an ist.
• Ends on setzen, um ein Abonnement ab einem Datum abzuschalten, ohne es zu löschen.
• Starts on setzen, um eine Automatisierung jetzt vorzubereiten und später starten zu lassen.

Das ist auch der saubere Weg, eine Automatisierung zu pausieren: Setzen Sie Ends on in die Vergangenheit, statt das Abonnement zu löschen — dann bleibt die Konfiguration für später erhalten.

Speichern

Klicken Sie auf Save. Trigger identifier und trigger type sind Pflicht; fehlen sie, markiert die Seite sie rot. Nach dem Speichern bekommt das Abonnement eine ID, und Sie können Bedingungen und Aktionen ergänzen.

Ändern und löschen

Ein vorhandenes Abonnement öffnet schreibgeschützt.

• Edit entsperrt alle drei Karten. Ändern Sie, was nötig ist, und klicken Sie auf Save.
• Im Menü ⋮ neben Save steht Delete. Ein gelöschtes Abonnement nimmt alle seine Ereignisaktionen mit; vorher werden Sie um Bestätigung gebeten.