Pour être franc : l'intégration OMS–WMS casse pour presque tous les vendeurs que je connais. Les commandes quittent l'OMS ; l'entrepôt dit qu'elles ne sont jamais arrivées. L'entrepôt dit qu'il a expédié ; l'acheteur dit que rien n'est venu. Les deux systèmes sont au vert, et le vendeur absorbe la mauvaise évaluation, le remboursement et le coût d'expédition.
Je vends en cross-border depuis cinq ans. Les trois premières années, je gérais mon propre petit entrepôt ; quand le volume l'a dépassé, je suis passé à un 3PL à Los Angeles en September 2024. Même OMS, nouveau WMS — et la première semaine m'a donné des leçons que j'ai payées avec de l'argent réel.
La première, c'était le mapping des SKU.
Nous avions 800+ SKU. Avant le go-live, j'ai exporté la liste pour que le 3PL crée les fiches produits dans son WMS. Simple en apparence. Première semaine : 100+ commandes bloquées en « pending » — l'envoi passait bien, mais le WMS ne trouvait pas le SKU. Ils en avaient créé environ 700 ; les 100+ autres étaient des produits nouveaux des deux derniers mois, absents de mon export. Les commandes sont restées deux jours avant que je les repère dans le rapport d'exceptions, juste quand les SKU automne/hiver démarraient. 100+ commandes expédiées avec deux jours de retard ; le service client s'est fait hurler dessus toute la semaine.
Leçon dure : la table de mapping des SKU doit se réconcilier à 100%, pas 99%. J'exporte chaque SKU de l'OMS et je fais un vlookup contre les codes article du WMS — une ligne manquante, pas de go-live. Et une règle dure : aucune fiche produit ne passe en ligne tant que son mapping SKU n'existe pas dans le WMS. Mapping d'abord, mise en ligne ensuite.
L'intégration OMS WMS commence par la table de mapping des champs
Un envoi de commande de l'OMS vers le WMS est, au fond, une table de mapping des champs — et quatre-vingt-dix pour cent des incidents d'intégration y vivent. La plupart des guides de mapping des champs pour l'intégration OMS WMS s'arrêtent à la table. La table est la partie facile ; les exceptions sont là où les vendeurs perdent de l'argent. Voici notre version actuelle, avec la dernière colonne marquant les endroits où je me suis brûlé personnellement :
| Champ OMS | Champ WMS | Où ça casse |
|---|---|---|
| Numéro de commande marketplace | Référence externe de commande | Les deux systèmes utilisent des numéros de commande différents — envoyez les deux ; le WMS doit dédupliquer sur la référence externe |
| Numéro de commande OMS | Numéro de commande de sortie | N'utilisez pas ici le numéro de commande marketplace — un acheteur passant deux commandes dans la journée provoquera une collision |
| SKU | Code article | La table de mapping doit exister d'abord ; « créer le mapping » est une étape obligatoire de chaque lancement de produit |
| Quantité | Quantité de picking | Les unités ! Vendre au carton vs. à la pièce doit se résoudre en une seule unité dans le WMS |
| Destinataire / adresse / ville / état / code postal / téléphone | Infos d'expédition | La ligne 2 de l'adresse (apt, unit, suite) doit être envoyée — beaucoup d'intégrations n'envoient que la ligne 1 |
| Méthode d'expédition | Transporteur + code de service | N'envoyez jamais de noms d'affichage comme « Standard » — envoyez des codes convenus à l'avance par les deux parties |
| Note de l'acheteur | Note de préparation | Son propre champ — ne la fourrez jamais dans les lignes d'adresse ou la validation d'adresse échoue |
| Boutique / marchand | Code marchand | Obligatoire quand plusieurs boutiques partagent un WMS, sinon le stock est déduit du mauvais propriétaire |
Le plus sournois, c'est l'unité de quantité. Notre pack variété se vendait au carton — 12 pièces chacun. L'OMS envoyait « cartons », la fiche WMS était en « pièces », et les 20 premières commandes ont pické 20 pièces au lieu de 20 cartons. Les acheteurs ont reçu une pièce, ont cru que c'était le carton entier, et ont ouvert des litiges partout. Nous avons ajouté une colonne « conversion d'unités » et signalé chaque pack variété. Ça n'est plus arrivé.
N'envoyez jamais les noms de méthodes d'expédition, seulement les codes. Nous avions commencé avec « standard » et « expedited » — le 3PL utilise cinq transporteurs, chacun avec son propre « standard », et le WMS ne pouvait pas dire lequel nous voulions. Maintenant les deux parties partagent une table de codes, l'OMS envoie des codes comme GROUND_HOME, et les disputes ont chuté de quatre-vingt-dix pour cent.
Quatre exceptions de l'intégration OMS WMS que vous verrez chaque semaine
Je garde cette matrice épinglée — symptôme, traitement automatique, et quand un humain intervient. Quatre types couvrent presque tout :
| Exception | Symptôme | Traitement automatique | Intervention humaine quand |
|---|---|---|---|
| SKU non mappé | Commande bloquée en pending dans le WMS | Retenue + ajoutée au rapport d'exceptions | Le jour même : ajoutez le mapping, renvoyez manuellement |
| Stock court | Pas assez de stock pour exécuter | Retenir toute la commande, ou expédier la quantité disponible selon la règle | Non résolu après 4 heures — le CS contacte l'acheteur |
| Mauvaise adresse | La validation échoue / colis retourné | Retenue | Vérifiez manuellement l'adresse, corrigez-la, renvoyez |
| Envoi en double | La même réf. externe arrive deux fois | Le WMS déduplique sur la réf. externe et l'écarte | Aucune action nécessaire — mais le compteur d'écarts doit figurer dans le rapport |
L'envoi en double mérite sa propre histoire — Black Friday 2024. Notre envoi était une API temps réel ; le réseau a hoqueté, l'OMS a expiré et a réessayé. Sans déduplication sur le numéro de commande externe, le WMS a créé deux commandes de sortie et l'équipe de nuit a expédié les deux. Un acheteur a reçu deux colis et en a retourné un — l'expédition plus le produit m'ont coûté près de $40 sur cette commande. Une douzaine de doublons cette nuit-là. Ça pique encore.
Il en est sorti deux règles dures. Une : le WMS doit dédupliquer sur le numéro de commande marketplace — l'idempotence se met dans le contrat, pas dans une poignée de main. Deux : avant le go-live, je teste moi-même, en renvoyant la même commande 10 fois. Une commande de sortie, c'est un pass ; deux, c'est que le 3PL retourne corriger.
Les mauvaises adresses méritent aussi une note. La ligne 2 des adresses US — apt, unit, suite — est constamment abandonnée parce que les mappings n'envoient que la ligne 1. Un lot de nos commandes d'appartements est parti sans numéro d'unité, la livraison a échoué, et c'est revenu : sept jours aller-retour, directement vers des avis une étoile. Maintenant l'OMS bloque l'envoi sauf si les quatre sont présents — destinataire, lignes d'adresse (ligne 2 incluse), code postal, téléphone.
La conclusion contre-intuitive : moins de champs, moins de problèmes
La plupart des gens pensent que plus de champs signifie une meilleure intégration et essaient d'envoyer tout jusqu'aux codes promo. Je le pensais aussi, jusqu'à ce que ça me morde : chaque champ supplémentaire est un nouveau point de défaillance.
Un WMS exécute. Il a besoin du destinataire, du contenu, de la quantité, de la méthode d'expédition et d'une éventuelle note de préparation. Infos coupons, source du pub — le WMS ne peut pas les utiliser, et un champ malformé peut faire échouer toute la commande. Nous avons réduit notre payload de 30+ champs à 18 ; le taux d'exceptions a été divisé par deux.
Compromis lié : envoi temps réel vs. batch planifié. Le temps réel fait plaisir — les commandes arrivent à l'entrepôt en quelques secondes — mais un hoquet réseau signifie des commandes perdues ou en double, généralement à 2h du matin sans personne pour regarder. Le batch (un fichier toutes les 15 minutes) a l'air bête mais est rejouable et réconciliable ; quand il casse, on relance le fichier. Mon setup : envoi temps réel plus un job de réconciliation toutes les 15 minutes qui compare les numéros de commande des deux systèmes. Les commandes dans l'OMS mais absentes du WMS sont renvoyées automatiquement. Vous voulez les deux avantages ? Faites les deux jobs.
Check-list de go-live : 7 choses à vérifier la veille
Notre deuxième bascule a fonctionné avec cette liste — sept coches, ou pas de go-live :
- Idempotence : renvoyez délibérément la même commande 10 fois — le WMS doit créer exactement 1 commande de sortie.
- Réconciliation totale des SKU : exportez chaque SKU de l'OMS, vlookup contre les codes article du WMS. Une ligne manquante = pas de go-live.
- Conversions d'unités : packs variété et packs carton, chaque conversion détaillée dans la table de mapping.
- Complétude de l'adresse : destinataire, lignes d'adresse (ligne 2 incluse), code postal, téléphone — l'OMS bloque l'envoi si l'un manque.
- Table de codes transporteurs : les deux parties s'accordent sur les codes ; pas de noms d'affichage, pas de mots flous comme « standard ».
- Les notes ont leur propre champ : les notes d'acheteur ne vont jamais dans les lignes d'adresse.
- Run sandbox de 50 commandes : utilisez de vraies commandes historiques, en incluant délibérément des données sales — numéros d'appartement, boîtes postales, codes postaux reculés, téléphones manquants.
Lire le rapport d'exceptions : trois chiffres
Chaque matin à 8h, le rapport d'exceptions arrive. Trois chiffres, rien d'autre :
Premier, le nombre de commandes en pending. Un chiffre à un seul digit est normal ; au-delà de 20, j'appelle le 3PL.
Deuxième, la ventilation des causes de pending. Si la même cause domine la liste trois jours de suite, la table de mapping ou la règle doit être corrigée — c'est systémique, pas aléatoire.
Troisième, les commandes en pending depuis plus de 24 heures — la ligne rouge. Pending, ça va ; ignoré, non. Tout ce qui reste coincé si longtemps est une expédition en retard en préparation ; nettoyez-le le jour même.
Deux premières semaines : le taux d'exceptions (pending + erreurs d'expédition sur commandes totales) tournait autour de 8%. Deux mois avec cette routine : sous 0.5%. Les semaines de pointe comme Black Friday remontent à ~1%, mais tout est visible dans le rapport et tout est actionnable.
L'intégration OMS–WMS n'est pas un problème de technologie. C'est un problème d'attention. Faites bien le mapping des champs de l'intégration OMS WMS, donnez un propriétaire à chaque exception, et lisez le rapport quotidien — faites ces trois choses et le taux d'échec chute de quatre-vingt-dix pour cent. Je l'ai testé moi-même — de 8% à 0.5% avec cette table et cet e-mail.
Par Ah K, Vendeur e-commerce (5 ans d'expérience)
Traduit de l'anglais. En cas de divergence, la version anglaise fait foi.
