Eenvoudige invoerintegratie

Bijgewerkt

Opmerking: Dit is een technisch zeer diepgaand artikel. We raden u daarom aan uw IT‑afdeling te betrekken bij het lezen. Als u vragen of verzoeken heeft, neem dan contact met ons op via support@azumuta.com — wij helpen u graag.

Wat is Simple Entry Integration?

Een veelvoorkomend gebruik van Simple Entry Integration is automatische navigatie naar productorders. U kunt de streepjescode van een productorder scannen; het scherm wordt vervolgens automatisch naar die productorder geleid, zodat u direct op uw apparaat met die order kunt beginnen.

docs new feature simple entry integrations

Om dit mogelijk te maken hebben we een generieke Simple Entry Integration gemaakt, beschikbaar in de sectie “Integrations” van uw bedrijfsinstellingen. Zo navigeert u daarheen.

  1. Klik op “Settings” onder “Management”.
  2. Klik op “Integrations” onder “Integrations”.

docs what is simple entry integration 2

De vooraf ingevulde URL /api/integrations/generic/v1/getOrderByBarcode is een generieke implementatie van het simple entry-proces. Deze configuratie maakt een eenvoudige flow mogelijk waarbij het scannen en invoeren van een productorder-identifier een bestaande productorder opent.

Opmerking: Dit werkt alleen als de productorder al bestaat en de gescande code exact overeenkomt met de productidentificatie in Azumuta.

Als u geavanceerdere functionaliteit nodig heeft, zoals het automatisch aanmaken van een productorder die nog niet bestaat, raadpleeg dan this section.

Nadat u een Simple Entry Integration in uw bedrijfsinstellingen hebt ingesteld, werkt u de apparaatinstellingen bij waar u deze wilt gebruiken. Navigeer naar the Product orders tab, en controleer zorgvuldig de hieronder gemarkeerde instellingen:

docs what is simple entry integration 3

Hoe u een aangepaste Simple Entry Integration maakt

Als u dit proces wilt uitbreiden met uw eigen bedrijfslogica, kunt u een aangepaste integratie maken.

Wanneer een apparaat is geconfigureerd om simple entry te gebruiken, zal het een verzoek sturen naar de URL die is opgegeven in het veld “simpleEntryEndpoint”. Het configuratieveld kan leeg worden gelaten.

docs how to create a custom simple entry integration

Na het scannen van een streepjescode op het geconfigureerde apparaat zal onze service een GET-verzoek sturen naar de URL die in het simpleEntryEndpoint-veld is opgegeven.

Het verzoek bevat een queryparameter met de naam barcode, die de gescande code of invoer op het apparaat vertegenwoordigt.

Opmerking: De barcode wordt URL-gecodeerd

Daarnaast bevatten de requestheaders een x-api-key die u kunt gebruiken om te authenticeren bij de Azumuta REST API.

Voorbeeld verzoek

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

Na verwerking van uw aangepaste logica moet de integratie reageren met een JSON-object dat het veld identifier bevat. Content-type op het verzoek moet application/json zijn.

Voorbeeld response

{ identifier: “” }

Hoe u automatisch een productorder aanmaakt

Een veelgevraagd verzoek van klanten is de mogelijkheid om automatisch een productorder aan te maken voor de gescande code (als de productorder nog niet bestaat).

Dit kan eenvoudig worden bereikt met een enkele oproep naar de Products Create REST API. Open Help (het vraagteken rechtsboven) → API docs, en open vervolgens de Products Create-endpoint. Authenticeer met een API-sleutel van een Api Device. Meer over het openen van de documentatie: Azumuta’s REST API.

U kunt een POST-verzoek doen naar het create product-endpoint met de volgende parameters:

  • returnExisting: true — Dit creëert geen nieuw product maar retourneert het bestaande product als de productorder al bestaat.

  • activate: true — Activeert de productorder automatisch bij aanmaak. Het activeren van een productorder maakt deze zichtbaar in de operatorinterface. Hierdoor worden de bijbehorende werkinstructies vergrendeld op hun laatst goedgekeurde versies.

Op deze pagina
© Azumuta 2026