ERP-integratie

Opmerking: Dit is een technisch zeer gespecialiseerde handleiding. Daarom raden wij aan uw IT-afdeling te betrekken bij het lezen hiervan. Als u vragen of verzoeken heeft, neem dan contact op via support@azumuta.com - wij helpen u graag.

Integratie van Azumuta met een ERP-systeem

Het is mogelijk Azumuta te integreren met een extern ERP-systeem. Meestal wordt deze integratie gebruikt voor de automatische aanmaak van productorders in Azumuta – op basis van productordergegevens die door het ERP-systeem worden geleverd.

Het voordeel? Uw productorders kunnen razendsnel automatisch worden aangemaakt in Azumuta (inclusief parameters, varianten, en andere belangrijke gegevens) – zonder handmatige invoer.

De integratie tussen Azumuta en een ERP-systeem gebruikt doorgaans de REST API en omvat meerdere stappen. Houd er rekening mee dat de details kunnen variëren afhankelijk van uw behoeften en het gebruikte ERP-systeem.

Hier volgt een algemeen overzicht van het proces:

1. Begrijpen van de vereisten: identificeer de specifieke gegevens en processen die tussen Azumuta en het ERP-systeem geïntegreerd moeten worden. Een eenvoudig voorbeeld is de automatische aanmaak van productorders op basis van informatie uit het ERP-systeem.
2. Authenticatie en autorisatie: zorg dat u de benodigde inloggegevens en machtigingen heeft om de REST API van zowel Azumuta als het ERP-systeem te benaderen. Authenticatie bij Azumuta geschiedt via API-sleutels.
3. Controleer de API-documentatie: verkrijg en beoordeel de API-documentatie voor zowel Azumuta als het ERP-systeem. Deze documentatie geeft details over beschikbare endpoints, request/response-formaten en eventuele authenticatievereisten.
4. Afstemming van datamapping: leg de gegevensvelden en -structuren tussen Azumuta en het ERP-systeem vast. Zorg voor gedeeld begrip over hoe gegevens worden weergegeven en uitgewisseld. Voor het eenvoudige voorbeeld 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 meegezonden met de zojuist aangemaakte productorder?
5. Ontwikkeling: ontwikkel de middleware of connectors die de communicatie tussen Azumuta en het ERP-systeem vergemakkelijken. Dit noemen we doorgaans de integratielaag, die fungeert als een 'bruglaag' tussen Azumuta en het ERP-systeem.

Hieronder 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 om gegevens uit Azumuta te halen. Enerzijds is het mogelijk triggers automatisch uit te voeren. Een trigger is een gebeurtenis die plaatsvindt als gevolg van een andere gebeurtenis. Bijvoorbeeld: een webhook wordt aangeroepen nadat een productorder door een operator is afgerond. Wij geven de voorkeur aan deze methode omdat alleen de noodzakelijke gegevens op het gewenste moment worden uitgewisseld.

Anderzijds is het mogelijk periodiek gegevens op te halen via onze REST API. Deze methode wordt sterk afgeraden omdat het onnodig meer belasting op onze systemen veroorzaakt.

We tonen u de eerste optie, aangezien dit de aanbevolen methode is. Triggers kunnen worden geconfigureerd op een artikelcategorie om te worden uitgevoerd wanneer een specifieke gebeurtenis zich voordoet.

In het voorbeeld hieronder wordt een webhook aangeroepen wanneer een productorder gekoppeld 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 werkopdracht en opname-ID's worden als queryparameters (bij een GET-verzoek) of als JSON (bij een POST-verzoek) meegegeven in de webhook.

Opmerking: Een webhook is een manier voor het ene systeem om het andere systeem in realtime te informeren over gebeurtenissen of updates. Het is een communicatiemethode tussen twee applicaties, waarbij de ene applicatie gegevens naar een specifieke URL-endpoint stuurt wanneer een bepaalde gebeurtenis plaatsvindt. Webhooks worden veel gebruikt om systemen te integreren en processen te automatiseren.

Het bronsysteem stuurt doorgaans een HTTP POST-verzoek naar een URL die door het bestemmingssysteem is opgegeven. Deze URL wordt vaak het "webhook endpoint" genoemd. Het POST-verzoek bevat gegevens die verband houden met de gebeurtenis in de vorm van een payload. Deze payload bevat informatie over de opgetreden gebeurtenis en is meestal 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 wordt geconfigureerd als het aangewezen endpoint voor de webhook-trigger. Deze middleware-component kan door Azumuta geactiveerde gebeurtenissen interpreteren. Indien nodig haalt de integratielaag aanvullende gegevens op via de REST API om te garanderen dat de juiste informatie beschikbaar is voor verzending naar het ERP-systeem.