Een abonnement aanmaken

Klik op New in het overzicht Abonnementen. Er opent een nieuw, leeg abonnement met drie kaarten; deze pagina gaat over de eerste, Details. Die beantwoordt de vraag wanneer moet dit draaien?

De kaart Details

Trigger identificatie (verplicht)

De code van het event waarnaar u wilt luisteren, bijvoorbeeld $invoicing_invoice_finalized. Het is een vrij tekstveld, dus het moet exact goed worden getypt — een typefout betekent dat het abonnement simpelweg nooit afgaat.

De pagina Eventtypen somt de identificaties op die u kunt gebruiken, per gebied, en legt uit hoe die voor uw eigen objecten zijn opgebouwd.

Gebruik de volledige identificatie

Typ de volledige identificatie, inclusief het laatste deel (…_finalized, …_add, …_update). Het laatste deel weglaten werkt in sommige gevallen en faalt in andere stilzwijgend, dus de volledige identificatie is altijd de veilige keuze.

Naam

Een kort label zodat u het abonnement in het overzicht herkent — "Definitieve factuur naar Exact Online sturen". Optioneel, maar zeer de moeite waard: het overzicht toont identificaties, en meerdere abonnementen delen er vaak één.

Triggertype (verplicht)

Het soort event. Een nieuw abonnement begint op Algemeen, dus dit is er een om bewust te zetten. Kies degene die past bij het laatste deel van uw trigger identificatie:

Triggertype	Gebruik het voor identificaties die eindigen op
Creëren	_add, _added, _create, _created
Bijwerken	_change, _changed, _update, _updated
Verwijderen	_delete, _deleted, _detach, _detached, _remove, _removed
Verwerkt	_processed
Algemeen	al het overige — inclusief _finalized, _cancel, _split, de havenbezoek-events en inkomende webhooks
Hangfire	geplande taken, waarbij de identificatie het ID van de taak is

Dit verkeerd zetten is de meest voorkomende reden dat een abonnement nooit draait, dus controleer het tegen de pagina Eventtypen — daar staat bij elk event het type vermeld.

Bijwerken heeft een voor- en een nasituatie nodig

Staat het triggertype op Bijwerken, dan draait SHIPM8 het abonnement alleen als het event zowel de oude als de nieuwe versie van het record meedraagt. Events zonder "voor"-beeld worden voor Bijwerken-abonnementen overgeslagen.

Begint op / Eindigt op

Een optioneel venster waarin het abonnement actief is. Daarbuiten wordt het abonnement genegeerd — het event gebeurt nog wel, het past alleen niet.

Beide zijn datums:

• Laat beide leeg voor een abonnement dat altijd aan staat.
• Zet Eindigt op om een abonnement vanaf een bepaalde datum uit te zetten zonder het te verwijderen.
• Zet Begint op om een automatisering nu voor te bereiden en later te laten beginnen.

Dit is ook de nette manier om een automatisering te pauzeren: zet een Eindigt op in het verleden in plaats van het abonnement te verwijderen, dan houdt u de configuratie voor later.

Opslaan

Klik op Save. Trigger identificatie en triggertype zijn verplicht; de pagina markeert ze in rood als ze ontbreken. Na het opslaan krijgt het abonnement een ID en kunt u voorwaarden en acties toevoegen.

Wijzigen en verwijderen

Een bestaand abonnement opent alleen-lezen.

• Edit ontgrendelt alle drie de kaarten. Wijzig wat u nodig hebt en klik op Save.
• Het menu ⋮ naast Save bevat Verwijderen. Een abonnement verwijderen haalt ook al zijn event acties weg, en u wordt eerst om bevestiging gevraagd.