Remarque : cette page web contient des informations très techniques. Nous vous recommandons donc de faire appel à votre service informatique pour la consulter. Pour toute question ou demande, n'hésitez pas à nous contacter àl'adresse support@old-old-wordpress.azumuta.com. Nous serons ravis de vous aider.
Qu'est-ce que l'intégration de la saisie simple ? #
Un cas d'utilisation courant de l'intégration de la saisie simple est la navigation automatique vers les commandes de produits. Un opérateur peut scanner le code-barres d'une commande de produits et son écran sera automatiquement redirigé vers cette commande de produits, de sorte qu'il pourra immédiatement commencer à travailler sur cette commande de produits sur son appareil.
Pour ce faire, nous avons créé une intégration générique de la saisie simple, 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 saisie simple. Cette configuration permet un flux simple où le balayage et la saisie d'un identifiant de commande de produit ouvrent une commande de produit existante.
Remarque : cela ne fonctionne que si la commande de produits 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, telles que la création automatique d'une commande de produit qui n'existe pas encore, veuillez vous référer à cette section du guide.
Après avoir configuré une intégration de la saisie simple dans les paramètres de votre entreprise, mettez à jour les paramètres de l'appareil sur lequel vous souhaitez l'utiliser. Accédez à l'onglet l'onglet Commandes de produitset examinez attentivement les paramètres mis en évidence ci-dessous :
Comment créer une intégration personnalisée de Simple Entry ?
Si vous souhaitez étendre ce processus à votre propre logique commerciale, vous pouvez créer une intégration personnalisée.
Lorsqu'un appareil est configuré pour utiliser la saisie simple, il envoie 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 requête GET à l'URL fournie dans le champ simpleEntryEndpoint.
La demande comprendra un paramètre de requête appelé code-barres, qui représente le code scanné ou l'entrée sur le dispositif.
Note : Le code-barres sera codé en URL.
En outre, les en-têtes de la requête contiennent une clé x-api-key que vous pouvez utiliser pour vous authentifier auprès de l'API REST d'Azumuta.
Exemple de demande #
Request:
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 par un objet JSON contenant le champ identifiant. Le type de contenu de la requête doit être application/json.
Exemple de réponse #
{ identifier: “<identifier>” }
Comment créer automatiquement une commande de produit ?
Les clients nous demandent souvent de pouvoir créer automatiquement une commande de produits pour le code scanné (si la commande de produits n'existe pas encore).
Cela peut être facilement réalisé en effectuant un simple appel à l'API REST de création de produits : https://app.old-old-wordpress.azumuta.com/docs/api/products/create
Vous pouvez effectuer une requête POST pour créer un point final de produit en utilisant les paramètres suivants :
- returnExisting : true - Cette option ne crée pas de nouveau produit mais renvoie le produit existant au cas où la commande existe déjà.
- activate : true - Active automatiquement la commande de produits 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 sur leurs dernières versions approuvées.