Intégration Simple Entry – Azumuta

Remarque : Cet Article est technique, nous vous recommandons donc de faire intervenir quelqu'un possédant l'expertise technique appropriée. Si vous avez des questions, contactez-nous à support@azumuta.com.

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. Pour 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 que le code scanné correspond exactement à l'identifiant du Produit dans Azumuta.

Si vous avez besoin de fonctionnalités plus avancées, comme créer automatiquement une Commande de produit qui n'existait 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 d'Appareil où vous souhaitez l'utiliser. Accédez à l'onglet commandes de produits, et examinez attentivement les Paramètres mis en évidence ci-dessous :

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.

Quand un Appareil est configuré pour utiliser simple entry, il enverra une Demande à l'URL spécifiée dans le Champ simpleEntryEndpoint. Le Champ config 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 encodé en URL

Authentification

Le Paramètre Authentification sur l'intégration détermine comment Azumuta s'identifie auprès de votre Point de terminaison. Il offre les mêmes Options qu'un webhook de vérification de Procédure.

Hérité (clé API de l'appareil appelant) - la valeur par défaut pour les Intégrations créées avant l'existence de ce Paramètre. Azumuta envoie la clé API de l'Appareil qui a scanné le Code-barres dans un En-tête x-api-key. Cette clé authentifie l'Appareil auprès de l'API REST Azumuta, afin que votre Point de terminaison puisse rappeler Azumuta avec elle, mais elle n'authentifie pas Azumuta auprès de vous. Préférez l'une des Options ci-dessous pour une nouvelle intégration.
Aucun - aucune Authentification n'est envoyée.
En-tête - un En-tête de votre choix, contenant soit une valeur que vous entrez, soit la clé API d'un Appareil API que vous Sélectionnez. Le Nom de l'en-tête est par défaut X-API-Key.
Basic - un Nom d'utilisateur et un Mot de passe, envoyés en tant qu'En-tête Authorization: Basic.
Identifiants client OAuth - Azumuta demande un token à votre URL du token avec un ID client et un Secret client, puis l'envoie en tant qu'En-tête Authorization: Bearer. L'URL du token doit utiliser https.

Choisir autre chose que Hérité remplace l'En-tête x-api-key plutôt que de l'ajouter. L'Appareil de numérisation est toujours identifié via les paramètres de requête deviceId et deviceName.

Les Secrets que vous entrez (une Valeur de l'en-tête, un Mot de passe, un Secret client) sont chiffrés avant d'être stockés et ne sont jamais renvoyés au navigateur. Quand vous rouvrez l'intégration, le Champ est vide ; laissez-le vide pour conserver le Secret stocké. Modifier l'URL du Point de terminaison (ou, pour OAuth, l'URL du token) efface le Secret stocké, vous devez donc l'entrer à nouveau.

Exemple de Demande

Demande : url: <simpleEntryEndpoint>?barcode=<barcode>&deviceId=<deviceId>&deviceName=<deviceName> headers: { x-api-key: <Azumuta REST API key> }

L'En-tête ci-dessus est la valeur par défaut Hérité. Avec toute Autre Option d'Authentification, l'Authentification que vous avez configurée est envoyée à sa place.

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 sur la Demande doit être application/json.

Exemple de Réponse

{ identifier: "<identifier>" }

Créer une commande de produit automatiquement

Une Fonctionnalité courante que nous recevons souvent de la part de nos clients est la capacité à créer automatiquement une Commande de produit pour le code scanné (si la Commande de produit n'existait 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 Appareil API. Plus d'informations sur l'accès aux docs : API REST d'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 existerait déjà.
activate: true — Activer automatiquement la Commande de produit lors de la 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.

Turn manufacturing into a limitless engine of progress