Templates zijn onmisbare onderdelen in GelatoConnect die zorgen voor zowel inkomende als uitgaande datastromen. Ze zetten klantgegevens om naar een formaat dat past bij jouw workflow, en ze maken uitgaande data van GelatoConnect geschikt voor de systemen van je klanten. In deze gids laten we je stap voor stap zien hoe je templates maakt, test en gebruikt voor beide kanten van de gegevensuitwisseling in je orderbeheer.

Templates in GelatoConnect dienen als blauwdrukken die bepalen hoe gegevens moeten worden gestructureerd, verwerkt en gepresenteerd. Ze verwerken twee kritieke gegevensstromen:

Deze sjablonen zetten gegevens van je klanten om in een formaat dat GelatoConnect kan verwerken:

Deze sjablonen zorgen ervoor dat de gegevens die vanuit GelatoConnect worden verstuurd, netjes bij je klanten of hun systemen aankomen:

Alle sjablonen gebruiken de Jinja2 sjabloontaal, die krachtige functies biedt voor gegevenstransformatie, voorwaardelijke logica en het genereren van dynamische inhoud.

GelatoConnect ondersteunt verschillende sjabloontypes voor diverse datastromen:

Het is belangrijk om te weten welke kant de data opgaat als je sjablonen maakt. Zo weet je welke data je kunt gebruiken en hoe je die het beste kunt indelen.

Kies welk type sjabloon je wilt maken:

Kies het formaat voor je template:

Om een goed sjabloon te maken, is het belangrijk dat je weet welke gegevens beschikbaar zijn:

Het systeem vult een voorbeeldpayload in met typische gegevens voor die gebeurtenis, die je kunt gebruiken als referentie bij het maken van je sjabloon.

De Template Mapper is waar je definieert hoe gegevens worden getransformeerd tussen formaten:

De inhoud van je sjabloon zal verschillen op basis van of je inkomende of uitgaande gegevens verwerkt:

Voor inkomende gegevenssjablonen (klant → GelatoConnect):

Voor uitgaande gegevenssjablonen (GelatoConnect → klant):

Hier is een voorbeeldsjabloon voor een "Order Received" Webhook:

Met deze template maak je een JSON-structuur met bestelgegevens en loop je door alle items in de bestelling heen.

Na het maken van je sjabloon:

Testen is superbelangrijk om zeker te weten dat je template goed werkt:

Als je blij bent met het sjabloon:

Sjablonen worden meestal gebruikt met triggers om meldingen te automatiseren wanneer specifieke gebeurtenissen plaatsvinden:

Kies hoe je meldingen wilt ontvangen:

Handig: je kunt ook sjablonen maken terwijl je triggers instelt.

Deze aanpak is handig voor het snel maken van sjablonen wanneer je al bezig bent met het configureren van een trigger.

Als je bestellingen via de API verstuurt, moet je vaak gegevens omzetten van jouw formaat naar het formaat van GelatoConnect. Templates regelen deze omzetting, maar je moet je template wel zelf koppelen aan het API-endpoint voordat deze wordt toegepast.

Zo koppel je een template aan een order submit-endpoint:

Als je deze stappen hebt doorlopen, worden alle bestellingen die naar dit endpoint worden gestuurd, met jouw template omgezet voordat ze verwerkt worden. Zo weet je zeker dat het formaat van jouw systeem goed wordt omgezet naar het formaat dat GelatoConnect verwacht.

Zonder deze configuratie wordt je sjabloon niet toegepast, zelfs als het bestaat en correct is ontworpen. Dit kan leiden tot mislukte ordervalidaties als je gegevensformaat niet exact overeenkomt met de vereisten van GelatoConnect.

Lookups zijn vooral handig als je gegevens tussen systemen heen en weer wilt koppelen. Hoe ze werken, hangt af van de richting van de template:

Koppel klantspecifieke waarden aan de gestandaardiseerde waarden van GelatoConnect:

Zet de interne waarden van GelatoConnect om naar het formaat dat klanten verwachten:

Gebruik voorwaarden om gegevens op te nemen of anders weer te geven, afhankelijk van de situatie:

Maak variabelen aan om ingewikkelde formules makkelijker te maken:

Navigeer door ingewikkelde gegevensstructuren: