Opmerking: Dit artikel is technisch van aard, daarom raden we aan iemand met de juiste technische expertise bij te betrekken. Als u vragen heeft, ons te contacteren.
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 geleverd.
Het voordeel? Uw productorders kunnen automatisch in een mum van tijd in Azumuta worden aangemaakt (inclusief Parameters, varianten, en 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 is 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 basic voorbeeld 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 referenties 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-/antwoordindelingen 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 inzicht is in hoe gegevens zullen worden weergegeven en uitgewisseld. Voor het basic voorbeeld 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 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 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. 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 Na een productorder is voltooid door een Operator. We geven de voorkeur aan deze methode omdat enkel de noodzakelijke gegevens op het juiste 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 onnodig 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 bepaalde Gebeurtenis plaatsvindt.
In het voorbeeld hieronder 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 te laten slagen.
Voor stap-voor-stap-instelling (Endpoint, GET/POST en optionele op maat gemaakte POST Payload), zie Een webhook aanroepen vanuit een Trigger. Voor API-apparaat / API-sleutelinstelling, 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-component 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.