Opmerking: Dit is een zeer technische handleidingspagina. Daarom raden wij aan uw IT-afdeling erbij te betrekken bij het lezen hiervan. Mocht u vragen of verzoeken hebben, neem dan contact met ons op via support@azumuta.com - wij helpen u graag verder.
Azumuta integreren met een ERP-systeem
Het is mogelijk om 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 in een oogwenk in Azumuta worden aangemaakt (inclusief de parameters, varianten, en alle andere belangrijke gegevens) – zonder handmatige invoer.
De integratie tussen Azumuta en een ERP-systeem maakt doorgaans gebruik van REST API en omvat verschillende stappen. Houd er rekening mee dat de specifieke details kunnen variëren afhankelijk van uw behoeften en het ERP-systeem dat u gebruikt.
Hier volgt een algemeen overzicht van het proces:
- De vereisten begrijpen: Identificeer de specifieke gegevens en processen die moeten worden geïntegreerd tussen Azumuta en het ERP-systeem. Een basisvoorbeeld is het automatisch aanmaken van productorders op basis van informatie afkomstig van het ERP-systeem.
- Authenticatie en autorisatie: Zorg ervoor dat u over de nodige referenties en machtigingen beschikt om toegang te krijgen tot de REST API van zowel Azumuta als het ERP-systeem. Authenticatie met Azumuta gebeurt via API-sleutels.
- Controleer de API-documentatie: Verkrijg en controleer de API-documentatie voor zowel Azumuta als het ERP-systeem. Deze documentatie bevat details over de beschikbare eindpunten, aanvraag-/antwoordformaten en eventuele authenticatievereisten.
- Afspraken maken over gegevenstoewijzing: Wijs de gegevensvelden en -structuren tussen Azumuta en het ERP-systeem toe. Zorg ervoor dat er een gemeenschappelijk begrip is van hoe gegevens worden weergegeven en uitgewisseld. Voor het basisvoorbeeld van het aanmaken van productorders komt het neer op de volgende vragen: Hoe wordt het productordernummer bepaald? Op basis van welke artikelen worden de productorders aangemaakt? Welke parameters of varianten worden meegestuurd met de nieuw aangemaakte productorder?
- Ontwikkeling: Ontwikkel de middleware of connectoren om de communicatie tussen Azumuta en het ERP-systeem te vergemakkelijken. Doorgaans noemen we dit de integratielaag, die als "lijmlaag" tussen Azumuta en het ERP-systeem fungeert.
Hieronder vindt u 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 voor het extraheren van gegevens uit Azumuta. Aan de ene kant is het mogelijk om triggers automatisch uit te voeren. Een trigger is een gebeurtenis die plaatsvindt als gevolg van een ander evenement. Bijvoorbeeld, een webhook wordt aangeroepen nadat een productorder door een operator is voltooid. We geven de voorkeur aan deze methode omdat alleen de nodige gegevens op het gewenste moment worden uitgewisseld.
Aan de andere kant is het mogelijk om gegevens periodiek op te halen via onze REST API. Deze methode wordt sterk afgeraden omdat deze onnodige belasting op onze systemen veroorzaakt.
Wij zullen u de eerste optie laten zien, omdat dit de aanbevolen methode is. Triggers kunnen voor een artikelcategorie worden geconfigureerd om te worden uitgevoerd wanneer een specifieke gebeurtenis plaatsvindt.
In het onderstaande voorbeeld wordt een webhook aangeroepen wanneer een productorder die aan een specifieke artikelcategorie is gekoppeld, is voltooid.
Om ervoor te zorgen dat de webhook werkt, moeten de Azumuta-servers toegang hebben tot het geconfigureerde eindpunt. Het productordernummer en, indien van toepassing, de werk-instructie- en opname-ID's worden opgenomen als queryparameters (voor een GET-aanvraag) of als JSON (in het geval van een POST-aanvraag) in de webhook.
Opmerking: Een webhook is een manier voor het ene systeem om het andere systeem in real-time op de hoogte te stellen van gebeurtenissen of updates. Het is een communicatiemethode tussen twee applicaties, waarbij de ene applicatie gegevens naar een specifiek URL-eindpunt verzendt wanneer een bepaalde gebeurtenis plaatsvindt. Webhooks worden vaak gebruikt om verschillende systemen te integreren en processen te automatiseren.
Het bronsysteem verzendt doorgaans een HTTP POST-aanvraag naar een URL die door het doelsysteem is opgegeven. Deze URL wordt vaak de "webhook-eindpunt" genoemd. De POST-aanvraag bevat gegevens met betrekking tot de gebeurtenis in de vorm van een payload. Deze payload bevat informatie over de gebeurtenis die heeft plaatsgevonden, en deze is doorgaans in een formaat zoals JSON.
Om triggers te gebruiken voor het verzenden van gegevens naar het ERP-systeem, moet eerst een integratielaag worden geplaatst. De integratielaag is geconfigureerd als het aangewezen eindpunt voor de webhooktrigger. Dit middleware-component kan door Azumuta geactiveerde gebeurtenissen interpreteren. Indien nodig haalt de integratielaag aanvullende gegevens op via de REST API om ervoor te zorgen dat de juiste informatie beschikbaar is voor verzending naar het ERP-systeem.