Integratie voor eenvoudige invoer

Bijgewerkt

Note: Dit is een technisch artikel met veel details. Daarom raden we aan uw IT‑afdeling bij het lezen te betrekken. Heeft u vragen of verzoeken, neem dan contact met ons op via support@azumuta.com - we helpen u graag.

Wat is Simple Entry Integration?

Een veelvoorkomend gebruiksscenario van Simple Entry Integration is automatische navigatie naar productorders. Een operator kan de barcode van een productorder scannen; het scherm wordt dan automatisch naar die productorder geleid, zodat de operator meteen op het apparaat met die productorder kan 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 bereikt u deze sectie.

  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 workflow mogelijk waarbij het scannen of invoeren van een productorder‑identifier een bestaande productorder opent.

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

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

Na het instellen van een Simple Entry Integration in uw bedrijfsinstellingen, werkt u de apparaatinstellingen bij waar u deze wilt gebruiken. Navigeer naar het tabblad Product orders en bekijk zorgvuldig de hieronder gemarkeerde instellingen:

docs what is simple entry integration 3

Hoe maakt u een aangepaste Simple Entry Integration

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, stuurt het een verzoek naar de URL die is opgegeven in het veld “simpleEntryEndpoint”. Het configuratieveld kan leeg blijven.

docs how to create a custom simple entry integration

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

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

Note: De barcode wordt URL‑gecodeerd

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

Request Example

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 van het verzoek moet application/json zijn.

Response Example

{ identifier: “” }

Hoe maakt u automatisch een productorder aan

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

Dit kan eenvoudig worden bereikt met één oproep naar de Products Create REST API: https://app.azumuta.com/docs/api/products/create

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

  • returnExisting: true — Dit maakt geen nieuw product aan maar retourneert het bestaande product als de productorder al bestaat.

  • activate: true — Activeert de productorder automatisch bij aanmaken. Het activeren van een productorder zorgt dat deze zichtbaar is in de operatorinterface. Deze handeling garandeert dat de bijbehorende werkvoorschriften worden vergrendeld naar hun meest recente goedgekeurde versies.

Op deze pagina
© Azumuta 2026