ERP-integratie

Opmerking: Dit artikel is technisch van aard, dus wij adviseren u iemand met de juiste technische expertise te betrekken. Als u vragen heeft, neem contact op via support@azumuta.com.

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 aangeleverd.

Het voordeel? Uw productorders kunnen razendsnel automatisch in Azumuta worden aangemaakt (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 wensen en het ERP-systeem dat u gebruikt.

Hier volgt een algemeen overzicht van het proces:

1. Begrijpen van de vereisten: Identificeer de specifieke gegevens en processen die geïntegreerd moeten worden tussen Azumuta en het ERP-systeem. Een eenvoudig voorbeeld is het automatisch aanmaken van productorders op basis van informatie uit het ERP-systeem.
2. Authenticatie en autorisatie: Zorg dat u de benodigde inloggegevens en rechten heeft om de REST API van zowel Azumuta als het ERP-systeem te benaderen. Authenticatie bij Azumuta gebeurt via API keys.
3. Controleer de API-documentatie: Verkrijg en doorloop de API-documentatie voor zowel Azumuta als het ERP-systeem. Deze documentatie bevat details over beschikbare endpoints, request/response-formaten en eventuele authenticatie-eisen.
4. Afstemming over datamapping: Breng de gegevensvelden en -structuren tussen Azumuta en het ERP-systeem in kaart. Zorg voor een gemeenschappelijk begrip van hoe gegevens worden weergegeven en uitgewisseld. Voor het 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 nieuw aangemaakte productorder?
5. Ontwikkeling: Ontwikkel de middleware of connectors om de communicatie tussen Azumuta en het ERP-systeem mogelijk te maken. Gewoonlijk noemen we dit de integratielaag, die fungeert als een “lijmlaag” tussen Azumuta en het ERP-systeem.

Below is a schematic representation of creating product orders based on information from the ERP system.

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 operator een productorder heeft voltooid. Wij geven de voorkeur aan deze methode omdat alleen de benodigde gegevens op het juiste moment worden uitgewisseld.

Aan de andere kant is het mogelijk periodiek gegevens op te halen via onze REST API. Deze methode wordt sterk afgeraden omdat het onnodige extra belasting op onze systemen veroorzaakt.

We laten u de eerste optie zien, omdat dit de aanbevolen methode is. Triggers kunnen per artikelcategorie worden geconfigureerd om te worden uitgevoerd wanneer een specifieke gebeurtenis plaatsvindt.

In het onderstaande voorbeeld wordt een webhook aangeroepen wanneer een productorder die gekoppeld is aan een specifieke artikelcategorie is voltooid.

Om 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 opgenomen als queryparameters (bij een GET-request) of als JSON (bij een POST-request) in de webhook. Elke webhook-aanroep bevat ook een apiKey van een workspace Api Device - u heeft minimaal één Api Device geconfigureerd nodig om webhooks te laten slagen.

Voor stapsgewijs opzetten (endpoint, GET/POST en optionele custom POST-payload), zie Een webhook aanroepen vanuit een trigger. Voor Api Device / API-key setup, zie API-sleutels aanmaken en beheren.

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

Om triggers te gebruiken voor het doorsturen 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 middlewarecomponent kan de 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.