Remarque : Ceci est un article hautement technique. Par conséquent, nous vous recommandons de faire participer votre département informatique à la lecture de cet article. Si vous avez des questions ou des demandes, veuillez nous contacter à l'adresse support@azumuta.com - nous serions heureux de vous aider.
Qu'est-ce que l'intégration Simple Entry ?
Un cas d'usage courant de l'intégration simple entry est la Navigation automatique vers les commandes de produits. Un Opérateur peut scanner le code-barres d'une Commande de produit, et son Écran sera automatiquement redirigé vers cette Commande de produit, afin qu'il puisse immédiatement commencer à travailler sur cette Commande de produit sur son Appareil.
Pour Activer cela, nous avons créé une intégration Simple Entry générique, Disponible dans la section « Intégrations » de vos Paramètres d'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 simple entry. Cette configuration permet un flux simple où scanner et entrer un identifiant de Commande de produit ouvrira une Commande de produit existante.
Remarque : Cela ne fonctionne que si la Commande de produit existe déjà et si le code scanné correspond exactement à l'Identifiant du Produit dans Azumuta.
Si vous avez besoin de fonctionnalités plus avancées, telles que la création automatique d'une Commande de produit qui n'existe pas encore, veuillez consulter cette section.
Après avoir configuré une intégration Simple Entry dans vos Paramètres d'entreprise, mettez à jour les Paramètres de l'Appareil où vous souhaitez l'utiliser. Accédez à l'onglet commandes de produits, et examinez attentivement les Paramètres mis en évidence ci-dessous :
Comment créer une intégration Simple Entry personnalisée
Si vous souhaitez étendre ce processus avec votre propre logique métier personnalisée, vous pouvez Créer une intégration personnalisée.
Lorsqu'un Appareil est configuré pour utiliser simple entry, il enverra une Demande à l'URL spécifiée dans le champ « simpleEntryEndpoint ». Le champ de configuration peut être laissé vide.
Après avoir scanné un code-barres sur l'Appareil configuré, notre service enverra une Demande GET à l'URL fournie dans le champ simpleEntryEndpoint.
La Demande inclura un Paramètre de requête nommé barcode, qui représente le code scanné ou l'entrée sur l'Appareil.
Remarque : Le code-barres sera codé en URL
De plus, les en-têtes de Demande contiendront une x-api-key que vous pouvez utiliser pour vous authentifier auprès de l'API REST Azumuta.
Exemple de Demande
Demande :
url: <simpleEntryEndpoint>?barcode=<barcode>
headers: { x-api-key: <Azumuta REST API key>
Après avoir traité votre logique personnalisée, l'intégration doit répondre avec un objet JSON contenant le champ Identifiant. Le Content-type de la Demande doit être application/json.
Exemple de Réponse
{ identifier: "<identifier>" }
Comment créer une Commande de produit automatiquement
Une Fonctionnalité couramment demandée que nous recevons souvent de nos clients est la capacité à créer automatiquement une Commande de produit pour le code scanné (si la Commande de produit n'existe pas encore).
Ceci peut être facilement réalisé en utilisant un seul appel à l'API REST Créer un Produit. Ouvrez Aide (le point d'interrogation dans le coin supérieur droit) → Docs API, puis Ouvrez le Point de terminaison Créer un Produit. Authentifiez-vous avec une Clé API d'un Api Device. Plus d'informations sur l'accès aux docs : API REST Azumuta.
Vous pouvez faire une Demande POST au Point de terminaison de création de Produit en utilisant les Paramètres suivants :
-
returnExisting: true — Cela ne créera pas un nouveau Produit mais retournera le Produit existant au cas où la Commande de produit existe déjà.
-
activate: true — Activer automatiquement la Commande de produit lors de sa création. L'activation d'une Commande de produit la rend visible dans l'Interface opérateur. Cette Action garantit que les instructions de travail associées sont verrouillées à leurs Versions approuvées les plus récentes.