Hoe controleer ik wat een integratie heeft gedaan?

Een integratie werkt op de achtergrond: reserveringen gaan naar een extern systeem, facturen worden doorgezet naar de boekhouding, of een extern platform maakt reserveringen aan in i-Reserve. Soms wil je precies weten wat er is gebeurd. Bijvoorbeeld: "staat deze factuur nu in de boekhouding, en wanneer is die verstuurd?". i-Reserve biedt daarvoor drie ingangen: de geschiedenis van de entiteit, de externe id op de entiteit en de technische integratielogging.

1. De geschiedenis van de entiteit (audit trail)

Vanaf versie 5.48 schrijft elke integratie een regel in de geschiedenis van de entiteit waarop zij werkt. Open de reservering, factuur of klant en kies het tabblad Geschiedenis. Integratieregels zijn herkenbaar aan het stekker-icoon met de naam van de integratie, en aan een van de volgende acties:

• Aangemaakt via integratie — de entiteit is in het externe systeem aangemaakt (bijvoorbeeld een factuur die naar de boekhouding is doorgezet);
• Bijgewerkt via integratie — de entiteit is in het externe systeem bijgewerkt;
• Ontvangen via integratie — de entiteit is in i-Reserve aangemaakt of bijgewerkt door een inkomende koppeling (bijvoorbeeld een webhook);
• Verwijderd via integratie — de entiteit is in het externe systeem verwijderd of ingetrokken;
• Integratie mislukt — het doorzetten is definitief mislukt, na alle herhaalpogingen of direct bij een harde fout.

In de kolom met de nieuwe waarde staat de externe id (zie hieronder). Geschiedenis-regels worden permanent bewaard: ook maanden later kun je nog naspelen of en wanneer een integratie op een entiteit heeft gewerkt.

2. Externe id's

Bij het doorzetten kent het externe systeem een eigen id toe aan de entiteit: een factuurnummer of factuur-id in de boekhouding, een boekings-id in het externe platform. i-Reserve legt deze externe id op twee plekken vast: in een veld op de entiteit zelf (per integratie instelbaar, bijvoorbeeld het veld external_id of een custom veld) en in de geschiedenis-regel van de integratie.

Met de externe id zoek je de entiteit terug in het externe pakket. Andersom werkt ook: staat er in het externe pakket een record waarvan je de herkomst wilt weten, dan zoek je in i-Reserve op die externe id. Zo stel je vast of i-Reserve de bron was.

3. Technische integratielogging

Voor foutanalyse is er per integratie een technische log van de aanroepen. Ga naar Instellingen > Integraties, open de integratie en kies de logging. Je ziet per aanroep de request-URL, de methode, de verstuurde payload en de response (code en detail). Hiervoor is het recht menu_confmod_integrations nodig.

Let op: deze logging is technisch van aard en wordt standaard 90 dagen bewaard (instelbaar). Voor de vraag "heeft de integratie ooit op deze entiteit gewerkt?" is de geschiedenis van de entiteit daarom de juiste plek; de technische log is er voor de details van recente aanroepen.

Herhaalpogingen en foutmeldingen

Uitgaande koppelingen die via de verzendwachtrij lopen, worden bij een fout automatisch opnieuw geprobeerd met een oplopend interval: eerst elke paar minuten, daarna elk half uur en elk uur, tot ruim een dag na de eerste poging. Slaagt het daarna nog niet, dan wordt de poging definitief als mislukt gemarkeerd: er verschijnt een regel "Integratie mislukt" in de geschiedenis en — indien ingesteld bij de integratie — ontvangen de opgegeven probleem-e-mailadressen een notificatie.

Praktisch stappenplan

1. Open de entiteit (reservering, factuur, klant) en kijk in het tabblad Geschiedenis naar regels met het stekker-icoon.
2. Controleer de externe id in de geschiedenis-regel of op de entiteit, en zoek daarmee het record op in het externe pakket.
3. Meer detail of een fout nodig? Open de technische logging bij de integratie zelf via Instellingen > Integraties.