ERP und andere Systeme anbinden

Ihr ERP kennt Ihre Ernten, Wareneingänge und Lieferungen bereits. Wenn Sie es anbinden, muss niemand sie doppelt eintippen. Alles liegt unter Einstellungen › Integrationen, in fünf Reitern: Webhooks, Eingehend, Maschinen-Clients, IP-Adressen und Nachweisidentität (die Identität, mit der Ihre Produktpässe signiert werden, siehe Nachweisidentität). Eigentümer und Administratoren richten die Verbindungen von Produktionsunternehmen ein. In einer Sandbox können auch Operatoren sie einrichten.

Was aus einem anderen System kommt, handelt nie von selbst: Es wird zu einem Ereignis, einem Entwurf oder einer Genehmigung, und eine Person muss genehmigen.

Den richtigen Weg wählen

Nachrichten von Ihrem ERP empfangen

1. Unter Eingehend wählen Sie Eingehenden Endpunkt hinzufügen.
2. Absender: Geben Sie einen Namen ein (zum Beispiel „ERP Wareneingänge“) und wählen Sie Wie der Absender signiert.
3. Zugriff und Limits: Beschränken Sie optional die Adressen unter Erlaubte Absenderadressen und legen Sie Nachrichtengröße und Rate fest.
4. Beispielnachricht: Fügen Sie eine typische Nachricht ein. Ihre Felder werden zum erwarteten Format.
5. Wählen Sie Erstellen und bestätigen Sie mit dem Code aus Ihrer Authenticator-App. Kopieren Sie die Adresse und das Secret in Ihr ERP: Das Secret wird nur einmal angezeigt.

Nachrichten, die nicht zu den erwarteten Feldern passen, erhalten den Status In Quarantäne. Öffnen Sie eine davon und wählen Sie nach der Korrektur der Felder Erneut prüfen, oder Verwerfen.

Ereignisse an Ihr ERP senden (Webhooks)

1. Unter Webhooks wählen Sie Endpunkt hinzufügen.
2. Ziel: ein Name, die https-URL Ihres Systems und das Format (CloudEvents (empfohlen) oder Einfaches JSON). Haken Sie Automatisierungen dürfen an diesen Endpunkt senden an, wenn Schritte von Automatisierungen an ihn senden sollen.
3. Ereignisse: Mit einer Vorlage beginnen (Alles zu Partien, Genehmigungen, Berichte, Änderungen im Verzeichnis, Nur Probleme, Partienregeln und Erweiterungen) oder Ereignisse nach Gruppe wählen. Zum Beispiel melden Lieferung wartet und Lieferung fehlgeschlagen Ihrem ERP, wenn eine genehmigte Lieferung aufgehalten wird oder nicht erfolgen kann.
4. Prüfen, dann Erstellen. Kopieren Sie das Signatur-Secret. A-REX sendet eine Bestätigungsanfrage, und der Endpunkt wird Aktiv, sobald Ihr System sie beantwortet.

Ein Endpunkt erhält die Ereignisse seines eigenen Unternehmens: echte Ereignisse in einem Produktionsunternehmen, Übungsereignisse in einer Sandbox. Nachrichten enthalten Kennungen und Links, keine Namen. Jeder Endpunkt listet seine Zustellungen mit jedem Versuch. Fehlgeschlagene werden wiederholt, und Fehlende wiederherstellen / erneut senden sendet erneut, was Ihr System verpasst hat. Erlauben Sie die Adressen unter IP-Adressen in Ihrer Firewall.

Prüfen, dass eine Nachricht von A-REX kommt

Jede Webhook-Nachricht ist mit dem Secret des Endpunkts signiert, das mit whsec_ beginnt. Ihr System muss diese Signatur prüfen, bevor es einer Nachricht vertraut. Öffnen Sie den Endpunkt unter Webhooks: Das Fenster Signaturen prüfen bietet fertigen Code in TypeScript, Python, Java und C#, den Ihr IT-Team übernehmen kann. Während Secret rotieren sind das bisherige und das neue Secret für die von Ihnen gewählte Überschneidung gültig; geben Sie also beide an die Prüfung weiter.

Maschinen-Clients

Unter Maschinen-Clients wählen Sie Client erstellen, legen den Zugriff fest (Lesen, Vorschlagen) und die Anmeldemethode: Privater Schlüssel (empfohlen) oder Client-Secret. Kein Zugriff kann genehmigen: Was ein System vorschlägt, wartet auf eine Person. Client-Secrets und API-Schlüssel zeigen, zu welcher Art von Unternehmen sie gehören: Sie beginnen mit arex_cs_prod_ oder arex_cs_sandbox_ und arex_sk_prod_ oder arex_sk_sandbox_. So wird ein Übungsschlüssel nie mit einem Produktionsschlüssel verwechselt. Ältere Schlüssel funktionieren weiter.

API- und Ereignisbeschreibungen

Für Ihr IT-Team beschreibt A-REX seine API in OpenAPI 3.1 und jedes Webhook-Ereignis in AsyncAPI 3.0. Beide werden aus der Plattform selbst erzeugt und entsprechen daher dem, was sie annimmt und sendet. Ihre Entwickler können die aktuellen Dateien über Support anfordern und sich dann mit einem Maschinen-Client verbinden.

Ihre eigenen Kennungen

Partner, Standorte und Produkte können die eigene Kennung Ihres Unternehmens tragen, also den Code aus Ihrem ERP. Ihre Integration kann dann einen Erzeuger, Betrieb oder ein Produkt über Ihren Code finden, und Nachrichten können ihn enthalten. So muss Ihr ERP nie die Kennungen von A-REX lernen.

Dateiimport

Der Dateiimport (CSV) für Ernteeingänge, Lieferungen, Laborergebnisse und Verzeichniseinträge kommt gerade zu den Integrationen hinzu. Er prüft zuerst jede Zeile und listet die Fehler auf. Danach erstellt er offene Genehmigungen, nie direkte Änderungen.

In einer Sandbox üben

Probieren Sie alles aus, bevor Ihr Produktionsunternehmen es nutzt:

• Erstellen Sie aus Ihrer Organisation eine Sandbox: Neues Unternehmen › Eine Sandbox. Sie ist ein Übungsunternehmen mit fiktiven Daten, und ihre Endpunkte erhalten ihre eigenen Ereignisse: Genehmigen Sie eine Übungsernte und sehen Sie, wie die echte Nachricht ankommt. Operatoren können dort Endpunkte hinzufügen. In einem Produktionsunternehmen brauchen Endpunkte einen Eigentümer oder Administrator und dessen zweiten Faktor.
• Wählen Sie an einem Endpunkt Beispielereignis senden, um ein signiertes, als Beispiel markiertes Ereignis zu senden und die genaue Anfrage und Antwort zu sehen.
• Der Testlauf einer Automatisierung simuliert ihre Nachrichten nur: Nichts erreicht Ihre Live-Systeme. Siehe Automatisierungen.