# Connecteur Sellsy PrestaShop – Documentation > Guide complet du connecteur Sellsy pour PrestaShop 8 et 9 : installation, création de l'accès API Sellsy v2, configuration, synchronisation des clients, commandes, factures, paiements et avoirs, cron et dépannage. - Page: - Langue: fr - Mis à jour le: 2026-07-06 - Autres langues: [en](https://www.datafirefly.com/en/documentation/connecteur-sellsy-prestashop/index.md), [es](https://www.datafirefly.com/es/documentation/connecteur-sellsy-prestashop/index.md), [de](https://www.datafirefly.com/de/documentation/connecteur-sellsy-prestashop/index.md), [it](https://www.datafirefly.com/it/documentation/connecteur-sellsy-prestashop/index.md), [pl](https://www.datafirefly.com/pl/documentation/connecteur-sellsy-prestashop/index.md), [nl](https://www.datafirefly.com/nl/documentation/connecteur-sellsy-prestashop/index.md), [pt](https://www.datafirefly.com/pt/documentation/connecteur-sellsy-prestashop/index.md) - Index: ## Présentation Le connecteur Sellsy de DataFirefly relie votre boutique PrestaShop à **Sellsy**, la solution SaaS française de CRM, facturation et gestion. Il synchronise automatiquement vos clients, produits, commandes, factures, paiements et avoirs de PrestaShop vers Sellsy via l'**API Sellsy v2**. La synchronisation est unidirectionnelle : PrestaShop → Sellsy. Compatible PrestaShop 8.0 à 9.x, multiboutique. Interface d'administration en français et anglais. ## Installation 1. Depuis le back-office PrestaShop, allez dans _Modules > Gestionnaire de modules_. 2. Cliquez sur _Installer un module_ et téléversez le fichier `dfsellsy.zip`. 3. Une fois installé, cliquez sur _Configurer_. Le module crée deux tables (`dfsellsy_link` pour la correspondance PrestaShop ↔ Sellsy, `dfsellsy_log` pour le journal) et un onglet « Sellsy Connector » dans le menu Modules. ## Créer l'accès API dans Sellsy Le connecteur utilise l'authentification OAuth2 (client credentials) de l'API v2. 1. Dans Sellsy, ouvrez _Menu > Réglages > Portail développeur_. 2. Dans l'onglet _API V2_, cliquez sur _Créer un accès API_. 3. Choisissez le collaborateur lié à l'accès (de préférence un administrateur, pour disposer de tous les droits) et cochez les scopes nécessaires (clients, documents, catalogue, paiements). 4. Enregistrez, puis copiez le **Client ID** et le **Client Secret**. Le Client Secret n'est affiché qu'une seule fois. Conservez-le en lieu sûr avant de quitter la page Sellsy. ## Configuration du module Sur la page de configuration du module, renseignez : - **Client ID** et **Client Secret** : les identifiants OAuth2 créés dans Sellsy. Laissez le champ secret vide pour conserver la valeur déjà enregistrée. - **Synchroniser les clients** : crée/met à jour un tiers Sellsy à l'inscription et à la mise à jour d'un client. - **Synchroniser les commandes** : transforme les commandes en documents Sellsy. - **Type de document Sellsy pour les commandes** : facture ou bon de commande. - **Déclencheur de synchronisation des commandes** : à la confirmation du paiement ou à la validation de la commande. - **Valider les documents Sellsy** : valide automatiquement factures et avoirs après création (sinon ils restent en brouillon dans Sellsy). - **Enregistrer les paiements** : enregistre les règlements PrestaShop sur la facture Sellsy (uniquement en type facture). - **Synchroniser les remboursements en avoirs** : crée un avoir Sellsy à chaque avoir PrestaShop et le lie à la facture d'origine. - **Synchroniser les produits** : pousse le catalogue vers les items Sellsy. Utilisez le bouton _Tester la connexion API_ pour vérifier vos identifiants avant d'activer les synchronisations. ## Synchronisation des clients À l'inscription ou à la mise à jour d'un client, le module crée ou met à jour un tiers Sellsy. Les clients avec un champ « société » renseigné deviennent des **sociétés** Sellsy (avec le SIRET si disponible), les autres des **particuliers**. Une recherche par e-mail évite les doublons, et l'adresse de facturation principale est remontée à la création. ## Synchronisation des commandes Selon le déclencheur choisi, une commande validée ou payée devient un document Sellsy comportant les lignes produits, les frais de port et les remises panier (en ligne négative). Les taux de TVA PrestaShop sont automatiquement mis en correspondance avec les taxes Sellsy. Chaque commande n'est synchronisée qu'une seule fois (idempotence). ## Factures, validation et paiements Lorsque le type de document est « facture » : - si l'option _Valider les documents_ est active, la facture est validée automatiquement après création ; - si l'option _Enregistrer les paiements_ est active, chaque règlement PrestaShop est enregistré sur la facture, sans doublon, y compris les paiements partiels ou multiples ; - si la commande a été créée à la validation et que le paiement arrive plus tard, le module enregistre uniquement les nouveaux règlements sur la facture existante. ## Avoirs sur remboursement À la génération d'un avoir PrestaShop, le module crée un avoir Sellsy à partir des lignes remboursées (produits et port), le valide si l'option est active, puis le rattache à la facture d'origine lorsque celle-ci existe côté Sellsy. ## Synchronisation des produits La synchronisation des produits est optionnelle. Une fois activée, les produits sont poussés vers le catalogue Sellsy à la création et à la mise à jour. Vous pouvez aussi lancer une synchronisation de masse depuis la page « Sellsy Connector » (traitement par lots de 20). ## Tâches planifiées (cron) Un cron intégré permet de rattraper ce que les hooks temps réel auraient manqué. Planifiez les URL affichées sur la page de configuration : - `.../module/dfsellsy/cron?token=VOTRE_TOKEN&job=orders` - `...&job=customers` - `...&job=products` - `...&job=retry` (relance les entités en erreur non encore liées) Le paramètre `limit` (par défaut 20, max 100) contrôle la taille du lot par exécution. ## Journal de synchronisation La page « Sellsy Connector » affiche un journal filtrable (par entité et par statut) de chaque opération, avec le message renvoyé par Sellsy en cas d'erreur. Un bouton _Relancer les erreurs_ rejoue les échecs en un clic. ## Dépannage - **« Connexion échouée »** : vérifiez le Client ID / Client Secret et que les scopes nécessaires sont bien cochés dans Sellsy. - **Une erreur sur un champ de document (HTTP 422)** : certains comptes Sellsy ont des exigences spécifiques (mentions e-invoicing, champs obligatoires). Consultez le message du journal pour identifier le champ concerné. - **Doublons de tiers** : le module recherche par e-mail avant création ; assurez-vous que l'e-mail client est bien renseigné. - **Rien ne se synchronise** : vérifiez que les options concernées sont actives et testez la connexion API.