Connecter WooCommerce : recevoir les commandes, renvoyer le fulfillment

Créez une clé REST API dans WooCommerce, collez l’URL de la boutique, la Consumer key et le Consumer secret dans Integration, testez, mappez, activez.

Le connecteur WooCommerce importe les commandes de votre boutique WooCommerce dans OMS et renvoie le fulfillment vers WooCommerce. Il peut aussi pousser produits et stock, pour que les fiches et le stock restent synchronisés des deux côtés. Une connexion par boutique : chaque boutique a sa propre Consumer key et son Consumer secret.

Prérequis#

• Une boutique WooCommerce sous WordPress, avec accès administrateur aux réglages WooCommerce.
• Droit de créer des clés REST API dans cette boutique (WooCommerce → Réglages → Avancé → REST API).
• L’URL de votre boutique utilise https et les permaliens ne sont pas en mode Simple : la REST API ne fonctionne pas avec les permaliens simples.

Obtenir les identifiants#

1. Dans l’administration de votre boutique, allez dans WooCommerce → Réglages → Avancé → REST API → Ajouter une clé.
2. Sélectionnez l’utilisateur de la clé, réglez les autorisations sur Lecture/Écriture (Read/Write), puis générez la clé. Lecture/Écriture est nécessaire car le connecteur ne fait pas qu’importer les commandes : il renvoie aussi fulfillment, produits et stock.
3. Copiez la Consumer key. Elle commence par ck_.
4. Sur la même page, copiez le Consumer secret. Il commence par cs_ et n’est affiché qu’une fois : enregistrez les deux valeurs en lieu sûr immédiatement.

Remplir dans Integration#

1. Ouvrez Integration → Marketplace → WooCommerce → Nouvelle connexion.
2. URL de la boutique (Store URL), obligatoire : l’URL complète de la boutique, https inclus, par ex. https://www.example.com. Saisissez l’adresse de la boutique elle-même, pas celle de l’administration.
3. Consumer key, obligatoire : collez la Consumer key copiée depuis WooCommerce → Réglages → Avancé → REST API (commence par ck_).
4. Consumer secret, obligatoire : collez le Consumer secret de la même page (commence par cs_). Il est chiffré au repos et jamais réaffiché.

Tester la connexion#

Cliquez sur Tester la connexion. Le test a deux niveaux : connectivité (l’URL de la boutique répond et la Consumer key et le Consumer secret sont acceptés) et aperçu au niveau document (récupère une commande réelle et affiche champs plateforme → commande standard côte à côte). Si la boutique n’a pas encore de commande, passez d’abord une commande de test dans WooCommerce : l’aperçu a besoin d’un document réel. En cas d’échec, notez l’erreur et consultez la FAQ avant de changer autre chose.

Mapping / choisir un modèle#

Choisissez le modèle standard WooCommerce. Il mappe numéro de commande, SKU de ligne, quantités, adresse de livraison et statut de fulfillment. Vérifiez l’aperçu avec une commande réelle avant d’activer, surtout que chaque SKU WooCommerce est associé à un produit OMS et que l’adresse tombe au bon endroit.

Activer#

Après activation, Integration récupère les nouvelles commandes selon la fréquence définie et renvoie le fulfillment avec numéros de suivi vers WooCommerce. La poussée produits et stock garde fiches et stock synchronisés. Surveillez les premières commandes dans Runs / Logs avant de laisser tourner sans surveillance.

FAQ#

Le test échoue avec 401

La Consumer key ou le Consumer secret ne correspond pas à la boutique, ou la clé a été créée en lecture seule. Une copie incorrecte ou incomplète est rejetée, et une clé en lecture seule ne peut pas renvoyer fulfillment, produits ni stock : les écritures sont donc aussi rejetées.

Allez dans WooCommerce → Réglages → Avancé → REST API, créez une nouvelle clé avec les autorisations Lecture/Écriture (Read/Write), copiez la nouvelle Consumer key et le Consumer secret tels quels dans Integration, puis retestez. Quand vous régénérez la clé, les anciennes valeurs cessent de fonctionner : mettez donc la connexion à jour dans la même étape.

Le chemin de la REST API ne répond pas

Les permaliens WordPress sont en mode Simple. Dans ce mode, les pages de la boutique s’ouvrent encore, mais les chemins de la REST API WooCommerce ne fonctionnent pas : Integration ne peut donc pas atteindre l’API pour importer les commandes ni rien renvoyer.

Dans WordPress, ouvrez Réglages → Permaliens, choisissez une structure autre que Simple, enregistrez, puis retestez la connexion dans Integration.

L’URL de la boutique est incorrecte et le test ne connecte pas

L’URL de la boutique dans Integration ne pointe pas vers la boutique : le plus souvent, il manque https://, ou l’adresse d’administration a été collée au lieu de celle de la boutique, donc le test parle au mauvais endroit et n’atteint jamais WooCommerce.

Corrigez le champ URL de la boutique avec l’adresse complète de la boutique, https inclus, par ex. https://www.example.com : l’adresse que les clients ouvrent, pas celle de l’administration, puis retestez.

Connecté mais aucune nouvelle commande n’arrive

La connexion va bien : la boutique n’a simplement pas de nouvelles commandes dans la plage d’extraction, il n’y a donc encore rien à importer.

Passez une commande de test dans votre boutique WooCommerce, vérifiez que son heure est dans la plage d’extraction, lancez une extraction manuelle et confirmez que la commande apparaît dans l’aperçu ou dans Runs / Logs.