Hinweis: Dies ist eine sehr technische Anleitung. Wir empfehlen Ihnen daher, beim Lesen diese Seite gemeinsam mit Ihrer IT-Abteilung durchzugehen. Sollten Sie Fragen oder Wünsche haben, kontaktieren Sie uns bitte untersupport@old-old-wordpress.azumuta.com – wir helfen Ihnen gerne weiter.
Was ist eine einfache Einstiegsintegration? #
Ein häufiger Anwendungsfall für die Integration einfacher Eingaben ist die automatische Navigation zu Produktaufträgen. Ein Bediener kann den Barcode eines Produktauftrags scannen, und sein Bildschirm wird automatisch zu diesem Produktauftrag weitergeleitet, so dass er sofort mit der Bearbeitung dieses Produktauftrags auf seinem Gerät beginnen kann.
Um dies zu ermöglichen, haben wir eine generische Simple Entry Integration erstellt, die im Abschnitt "Integrationen" Ihrer Unternehmenseinstellungen verfügbar ist. Hier erfahren Sie, wie Sie diesen Bereich erreichen.
- Klicken Sie auf "Einstellungen" unter "Verwaltung".
- Klicken Sie auf "Integrationen" unter "Integrationen".
Die vorausgefüllte URL /api/integrations/generic/v1/getOrderByBarcode ist eine generische Implementierung des einfachen Eingabeprozesses. Diese Einrichtung ermöglicht einen unkomplizierten Ablauf, bei dem durch Scannen und Eingeben einer Produktbestellkennung eine bestehende Produktbestellung geöffnet wird.
Hinweis: Dies funktioniert nur, wenn die Produktbestellung bereits existiert und der gescannte Code genau mit dem Produktidentifikator in Azumuta übereinstimmt.
Wenn Sie erweiterte Funktionen benötigen, z. B. die automatische Erstellung einer Produktbestellung, die noch nicht existiert, lesen Sie bitte diesen Abschnitt.
Nachdem Sie eine Simple Entry Integration in den Einstellungen Ihres Unternehmens eingerichtet haben, aktualisieren Sie die Geräteeinstellungen, in denen Sie die Integration verwenden möchten. Navigieren Sie zu die Registerkarte Produktbestellungenund überprüfen Sie die unten hervorgehobenen Einstellungen sorgfältig:
Wie man eine benutzerdefinierte Simple Entry Integration erstellt #
Wenn Sie diesen Prozess mit Ihrer eigenen benutzerdefinierten Geschäftslogik erweitern möchten, können Sie eine benutzerdefinierte Integration erstellen.
Wenn ein Gerät für die Verwendung der einfachen Eingabe konfiguriert ist, sendet es eine Anfrage an die im Feld "simpleEntryEndpoint" angegebene URL. Das Feld "config" kann leer gelassen werden.
Nach dem Scannen eines Barcodes auf dem konfigurierten Gerät sendet unser Dienst eine GET-Anfrage an die im Feld simpleEntryEndpoint angegebene URL.
Die Anfrage enthält einen Abfrageparameter namens barcode, der den gescannten Code oder die Eingabe auf dem Gerät darstellt.
Hinweis: Der Barcode wird URL-codiert
Außerdem enthalten die Header der Anfrage einen x-api-Schlüssel, den Sie zur Authentifizierung bei der Azumuta REST API verwenden können.
Anfrage Beispiel #
Request:
url: <simpleEntryEndpoint>?barcode=<barcode>
headers: { x-api-key: <Azumuta REST API key>
Nach der Verarbeitung Ihrer benutzerdefinierten Logik sollte die Integration mit einem JSON-Objekt antworten, das das Identifizierungsfeld enthält. Der Inhaltstyp der Anfrage sollte application/json sein.
Antwort Beispiel #
{ identifier: “<identifier>” }
Wie man einen Produktauftrag automatisch erstellt #
Eine häufige Anforderung, die wir von Kunden erhalten, ist die Möglichkeit, automatisch eine Produktbestellung für den gescannten Code zu erstellen (wenn die Produktbestellung noch nicht existiert).
Dies lässt sich ganz einfach durch einen einzigen Aufruf der REST-API zum Anlegen von Produkten erreichen : https://app.old-old-wordpress.azumuta.com/docs/api/products/create
Sie können eine POST-Anfrage stellen, um einen Produkt-Endpunkt mit den folgenden Parametern zu erstellen:
- returnExisting: true - Es wird kein neues Produkt erstellt, sondern das vorhandene Produkt zurückgegeben, falls die Produktbestellung bereits existiert.
- activate: true - Aktiviert die Produktbestellung automatisch bei der Erstellung. Durch die Aktivierung eines Produktauftrags wird dieser in der Benutzeroberfläche sichtbar. Durch diese Aktion wird sichergestellt, dass die zugehörigen Arbeitsanweisungen auf ihre zuletzt genehmigten Versionen beschränkt werden.