ERP-Integration

Hinweis: Dieser Artikel ist technisch, daher empfehlen wir, eine Person mit der entsprechenden technischen Expertise hinzuzuziehen. Bei Fragen kontaktieren Sie uns unter support@azumuta.com.

Integration von Azumuta mit einem ERP-System

Es ist möglich, Azumuta mit einem externen ERP-System zu integrieren. Meistens wird diese Integration zur automatischen Erstellung von Produktaufträgen in Azumuta verwendet – basierend auf Produktauftragsdaten, die vom ERP-System bereitgestellt werden.

Der Vorteil? Ihre Produktaufträge können in Azumuta automatisch und in kürzester Zeit erstellt werden (einschließlich der Parameter, Varianten und aller anderer wichtiger Daten) – ganz ohne manuellen Aufwand.

Die Integration zwischen Azumuta und einem ERP-System erfolgt typischerweise über REST API und umfasst mehrere Schritte. Beachten Sie, dass die Details je nach Ihren Anforderungen und dem eingesetzten ERP-System variieren können.

Hier ein allgemeiner Überblick über den Prozess:

1. Anforderungen verstehen: Identifizieren Sie die spezifischen Daten und Prozesse, die zwischen Azumuta und dem ERP-System integriert werden müssen. Ein einfaches Beispiel ist die automatische Erstellung von Produktaufträgen basierend auf Informationen aus dem ERP-System.
2. Authentifizierung und Autorisierung: Stellen Sie sicher, dass Sie über die notwendigen Zugangsdaten und Berechtigungen zum Zugriff auf die REST-API sowohl von Azumuta als auch des ERP-Systems verfügen. Die Authentifizierung bei Azumuta erfolgt über API-Schlüssel.
3. API-Dokumentation prüfen: Beschaffen und prüfen Sie die API-Dokumentation für sowohl Azumuta als auch das ERP-System. Diese Dokumentation enthält Details zu den verfügbaren Endpunkten, Anfrage-/Antwortformaten und etwaigen Authentifizierungsanforderungen.
4. Daten-Mapping abstimmen: Ordnen Sie die Datenfelder und -strukturen zwischen Azumuta und dem ERP-System zu. Stellen Sie sicher, dass eine gemeinsame Verständnisbasis darüber besteht, wie Daten dargestellt und ausgetauscht werden. Für das einfache Beispiel der Erstellung von Produktaufträgen geht es im Wesentlichen um folgende Fragen: Wie wird die Produktauftragsnummer bestimmt? Auf Grundlage welcher Artikel werden die Produktaufträge erstellt? Welche Parameter oder Varianten werden zusammen mit dem neu erstellten Produktauftrag übermittelt?
5. Entwicklung: Entwickeln Sie die Middleware oder Konnektoren, die die Kommunikation zwischen Azumuta und dem ERP-System erleichtern. Üblicherweise bezeichnen wir diese Komponente als Integrationsschicht, die als „Kleberschicht“ zwischen Azumuta und dem ERP-System fungiert.

Unten sehen Sie eine schematische Darstellung der Erstellung von Produktaufträgen basierend auf Informationen aus dem ERP-System.

Verwendung von Triggern zum Abrufen von Daten aus Azumuta

Es gibt zwei Möglichkeiten, Daten aus Azumuta zu extrahieren. Zum einen können Trigger automatisch ausgeführt werden. Ein Trigger ist ein Ereignis, das infolge eines anderen Ereignisses ausgelöst wird. Zum Beispiel wird ein Webhook aufgerufen, nachdem ein Produktauftrag von einem Bediener abgeschlossen wurde. Wir bevorzugen diese Methode, da nur die notwendigen Daten zum richtigen Zeitpunkt ausgetauscht werden.

Zum anderen ist es möglich, Daten periodisch über unsere REST-API abzurufen. Diese Methode wird dringend nicht empfohlen, da sie unnötig hohe Last auf unseren Systemen erzeugt.

Wir zeigen Ihnen die erste Option, da sie die empfohlene Methode ist. Trigger können für eine Artikelkategorie so konfiguriert werden, dass sie bei Auftreten eines bestimmten Ereignisses ausgeführt werden.

In dem folgenden Beispiel wird ein Webhook aufgerufen, wenn ein mit einer bestimmten Artikelkategorie verknüpfter Produktauftrag abgeschlossen wird.

Damit der Webhook funktioniert, müssen die Azumuta-Server Zugriff auf den konfigurierten Endpunkt haben. Die Produktauftragsnummer und, falls zutreffend, die Arbeitsanweisung sowie die Aufzeichnungs-IDs werden im Webhook als Query-Parameter (bei einer GET-Anfrage) oder als JSON (bei einer POST-Anfrage) übermittelt. Jeder Webhook-Aufruf enthält außerdem einen apiKey eines Workspace Api Device — Sie benötigen mindestens ein konfiguriertes Api Device, damit Webhooks erfolgreich sind.

Für die Schritt-für-Schritt-Konfiguration (Endpunkt, GET/POST und optionales benutzerdefiniertes POST-Payload) siehe Aufrufen eines Webhooks aus einem Trigger. Für die Einrichtung von Api Device / API-Schlüsseln siehe API-Schlüssel erstellen und verwalten.

Hinweis: Ein Webhook ist eine Möglichkeit, wie ein System ein anderes System in Echtzeit über Ereignisse oder Aktualisierungen benachrichtigt. Es ist eine Kommunikationsmethode zwischen zwei Anwendungen, bei der eine Anwendung Daten an einen bestimmten URL-Endpunkt sendet, wenn ein bestimmtes Ereignis eintritt. Webhooks werden häufig verwendet, um unterschiedliche Systeme zu integrieren und Prozesse zu automatisieren.

Um Trigger für die Übertragung von Daten an das ERP-System zu verwenden, muss zunächst eine Integrationsschicht eingerichtet werden. Die Integrationsschicht wird als der vorgesehene Endpunkt für den Webhook-Trigger konfiguriert. Diese Middleware-Komponente ist in der Lage, ausgelöste Ereignisse von Azumuta zu interpretieren. Falls erforderlich, ruft die Integrationsschicht zusätzliche Daten über die REST-API ab, um sicherzustellen, dass die korrekten Informationen für die Übertragung an das ERP-System vorliegen.