Simpel Startpunt Integratie – Azumuta

Opmerking: Dit artikel is technisch, dus we raden aan iemand met de juiste technische expertise in te schakelen. Als u vragen heeft, ons te contacteren.

Wat Is Simpel Startpunt Integratie?

Een veelvoorkomend gebruiksscenario van simpel startpunt integratie is automatische navigatie naar productorders. Een operator kan een barcode van een productorder scannen, en het scherm wordt automatisch omgeleid naar die productorder, zodat deze onmiddellijk aan die productorder op het apparaat kan beginnen te werken.

Om dit in te schakelen, hebben we een generieke Simpel Startpunt Integratie gemaakt, beschikbaar in de sectie Integraties van uw bedrijfsinstellingen. Om deze sectie te bereiken.

Klik op Instellingen onder Management.
Klik op Integraties onder Integraties.

De voorgevulde URL /api/integrations/generic/v1/getOrderByBarcode is een generieke implementatie van het simpel startpunt proces. Deze setup 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 product-identifier in Azumuta.

Als u meer geavanceerde functionaliteit nodig heeft, zoals het automatisch creëren van een productorder die nog niet bestond, raadpleeg dan deze sectie.

Nadat u een Simpel Startpunt Integratie in uw bedrijfsinstellingen hebt ingesteld, werkt u de apparaatinstellingen bij waar u deze wilt gebruiken. Navigeer naar het tabblad Productorders, en controleer zorgvuldig de instellingen die hieronder zijn gemarkeerd:

Creëer een op maat gemaakte simpel startpunt integratie

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

Wanneer een apparaat is geconfigureerd om simpel startpunt te gebruiken, stuurt het een verzoek naar de URL die is opgegeven in het veld simpleEntryEndpoint. Het configuratieveld kan leeg worden gelaten.

Nadat u een barcode op het geconfigureerde apparaat hebt gescand, 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 barcode wordt URL-gecodeerd

Authenticatie

De instelling Authenticatie op de integratie bepaalt hoe Azumuta zich identificeert bij uw endpoint. Het biedt dezelfde opties als een procedure check webhook.

Legacy (API-sleutel van het aanroepende apparaat) - de standaard voor integraties die zijn aangemaakt voordat deze instelling bestond. Azumuta stuurt de API-sleutel van het apparaat dat de barcode heeft gescand in een x-api-key header. Die sleutel verifieert het apparaat tegen de Azumuta REST API, dus uw endpoint kan ermee terugbellen naar Azumuta, maar het verifieert Azumuta niet voor u. Geef de voorkeur aan een van de onderstaande opties voor een nieuwe integratie.
Geen - geen referentie wordt verzonden.
Header - een header naar keuze, met een waarde die u invoert of de API-sleutel van een API-apparaat die u selecteert. De headernaam is standaard X-API-Key.
Basic - een gebruikersnaam en wachtwoord, verzonden als een Authorization: Basic header.
OAuth-clientgegevens - Azumuta vraagt een token aan van uw token-URL met een client-ID en clientgeheim, en stuurt het vervolgens als een Authorization: Bearer header. De token-URL moet https gebruiken.

Als u iets anders dan Legacy kiest, vervangt dit de x-api-key header in plaats van deze toe te voegen. Het scanapparaat wordt nog steeds geïdentificeerd via de queryparameters deviceId en deviceName.

Geheimen die u invoert (een headerwaarde, een wachtwoord, een clientgeheim) worden versleuteld voordat ze worden opgeslagen en worden nooit naar de browser verzonden. Wanneer u de integratie opnieuw opent, is het veld leeg; laat het leeg om het opgeslagen geheim te behouden. Het wijzigen van de endpoint-URL (of voor OAuth de token-URL) wist het opgeslagen geheim, dus u moet het opnieuw invoeren.

Verzoekvoorbeeld

Verzoek: url: ?barcode=&deviceId=&deviceName= headers: { x-api-key: }

De header hierboven is de Legacy standaard. Met elke andere Authenticatieoptie wordt de referentie die u hebt geconfigureerd in plaats daarvan verzonden.

Nadat u uw aangepaste logica hebt verwerkt, moet de integratie reageren met een JSON-object dat het veld identifier bevat. Content-type op het verzoek moet application/json zijn.

Antwoordvoorbeeld

{ identifier: "" }

Creëer automatisch een productorder

Een veelgebruikte feature request die we vaak van klanten ontvangen, is de mogelijkheid om automatisch een productorder voor de gescande code te creëren (als de productorder nog niet bestond).

Dit kan eenvoudig worden bereikt met behulp van een enkele aanroep naar de Creëer product REST API. Open Help (het vraagteken in de rechterbovenhoek) → API documentatie, open vervolgens het Creëer product endpoint. Verifieer met een API-sleutel van een Api-apparaat. Meer over het openen van de documentatie: Azumuta's REST API.

U kunt een POST-verzoek indienen bij het creëer product endpoint met behulp van de volgende parameters:

returnExisting: true — Dit zal geen nieuw product creëren, maar zal het bestaande product retourneren in het geval dat de productorder al bestaat.
activate: true — Activeer de productorder automatisch bij creatie. Het activeren van een productorder maakt deze zichtbaar in de Operator interface. Deze actie zorgt ervoor dat de bijbehorende werkinstructies zijn vergrendeld op hun nieuwste goedgekeurde versies.