Opmerking: Dit is een zeer technische handleiding. Wij raden u daarom aan om bij het lezen hiervan uw IT-afdeling in te schakelen. Mocht u vragen of verzoeken hebben, neem dan contact met ons op viasupport@old-old-wordpress.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 in een handomdraai automatisch worden aangemaakt in Azumuta (inclusief de parameters, varianten en andere belangrijke gegevens) - zonder handmatige invoer.
De integratie tussen Azumuta en een ERP-systeem maakt meestal gebruik van REST API en omvat verschillende stappen. Houd er rekening mee dat de details kunnen variëren, afhankelijk van je behoeften en het ERP-systeem dat je 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 het automatisch aanmaken van productorders op basis van informatie uit het ERP-systeem.
- Authenticatie en autorisatie: Zorg ervoor dat je de nodige credentials en permissies hebt om toegang te krijgen tot de REST API van zowel Azumuta als het ERP-systeem. Authenticatie bij Azumuta gebeurt via API-sleutels.
- Controleer de API-documentatie: Verkrijg en bekijk de API documentatie voor zowel Azumuta als het ERP systeem. Deze documentatie bevat details over de beschikbare endpoints, request/response formaten en eventuele authenticatie-eisen.
- Overeenstemming bereiken over de datamapping: Breng de datavelden en -structuren tussen Azumuta en het ERP-systeem in kaart. 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 productbestellingen aangemaakt? Welke parameters of varianten worden meegestuurd met de zojuist aangemaakte productorder?
- Ontwikkeling: Ontwikkelen van de middleware, of connectoren om de communicatie tussen Azumuta en het ERP-systeem te vergemakkelijken. Meestal noemen we dit de integratielaag, die fungeert als een "lijmlaag" tussen Azumuta en het ERP-systeem.
Hieronder ziet u een schematische weergave van het maken van productorders op basis van informatie uit het ERP-systeem.
Triggers gebruiken om gegevens op te halen uit Azumuta #
Er zijn twee opties om gegevens uit Azumuta te halen. Aan de ene kant is het mogelijk om automatisch triggers uit te voeren. Een trigger is een gebeurtenis die plaatsvindt als gevolg van een andere gebeurtenis. Een webhook wordt bijvoorbeeld aangeroepen nadat een productbestelling is afgerond door een operator. Wij geven de voorkeur aan deze methode omdat alleen de benodigde 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 het onze systemen onnodig zwaar belast.
We laten je de eerste optie zien, omdat dit de aanbevolen methode is. Triggers kunnen worden geconfigureerd voor een artikelcategorie om te worden uitgevoerd wanneer zich een specifieke gebeurtenis voordoet.
In het onderstaande voorbeeld wordt een webhook aangeroepen wanneer een productbestelling gekoppeld aan een specifieke artikelcategorie 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 werkinstructie en opname-ID's worden als queryparameters (bij een GET-verzoek) of als JSON (bij een POST-verzoek) in de webhook opgenomen.
Opmerking: Een webhook is een manier voor een systeem om een ander systeem in realtime op de hoogte te brengen van gebeurtenissen of updates. Het is een communicatiemethode tussen twee toepassingen, waarbij de ene toepassing gegevens naar een specifiek URL-eindpunt stuurt wanneer een bepaalde gebeurtenis plaatsvindt. Webhooks worden vaak gebruikt om verschillende systemen te integreren en processen te automatiseren. Het bronsysteem stuurt meestal een HTTP POST-verzoek naar een URL die is opgegeven door het bestemmingssysteem. Deze URL wordt vaak het "webhook eindpunt" genoemd. Het POST-verzoek bevat gegevens met betrekking tot het event in de vorm van een payload. Deze payload bevat informatie over de gebeurtenis die heeft plaatsgevonden en is meestal in een formaat zoals JSON.
Om triggers te gebruiken voor het verzenden van gegevens naar het ERP-systeem, moet er eerst een integratielaag worden geplaatst. De integratielaag wordt geconfigureerd als het aangewezen eindpunt voor de webhook trigger. Deze middlewarecomponent 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 bestaat voor verzending naar het ERP-systeem.
