Contrairement à Shopify ou WooCommerce, PrestaShop n'a pas d'écran d'autorisation. La connexion se fait avec une clé de l'API Webservice que vous créez dans votre back-office et collez dans Furgox. Pas de code à toucher, rien à installer.
Avant de commencer
Vous devez vous connecter au back-office de votre boutique en tant qu'administrateur.
Gardez sous la main l'adresse de votre boutique. Si PrestaShop est installé dans un sous-répertoire, incluez-le (
maboutique.com/shop).La réécriture d'URL doit être activée sur votre serveur : le webservice PrestaShop en a besoin pour répondre.
1. Activez le webservice de votre boutique
Dans le back-office, allez dans Paramètres avancés → Webservice. Plus bas, dans la configuration, réglez Activer le webservice PrestaShop sur Oui et enregistrez. S'il était déjà activé, passez à l'étape suivante.
2. Créez une clé pour Furgox
Cliquez sur Ajouter une nouvelle clé webservice (selon la version et la langue de votre PrestaShop, le bouton peut s'appeler un peu différemment). Sur la fiche :
Cliquez sur Générer pour que PrestaShop crée la clé, puis copiez-la : elle servira à l'étape 4.
Dans Description de la clé, écrivez
Furgoxpour la reconnaître plus tard.Laissez Activer la clé du service web sur Oui.
3. Cochez les autorisations
Dans le tableau Permissions de ce même écran, cochez toute la ligne —Voir (GET), Modifier (PUT) et Ajouter (POST)— pour ces ressources, puis enregistrez :
products, combinations, stock_availables, orders, order_states, order_histories, order_carriers, customers, addresses, countries
À quoi nous sert chaque groupe :
Produits et stock : lire votre catalogue et ses déclinaisons, écrire le SKU Furgox et mettre à jour les quantités disponibles.
Commandes et statuts : importer les commandes payées et tenir leur statut à jour.
Clients et adresses : savoir où livrer chaque commande.
Transporteurs de la commande : inscrire le numéro de suivi au départ du colis.
Nous vous conseillons de cocher aussi celles-ci, même si elles ne sont pas indispensables : states, currencies, product_option_values, configurations. Elles nous permettent de lire la région de chaque adresse, la devise des commandes, le nom des options de vos déclinaisons (taille, couleur…) ainsi que le nom et le fuseau horaire de votre boutique.
À la connexion, nous vérifions que la clé a accès à chaque ressource et nous vous disons lesquelles manquent. Ce que nous ne pouvons pas vérifier à ce moment-là, c'est l'accès en écriture : si vous oubliez PUT ou POST, la connexion fonctionne mais l'erreur apparaîtra plus tard, en publiant le stock ou en écrivant le suivi. Cochez toute la ligne.
4. Collez la clé dans Furgox
Dans votre panneau, ouvrez Intégrations, cliquez sur Connecter une boutique, choisissez PrestaShop et remplissez URL de votre boutique et Clé de l'API Webservice avec la clé copiée. Cliquez sur Se connecter à PrestaShop.
La connexion prend un peu plus de temps que sur les autres plateformes car nous lisons votre catalogue et vos commandes à ce moment-là. Sur une grande boutique, cela peut prendre une minute : ne fermez pas l'onglet.
5. C'est fait : votre boutique est connectée
Ce qui se passe ensuite
Produits
Nous importons vos produits et leurs déclinaisons avec leur référence, leur code-barres et leur photo. Quand vous incluez un produit dans sa première réception, il reçoit son SKU Furgox, que nous écrivons aussi dans votre PrestaShop. Si plusieurs déclinaisons partagent la même référence, nous attribuons à chacune son propre code pour pouvoir les distinguer en entrepôt. Plus de détails dans Ce que nous faisons de votre catalogue à la connexion.
Commandes
PrestaShop ne peut pas nous prévenir de lui-même de ce qui se passe dans votre boutique : nous l'interrogeons donc toutes les 15 secondes. Nous importons les commandes payées. Celles qui ne le sont pas encore sont retenues et arrivent d'elles-mêmes dès que votre boutique confirme le paiement ; les commandes annulées ou en erreur de paiement sont écarté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 PrestaShop les unités réelles de l'entrepôt au fil des réceptions et des expéditions.
Expéditions
PrestaShop dispose d'un suivi natif : nous inscrivons le numéro de suivi sur le transporteur de la commande —celui que votre client voit dans son compte et dans l'e-mail— puis nous passons la commande au statut Expédiée.
Recevoir les commandes instantanément (facultatif)
Si vous voulez que les commandes apparaissent immédiatement, sans attendre la prochaine vérification, vous pouvez installer notre module Furgox Sync :
Dans Intégrations, sur la fiche de votre boutique PrestaShop, cliquez sur Télécharger le module et copiez la Clé du module affichée juste en dessous.
Dans votre back-office, allez dans Modules → Gestionnaire de modules → Envoyer un module et envoyez le fichier
furgoxsync.zip.Cliquez sur Configurer et collez la clé du module. L'adresse du panneau est déjà renseignée.
C'est facultatif : sans le module, tout fonctionne de la même façon, avec juste quelques secondes de délai. Et même si vous l'installez, nous continuons d'interroger votre boutique par sécurité.
En cas de problème
« La clé n'est pas valide ou est désactivée »
Vérifiez que vous l'avez copiée en entier (32 caractères) et que son statut est Oui dans Paramètres avancés → Webservice.
« Le webservice de votre boutique est désactivé »
Revenez à l'étape 1 : il vous reste à régler Activer le webservice PrestaShop sur Oui.
« Nous ne trouvons pas l'API à cette adresse »
Vérifiez l'URL. Si PrestaShop se trouve dans un sous-répertoire, incluez-le. Si votre boutique est en mode maintenance, votre IP doit figurer dans la liste autorisée pour que l'API réponde.
« Il manque des autorisations à la clé »
Nous vous indiquons précisément les ressources manquantes. Retournez sur la clé dans votre back-office, cochez ces lignes en entier et cliquez à nouveau sur Se connecter à PrestaShop.
Le stock ou le suivi n'arrivent pas dans ma boutique
C'est presque toujours qu'il manque à la clé l'accès en écriture (PUT ou POST) sur une ressource. Vérifiez dans votre back-office que les lignes de l'étape 3 sont complètes.
J'ai supprimé ou régénéré la clé dans PrestaShop
Nous arrêtons de synchroniser et, quelques minutes après que votre boutique a commencé à refuser notre clé, la fiche passe d'elle-même en Déconnectée. Créez une nouvelle clé et cliquez sur Reconnecter sur la fiche, ou allez dans Connecter une boutique → PrestaShop avec la même URL : la boutique existante est mise à jour, sans perte de commandes ni d'historique. Le rôle de chaque bouton de la fiche est expliqué dans Synchroniser, déconnecter ou supprimer une boutique.
Vous êtes bloqué en cours de route ? Écrivez-nous depuis le chat de votre panneau et nous terminons avec vous.