Eenvoudige invoerintegratie

Bijgewerkt

Opmerking: Dit is een technisch artikel. Wij raden u aan uw IT‑afdeling te betrekken bij het lezen hiervan. Als u vragen of verzoeken heeft, neem dan contact op via support@azumuta.com — we helpen u graag.

What Is Simple Entry Integration?

Een veelvoorkomend gebruik van simple entry integration is automatische navigatie naar product orders. Een operator kan de barcode van een product order scannen, waarna het scherm automatisch wordt doorgestuurd naar die product order, zodat hij of zij direct op het apparaat aan die order kan beginnen.

docs new feature simple entry integrations

Om dit mogelijk te maken, hebben we een generieke Simple Entry Integration gemaakt, beschikbaar in de Integrations-sectie van uw company settings. 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 setup maakt een eenvoudige flow mogelijk waarbij het scannen en invoeren van een product order‑identificator een bestaande product order opent.

Opmerking: dit werkt alleen als de product order al bestaat en de gescande code exact overeenkomt met de productidentifier in Azumuta.

Als u meer geavanceerde functionaliteit nodig heeft, zoals het automatisch aanmaken van een product order die nog niet bestaat, raadpleeg dan dit gedeelte.

Nadat u een Simple Entry Integration in uw company settings hebt ingesteld, werkt u de apparaatinstellingen bij op het apparaat waar u het wilt gebruiken. Navigeer naar the Product orders tab en controleer zorgvuldig de hieronder gemarkeerde instellingen:

docs what is simple entry integration 3

Create a custom simple entry integration

Als u dit proces wilt uitbreiden met uw eigen bedrijfslogica, kunt u een custom integration aanmaken.

Wanneer een apparaat is geconfigureerd om simple entry te gebruiken, stuurt het een verzoek naar de URL die is opgegeven in het simpleEntryEndpoint-veld. Het config‑veld kan leeg worden gelaten.

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 is opgegeven in het simpleEntryEndpoint‑veld.

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

Opmerking: de barcode wordt URL‑encoded

Authentication

De Authentication‑instelling op de integration bepaalt hoe Azumuta zichzelf identificeert bij uw endpoint. De opties zijn hetzelfde als bij een procedure check webhook.

  • Legacy (API key of the calling device) — de standaard voor integrations die zijn aangemaakt voordat deze instelling bestond. Azumuta stuurt de API‑key van het apparaat dat de barcode scan in een x-api-key header. Die sleutel authenticieert het apparaat tegen de Azumuta REST API, zodat uw endpoint daarmee terug kan bellen naar Azumuta, maar hij authenticieert Azumuta niet naar u. Gebruik voor een nieuwe integration bij voorkeur een van de onderstaande opties.
  • None — er wordt geen credential meegestuurd.
  • Header — een header naar keuze, met daarin ofwel een door u ingevoerde waarde of de API‑key van een API device die u selecteert. De standaard headernaam is X-API-Key.
  • Basic — een gebruikersnaam en wachtwoord, verzonden als een Authorization: Basic header.
  • OAuth client credentials — Azumuta vraagt een token op bij uw token URL met een client ID en client secret, en stuurt dat vervolgens als een Authorization: Bearer header. De token URL moet https gebruiken.

Het kiezen van iets anders dan Legacy vervangt de x-api-key header in plaats van deze toe te voegen. Het scannende apparaat wordt nog steeds geïdentificeerd via de queryparameters deviceId en deviceName.

Gevoelige gegevens die u invoert (een headerwaarde, een wachtwoord, een client secret) worden versleuteld opgeslagen en nooit teruggestuurd naar de browser. Wanneer u de integration opnieuw opent, staat het veld leeg; laat het leeg om het opgeslagen geheim te behouden. Het wijzigen van de endpoint‑URL (of, bij OAuth, de token URL) wist het opgeslagen geheim, zodat u het opnieuw moet invoeren.

Request Example

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

De bovenstaande header is de Legacy‑standaard. Bij een andere Authentication‑optie wordt de door u geconfigureerde credential in plaats daarvan meegestuurd.

Na verwerking van uw custom logic, moet de integration reageren met een JSON‑object dat het identifier‑veld bevat. Content‑type van het verzoek moet application/json zijn.

Response Example

{ identifier: “” }

Create a product order automatically

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

Dit kan eenvoudig worden bereikt met één aanroep naar de Products Create REST API. Open Help (het vraagteken rechtsboven) → API docs, en open vervolgens het Products Create endpoint. Authenticateer met een API‑key van een Api Device. Meer over het openen van de docs: Azumuta’s REST API.

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

  • returnExisting: true — hiermee wordt er geen nieuw product gemaakt, maar wordt het bestaande product geretourneerd voor het geval de product order al bestaat.

  • activate: true — activeer de product order automatisch bij aanmaak. Het activeren van een product order zorgt dat deze zichtbaar is in de operator interface. Deze actie zorgt er ook voor dat de bijbehorende werkvoorschriften worden vergrendeld op hun laatste goedgekeurde versies.

Op deze pagina
© Azumuta 2026