Intégration Simple Entry

Note : Il s'agit d'une page-guide très technique. Nous vous recommandons donc d'impliquer votre service informatique lors de sa lecture. Si vous avez des questions ou des demandes, veuillez nous contacter via support@azumuta.com — nous nous ferons un plaisir de vous aider.

Qu'est-ce que l'intégration Simple Entry ?

Un cas d'utilisation courant de l'intégration Simple Entry est la navigation automatique vers des ordres de production. Un opérateur peut scanner le code-barres d'un ordre de production, et son écran sera automatiquement redirigé vers cet ordre de production, afin qu'il puisse immédiatement commencer à travailler dessus depuis son appareil.

Pour activer cela, nous avons créé une Simple Entry Integration générique, disponible dans la section “Integrations” des paramètres de votre entreprise. Voici comment accéder à cette section.

1. Cliquez sur “Settings” sous “Management”.
2. Cliquez sur “Integrations” sous “Integrations”.

L'URL préremplie /api/integrations/generic/v1/getOrderByBarcode est une implémentation générique du processus Simple Entry. Cette configuration permet un flux simple où le scan ou la saisie d'un identifiant d'ordre de production ouvrira un ordre de production existant.

Note : Cela ne fonctionne que si l'ordre de production existe déjà et que le code scanné correspond exactement à l'identifiant de produit dans Azumuta.

Si vous avez besoin d'une fonctionnalité plus avancée, comme la création automatique d'un ordre de production qui n'existe pas encore, veuillez vous référer à cette section du guide.

Après avoir configuré une Simple Entry Integration dans les paramètres de votre entreprise, mettez à jour les paramètres de l'appareil où vous souhaitez l'utiliser. Rendez-vous dans l'onglet Ordres de production, et vérifiez attentivement les paramètres mis en surbrillance ci-dessous :

Comment créer une intégration Simple Entry personnalisée

Si vous souhaitez étendre ce processus avec votre propre logique métier, vous pouvez créer une intégration personnalisée.

Lorsqu'un appareil est configuré pour utiliser Simple Entry, il enverra une requête à l'URL spécifiée dans le champ “simpleEntryEndpoint”. Ce champ de configuration peut rester vide.

Après le scan d'un code-barres sur l'appareil configuré, notre service enverra une requête GET vers l'URL fournie dans le champ simpleEntryEndpoint.

La requête inclura un paramètre de requête nommé barcode, qui représente le code scanné ou la saisie sur l'appareil.

Note : Le barcode sera encodé dans l'URL

De plus, les en-têtes de la requête contiendront un x-api-key que vous pouvez utiliser pour vous authentifier auprès de l'API REST d'Azumuta.

Exemple de requête

Requête :
url: ?barcode=
en-têtes: { x-api-key:

Après avoir traité votre logique personnalisée, l'intégration doit répondre avec un objet JSON contenant le champ identifier. Le Content-Type de la réponse doit être application/json.

Exemple de réponse

{ identifier: “” }

Comment créer automatiquement un ordre de production

Une demande fréquente de la part de nos clients est la possibilité de créer automatiquement un ordre de production pour le code scanné (si l'ordre de production n'existe pas encore).

Ceci peut être réalisé facilement en utilisant un appel unique à la Products Create REST API : https://app.azumuta.com/docs/api/products/create

Vous pouvez effectuer une requête POST vers l'endpoint de création de produit en utilisant les paramètres suivants :

• returnExisting : true — Cela ne créera pas un nouveau produit mais renverra le produit existant si l'ordre de production existe déjà.

• activate : true — Active automatiquement l'ordre de production lors de sa création. L'activation d'un ordre de production le rend visible dans l'interface opérateur. Cette action garantit que les instructions de travail associées sont verrouillées sur leurs dernières versions approuvées.