Eenvoudige invoerintegratie

Opmerking: Deze webpagina is technisch van aard. Daarom raden we u aan uw IT‑afdeling te betrekken bij het doornemen ervan. Als u vragen of verzoeken heeft, neem dan contact met ons op via support@azumuta.com — we helpen u graag.

Wat Is Simple Entry Integration?

Een veelvoorkomend gebruik van Simple Entry Integration is automatische navigatie naar productorders. Een operator kan de barcode van een productorder scannen, waarna zijn of haar scherm automatisch wordt doorgestuurd naar die productorder, zodat men direct op het apparaat aan die productorder kan beginnen te werken.

Om dit mogelijk te maken hebben we een generieke Simple Entry Integration gemaakt, beschikbaar in de sectie 'Integrations' van uw bedrijfsinstellingen. Zo kunt u deze sectie bereiken.

1. Klik op 'Settings' onder 'Management'.
2. Klik op 'Integrations' onder 'Integrations'.

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 waarin het scannen en invoeren van een productorder-identificatie 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 deze gidssectie.

Nadat u een Simple Entry Integration in uw bedrijfsinstellingen hebt ingesteld, werkt u de apparaatinstellingen bij waar u deze wilt gebruiken. Ga naar het tabblad Product orders en bekijk zorgvuldig de hieronder gemarkeerde instellingen:

Hoe u een aangepaste Simple Entry Integration maakt

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

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 leeggelaten worden.

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

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 zullen de request-headers een x-api-key bevatten die u kunt gebruiken om te authenticeren bij de Azumuta REST API.

Voorbeeld van een verzoek

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

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

Voorbeeld van een 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 aanroep naar de Products Create REST API: https://app.azumuta.com/docs/api/products/create

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

• returnExisting: true — Hiermee wordt er geen nieuw product aangemaakt, maar wordt het bestaande product geretourneerd als de productorder al bestaat.

• activate: true — Activeert de productorder automatisch bij aanmaak. Het activeren van een productorder maakt deze zichtbaar in de operatorinterface. Deze actie zorgt ervoor dat de bijbehorende werkinstructies vergrendeld zijn op hun laatst goedgekeurde versies.