Intégration d'entrée simple
Note: Ceci est un article très technique. Nous vous recommandons d'impliquer votre service informatique lors de sa lecture. Pour toute question ou demande, contactez-nous via support@azumuta.com - nous serons heureux de vous aider.
Qu'est-ce que Simple Entry Integration?
Un cas d'utilisation courant de Simple Entry Integration 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, afin qu'il puisse commencer immédiatement à exécuter cet ordre sur son appareil.
Pour activer cela, nous avons créé une Simple Entry Integration générique, disponible dans la section « Intégrations » des paramètres de votre entreprise. Voici comment accéder à cette section.
- Cliquez sur « Paramètres » sous « Gestion ».
- Cliquez sur « Intégrations » sous « Intégrations ».
L'URL préremplie /api/integrations/generic/v1/getOrderByBarcode est une implémentation générique du processus de simple entry. Cette configuration permet un flux simple où le scan et la saisie d'un identifiant d'ordre de production ouvrira un ordre de production existant.
Remarque : Cela ne fonctionne que si l'ordre de production existe déjà et que le code scanné correspond exactement à l'identifiant du produit dans Azumuta.
Si vous avez besoin de fonctionnalités plus avancées, comme la création automatique d'un ordre de production qui n'existe pas encore, veuillez vous référer à this section.
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. Accédez à l'onglet Ordres de production, et examinez attentivement les paramètres mis en évidence ci-dessous :
Comment créer une Simple Entry Integration 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 le simple entry, il enverra une requête à l'URL spécifiée dans le champ « simpleEntryEndpoint ». Le champ de configuration peut rester vide.
Après avoir scanné un code-barres sur l'appareil configuré, notre service enverra une requête GET à 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.
Remarque : Le barcode sera URL-encodé
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'Azumuta REST API.
Exemple de requête
Request:
url:
headers: { x-api-key:
Après avoir appliqué votre logique personnalisée, l'intégration doit répondre avec un objet JSON contenant le champ identifier. Le Content-type de la requête doit être application/json.
Exemple de réponse
{ identifier: “
Comment créer automatiquement un ordre de production
Une demande fréquente que nous recevons 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 effectuant un seul appel à 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 à leurs dernières versions approuvées.