Opmerking: Dit is een zeer technisch artikel. Daarom raden we 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 - we 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 automatische aanmaak van productorders in Azumuta – op basis van productordergegevens die door het ERP-systeem worden aangeleverd.
Het voordeel? Uw productorders kunnen automatisch in een mum van tijd in Azumuta worden aangemaakt (inclusief de Parameters, varianten, en alle andere belangrijke gegevens) – zonder enige 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:
- Inzicht in de vereisten: Identificeer de specifieke gegevens en processen die moeten worden geïntegreerd tussen Azumuta en het ERP-systeem. Een basisvoorbeeld is de automatische aanmaak van productorders op basis van informatie afkomstig van het ERP-systeem.
- Authenticatie en autorisatie: Zorg ervoor dat u over de nodige inloggegevens en Permissies beschikt om toegang te krijgen tot de REST API van zowel Azumuta als het ERP-systeem. Authenticatie met Azumuta gebeurt via API-sleutels.
- Check de API-documentatie: Verkrijg en controleer de API-documentatie voor zowel Azumuta als het ERP-systeem. Deze documentatie bevat details over de beschikbare endpoints, verzoek-/antwoordformaten en eventuele authenticatievereisten.
- Afspraken maken over gegevenstoewijzing: Wijs de gegevensvelden en -structuren toe tussen Azumuta en het ERP-systeem. Zorg ervoor dat er een gemeenschappelijk begrip bestaat van hoe gegevens zullen 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 artikels worden de productorders aangemaakt? Welke Parameters of varianten worden samen met de nieuw aangemaakte productorder verstuurd?
- Ontwikkeling: Ontwikkel de middleware of connectors om de communicatie tussen Azumuta en het ERP-systeem te vergemakkelijken. Doorgaans noemen we dit de integratielaag, die als een "lijmlaag" tussen Azumuta en het ERP-systeem fungeert.
Hieronder volgt 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. Enerzijds is het mogelijk om Triggers automatisch uit te voeren. Een Trigger is een Gebeurtenis die plaatsvindt als gevolg van een ander Gebeurtenis. 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.
Anderzijds is het mogelijk om gegevens periodiek op te halen via onze REST API. Deze methode wordt sterk afgeraden omdat dit meer onnodige belasting op onze Systemen veroorzaakt.
We tonen u de eerste optie, 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 Gelinkt 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 Productordernummer en, indien van toepassing, de werkinstructie en recording-ID's zijn opgenomen als queryparameters (voor een GET-verzoek) of als JSON (in geval van een POST-verzoek) in de webhook. Elke webhook-aanroep bevat ook een apiKey van een Workspace API-apparaat - u moet minstens één API-apparaat geconfigureerd hebben om webhooks succesvol te laten werken.
Voor stapsgewijze setup (Endpoint, GET/POST en optionele aangepaste POST Payload), zie Een webhook aanroepen vanuit een Trigger. Voor API-apparaat / API-sleutelsetup, zie API-sleutels aanmaken en beheren.
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-Endpoint verzendt wanneer een bepaalde Gebeurtenis plaatsvindt. Webhooks worden vaak gebruikt om verschillende Systemen te integreren en processen te automatiseren.
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 Endpoint voor de webhook Trigger. Dit middleware-onderdeel kan getriggerde Gebeurtenissen van Azumuta 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.