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, ons te contacteren via support@azumuta.com - we helpen u graag.
Azumuta integreren met een ERP-systeem
Het is mogelijk Azumuta te integreren met een extern ERP-systeem. Meestal wordt deze integratie gebruikt voor automatische productorderaanmaak 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 Parameters, varianten, en 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 is een algemeen overzicht van het proces:
- Inzicht in de vereisten: Identificeer de specifieke gegevens en processen die tussen Azumuta en het ERP-systeem moeten worden geïntegreerd. 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 noodzakelijke inloggegevens en Permissies beschikt om toegang te krijgen tot de REST API van zowel Azumuta als het ERP-systeem. Authenticatie met Azumuta wordt gedaan via API-sleutels.
- Check de API-documentatie: Verkrijg en beoordeel de API-documentatie voor zowel Azumuta als het ERP-systeem. Deze documentatie bevat Details over de beschikbare eindpunten, 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 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 artikels 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 een "lijmlaag" tussen Azumuta en het ERP-systeem fungeert.
Hieronder ziet 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 Gebeurtenis. Bijvoorbeeld, een webhook wordt aangeroepen nadat een Productorder door een Operator is voltooid. We geven de voorkeur aan deze methode omdat enkel de noodzakelijke gegevens op het gewenste moment worden uitgewisseld.
Aan de andere kant is het mogelijk om periodiek gegevens op te halen via onze REST API. Deze methode wordt sterk afgeraden omdat dit meer onnodige belasting op onze systemen creëert.
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 Device - u moet minstens één Api Device geconfigureerd hebben voor webhooks om succesvol te zijn.
Voor stap-voor-stap-setup (Endpoint, GET/POST en optionele aangepaste POST Payload), zie Een webhook aanroepen vanuit een Trigger. Voor Api Device / API Key-setup, zie How to Creëren en Beheer API Keys.
Opmerking: Een webhook is een manier voor het ene systeem om het andere systeem in realtime op de hoogte te stellen van Gebeurtenissen of updates. Het is een communicatiemethode tussen twee toepassingen, waarbij de ene toepassing 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 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.