Connectez votre boutique
PrestaShop à GSE-Web
Votre catalogue et votre stock disponible partent vers la boutique. Les commandes aux états que vous choisissez arrivent dans GSE-Web en bons de sortie confirmés, stock réservé.
En bref
Le connecteur PrestaShop relie une boutique PrestaShop à un magasin de GSE-Web, par le Webservice natif de la boutique : rien n'est à installer dans PrestaShop. GSE-Web publie le stock dans la boutique, la boutique envoie ses commandes. Il se configure par un administrateur de l'organisation, dans le menu ADMIN › « Intégrations ».
- Ce qui part vers la boutique : les fiches des produits simples, des kits et des produits à déclinaisons (nom, référence, prix de vente hors taxe, code-barres), si vous le demandez, et le stock disponible du magasin publié si vous cochez « Publier le stock disponible ».
- Ce qui arrive dans GSE-Web : chaque commande qui passe à l'un des états de commande que vous choisissez devient un bon de sortie confirmé, stock réservé, si vous cochez « Recevoir les commandes » ; l'acheteur devient un client « particulier ». Si vous le demandez, la description et les photos des produits reliés sont aussi reprises de la boutique.
- Quand : le stock part vers la boutique quelques secondes après chaque changement dans GSE-Web. PrestaShop ne prévient pas GSE-Web : les commandes sont lues toutes les 5 minutes, elles n'arrivent donc pas en temps réel.
- Ce qui n'est jamais fait : rien n'est supprimé en boutique (un produit retiré de la vente y est désactivé), GSE-Web n'écrit jamais les lignes d'une commande et n'émet jamais de remboursement. Il pose seulement l'état de commande que vous avez choisi à la livraison ou à l'annulation d'un bon, si vous le demandez.
- Coupure : pause, déconnexion ou fermeture du module à tout moment, sans rien perdre ; à la reprise, les commandes passées entre-temps sont rattrapées.
- Le connecteur est compatible avec le Webservice de PrestaShop 8 et 9. PrestaShop est une marque de son éditeur ; GSE-Web n'est ni édité ni approuvé par PrestaShop.
Prérequis
Vérifiez ces points avant d'ouvrir l'écran du connecteur : le test de connexion les contrôle et refuse en clair ce qui manque.
Le Webservice activé et la réécriture d'URL
Dans l'administration de PrestaShop : Paramètres avancés › Webservice, « Activer le service web de PrestaShop ». Le Webservice vit sous /api/ et exige la réécriture d'URL (Apache : mod_rewrite et AllowOverride All).
Une clé du Webservice avec les bons droits
32 lettres et chiffres, statut activé. Lecture sur shops, languages, currencies, countries, configurations, categories, tax_rule_groups, images, orders, order_states, addresses, customers ; lecture, création et modification sur products et combinations ; lecture et création sur product_options et product_option_values ; lecture et modification sur stock_availables et order_carriers ; création sur order_histories. Le test nomme chaque droit manquant.
Une adresse HTTPS publique
La boutique doit être joignable sur Internet en HTTPS ; un sous-dossier est admis (https://www.ma-boutique.fr/boutique). Une adresse en http:// ou sur un réseau privé est refusée.
Des versions testées, une seule boutique
Le connecteur est testé sur PrestaShop 8.2.8, 9.1.0 et 9.1.2. Les autres versions sont acceptées, mais l'écran de connexion affiche alors un avertissement : contactez-nous si vous rencontrez un problème. Une clé qui voit plusieurs boutiques est refusée : la multiboutique n'est pas prise en charge.
Les modules ouverts pour votre organisation
« Intégrations », puis « PrestaShop ». Leur ouverture se demande à KLS-Concept. Sans « Intégrations », l'entrée du menu n'apparaît pas.
Un compte ADMIN avec double authentification
La saisie de la clé de la boutique est refusée tant que la double authentification n'est pas activée sur votre compte (« Mes informations »). Activez-la avant de remplir les champs.
Un magasin réel, la même devise, un groupe de TVA
Le magasin publié est un magasin réel (un magasin d'exercice est refusé). La devise de la boutique doit être celle de votre organisation et la gestion des stocks doit y être activée. Pour que GSE-Web crée des fiches, la boutique doit avoir un groupe de règles de TVA : une boutique neuve n'en a aucun.
Configuration pas à pas
Six étapes, dans l'ordre de l'écran.
Ouvrir l'écran du connecteur
Menu ADMIN › « Intégrations ». La carte PrestaShop se trouve dans la catégorie « E-commerce ». Cliquez sur « Configurer » (le bouton devient « Gérer » une fois la boutique enregistrée).
Carte « Boutique »
Renseignez « Adresse de la boutique » (HTTPS, par exemple https://www.ma-boutique.fr), « Clé du Webservice » (créée dans Paramètres avancés › Webservice) et « Magasin publié » (un magasin réel).
La clé est en écriture seule : une fois enregistrée, elle n'est plus jamais réaffichée, l'écran n'en montre que le début et la fin. Une boutique déjà activée ne change pas d'adresse : il faut la déconnecter d'abord.
Carte « Réglages »
Chaque réglage a une valeur par défaut :
- « Créer et mettre à jour les fiches produits en boutique » : décoché par défaut. Décoché, GSE-Web ne fait que rapprocher les produits déjà en boutique, par référence. Coché, il exige un « Groupe de règles de TVA des fiches créées » et une « Catégorie par défaut des fiches créées » (une fiche existante garde les siens).
- « Publier le stock disponible » : décoché par défaut ; à cocher pour que GSE-Web écrive le stock en boutique. Exige la gestion des stocks activée dans la boutique.
- « Recevoir les commandes » : décoché par défaut ; à cocher pour importer les commandes. Coché, il exige « États de commande qui créent un bon » (au moins un, par exemple « Paiement accepté »). Les états sont propres à chaque boutique ; un état inconnu n'est jamais importé.
- « États de commande qui annulent le bon » : facultatif. Vide, la boutique n'annule aucun bon.
- « Âge maximal d'une commande rattrapée (jours) » : 30 par défaut, de 1 à 90. Après une pause ou une fermeture, une commande plus ancienne n'est pas importée d'office.
- « Remonter les livraisons et annulations à la boutique » : décoché par défaut ; à cocher pour que les livraisons et annulations remontent. Coché, avec « État posé à la livraison du bon » (typiquement « Expédié ») et « État posé à l'annulation du bon » (typiquement « Annulé »). Sans état choisi, rien n'est remonté.
- « Reprendre la description et les photos de la boutique » : décoché par défaut. La boutique reste maîtresse de ces contenus ; GSE-Web ne les écrit jamais en boutique.
- Pas de régime de prix à régler : GSE-Web publie son prix de vente hors taxe, la boutique calcule son TTC avec le groupe de règles de TVA choisi.
Enregistrer
Cliquez sur « Enregistrer ». « Tester la connexion » et « Activer » agissent sur la configuration enregistrée : l'écran demande d'enregistrer d'abord toute modification.
Tester la connexion, puis choisir dans les listes de la boutique
« Tester la connexion » interroge la boutique : clé acceptée, droits de la clé (avec la liste de ceux qui manquent), devise égale à celle de l'organisation, gestion des stocks, une seule boutique visible. Elle affiche ce que la boutique a déclaré (version de PrestaShop, fuseau horaire, devise, langues) et charge les listes à choisir : groupes de règles de TVA, catégories, états de commande. Choisissez-y vos états, enregistrez, testez de nouveau.
Activer
« Activer » refait le test, exige les choix de vos réglages (états ; groupe de TVA et catégorie si vous créez les fiches), puis lance la synchronisation. Les commandes passées avant l'activation ne sont pas importées.
Ce qui se synchronise, et qui fait foi
Chaque champ a un seul maître. Dans une commande de la boutique, GSE-Web n'écrit que son état de livraison ou d'annulation, jamais ses lignes.
📦 GSE-Web fait foi
- ✓Nom du produit (toutes les langues de la boutique)
- ✓Référence (SKU en boutique)
- ✓Prix de vente hors taxe
- ✓Code-barres
- ✓Mise en vente ou désactivation
- ✓Stock, par produit ou par combinaison
🛒 La boutique fait foi
- ✓Description (reprise dans GSE-Web en option)
- ✓Photos (reprises dans GSE-Web en option)
- ✓Catégories, promotions, caractéristiques
- ✓Taxes (groupes de règles)
- ✓Commandes et leurs états
- ✓Remboursements
Les règles
- Produits simples, kits et produits à déclinaisons. Un produit simple est publié comme un produit PrestaShop standard. Un kit aussi, avec pour stock le nombre de kits montables avec les composants du magasin publié. Un produit à déclinaisons est publié comme un produit à combinaisons : les axes (taille, couleur…) deviennent des groupes d'options, chaque déclinaison est une combinaison avec sa référence, son stock et un écart de prix par rapport au prix de base.
- Le nom de GSE-Web fait foi. Une mise à jour du nom le réécrit dans toutes les langues actives de la boutique : les traductions faites dans PrestaShop sont écrasées.
- Un produit retiré de la vente dans GSE-Web est désactivé dans la boutique ; il n'y est jamais supprimé. Une déclinaison retirée de la vente est mise à stock 0. À la création d'une fiche, la boutique refuse les commandes sans stock ; une fiche existante garde le réglage du marchand.
- Prix de vente hors taxe, publié tel quel à 4 décimales. La boutique calcule son TTC avec le groupe de règles de TVA choisi pour les fiches créées : si son taux diffère de la TVA du produit dans GSE-Web, le TTC affiché en boutique diffère de celui de GSE-Web.
- Stock publié = stock disponible du magasin publié (physique moins réservé), arrondi à l'unité inférieure, jamais négatif. Il part vers la boutique quelques secondes après chaque changement : entrée, sortie, transfert, inventaire, réservation posée ou libérée sur un bon. Le passage complet le relit aussi toutes les 5 minutes. Pour une déclinaison, le stock est écrit par combinaison.
- Une commande = un bon de sortie confirmé du magasin publié, case « Réserver les produits pour ce bon » cochée : toute la quantité commandée est réservée, même au-delà du stock (le manque se lit « En attente de réception » sur le bon). L'adresse de livraison est reprise. Jamais de bon partiel : si une ligne pose problème (produit inconnu, déclinaison inconnue, kit non publiable, acheteur sans e-mail, autre devise), aucun bon n'est créé et un point à traiter l'explique.
- Détection par lecture, sans webhook. PrestaShop ne prévient pas GSE-Web : toutes les 5 minutes, GSE-Web lit les commandes nouvelles ou modifiées. Un changement d'état est donc vu au passage suivant, jamais en temps réel.
- Un acheteur = un client « particulier », retrouvé par son e-mail d'une commande à l'autre. Un tiers déjà présent dans GSE-Web n'est pas rapproché : un client « particulier » est créé.
- Commande passée à un état d'annulation que vous avez choisi : le bon est annulé et ses réservations libérées, sauf s'il est déjà pris en charge par quelqu'un. Dans ce cas, un point à traiter laisse la décision à l'équipe.
- Commande modifiée en boutique après import : la modification n'est pas reportée sur le bon ; un point à traiter vous invite à le vérifier. Une commande de kit devient un bon de sortie sur ses composants ; une commande de déclinaison donne un bon sur la déclinaison.
- Remontée des livraisons et annulations (réglage décoché par défaut : l'ADMIN le coche) : un bon livré ou clôturé reçoit d'abord son n° de suivi (quand son expédition en porte un), puis la commande passe à l'état choisi ; GSE-Web ne déclenche pas l'e-mail de la boutique : PrestaShop ne prévient pas l'acheteur de ce changement. Un bon annulé dans GSE-Web pose l'état d'annulation choisi, sans remboursement : il se fait dans PrestaShop. Une commande que la boutique a déjà expédiée ou livrée n'est pas défaite : un point à traiter le signale. Livré partiel ou en préparation : rien tant que le bon n'est pas complet.
- Reprise de la description et des photos (réglage décoché par défaut) : à chaque passage, pour chaque produit relié, la description de la boutique est recopiée en texte brut (une description vide n'efface jamais celle de GSE-Web) ; les photos sont ajoutées dans l'ordre de la boutique et retirées quand elles disparaissent de la boutique. Au plus 20 photos par produit. Ne sont pas repris : catégories, promotions, caractéristiques, contenu propre à chaque déclinaison, ni les noms, prix et codes-barres modifiés en boutique.
Au quotidien
L'écran du connecteur se lit de haut en bas : l'état, la boutique, les réglages, les boutons, puis les points à traiter et le journal.
La carte « État »
Elle dit où en est la connexion, le nom et la devise de la boutique, la date de la dernière synchronisation, la dernière erreur et le nombre de points à traiter. Sur la carte de la page « Intégrations », l'état tient en une puce.
- À activer « Configurée, pas encore activée ».
- Connecté « Active — stock envoyé dès qu'il change, commandes lues toutes les 5 minutes ». L'état suit les réglages enregistrés : sans « Recevoir les commandes », « … commandes non reçues » ; sans « Publier le stock disponible », « … stock non publié ».
- En pause « En pause — rien n'est envoyé ni importé ».
- Arrêté — à vérifier « Arrêtée par le serveur — vérifiez la clé du Webservice et testez ».
« Synchroniser maintenant »
Le stock est envoyé automatiquement à la boutique, quelques secondes après chaque changement. PrestaShop ne prévient pas GSE-Web : les commandes sont lues toutes les 5 minutes. Ce bouton sert à lancer tout de suite la synchronisation complète (fiches produits, lecture des commandes, livraisons). Le message dit si le passage est terminé, s'il a relevé des points à traiter, ou pourquoi il n'a pas été lancé.
La carte « Ce qui passe entre GSE-Web et la boutique »
Sous les réglages, une carte dit, pour chaque échange, dans quel sens il va : de GSE-Web vers la boutique (fiches, stock, déclinaisons, livraisons et annulations), de la boutique vers GSE-Web (commandes, annulations, description et photos) et ce qui ne passe jamais (lignes d'une commande, remboursements, catégories, règles de taxe, prix spécifiques, noms, prix et codes-barres modifiés en boutique). Une ligne liée à un réglage décoché est marquée « Désactivé ».
Le « Journal »
Chaque passage y figure avec son type et son résultat. Types : « Fiches produits », « Stock », « Stock en direct » (envoi dès qu'un stock change, inscrit seulement si une quantité a changé), « Reprise depuis la boutique », « Lecture des commandes », « Remontée des bons », « Test de connexion ». Résultats : « Réussi », « Partiel », « Échec », « En cours », « Interrompu ». Un clic sur un passage ouvre son détail, élément par élément. Les passages qui n'ont rien changé peuvent être masqués.
Les « Points à traiter »
Une ligne qui ne passe pas ne bloque jamais la synchronisation : elle devient un point à traiter et le reste continue. Les points des fiches et du stock disparaissent d'eux-mêmes quand leur cause est corrigée. Les points des commandes portent deux boutons.
- « Rejouer » relit la commande dans la boutique et retente l'import, quel que soit son âge. Il n'est pas proposé pour les points de remontée (exécution, annulation en boutique) : le passage suivant les retente de lui-même.
- « Ignorer » range le point : un point ignoré ne revient pas dans la liste. « Tout ignorer », en tête de la liste, range d'un coup tous les points ouverts, y compris ceux qui ne sont pas affichés, après confirmation.
Fiches produits
- Cause
- Le produit n'est pas d'un type que le connecteur sait publier.
- Que faire
- Utilisez un produit simple, un kit ou un produit à déclinaisons.
- Cause
- Le produit n'a pas de prix de vente dans GSE-Web.
- Que faire
- Renseignez son prix de vente. Le point disparaît au passage suivant.
- Cause
- La référence est portée par plusieurs produits de la boutique, commence par un crochet, correspond à un produit d'un autre type (pack, virtuel, à déclinaisons) ou est déjà reliée à un autre produit de GSE-Web.
- Que faire
- Rendez la référence unique dans la boutique ou dans GSE-Web ; GSE-Web ne rapproche jamais au hasard.
- Cause
- La boutique a refusé la fiche (référence trop longue, nom vide, donnée invalide).
- Que faire
- Corrigez la fiche dans GSE-Web : le point disparaît au passage suivant.
- Cause
- La fiche reliée a été supprimée dans PrestaShop.
- Que faire
- Recréez-la, ou retirez le produit du périmètre publié, puis resynchronisez.
- Cause
- Le produit est passé de simple à déclinaisons (ou l'inverse) : le lien vers l'ancienne fiche est retiré.
- Que faire
- Désactivez ou supprimez l'ancienne fiche dans PrestaShop, puis ignorez le point.
- Cause
- Le kit n'a pas de composant, un composant est archivé, ou son unité diffère de son unité de base.
- Que faire
- Corrigez la composition du kit dans GSE-Web.
- Cause
- Le produit n'a aucune déclinaison publiable.
- Que faire
- Créez au moins une déclinaison avec un prix.
- Cause
- Le parent manque, est archivé, hors du périmètre, pas encore publié, ou ses axes sont invalides.
- Que faire
- Publiez le produit parent et corrigez ses axes, puis resynchronisez.
- Cause
- La fiche a été créée mais PrestaShop n'a pas accepté le réglage « refuser les commandes sans stock ».
- Que faire
- Posez ce réglage dans PrestaShop si vous le souhaitez, puis ignorez le point.
- Cause
- Une photo de la boutique est introuvable, d'un format non pris en charge, trop lourde (plus de 5 Mo), la boutique est injoignable, ou le produit en a plus de 20.
- Que faire
- Corrigez la photo dans la boutique ; le reste du produit est repris.
Stock
- Cause
- Le disponible n'est pas un entier ; PrestaShop ne gère que des quantités entières.
- Que faire
- Aucune action requise ; la quantité est arrondie à l'unité inférieure.
- Cause
- La boutique a refusé la quantité envoyée.
- Que faire
- Vérifiez la fiche en boutique ; l'envoi est retenté au passage suivant.
Choix enregistrés (boutique)
- Cause
- Le groupe choisi a été supprimé ou désactivé dans PrestaShop.
- Que faire
- Mettez la connexion en pause, testez, choisissez un autre groupe, enregistrez et reprenez.
- Cause
- La catégorie choisie a été supprimée dans PrestaShop.
- Que faire
- Mettez la connexion en pause, testez, choisissez une autre catégorie, enregistrez et reprenez.
- Cause
- Aucun état n'est choisi, ou celui qui l'était a été supprimé de la boutique.
- Que faire
- Choisissez l'état dans « Réglages » (en pause), enregistrez et reprenez.
- Cause
- Aucun état n'est choisi, ou celui qui l'était a été supprimé de la boutique.
- Que faire
- Choisissez l'état dans « Réglages » (en pause), enregistrez et reprenez.
Commandes
- Cause
- Une ligne de la commande porte une référence absente de GSE-Web.
- Que faire
- Créez le produit avec la même référence, puis « Rejouer ».
- Cause
- La combinaison commandée est inconnue de GSE-Web, ou la référence d'un produit à déclinaisons est commandée sans combinaison.
- Que faire
- Créez la déclinaison dans GSE-Web, puis « Rejouer ».
- Cause
- La boutique ne fournit aucun e-mail pour cet acheteur.
- Que faire
- Corrigez la fiche client dans PrestaShop, puis « Rejouer ».
- Cause
- Le client « particulier » associé à cet e-mail a été archivé dans GSE-Web.
- Que faire
- Désarchivez le client, puis « Rejouer ».
- Cause
- La devise de la commande n'est pas celle de l'organisation ; aucune conversion n'est faite.
- Que faire
- Traitez cette commande à la main dans GSE-Web, puis ignorez le point.
- Cause
- Elle a plus de jours que « Âge maximal d'une commande rattrapée ».
- Que faire
- « Rejouer » l'importe, quel que soit son âge.
- Cause
- Le bon est déjà pris en charge par quelqu'un : GSE-Web ne l'annule pas en silence.
- Que faire
- Décidez avec l'équipe d'entrepôt s'il faut arrêter la préparation.
- Cause
- Les lignes de la commande ont changé depuis la création du bon.
- Que faire
- Vérifiez le bon et corrigez-le à la main si besoin.
- Cause
- Une erreur empêche la création du bon.
- Que faire
- Lisez la cause dans le détail du point, corrigez-la, puis « Rejouer ».
- Cause
- Le kit commandé n'a pas de composant, un composant est archivé, ou son unité diffère.
- Que faire
- Corrigez la composition du kit, puis « Rejouer ».
- Cause
- La boutique a refusé l'état posé par GSE-Web.
- Que faire
- Vérifiez la commande en boutique ; le passage suivant retente.
- Cause
- Le bon a été annulé dans GSE-Web, mais la boutique avait déjà expédié ou livré la commande : GSE-Web ne la défait pas.
- Que faire
- Réglez la situation avec le client (remboursement, retour) directement dans la boutique.
- Cause
- La commande n'a pas de transporteur dans PrestaShop, ou en a plusieurs : le n° de suivi n'a pas pu être écrit. L'état, lui, est posé.
- Que faire
- Saisissez le n° de suivi dans PrestaShop si besoin.
Pause, reprise et changements
Le connecteur se coupe et se rouvre à tout moment. Certains changements ont une règle, que l'écran rappelle et que le serveur fait respecter.
« Mettre en pause »
Plus rien n'est envoyé ni importé, et rien n'est perdu. Le stock affiché en boutique reste celui du dernier envoi.
« Reprendre »
La boutique est de nouveau vérifiée (clé, droits, devise, TVA, catégorie et états choisis), puis le rattrapage est lancé : les commandes passées pendant la pause sont importées si elles ont moins de N jours (« Âge maximal d'une commande rattrapée », 30 par défaut). Plus anciennes, elles deviennent des points à traiter.
Changer de clé du Webservice
Sous une connexion active, l'adresse de la boutique et la clé sont verrouillées. Suivez cet ordre : « Mettre en pause », modifier, « Enregistrer », « Tester la connexion », « Reprendre ».
Changer d'adresse de boutique
« Déconnecter » d'abord : les produits et les commandes déjà reliés désignent l'ancienne boutique. Saisissez ensuite la nouvelle adresse et sa clé.
Reconnecter la même boutique
Les produits, les commandes et les clients déjà reliés sont retrouvés : aucun second bon n'est créé pour une commande déjà importée.
Changer la TVA, la catégorie ou les états
En pause seulement. La reprise revérifie ces choix contre la boutique : PrestaShop accepte en silence une TVA ou une catégorie qui n'existe pas, c'est GSE-Web qui contrôle. Un groupe de TVA ou une catégorie supprimé en boutique devient un point à traiter, et aucune fiche n'est créée.
« Déconnecter »
La clé est effacée et la synchronisation s'arrête. Rien n'est supprimé en boutique ni dans GSE-Web : les bons et les clients déjà importés restent.
Fermeture du module
Si KLS-Concept ferme le module pour votre organisation, tout s'arrête sans rien supprimer. À la réouverture, le passage suivant rattrape les commandes et republie le stock.
Sécurité et données
Ce que le connecteur garde, et comment.
Clé chiffrée
La clé du Webservice est chiffrée sur le serveur (AES-256-GCM). Elle n'est jamais réaffichée, ni inscrite dans les journaux.
Double authentification
Elle est exigée pour saisir ou remplacer les identifiants d'une boutique.
Boutique HTTPS publique seulement
Le connecteur n'appelle que l'adresse HTTPS saisie, sur un hôte public dont l'adresse est vérifiée ; aucune redirection n'est suivie. Les photos reprises ne sont téléchargées que depuis une adresse HTTPS publique, sans jamais transmettre la clé.
Rien à ouvrir côté GSE-Web
PrestaShop n'envoie rien à GSE-Web : c'est GSE-Web qui interroge la boutique. Aucune adresse de GSE-Web n'est à exposer à la boutique, aucun module à y installer.
Données de l'acheteur
Ses coordonnées sont reprises dans sa fiche client et l'adresse de livraison sur le bon. Le lien avec la boutique ne garde qu'une empreinte de son e-mail.
Rien dans l'export
Les identifiants chiffrés ne figurent pas dans l'export de portabilité de l'organisation.
Dépannage
Le message affiché par l'écran, sa cause et ce qu'il faut faire. Le code entre crochets aide le support à retrouver le cas.
« Arrêtée par le serveur — vérifiez la clé du Webservice et testez »
Après cinq refus d'authentification d'affilée (clé désactivée ou supprimée dans PrestaShop), le serveur arrête la connexion pour ne pas insister. Vérifiez la clé dans Paramètres avancés › Webservice, saisissez-la de nouveau si besoin, « Enregistrer », « Tester la connexion », puis « Activer ».
- Que faire
- Saisissez l'adresse HTTPS de la boutique, par exemple https://www.ma-boutique.fr, sans identifiant ni paramètre.
[PRESTASHOP_SHOP_URL_INVALID]
- Que faire
- Utilisez l'adresse publique de la boutique.
[PRESTASHOP_SHOP_URL_PRIVATE_HOST]
- Que faire
- Vérifiez que la clé est recopiée en entier (32 caractères) et qu'elle est active dans Paramètres avancés › Webservice.
[PRESTASHOP_SHOP_AUTH_FAILED]
- Que faire
- Testez la connexion : l'écran liste les droits qui manquent à la clé.
[PRESTASHOP_SHOP_ACCESS_DENIED]
- Que faire
- Dans Paramètres avancés › Webservice, cochez pour cette clé les droits listés, puis testez de nouveau.
[PRESTASHOP_RIGHTS_MISSING]
- Que faire
- Activez le Webservice dans Paramètres avancés › Webservice et vérifiez que la réécriture d'URL fonctionne.
[PRESTASHOP_WEBSERVICE_UNAVAILABLE]
- Que faire
- Aucune conversion n'est faite : alignez la devise par défaut de la boutique sur celle de l'organisation.
[PRESTASHOP_SHOP_CURRENCY_MISMATCH]
- Que faire
- Activez la gestion des stocks dans PrestaShop, ou décochez « Publier le stock disponible ».
[PRESTASHOP_STOCK_MANAGEMENT_DISABLED]
- Que faire
- Créez une clé limitée à une seule boutique.
[PRESTASHOP_MULTISHOP_UNSUPPORTED]
- Que faire
- Choisissez un groupe de règles de TVA après avoir testé la connexion. Une boutique neuve n'en a aucun : créez-en un dans PrestaShop (International › Taxes › Règles de taxe).
[PRESTASHOP_TAX_GROUP_REQUIRED]
- Que faire
- Testez la connexion, puis choisissez une catégorie de la liste.
[PRESTASHOP_CATEGORY_REQUIRED]
- Que faire
- Choisissez un état (par exemple « Paiement accepté »), ou décochez « Recevoir les commandes ».
[PRESTASHOP_IMPORT_STATES_REQUIRED]
- Que faire
- Cliquez sur « Déconnecter », puis saisissez la nouvelle adresse et sa clé.
[PRESTASHOP_SHOP_CHANGE_REQUIRES_DISCONNECT]
- Que faire
- « Mettre en pause », modifier, « Enregistrer », « Tester la connexion », « Reprendre ».
[PRESTASHOP_SHOP_SETTINGS_CHANGE_REQUIRES_PAUSE]
- Que faire
- « Mettre en pause », changer la clé, « Enregistrer », « Tester la connexion », « Reprendre ».
[PRESTASHOP_CONNECTION_ACTIVE_CHANGE_REFUSED]
- Que faire
- Saisissez la clé du Webservice.
[PRESTASHOP_CREDENTIALS_REQUIRED]
- Que faire
- Ouvrez « Mes informations », activez la double authentification, puis revenez.
[PRESTASHOP_CONNECTION_TWO_FACTOR_REQUIRED]
- Que faire
- Choisissez un magasin réel comme « Magasin publié ».
[PRESTASHOP_WAREHOUSE_EXERCISE_REFUSED]
- Que faire
- Vérifiez que la boutique est en ligne ; réessayez dans quelques instants.
[PRESTASHOP_SHOP_UNREACHABLE]
- Que faire
- Réessayez ; si le message persiste, contactez le support avec le code ci-dessous.
[PRESTASHOP_SHOP_RESPONSE_INVALID]
- Que faire
- Attendez quelques minutes ; le passage suivant reprend.
[PRESTASHOP_SHOP_RATE_LIMITED]
- Que faire
- Attendez la fin du passage en cours.
[INTEGRATIONS_CONNECTION_BUSY]
- Que faire
- Saisissez de nouveau la clé du Webservice, testez, puis activez.
[INTEGRATIONS_CREDENTIALS_UNREADABLE]
Questions fréquentes
Les produits à déclinaisons sont-ils pris en charge ?
Oui. Un produit à déclinaisons est publié comme un produit à combinaisons, et chacune de ses déclinaisons comme une combinaison avec sa référence, son stock et un écart de prix par rapport au prix de base. Les axes deviennent des groupes d'options de la boutique.
Peut-on relier plusieurs boutiques ?
Non. Une organisation relie une boutique, et un magasin de GSE-Web, le « Magasin publié », alimente cette boutique. La multiboutique de PrestaShop n'est pas prise en charge : une clé qui voit plusieurs boutiques est refusée.
Les livraisons sont-elles renvoyées à la boutique ?
Oui, si « Remonter les livraisons et annulations à la boutique » est coché (il est décoché par défaut : l'ADMIN doit le cocher) et si vous avez choisi l'état à poser. Un bon livré ou clôturé fait passer la commande à l'état choisi, avec le n° de suivi quand l'expédition en porte un ; GSE-Web ne déclenche pas l'e-mail de la boutique, PrestaShop ne prévient pas l'acheteur de ce changement. Un bon annulé pose l'état d'annulation choisi, sans remboursement.
Les images et la description des produits sont-elles échangées ?
Elles ne partent jamais de GSE-Web : photos et description se gèrent dans PrestaShop. En revanche, si vous cochez « Reprendre la description et les photos de la boutique », GSE-Web les recopie sur la fiche du produit relié, à chaque passage.
Les catégories, les promotions et les caractéristiques sont-elles reprises ?
Non. Elles restent gérées dans PrestaShop. Les fiches créées par GSE-Web reçoivent une seule catégorie par défaut, que vous choisissez.
Les commandes arrivent-elles en temps réel ?
Non. PrestaShop n'offre pas de webhook natif : GSE-Web lit les commandes nouvelles ou modifiées toutes les 5 minutes. Une commande peut donc apparaître jusqu'à 5 minutes après son passage à l'état choisi. Le stock, lui, part de GSE-Web vers la boutique quelques secondes après chaque changement.
Que se passe-t-il si je mets en pause ou si le module est fermé ?
Rien n'est envoyé ni importé, et rien n'est supprimé. Le stock en boutique reste celui du dernier envoi. À la reprise, les commandes passées entre-temps sont rattrapées, dans la limite de l'âge maximal choisi.
Quelles versions de PrestaShop sont prises en charge ?
Le connecteur est testé sur PrestaShop 8.2.8, 9.1.0 et 9.1.2. Les autres versions sont acceptées, avec un avertissement à l'écran de connexion : contactez-nous si vous rencontrez un problème.
Le nom de mes produits est-il modifié dans la boutique ?
Quand la création et la mise à jour des fiches sont activées, oui : le nom de GSE-Web fait foi et il est réécrit dans toutes les langues actives de la boutique, ce qui écrase les traductions faites dans PrestaShop. Sans cette option, GSE-Web ne touche pas aux fiches.
Un acheteur déjà présent dans mes tiers est-il reconnu ?
Non. Le connecteur crée un client « particulier » par acheteur et le retrouve par son e-mail aux commandes suivantes.
Les commandes passées avant l'activation sont-elles importées ?
Non. Seules les commandes lues après l'activation sont importées.
Comment obtenir le connecteur ?
Les modules « Intégrations » et « PrestaShop » sont ouverts organisation par organisation par KLS-Concept. Écrivez-nous depuis la page Contact en indiquant la version de votre PrestaShop.
Relier votre boutique PrestaShop
Demandez l'ouverture du connecteur pour votre organisation, ou posez-nous vos questions sur votre cas.