Connecter Logiwa : envoyer les commandes, consulter le stock

Utilisez l’e-mail et le mot de passe d’un compte Logiwa avec accès API dans la connexion WMS, testez la vraie connexion par token, mappez et activez.

Le connecteur Logiwa relie ce système à Logiwa en tant que système d’entrepôt externe. Il peut envoyer des commandes d’expédition vers Logiwa, à l’unité ou en lot, et consulter le stock détenu dans Logiwa. Les confirmations d’expédition reviennent via le Webhook V2 de Logiwa, et non par un appel de consultation de cette connexion. Cette connexion se configure dans la zone WMS, pas dans l’assistant de canaux, et elle se connecte avec un nom d’utilisateur et un mot de passe Logiwa pour obtenir un token de session.

Prérequis#

• Un compte Logiwa auquel vous pouvez vous connecter. Le nom d’utilisateur de cette connexion est l’e-mail d’un utilisateur Logiwa disposant d’un accès API.
• Le mot de passe de ce même utilisateur Logiwa. Il n’y a pas d’API Key séparée à générer pour cette connexion : l’e-mail et le mot de passe du compte sont les identifiants.
• Vous savez s’il faut utiliser l’adresse de service par défaut https://myapi.logiwa.com ou une autre baseUrl indiquée pour votre environnement Logiwa. Si personne ne vous a donné d’autre adresse, laissez celle par défaut.

Obtenir les identifiants#

1. Choisissez l’utilisateur Logiwa pour l’intégration et confirmez que cet utilisateur dispose d’un accès API. Utilisez un utilisateur dédié quand c’est possible, afin qu’un changement personnel de mot de passe ne casse pas la connexion.
2. Notez le nom d’utilisateur : l’adresse e-mail de cet utilisateur Logiwa.
3. Notez le mot de passe de ce même utilisateur. Vous le saisirez une fois dans la connexion WMS, où il est conservé comme secret et utilisé avec le nom d’utilisateur pour obtenir un token.
4. Si votre environnement Logiwa vous a donné une adresse de service différente de celle par défaut, notez aussi cette baseUrl. Sinon, il n’y a rien d’autre à rassembler.

Remplir dans Integration#

Cette connexion n’a pas de liste de champs dans l’assistant de canaux. Ouvrez la connexion WMS de Logiwa dans Integration et saisissez les valeurs ci-dessous dans ce formulaire de connexion WMS. Ne cherchez pas Logiwa dans les étapes de champs de l’assistant de canaux : l’assistant n’a pas de champs pour elle.

1. username, obligatoire : l’e-mail de l’utilisateur Logiwa avec accès API, exactement comme utilisé pour se connecter à Logiwa.
2. password, obligatoire : le mot de passe de ce même utilisateur Logiwa. C’est un champ secret, envoyé avec username quand le système obtient un token.
3. baseUrl, facultatif : l’adresse de service Logiwa. Laissez vide pour utiliser celle par défaut https://myapi.logiwa.com, ou saisissez l’adresse différente indiquée pour votre environnement Logiwa.

Tester la connexion#

Utilisez le test de la connexion WMS. Il envoie une vraie demande de connexion à l’adresse de token sous votre baseUrl, avec le username et le password saisis, et il ne réussit que lorsque Logiwa renvoie un token. Si username ou password manque, le test s’arrête avec MISSING_CREDENTIALS. Si la demande ne renvoie pas de token, elle échoue avec AUTH_FAILED. Vous pouvez rencontrer deux entrées de test : ce test de la connexion WMS est la vraie vérification des identifiants décrite ici, tandis qu’un test affiché dans l’assistant de canaux ne contacte pas Logiwa avec ces identifiants — ne considérez pas un succès là-bas comme la preuve que le compte Logiwa fonctionne. Jugez la connexion uniquement sur le test de la connexion WMS.

Mapping / choisir un modèle#

Choisissez le mapping standard Logiwa. Avec lui, une commande sortante de ce système devient une commande d’expédition Logiwa, et une consultation de stock lit la liste de stock Logiwa pour le SKU mappé. Après un test réussi, envoyez une commande réelle et comparez-la dans Logiwa — référence, lignes et quantités — puis comparez la quantité d’un SKU avec ce qu’affiche Logiwa, avant d’activer. Si un SKU de ce système désigne autrement le même produit dans Logiwa, corrigez ce SKU dans le mapping plutôt que de renommer le produit dans l’un ou l’autre système.

