Opmerking: Dit is een zeer technische handleiding. Wij raden u daarom aan om bij het lezen hiervan uw IT-afdeling in te schakelen. Mocht u vragen of verzoeken hebben, neem dan contact met ons op viasupport@old-old-wordpress.azumuta.com – wij helpen u graag verder.
Wat is eenvoudige ingangsintegratie? #
Een veelgebruikte toepassing van eenvoudige invoerintegratie is automatische navigatie naar productorders. Een operator kan de barcode van een productorder scannen en zijn scherm wordt automatisch omgeleid naar die productorder, zodat hij meteen op zijn apparaat aan de slag kan met die productorder.
Om dit mogelijk te maken, hebben we een generieke Eenvoudige invoerintegratie gemaakt, die beschikbaar is in het gedeelte "Integraties" van je bedrijfsinstellingen. Zo bereik je deze sectie.
- Klik op "Instellingen" onder "Beheer".
- Klik op "Integraties" onder "Integraties".
De vooraf ingevulde URL /api/integrations/generic/v1/getOrderByBarcode is een generieke implementatie van het eenvoudige invoerproces. Deze opzet maakt een eenvoudige flow mogelijk waarbij het scannen en invoeren van een productorder-ID een bestaande productorder opent.
Opmerking: Dit werkt alleen als de productorder al bestaat en de gescande code exact overeenkomt met de productidentifier in Azumuta.
Als je geavanceerdere functionaliteit nodig hebt, zoals het automatisch aanmaken van een productbestelling die nog niet bestaat, raadpleeg dan deze sectie van de handleiding.
Nadat je een Simple Entry Integration hebt ingesteld in je bedrijfsinstellingen, moet je de apparaatinstellingen bijwerken waar je het wilt gebruiken. Navigeer naar het tabblad Productordersen bekijk de onderstaande instellingen zorgvuldig:
Zo maak je een aangepaste eenvoudige invoerintegratie #
Als je dit proces wilt uitbreiden met je eigen aangepaste bedrijfslogica, kun je een aangepaste integratie maken.
Wanneer een apparaat geconfigureerd is om simple entry te gebruiken, zal het een verzoek sturen naar de URL die gespecificeerd is in het "simpleEntryEndpoint" veld. Het config veld kan leeg gelaten worden.
Na het scannen van een barcode op het geconfigureerde apparaat stuurt onze service een GET-verzoek naar de URL die is opgegeven in het veld simpleEntryEndpoint.
Het verzoek bevat een queryparameter met de naam barcode, die de gescande code of invoer op het apparaat vertegenwoordigt.
Opmerking: De streepjescode is URL-gecodeerd
Daarnaast bevatten de request headers een x-api-key die je kunt gebruiken om je te authenticeren met de Azumuta REST API.
Aanvraag Voorbeeld #
Request:
url: <simpleEntryEndpoint>?barcode=<barcode>
headers: { x-api-key: <Azumuta REST API key>
Na het verwerken van je aangepaste logica moet de integratie reageren met een JSON-object dat het identificatieveld bevat. Het inhoudstype van het verzoek moet application/json zijn.
Antwoord Voorbeeld #
{ identifier: “<identifier>” }
Hoe maak je automatisch een productbestelling #
Een veelgehoorde vraag 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 gerealiseerd door één keer de REST API voor het aanmaken van producten aan te roepen : https://app.old-old-wordpress.azumuta.com/docs/api/products/create
Je kunt een POST-verzoek doen om een producteindpunt te maken met de volgende parameters:
- returnExisting: true - Hiermee wordt geen nieuw product gemaakt, maar wordt het bestaande product geretourneerd als de productbestelling al bestaat.
- activeren: true - Automatisch activeren van de productorder bij het aanmaken. Door een productorder te activeren, wordt deze zichtbaar in de operatorinterface. Deze actie zorgt ervoor dat de bijbehorende werkinstructies worden vergrendeld op hun laatste goedgekeurde versies.