ERP-integratie

Opmerking: Dit is een technisch artikel van hoog niveau. Daarom raden wij aan uw IT‑afdeling erbij te betrekken tijdens het lezen. Mocht u vragen of verzoeken hebben, neem dan contact met ons op via support@azumuta.com - wij helpen u graag.

Integratie van Azumuta met een ERP-systeem

Het is mogelijk Azumuta te integreren met een extern ERP-systeem. Meestal wordt deze integratie gebruikt voor het automatisch aanmaken van productorders in Azumuta – op basis van productordergegevens die door het ERP-systeem worden aangeleverd.

Het voordeel? Uw productorders kunnen automatisch en razendsnel in Azumuta worden aangemaakt (inclusief de parameters, varianten, en alle andere belangrijke gegevens) – zonder handmatige invoer.

De integratie tussen Azumuta en een ERP-systeem gebruikt doorgaans REST API en bestaat uit meerdere stappen. De precieze invulling kan variëren afhankelijk van uw wensen en het gebruikte ERP‑systeem.

Hier volgt een algemeen overzicht van het proces:

1. Vereisten begrijpen: Breng de specifieke gegevens en processen in kaart die geïntegreerd moeten worden tussen Azumuta en het ERP‑systeem. Een eenvoudig voorbeeld is het automatisch aanmaken van productorders op basis van informatie uit het ERP‑systeem.
2. Authenticatie en autorisatie: Zorg dat u de benodigde referenties en rechten hebt om de REST API van zowel Azumuta als het ERP‑systeem te benaderen. Authenticatie bij Azumuta gebeurt via API‑sleutels.
3. Controleer de API‑documentatie: Verkrijg en bestudeer de API‑documentatie voor zowel Azumuta als het ERP‑systeem. Die documentatie geeft details over beschikbare endpoints, request/response‑formaten en eventuele authenticatievereisten.
4. Afspreken van data‑mapping: Breng de gegevensvelden en -structuren tussen Azumuta en het ERP‑systeem in kaart. Zorg voor een gemeenschappelijk begrip van hoe gegevens worden gerepresenteerd en uitgewisseld. Voor het basisvoorbeeld van het aanmaken van productorders komt het neer op vragen als: Hoe wordt het productordernummer bepaald? Op basis van welke artikelen worden productorders aangemaakt? Welke parameters of varianten worden meegezonden bij de nieuw aangemaakte productorder?
5. Ontwikkeling: Ontwikkel de middleware of connectors die de communicatie tussen Azumuta en het ERP‑systeem faciliteren. Meestal noemen we dit de integratielaag, die fungeert als een "lijmlaag" tussen Azumuta en het ERP‑systeem.

Hieronder een schematische weergave van het aanmaken van productorders op basis van informatie uit het ERP‑systeem.

Triggers gebruiken om gegevens uit Azumuta op te halen

Er zijn twee opties om gegevens uit Azumuta te extraheren. Enerzijds is het mogelijk triggers automatisch uit te voeren. Een trigger is een gebeurtenis die plaatsvindt als gevolg van een andere gebeurtenis. Bijvoorbeeld: een webhook wordt aangeroepen nadat een productorder door een operator is afgerond. Wij geven de voorkeur aan deze methode omdat alleen de noodzakelijke gegevens op het gewenste moment worden uitgewisseld.

Anderzijds is het mogelijk periodiek gegevens op te halen via onze REST API. Deze methode wordt sterk afgeraden omdat dit onnodige belasting van onze systemen veroorzaakt.

We tonen de eerste optie, aangezien dit de aanbevolen methode is. Triggers kunnen worden geconfigureerd voor een artikelcategorie zodat ze worden uitgevoerd wanneer een specifieke gebeurtenis plaatsvindt.

In het onderstaande voorbeeld wordt een webhook aangeroepen wanneer een productorder gekoppeld aan een specifieke artikelcategorie is afgerond.

Om zeker te stellen dat de webhook werkt, moeten de Azumuta‑servers toegang hebben tot het geconfigureerde endpoint. Het productordernummer en, indien van toepassing, de werkopdracht‑ en registratie‑ID's worden meegeleverd als queryparameters (voor een GET‑request) of als JSON (in geval van een POST‑request) in de webhook. Elke webhookaanroep bevat ook een apiKey van een workspace Api Device - u heeft minimaal één Api Device geconfigureerd nodig om webhooks te laten slagen.

Voor stapsgewijze installatie (endpoint, GET/POST en optionele custom POST‑payload), zie Calling a Webhook from a Trigger. Voor Api Device / API‑sleutelconfiguratie, zie How to Create and Manage API Keys.

Opmerking: Een webhook is een manier waarop het ene systeem het andere systeem in realtime kan informeren over gebeurtenissen of updates. Het is een communicatiemethode tussen twee applicaties, waarbij de ene applicatie data naar een specifiek URL‑endpoint stuurt wanneer een bepaalde gebeurtenis plaatsvindt. Webhooks worden veel gebruikt om verschillende systemen te integreren en processen te automatiseren.

Om triggers te gebruiken voor het versturen van gegevens naar het ERP‑systeem, moet eerst een integratielaag worden geplaatst. De integratielaag wordt geconfigureerd als het aangewezen endpoint voor de webhook‑trigger. Deze middlewarecomponent kan de door Azumuta getriggerde gebeurtenissen interpreteren. Indien nodig haalt de integratielaag aanvullende gegevens op via de REST API om te verzekeren dat de juiste informatie beschikbaar is voor verzending naar het ERP‑systeem.