Connecteur Sellsy PrestaShop – Documentation
Installer, connecter et synchroniser PrestaShop avec Sellsy via l'API v2.
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
- Depuis le back-office PrestaShop, allez dans Modules > Gestionnaire de modules.
- Cliquez sur Installer un module et téléversez le fichier
dfsellsy.zip. - 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.
- Dans Sellsy, ouvrez Menu > Réglages > Portail développeur.
- Dans l’onglet API V2, cliquez sur Créer un accès API.
- 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).
- 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.