Opmerking: Dit is een zeer technisch artikel. Daarom raden we aan uw IT-afdeling erbij te betrekken bij het lezen hiervan. Mocht u vragen of verzoeken hebben, neem dan contact met ons op via support@azumuta.com - we helpen u graag.
Wat Is Simpel Entry Integration?
Een veelvoorkomend gebruik van simpel entry integration is automatische navigatie naar productorders. Een Operator kan de barcode van een productorder scannen, en hun Scherm wordt automatisch omgeleid naar die productorder, zodat zij onmiddellijk kunnen beginnen met werken aan die productorder op hun Device.
Om dit in te schakelen, hebben we een generieke Simpel Entry Integration gemaakt, beschikbaar in de sectie "Integraties" van uw bedrijfsinstellingen. Hier leest u hoe u deze sectie bereikt.
- Klik op "Instellingen" onder "Management".
- Klik op "Integraties" onder "Integraties".
De vooringevulde URL /api/integrations/generic/v1/getOrderByBarcode is een generieke implementatie van het simpel entry-proces. Deze setup maakt een eenvoudige flow mogelijk waarbij scannen en invoeren van een productorder-identifier een bestaande productorder opent.
Opmerking: Dit werkt enkel als de productorder al bestaat en de gescande code exact overeenkomt met de product-identifier in Azumuta.
Als u meer geavanceerde functionaliteit nodig hebt, zoals het automatisch creëren van een productorder die nog niet bestaat, raadpleeg dan deze sectie.
Na het instellen van een Simpel Entry Integration in uw bedrijfsinstellingen, werkt u de Device-instellingen bij waar u deze wilt gebruiken. Navigeer naar het tabblad Productorders, en controleer zorgvuldig de instellingen die hieronder zijn gemarkeerd:
How to Creëren van een Op maat Simpel Entry Integration
Als u dit proces wilt uitbreiden met uw eigen aangepaste bedrijfslogica, kunt u een aangepaste integratie creëren.
Wanneer een Device is geconfigureerd om simpel entry te gebruiken, stuurt het een verzoek naar de URL die is opgegeven in het veld "simpleEntryEndpoint". Het config-veld kan leeg worden gelaten.
Na het scannen van een barcode op het geconfigureerde Device, stuurt onze service een GET-verzoek naar de URL die is opgegeven in het simpleEntryEndpoint-veld.
Het verzoek bevat een query-parameter met de naam barcode, die de gescande code of invoer op het Device vertegenwoordigt.
Opmerking: De barcode wordt URL-gecodeerd
Bovendien bevatten de verzoekheaders een x-api-key die u kunt gebruiken om te verifiëren met de Azumuta REST API.
Voorbeeld Verzoek
Verzoek:
url: ?barcode=
headers: { x-api-key:
Na het verwerken van uw aangepaste logica, moet de integratie reageren met een JSON-object dat het Identifier-veld bevat. Content-type op het verzoek moet application/json zijn.
Voorbeeld Antwoord
{ identifier: "" }
How to Automatisch Creëren van een Productorder
Een veelgevraagde feature die we regelmatig van klanten ontvangen, 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 Producten Creëren REST API: https://app.azumuta.com/docs/api/products/create
U kunt een POST-verzoek indienen om een product-endpoint aan te maken met behulp van de volgende Parameters:
-
returnExisting: true — Dit zal geen nieuw product creëren, maar zal het bestaande product terugkeren in het geval dat de productorder al bestaat.
-
activate: true — Activeer de productorder automatisch bij aanmaak. Het activeren van een productorder maakt deze zichtbaar in de Operator interface. Deze Actie zorgt ervoor dat de bijbehorende werkinstructies zijn vergrendeld op hun Goedgekeurde versies.