Integration für einfache Eingaben

Hinweis: Dies ist eine hoch technische Anleitung. Daher empfehlen wir, Ihre IT-Abteilung hinzuzuziehen. Sollten Sie Fragen oder Anliegen haben, kontaktieren Sie uns bitte über support@azumuta.com – wir helfen Ihnen gerne weiter.

Was ist Simple Entry Integration?

Ein gängiger Anwendungsfall der Simple Entry Integration ist die automatische Navigation zu Produktaufträgen. Ein Operator kann den Barcode eines Produktauftrags scannen, und sein Bildschirm wird automatisch zu diesem Produktauftrag weitergeleitet, sodass er sofort mit der Arbeit an diesem Gerät beginnen kann.

Um dies zu ermöglichen, haben wir eine generische Simple Entry Integration erstellt, die im Bereich „Integrationen“ Ihrer Unternehmenseinstellungen verfügbar ist. So gelangen Sie zu diesem Bereich.

1. Klicken Sie auf „Einstellungen“ unter „Verwaltung“.
2. Klicken Sie auf „Integrationen“ unter „Integrationen“.

Die vorausgefüllte URL /api/integrations/generic/v1/getOrderByBarcode ist eine generische Implementierung des Simple Entry‑Prozesses. Diese Einrichtung ermöglicht einen einfachen Ablauf, bei dem das Scannen bzw. Eingeben eines Produktauftrags‑Identifiers einen bestehenden Produktauftrag öffnet.

Hinweis: Dies funktioniert nur, wenn der Produktauftrag bereits existiert und der gescannte Code genau mit der Produktkennung in Azumuta übereinstimmt.

Wenn Sie erweiterte Funktionen benötigen, z. B. das automatische Erstellen eines Produktauftrags, der noch nicht existiert, lesen Sie bitte diesen Abschnitt des Leitfadens.

Nachdem Sie eine Simple Entry Integration in den Unternehmenseinstellungen eingerichtet haben, aktualisieren Sie die Geräteeinstellungen, auf denen Sie sie verwenden möchten. Navigieren Sie zur Registerkarte „Produktaufträge“ und prüfen Sie sorgfältig die unten hervorgehobenen Einstellungen:

Wie Sie eine benutzerdefinierte Simple Entry Integration erstellen

Wenn Sie diesen Prozess mit Ihrer eigenen Geschäftslogik erweitern möchten, können Sie eine benutzerdefinierte Integration erstellen.

Wenn ein Gerät so konfiguriert ist, dass es Simple Entry verwendet, sendet es eine Anfrage an die in dem Feld „simpleEntryEndpoint“ angegebene URL. Das Konfigurationsfeld kann leer gelassen werden.

Nach dem Scannen eines Barcodes auf dem konfigurierten Gerät sendet unser Service eine GET-Anfrage an die in dem Feld simpleEntryEndpoint angegebene URL.

Die Anfrage enthält einen Query-Parameter namens barcode, der den gescannten Code bzw. die Eingabe auf dem Gerät repräsentiert.

Hinweis: Der Barcode wird URL-codiert

Zusätzlich enthalten die Request-Header einen x-api-key, den Sie zur Authentifizierung bei der Azumuta REST API verwenden können.

Anfragebeispiel

Anfrage:
url: ?barcode=
headers: { x-api-key:

Nach der Verarbeitung Ihrer benutzerdefinierten Logik sollte die Integration mit einem JSON‑Objekt antworten, das das Feld identifier enthält. Der Content-Type der Antwort sollte application/json sein.

Beispielantwort

{ identifier: “” }

Wie Sie einen Produktauftrag automatisch erstellen

Eine häufig an uns herangetragene Anforderung ist die Möglichkeit, für den gescannten Code automatisch einen Produktauftrag zu erstellen (falls dieser noch nicht existiert).

Dies lässt sich leicht mit einem einzigen Aufruf der Products Create REST API: https://app.azumuta.com/docs/api/products/create

Sie können eine POST-Anfrage an den Create‑Product‑Endpunkt stellen und dabei die folgenden Parameter verwenden:

• returnExisting: true — Dadurch wird kein neues Produkt erstellt; es wird stattdessen das vorhandene Produkt zurückgegeben, falls der Produktauftrag bereits existiert.

• activate: true — Aktiviert den Produktauftrag bei der Erstellung automatisch. Durch die Aktivierung wird der Produktauftrag in der Bedienoberfläche sichtbar. Diese Aktion stellt sicher, dass die zugehörigen Arbeitsanweisungen auf ihre zuletzt freigegebenen Versionen gesperrt werden.