ERP-integratie

Opmerking: Dit is een technisch zeer diepgaand artikel. Wij raden u aan uw IT‑afdeling te betrekken bij het doornemen hiervan. Heeft u vragen of verzoeken, 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 productopdrachten in Azumuta – op basis van productopdrachtgegevens die door het ERP‑systeem worden aangeleverd.

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

De integratie tussen Azumuta en een ERP‑systeem maakt doorgaans gebruik van de REST API en bestaat uit meerdere stappen. Houd er rekening mee dat de details kunnen variëren afhankelijk van uw behoeften en het gebruikte ERP‑systeem.

Hier volgt een algemeen overzicht van het proces:

1. Begrijpen van de eisen: Bepaal welke specifieke gegevens en processen geïntegreerd moeten worden tussen Azumuta en het ERP‑systeem. Een eenvoudig voorbeeld is het automatisch aanmaken van productopdrachten op basis van informatie uit het ERP‑systeem.
2. Authenticatie en autorisatie: Zorg dat u de benodigde geloofsgegevens en rechten heeft om de REST API van zowel Azumuta als het ERP‑systeem te benaderen. Authenticatie bij Azumuta gebeurt via API‑sleutels.
3. Raadpleeg de API‑documentatie: Verkrijg en bestudeer de API‑documentatie voor zowel Azumuta als het ERP‑systeem. Deze documentatie geeft details over beschikbare endpoints, request/response‑formaten en eventuele authenticatievereisten.
4. Afstemming van gegevensmapping: Map de gegevensvelden en -structuren tussen Azumuta en het ERP‑systeem. Zorg voor een gemeenschappelijk begrip van hoe gegevens worden weergegeven en uitgewisseld. Voor het voorbeeld van het aanmaken van productopdrachten gaat het om vragen als: hoe wordt het productopdrachtnummer bepaald? Op basis van welke artikelen worden de productopdrachten aangemaakt? Welke parameters of varianten worden meegestuurd met de nieuw aangemaakte productopdracht?
5. Ontwikkeling: Ontwikkel de middleware of connectoren om de communicatie tussen Azumuta en het ERP‑systeem te faciliteren. Typisch noemen we dit de integratielaag, die fungeert als een "koppellaag" tussen Azumuta en het ERP‑systeem.

Hieronder ziet u een schematische weergave van het aanmaken van productopdrachten 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 productopdracht 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 ontraden omdat het onnodige belasting op onze systemen veroorzaakt.

We tonen hier de eerste optie, omdat dit de aanbevolen methode is. Triggers kunnen per artikelcategorie worden geconfigureerd en uitgevoerd wanneer een specifieke gebeurtenis optreedt.

In het onderstaande voorbeeld wordt een webhook aangeroepen wanneer een productopdracht gekoppeld aan een specifieke artikelcategorie is voltooid.

Om ervoor te zorgen dat de webhook werkt, moeten de Azumuta‑servers toegang hebben tot het geconfigureerde endpoint. Het productopdrachtnummer en, indien van toepassing, de werkinstructie en opname‑ID's worden opgenomen als queryparameters (bij een GET‑request) of als JSON (in het geval van een POST‑request) in de webhook. Iedere webhook‑aanroep bevat bovendien een apiKey van een workspace Api Device - u heeft ten minste één Api Device geconfigureerd nodig om webhooks te laten slagen.

Voor stap‑voor‑stap setup (endpoint, GET/POST en optionele custom POST‑payload), zie Calling a Webhook from a Trigger. Voor Api Device / API‑sleutel setup, zie Create and manage API keys.

Opmerking: Een webhook is een manier voor het ene systeem om het andere systeem in realtime te 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 vaak gebruikt om systemen te integreren en processen te automatiseren.

Om triggers in te zetten voor het overdragen 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 zorgen dat de juiste informatie beschikbaar is voor verzending naar het ERP‑systeem.