WooCommerce se connecte à Furgox grâce à son assistant d'autorisation intégré : aucune extension à installer, aucune clé à copier à la main. Vous saisissez l'adresse de votre boutique, vous approuvez la connexion depuis votre WordPress et nous nous occupons du reste.
Avant de commencer
Vous devez vous connecter à votre WordPress en tant qu'administrateur de la boutique.
Votre boutique doit être en HTTPS. WooCommerce ne transmet pas les clés d'API sur une connexion non chiffrée.
Les permaliens ne peuvent pas être réglés sur « Simple » (Réglages → Permaliens). L'assistant WooCommerce se trouve à une adresse du type
/wc-auth/v1/authorizeet, sans permaliens lisibles, il renvoie une erreur 404.Votre boutique doit être accessible depuis Internet : à la fin du processus, c'est le serveur WooCommerce qui nous envoie les clés.
Votre WooCommerce doit être à la racine d'un domaine ou d'un sous-domaine (
maboutique.comoushop.maboutique.com). S'il se trouve dans un sous-répertoire (maboutique.com/shop), écrivez-nous avant de connecter : ce cas ne peut pas être connecté depuis le panneau.
1. Ouvrez Intégrations et choisissez WooCommerce
Dans votre panneau Furgox, ouvrez Intégrations, cliquez sur Connecter une boutique et sélectionnez WooCommerce.
2. Saisissez l'adresse de votre boutique
Dans URL de votre boutique, indiquez l'adresse où est installé votre WooCommerce, telle que la tapent vos clients (maboutique.com). Si elle est sur un sous-domaine, incluez-le. Cliquez ensuite sur Se connecter à WooCommerce.
3. Approuvez la connexion dans votre WordPress
Nous vous emmenons sur votre propre boutique. Si vous n'êtes pas connecté, WordPress vous demandera de vous identifier. Un écran WooCommerce indique que Furgox Fulfillment souhaite se connecter avec un accès en lecture et écriture. Cliquez sur Approuver.
L'accès en écriture nous permet de mettre à jour le stock, d'écrire le SKU Furgox sur vos produits et de marquer les commandes comme expédiées. En lecture seule, le reste du travail retomberait sur vous.
Quand vous approuvez, WooCommerce crée une clé d'API au nom de Furgox et nous l'envoie. Vous pouvez la consulter, et la révoquer quand vous voulez, dans WooCommerce → Réglages → Avancé → API REST.
4. C'est fait : votre boutique est connectée
Vous revenez sur votre panneau avec l'avis de boutique connectée. À ce moment-là, nous importons votre catalogue et les commandes des 30 derniers jours, et nous enregistrons dans votre boutique les notifications automatiques (webhooks) qui nous informent de chaque nouvelle commande et de chaque modification de produit.
Ce qui se passe ensuite
Produits
Nous importons produits et variations avec leur SKU et leur photo. Quand vous incluez un produit dans sa première réception, il reçoit son SKU Furgox, celui que nous utilisons en rayon, et nous l'écrivons aussi dans votre WooCommerce pour que les deux côtés parlent la même langue. Nous l'expliquons dans Ce que nous faisons de votre catalogue à la connexion.
Nous n'importons pas le code-barres depuis WooCommerce : si vos produits portent un EAN d'usine, indiquez-le en créant la réception (comment créer une réception).
Commandes
Chaque nouvelle commande arrive chez Furgox immédiatement grâce aux webhooks. Vous la voyez dans Commandes avec son état de préparation.
Les commandes « En attente de paiement », « En attente » (par exemple un virement pas encore reçu) et « Échouée » sont retenues et arrivent toutes seules une fois payées.
En plus, toutes les 5 minutes nous repassons sur votre boutique par sécurité : nous récupérons toute commande restée en route et réenregistrons les notifications si WooCommerce les a désactivées.
Si vous préférez vérifier chaque commande avant sa préparation, activez Accepter les commandes moi-même sur la fiche de la boutique.
Stock
Nous publions dans WooCommerce les unités réellement présentes dans l'entrepôt, au fil des réceptions et des commandes expédiées.
Expéditions
Quand la commande part, nous la passons en Terminée et ajoutons une note visible par le client avec le transporteur et le numéro de suivi. WooCommerce n'a pas de champ de suivi natif : nous l'enregistrons donc aussi comme métadonnée de la commande, au cas où vous utiliseriez une extension qui la lit. En passant en Terminée, WooCommerce envoie son e-mail de commande terminée si vous l'avez activé dans ses réglages d'e-mail.
En cas de problème
L'écran d'autorisation renvoie une erreur 404
C'est le cas le plus fréquent et la cause est toujours la même : les permaliens sont sur « Simple ». Modifiez-les dans Réglages → Permaliens (par exemple « Titre de la publication »), enregistrez et réessayez.
« Les données n'ont pas pu être envoyées » au moment d'approuver
Quand vous cliquez sur Approuver, c'est votre serveur WooCommerce qui nous transmet les clés. Si un pare-feu ou une extension de sécurité (Wordfence, règles Cloudflare strictes…) bloque les appels sortants, rien n'arrive. Autorisez les sorties vers panel.furgox.com et recommencez.
« Cette boutique est déjà connectée à un autre compte Furgox »
Une même adresse ne peut pas être dans deux comptes. Si vous pensez que c'est une erreur, écrivez-nous.
J'ai supprimé ou révoqué la clé Furgox dans WooCommerce
La synchronisation s'arrête : nous ne recevons plus les commandes et ne mettons plus le stock à jour. Quand votre boutique refuse notre clé plusieurs fois de suite, la fiche passe d'elle-même en Déconnectée en quelques minutes. Pour nous donner une nouvelle clé, cliquez sur Reconnecter sur la fiche, ou allez dans Connecter une boutique → WooCommerce et saisissez la même URL : en approuvant, la boutique existante est mise à jour, sans perte de commandes ni d'historique.
Les commandes n'arrivent plus
Cliquez sur Synchroniser sur la fiche de la boutique pour récupérer les commandes des 30 derniers jours et sur Webhooks pour réenregistrer les notifications. Si la fiche indique « Déconnectée », la clé n'est plus valide : faites ce qu'indique le point précédent. Le rôle de chaque bouton est expliqué dans Synchroniser, déconnecter ou supprimer une boutique.
Si vous bloquez à une étape, écrivez-nous depuis le chat de votre panneau et nous regardons ensemble.