FAQ - PrestaShop
Quelles versions Prestashop sont compatibles avec Atoo-Sync ?
Explications
Atoo-Sync est compatible avec PrestaShop de la version 1.6.1 jusqu’à la version 9.
La compatibilité avec PrestaShop 9 a été ajoutée à partir de la version 25.10.1.0 (13 octobre 2025).
Détails techniques
-
Version minimale : PrestaShop 1.6.1
-
Version maximale : PrestaShop 9
-
Version du module : doit être identique à celle de l’application Atoo-Sync
-
Multi-boutiques : 
totalement compatible
Compatibilités PHP
| |Version PrestaShop |
|Versions PHP supportées |
|Version PHP recommandée |
| 1.6.1 → 1.7.8 |
5.6 → 7.4 |
7.3 – 7.4 |
| 8.0 → 8.2 |
7.4 → 8.2 |
8.1 |
Atoo-Sync est compatible avec les environnements PHP 7.4 à 8.2 (sous réserve de la configuration serveur).
Compatibilité avec les thèmes
Atoo-Sync agit au niveau des données (produits, clients, commandes, stocks, etc.) et non sur le visuel du site.
Il est donc compatible avec la majorité des thèmes PrestaShop, y compris :
Cas particuliers avec impact potentiel
Mais certains thèmes “complexes” peuvent ne pas être totalement compatibles, notamment :
-
les thèmes qui remplacent le système d’attributs/variations par un module personnalisé (sélecteurs de couleur, taille, etc.),
-
les thèmes utilisant une galerie d’images via un autre module que celui natif de PrestaShop,
-
les thèmes “headless” ou hybrides (PrestaShop + React/VueJS) consommant l’API différemment.
Atoo-Sync ne passe pas par l’API PrestaShop, mais communique via des requêtes HTTP (GET ou POST) échangées avec le module Atoo-Sync installé sur la boutique.
Cette méthode assure la compatibilité même avec des environnements headless ou personnalisés.
Exemple de requête HTTP (récupération des commandes) :
Multi-boutique PrestaShop : où sont créés les articles lors de l’export depuis Atoo-Sync ?
Objectif
Cette FAQ explique le fonctionnement d’Atoo-Sync dans le cadre d’une configuration multi-boutique PrestaShop, notamment où sont créés les articles et comment les données sont gérées entre les différentes boutiques.
Fonctionnement général
Nativement, Atoo-Sync exporte les articles vers toutes les boutiques configurées dans PrestaShop.
Il n’existe pas de sélection spécifique pour choisir une ou plusieurs boutiques lors de l’export :
Les produits sont créés et mis à jour automatiquement sur toutes les boutiques.
Détails techniques
| Élément |
Comportement |
| Version concernée d’Atoo-Sync |
Toutes les versions d’Atoo-Sync compatibles PrestaShop |
| Export des articles |
Les articles sont envoyés globalement via une requête HTTP createproducts sans préciser d’id_shop.
Exemple :
https://Nomdusiteweb.fr/modules/atoosyncgescomwavesoft/atoosync-gescom-prestashop.php?cmd=createproducts&pass=**************
PrestaShop se charge ensuite de dupliquer automatiquement le produit sur l’ensemble des boutiques (ps_product_shop, ps_category_shop, etc.). |
| Stock, prix et descriptions |
Partagés entre toutes les boutiques. Toute création ou modification effectuée dans Atoo-Sync est répercutée sur l’ensemble des boutiques. |
| Désactivation / Suppression d’un article |
L’action s’applique également à toutes les boutiques concernées. Atoo-Sync ne gère pas de boutique par défaut lors de l’export. |
Comportement lors de l’import de commandes
Contrairement à l’export des produits, Atoo-Sync permet de sélectionner les boutiques à partir desquelles les commandes doivent être importées.
Cela permet une gestion plus fine du flux de commandes dans un environnement multi-boutique.
Cas particulier : ajout d’une nouvelle boutique
Lorsqu’une nouvelle boutique est créée dans PrestaShop :
-
Elle hérite des produits existants selon la boutique de référence choisie lors de la création.
-
Atoo-Sync n’ayant pas besoin de spécifier d’id_shop, les synchronisations suivantes mettront automatiquement à jour cette nouvelle boutique.
Il n’est donc pas nécessaire de relancer un export complet : la synchronisation suivante suffira à aligner les données.
Personnalisation possible
Si vous souhaitez pouvoir sélectionner manuellement les boutiques destinataires lors de l’export des articles,
cela peut être mis en place via une personnalisation spécifique (développement sur mesure).
Cette option nécessite un devis et un temps de développement supplémentaire.
À retenir
-
Export automatique vers toutes les boutiques PrestaShop.
-
Données partagées entre boutiques (stock, prix, description, images, etc.).
-
Aucune boutique “par défaut” côté Atoo-Sync.
-
Sélection possible uniquement pour l’import des commandes.
-
Comportement géré via les mécanismes natifs multi-boutique de PrestaShop.
Comment associer plusieurs images à un article à déclinaison dans Prestashop ?
Objectif
Associer automatiquement plusieurs images à un article contenant des déclinaisons (variations) dans PrestaShop, en utilisant la fonction d’import d’images d’Atoo-Sync.
Ce système permet :
-
d’avoir plusieurs photos pour un même produit,
-
d’afficher des images spécifiques par déclinaison (variation),
-
d’automatiser complètement l’association via le nommage des fichiers.
Principe de fonctionnement
Atoo-Sync associe les images aux produits en analysant le nom du fichier image.
Les images doivent donc respecter un format précis :
Ce que signifient les suffixes :
-
_01 = Image n°1
-
_02 = Image n°2
-
_03 = Image n°3
-
… jusqu’à _99
Maximum reconnu : 99 images par référence.
Exemples concrets
Exemple : Images spécifiques à chaque déclinaison
Déclinaison ARTARGPP1 :
Déclinaison ARTARGPP2 :
Dans PrestaShop :
Chaque déclinaison affichera uniquement ses images.
Organisation recommandée du dossier d’images
Vous pouvez mettre toutes les images dans un même dossier, ex. :
Ce même dossier sera ensuite déclaré dans Atoo-Sync.
Paramétrage dans Atoo-Sync
Étapes :
-
Ouvrez Atoo-Sync
-
Allez dans :
Configurer le profil → Articles → Images
-
Sélectionnez :
Le dossier contenant les images
L’option d’export des images (mode FTP/HTTP selon installation)
Exemple d’écran :
Exportation des images
Une fois les images nommées et le dossier configuré :
-
Lancez un export produits dans Atoo-Sync
-
Atoo-Sync :
-
scanne le dossier,
-
détecte les fichiers correspondant à une référence,
-
envoie les images au module PrestaShop,
-
les associe automatiquement au produit et/ou à la déclinaison.
Résultat dans PrestaShop :
Avant Export :
Les images apparaissent dans la galerie du produit et la déclinaison sélectionnée affiche son image spécifique.
Vérification côté PrestaShop
Dans la fiche produit, vous verrez :
-
La galerie d’images correctement ordonnée
-
Les images propres à chaque variation
-
Les miniatures générées automatiquement
Autre Déclinaison avec ses propres images :
Résultat en Front Office :
Notes importantes
Formats supportés :
Les noms doivent être strictement identiques aux références ERP.
Les caractères spéciaux (espace, accents…) doivent être évités dans les noms de fichier.
Si une image ne s’affiche pas, vérifier :
-
Qu’elle porte le bon nom
-
Qu’elle est dans le bon dossier
-
Qu’elle a un format supporté
-
Que l’export de l’article a été relancé
Le fonctionnement est le même pour les articles à Gamme, on prend la référence de l'énuméré de gamme.
Où remontent les factures PDF dans PrestaShop?
Fonctionnement :
Lorsque Atoo-Sync exporte les factures en PDF. il les envoie à travers des requêtes HTTP. Ces factures en PDF sont stockées sur le serveur Web qui héberge votre boutique en ligne.
Le module Atoo-Sync B2B, permet d'indiquer si on affiche coté Espace client la brique factures.
Où trouver les factures PDF transférées ?
1. Dans l'espace du client
C'est à cet endroit que les clients pourront consulter et télécharger les factures PDF.
2. Coté back office Prestashop.
Dans le Back office, retrouvez les factures transférées au niveau de la commande.
En bas de page de la commande. Via le logo en dessous Donwload téléchargez la facture PDF.
Activer le mode « Debug » PrestaShop
Pour activer le mode debug de PrestaShop, il faut éditer le fichier defines.inc.php dans le dossier config.
- Connectez-vous au FTP de la boutique PrestaShop
- Ouvrez le dossier « config » Éditez le fichier defines.inc.php
- Changez la valeur _PS_MODE_DEV_ de « false » à « true » .
- Enregistrez votre fichier
Pour désactiver le mode Debug il suffit juste de remettre à false la valeur de _PS_MODE_DEV_
Mise à jour des textes des articles existants dans PrestaShop
Selon la configuration que vous avez réalisé dans le module Atoo-Sync dans PrestaShop, les textes des articles déjà existants seront écrasés ou pas.
S’il n’y a pas de « coche verte » dans le bloc Modification du module dans PrestaShop, alors les textes ne seront pas remplacés par ceux de la Gestion Commerciale.
Seuls les prix et stocks seront mis à jour pour les articles existants, si vous avez activé ces deux boutons.
Création des clients de Sage dans PrestaShop
La gestion des clients est la suivante :
Atoo-Sync ajoute 2 champs dans la table ps_customers
- atoosync_code_client
- atoosync_centrale_achat
Prérequis pour créer un client dans Prestashop :
- Nom et prénom
- Adresse mail valide
Note : une adresse email valide exemple
nomprenom@gmail.com sans caractère spécial, et une seule adresse dans le champ email, idéalement l'email doit être unique.
Lors du transfert des clients de Sage vers Prestashop.
Atoo-Sync recherche si le client existe à partir de son adresse email ou de son code client Sage.
(L’adresse email utilisée est celle renseignée dans l’onglet identification.)
Si le client est trouvé à partir de son adresse email alors le code client Sage est renseigné dans la table PrestaShop.
Si le client n’est pas trouvé, Atoo-Sync le crée et renseigne le code client Sage.
Dans le sens PrestaShop vers Sage.
S’il s’agit d’un nouveau client, le client est créé dans Sage et le code client Sage est remonté immédiatement dans PrestaShop pour l’enregistrer dans la table des clients.
Si le client a déjà le champ atoosync_code_client « renseigné » alors c’est celui-ci qui est utilisé pour rechercher le client dans Sage.
Notez que si un code client est renseigné dans PrestaShop et que ce code client n’existe pas dans Sage, le client est créé avec ce code dans Sage.
A retenir :
- C’est le code client Sage qui fait référence et non l’adresse email.
- L’adresse email n’est utilisée que lors de la recherche du client lors de la création dans le sens Sage -> PrestaShop.
Emplacement du module et des scripts PHP
Les scripts se trouvent dans le dossier d’installation du logiciel Atoo-Sync.
Atoo-Sync Export Compta
C:program filesAtoo NextAtoo-Sync Export ComptaShopsPrestaShopmodules
C:Program Files (x86)Atoo NextAtoo-Sync Export ComptaShopsPrestaShopmodules
Atoo-Sync GesCom
C:program filesAtoo NextAtoo-Sync GescomShopsPrestaShopmodules
C:Program Files (x86)Atoo NextAtoo-Sync GescomShopsPrestaShopmodules
Atoo-Sync GesCom Pro
C:program filesAtoo NextAtoo-Sync GesCom ProBoutiques eCommercePrestaShopModules
C:Program Files (x86)Atoo NextAtoo-Sync GesCom ProBoutiques eCommercePrestaShopModules
Erreur lors de la création des clients dans PrestaShop
Vous pouvez trouver des informations sur les overrides directement sur le site prestashop :
https://devdocs.prestashop.com/1.7/modules/concepts/overrides/
Si dans le nom de vos client vous avez des caractères interdits par PrestaShop, Atoo-Sync ne peut pas créer le client complètement.
Il faut donc :
- Modifier le nom du client dans la Gestion Commerciale
Ou
- Faire un « override » de la classe « validate » pour forcer PrestaShop à accepter certains caractères.
Vous avez en pièce jointe de cette fiche un exemple d’override à adapter à votre besoin.
Il faut copier par FTP le fichier validate.php dans le dossier overrideclasses de PrestaShop et ensuite supprimer le fichier cacheclass_index.php pour indiquer à PrestaShop de recharger les overrides.
Si vous avez déjà un override de la classe « validate » il faut alors modifier le fichier existant.
NB : Sachez que Prestashop souhaite limiter au maximum les override et les supprimer à terme.
Par conséquent depuis Prestashop 1.7 vous ne pourrez pas effectuer cette manipulation.
Atoo-Sync ne reconnaît pas les images nommées avec la référence maître.
Uniquement les références de déclinaisons sont prises en compte.