Activer#

Après activation, les commandes sortantes de ce système sont envoyées vers Logiwa comme commandes d’expédition, une par une ou en lot, et les consultations de stock lisent les quantités Logiwa actuelles pour les SKU mappés. Les confirmations d’expédition reviennent via le Webhook V2 de Logiwa, donc maintenez la livraison par webhook en état de marche côté Logiwa. Surveillez les premières commandes dans Runs / Logs et dans Logiwa même avant de laisser la connexion sans surveillance.

FAQ#

Le test WMS échoue avec AUTH_FAILED

La demande de token a atteint Logiwa mais n’a pas renvoyé de token. La paire nom d’utilisateur et mot de passe n’a pas été acceptée : l’e-mail n’est pas un utilisateur Logiwa avec accès API, le mot de passe n’appartient pas à cet utilisateur, ou la baseUrl pointe vers un environnement Logiwa différent de celui du compte.

Connectez-vous à Logiwa dans le navigateur avec le même e-mail et le même mot de passe pour prouver que la paire fonctionne, confirmez que l’utilisateur dispose d’un accès API, puis ressaisissez username et password dans la connexion WMS sans rien tronquer. Si une autre baseUrl a été indiquée pour votre environnement, mettez-la exactement ; sinon, videz baseUrl pour utiliser l’adresse par défaut et retestez.

Le test s’arrête avec MISSING_CREDENTIALS

username ou password est vide sur la connexion WMS. La demande de token a besoin des deux valeurs, donc le test s’arrête avant de contacter Logiwa.

Remplissez les deux champs du formulaire de connexion WMS — username avec l’e-mail de l’utilisateur Logiwa et password avec le mot de passe de cet utilisateur — enregistrez, puis retestez.

Le test de l’assistant de canaux a réussi, mais le test WMS échoue toujours

Les deux tests ne sont pas la même vérification. L’assistant de canaux n’a pas de champs Logiwa et son test ne se connecte pas à Logiwa avec votre username et votre password, donc un succès là-bas ne dit rien sur le compte Logiwa. Seul le test de la connexion WMS effectue la vraie connexion par token.

Ignorez le résultat de l’assistant pour cette connexion. Lancez le test de la connexion WMS et partez de son résultat : MISSING_CREDENTIALS signifie qu’un champ est vide, AUTH_FAILED signifie que la paire du compte a été refusée.

Les commandes sont envoyées, mais Logiwa affiche des quantités différentes

La connexion et le token fonctionnent — la commande est arrivée — mais une ligne ne correspond pas : en général, le SKU de la commande désigne un autre produit dans Logiwa, ou l’unité de la ligne diffère entre les deux systèmes.

Comparez la commande envoyée ligne par ligne avec la commande dans Logiwa, corrigez le mapping de SKU du produit qui ne correspond pas, puis envoyez une nouvelle commande de test et comparez à nouveau avant de reprendre les commandes normales.

La consultation de stock ne renvoie rien pour un SKU qui existe dans Logiwa

La consultation de stock lit la liste de stock Logiwa avec le SKU mappé. Si le SKU envoyé n’est pas celui sous lequel Logiwa détient le stock, la liste revient vide même si le produit existe.

Trouvez le SKU exact sur la fiche produit dans Logiwa, mettez cette valeur dans le mapping de ce produit et relancez la consultation de stock.

Les commandes sont expédiées dans Logiwa, mais aucune confirmation n’arrive ici

Les confirmations d’expédition de cette connexion passent par le Webhook V2 de Logiwa, et non par les appels de commande ou de stock. Si la livraison par webhook côté Logiwa est arrêtée ou en échec, les commandes et le stock continuent de fonctionner pendant que les confirmations cessent d’arriver.

Vérifiez l’état de livraison par webhook côté Logiwa et rétablissez-le, puis expédiez une commande de test dans Logiwa et confirmez que la confirmation arrive ici avant de reprendre le volume normal.