Connecter Item WMS : envoyer commandes et réceptions, synchroniser produits et stock
Demandez à UNIS vos Company ID, Customer ID et Facility ID, saisissez votre nom d’utilisateur et mot de passe Item WMS dans Integration, testez la connexion, vérifiez le mapping, puis activez sortie, entrée, étiquettes, produits et stock.
Le connecteur Item WMS relie ce système à Item WMS (UNIS). Il envoie les commandes de sortie et peut les annuler, consulte les accusés de commande et les confirmations d’expédition, charge les étiquettes d’expédition, crée et peut annuler les réceptions d’entrée, consulte les accusés de réception et les confirmations de réception, importe et recherche les produits, et lit le stock par article (disponible, alloué, endommagé, gelé et en main). Les trois ID dont il a besoin sont attribués par UNIS : vous ne pouvez pas les créer vous-même. Une connexion fonctionne avec les valeurs d’entreprise, de client et d’installation que vous saisissez.
Prérequis#
- Un accès Item WMS : un nom d’utilisateur et un mot de passe permettant de vous connecter à Item WMS.
- Votre Company ID, attribué par un administrateur système UNIS. Demandez-le avant de commencer : il est envoyé dans presque tous les appels API.
- Votre Customer ID, attribué par le service Finance d’UNIS. Il vient d’une équipe différente de celle du Company ID : demandez-le séparément au service Finance.
- Votre Facility ID (entrepôt), attribué par votre ITEM CSR. Confirmez qu’il s’agit bien de l’ID de l’entrepôt avec lequel cette connexion doit travailler.
- Vous n’avez normalement pas besoin d’une Base URL : la connexion utilise l’adresse de production par défaut. Ne notez une autre adresse que si UNIS vous a donné un environnement hors production ou spécial.
Obtenir les identifiants#
- Demandez votre Company ID à un administrateur système UNIS. Tous les ID ci-dessous sont attribués par UNIS : vous ne pouvez pas les créer vous-même dans Item WMS.
- Demandez votre Customer ID au service Finance d’UNIS. Ne réutilisez pas le Company ID ici : ce sont deux valeurs différentes, fournies par deux équipes différentes.
- Demandez à votre ITEM CSR votre Facility ID, l’ID de l’entrepôt desservi par cette connexion.
- Notez le nom d’utilisateur et le mot de passe de l’accès Item WMS pour l’intégration, exactement comme vous les utilisez pour vous connecter à Item WMS.
Remplir dans Integration#
- Ouvrez Integration, choisissez Item WMS et démarrez une nouvelle connexion.
- username, obligatoire, Username : le nom d’utilisateur de l’accès Item WMS pour l’intégration, par ex. your-username.
- password, obligatoire, Password : le mot de passe de ce même accès Item WMS. Il est conservé comme secret.
- company_id, obligatoire, Company ID : l’ID attribué par un administrateur système UNIS, par ex. sous la forme COMPANY01. Copiez-le exactement comme UNIS vous l’a donné.
- customer_id, obligatoire, Customer ID : l’ID attribué par le service Finance d’UNIS, par ex. sous la forme CUST001. Ce n’est pas la même valeur que le Company ID.
- facility_id, obligatoire, Facility ID (entrepôt) : l’ID d’entrepôt attribué par votre ITEM CSR, par ex. sous la forme WH01.
- base_url, facultatif, Base URL : laissez-le vide pour utiliser l’adresse de production par défaut https://wms.item.com/api/public/v1/public. Ne le remplissez que si UNIS vous a donné une autre adresse pour un environnement hors production ou spécial.
Tester la connexion#
Cliquez sur Tester la connexion. Le test se connecte réellement : il envoie votre username et votre password à l’endpoint de connexion d’Item WMS et ne réussit que si un token revient. Un succès prouve donc que le nom d’utilisateur et le mot de passe sont corrects et que l’adresse répond. Le test ne fait pas d’appel métier avec vos trois ID : un Company ID, Customer ID ou Facility ID incorrect peut donc passer le test et n’échouer que plus tard, au premier appel réel de commande, de réception, de produit ou de stock. Après un test réussi, vérifiez les trois ID avec un appel réel avant d’activer, comme décrit à l’étape de mapping.
Mapping / choisir un modèle#
Choisissez le mapping standard Item WMS pour les commandes, les réceptions, les produits et le stock, et gardez les valeurs d’entreprise, de client et d’installation de la connexion comme valeurs envoyées à chaque appel. Vérifiez ensuite avant d’activer : envoyez ou consultez une commande réelle et comparez numéro de commande, lignes et quantités ; lancez une consultation de stock pour un produit connu et comparez les quantités disponible et en main avec Item WMS. Cette vérification confirme aussi les trois ID : le test de connexion ne peut pas les contrôler, un résultat correct ici signifie donc que les ID vont ensemble et pointent vers le bon entrepôt.
Activer#
Après activation, la connexion envoie les commandes de sortie vers Item WMS, envoie les annulations de commande, crée les réceptions d’entrée et les annulations de réception, charge les étiquettes et continue d’importer les accusés, les confirmations d’expédition et les confirmations de réception, tandis que les imports de produits, les recherches et les lectures de stock passent par la même connexion. Surveillez les premières commandes et réceptions dans Runs / Logs et comparez-les avec Item WMS avant de laisser la connexion sans surveillance.
Gardez la portée en tête : cette connexion couvre le travail de sortie, d’entrée, d’étiquettes, de produits et de stock listé ci-dessus, avec la portée entreprise, client et installation que vous avez saisie. Le travail d’une autre installation ou d’un autre client a besoin de ses propres valeurs : ne changez pas les ID d’une connexion en cours pour changer d’entrepôt ; créez une connexion séparée.
FAQ#
Le test échoue avec AUTH_FAILED
La connexion a été refusée : Item WMS a répondu à l’appel de connexion mais n’a renvoyé aucun token. Cela signifie que le nom d’utilisateur, le mot de passe ou l’adresse utilisée ne correspond pas : le couple d’accès doit être l’accès Item WMS lui-même et base_url, lorsqu’il est rempli, doit pointer vers l’adresse API d’Item WMS.
Connectez-vous directement à Item WMS avec les mêmes nom d’utilisateur et mot de passe pour confirmer que le couple fonctionne, recopiez les deux valeurs sans espaces en trop et videz base_url, sauf si UNIS vous a donné une autre adresse. Puis retestez.
Le test réussit, mais le premier appel réel de commande ou de réception échoue
C’est le comportement attendu quand un ID est incorrect : le test se connecte uniquement avec le nom d’utilisateur et le mot de passe, tandis que les appels réels envoient aussi le Company ID, le Customer ID et le Facility ID. Un ID incorrect ou mal assorti passe donc le test et échoue au premier appel métier.
Comparez les trois ID caractère par caractère avec ce qu’UNIS a émis : Company ID d’un administrateur système UNIS, Customer ID du service Finance d’UNIS, Facility ID de votre ITEM CSR. Corrigez la valeur incorrecte dans la connexion, répétez le même appel réel et confirmez son succès avant d’activer.
Où obtenir le Company ID, le Customer ID et le Facility ID ?
Les trois ID sont attribués par UNIS : vous ne pouvez pas les créer vous-même, et ils viennent de trois sources différentes. Chercher dans Item WMS une page pour les générer ne fonctionnera pas.
Demandez à chaque source son propre ID : à un administrateur système UNIS le Company ID, au service Finance d’UNIS le Customer ID et à votre ITEM CSR le Facility ID. Rassemblez les trois, puis saisissez-les dans la connexion exactement comme émis.
Faut-il remplir base_url ?
Dans la plupart des cas, non. base_url est facultatif : laissé vide, la connexion utilise l’adresse de production par défaut https://wms.item.com/api/public/v1/public. Le remplir avec une adresse copiée ou devinée est une cause fréquente d’échecs de connexion.
Laissez base_url vide pour l’environnement de production. Ne le remplissez que si UNIS vous a donné une autre adresse pour un environnement hors production ou spécial, et copiez cette adresse exactement.
Les quantités de stock dans ce système ne correspondent pas à Item WMS
La connexion lit le stock par article depuis Item WMS : disponible, alloué, endommagé, gelé et en main sont des quantités distinctes. Un écart signifie généralement qu’un autre type de quantité a été comparé, ou que la portée produit ou installation diffère entre les deux vues.
Choisissez un produit connu dans la même installation, comparez le même type de quantité des deux côtés (par ex. disponible contre disponible) et vérifiez que le code produit correspond à l’article Item WMS. Si ce produit correspond, revérifiez la liste plus large avec le même type de quantité.