Aller au contenu
0
0

Retour à la documentation

Sellsy WooCommerce PRO

Aperçu des fonctionnalités (Vidéo)

Introduction

Sellsy WooCommerce relie votre boutique WooCommerce à Sellsy. L’extension existe en deux versions :

  • Version gratuite (FREE) — création manuelle de factures Sellsy, synchronisation du client, champs SIRET et n° de TVA au checkout, délai de paiement, mode brouillon / finalisé, téléchargement PDF, ouverture du document dans Sellsy, colonne dans la liste des commandes et téléchargement client depuis Mon compte.
  • Version PRO — automatisation selon les statuts et une condition d’émission (toutes / avec SIRET / sans SIRET), avoirs liés à la facture, e-mails PDF, autoliquidation UE (B2B), régime OSS (B2C), textes d’introduction et de clôture, langue du document, actions groupées et relances automatiques en cas d’échec temporaire. Nécessite la version FREE installée et active, ainsi qu’une licence PRO valide.

Cette documentation décrit la configuration et les fonctionnalités des deux versions. Les fonctionnalités PRO restent verrouillées tant que la licence n’est pas active.

1. Créer un accès dans Sellsy

Important : chaque boutique utilise son propre accès dans Sellsy (Client ID et Client Secret). Il n’y a pas d’identifiants partagés fournis par Devikit : vous créez les vôtres dans votre compte Sellsy, puis vous les collez dans WordPress.

Génération des identifiants

  1. Connectez-vous à Sellsy.
  2. Allez dans Réglages → Portail Développeur → API v2.
  3. Cliquez sur Créer un accès API, choisissez un accès Personnel et associez un collaborateur.
  4. Sélectionnez les autorisations nécessaires : sociétés, particuliers, contacts, factures, avoirs, taxes et fichiers — ou cochez l’ensemble des droits si vous préférez simplifier.
  5. Copiez le Client ID et le Client Secret. Le secret n’est affiché qu’une seule fois : conservez-le en lieu sûr.

Si le secret est compromis, révoquez l’accès dans Sellsy, créez-en un nouveau, puis mettez à jour l’onglet Connexion Sellsy dans WooCommerce.

2. Installation de l’extension

Version FREE

  1. Téléchargez le ZIP : invoicing-integration-for-sellsy-and-woocommerce-1.0.0.zip.
  2. Dans WordPress : Extensions → Ajouter → Téléverser une extension.
  3. Activez Invoicing Integration for Sellsy and WooCommerce.

Version PRO

  1. Assurez-vous que la version FREE est installée et active. PRO complète FREE et ne fonctionne pas sans elle.
  2. Téléversez et activez le ZIP PRO reçu après l’achat.
  3. Allez dans WooCommerce → Sellsy → Licence et activez votre clé de licence.

3. Configuration de la connexion

Chemin : WooCommerce → Sellsy → Connexion Sellsy.

  1. Collez le Client ID et le Client Secret.
  2. Cliquez sur Enregistrer les modifications.
  3. Cliquez sur Tester la connexion pour vérifier que les identifiants fonctionnent.

Si le champ Client Secret est laissé vide lors d’un nouvel enregistrement, l’extension conserve le secret déjà enregistré. Après un test réussi, vous pouvez passer aux onglets Documents et Commande.

4. Paramètres du formulaire de commande (Checkout)

Chemin : WooCommerce → Sellsy → Commande.

Ces réglages contrôlent l’affichage et la validation des champs SIRET et Numéro de TVA pour vos clients B2B.

Affichage des champs

  • Toujours afficher — SIRET et/ou TVA restent visibles dans le formulaire.
  • Case « Je souhaite une facture » — sur le checkout classique, les champs n’apparaissent qu’après cochage. Vous pouvez personnaliser le libellé (valeur par défaut : « Je souhaite une facture »).
  • Masqué (TVA uniquement) — si vous ne souhaitez pas demander le n° de TVA.

Validation et champs obligatoires

  • Valider le format SIRET — exactement 14 chiffres.
  • Valider le format TVA — code pays à 2 lettres suivi de 2 à 13 chiffres (ex. FR12345678901, DE123456789).
  • SIRET / TVA obligatoires — utiles si vous vendez principalement à des professionnels.

WooCommerce Blocks

L’extension prend en charge le checkout Blocks (WooCommerce 8.8+). Les champs SIRET et TVA apparaissent dans la section adresse de facturation. La case « Je souhaite une facture » n’est pas proposée sur Blocks : les champs suivent alors le mode d’affichage configuré (visibles selon les réglages).

Compatibilité avec d’autres extensions TVA

Si une extension tierce gère déjà le n° de TVA (par ex. WooCommerce EU VAT Number, EU VAT for WooCommerce, Germanized, Flexible Invoices), Sellsy ne duplique pas ce champ et réutilise la valeur existante. Le champ SIRET reste géré par Sellsy.

5. Configuration des documents

Chemin : WooCommerce → Sellsy → Documents.

Mode de finalisation

  • Brouillon — la facture est créée dans Sellsy sans être finalisée : vous pouvez encore la modifier dans Sellsy.
  • Finalisé — la facture est complétée dans Sellsy après création : un numéro de document est attribué.

Délai de paiement

Nombre de jours (0 à 60) appliqué à chaque facture comme délai de règlement dans Sellsy. Valeur par défaut : 7 jours. Ce réglage est disponible en FREE et en PRO.

Correspondance automatique des taxes

Vous n’avez pas à associer manuellement chaque produit à une taxe. L’extension lit le taux appliqué sur chaque ligne WooCommerce (produits, livraison, frais) et cherche la taxe Sellsy active correspondante.

  • Assurez-vous que vos taux WooCommerce et vos taxes Sellsy sont correctement configurés et actifs.
  • Si vous facturez avec des taux français non standard (autres que les taux courants déjà présents dans Sellsy), ajoutez également ces taxes dans votre compte Sellsy. Sinon la facture ne pourra pas être créée.
  • Si aucune taxe Sellsy ne correspond au taux de la ligne, la création de facture échoue avec un message explicite dans la commande.
  • La catégorie de taux Sellsy utilisée est celle marquée par défaut dans votre compte Sellsy.

Synchronisation du client dans Sellsy

Avant chaque facture, l’extension crée ou met à jour le client Sellsy à partir de l’adresse de facturation WooCommerce :

  • Société si une raison sociale, un SIRET ou un n° de TVA est présent ; sinon particulier.
  • Recherche préalable par e-mail pour éviter les doublons, puis mise à jour ou création.
  • Pour une société française : SIRET et TVA transmis dans les champs légaux Sellsy.
  • Adresses de facturation et de livraison synchronisées côté Sellsy.

La commande doit disposer d’une adresse de facturation complète (e-mail, adresse, ville, code postal, pays) pour pouvoir créer une facture.

Contenu de la facture

Les lignes WooCommerce (produits, livraison, frais) sont envoyées comme lignes libres Sellsy. Le SKU peut être transmis en référence. Un éventuel écart d’arrondi est corrigé sur la dernière ligne.

6. Options documents PRO

Chemin : WooCommerce → Sellsy → Documents (licence PRO active).

Autoliquidation UE (B2B) — Reverse Charge

Lorsque l’option est activée (par défaut : oui), l’autoliquidation est appliquée si :

  • le client a un n° de TVA,
  • une raison sociale ou un SIRET est présent,
  • le pays de facturation est un pays de l’UE hors France.

Dans ce cas, l’extension applique une taxe d’autoliquidation dans Sellsy (ou un taux 0 % si besoin).

Régime OSS (B2C)

Lorsque l’option est activée (par défaut : oui), le régime OSS s’applique pour un client de l’UE hors France sans n° de TVA ni raison sociale. Les taux utilisés sont ceux déjà calculés par WooCommerce pour le pays du client : vérifiez donc vos taux de taxe WooCommerce pour les pays concernés.

Texte d’introduction et texte de clôture

Ces textes sont ajoutés à la note du document Sellsy. Variables disponibles :

{order_id}, {order_number}, {order_date}, {order_date_raw}, {customer_name}, {customer_first_name}, {customer_last_name}, {customer_email}, {customer_phone}, {billing_company}, {billing_vat_id}, {billing_address}, {shipping_address}, {order_total}, {order_total_formatted}, {payment_method}, {shipping_method}

Langue de la facture

Choisissez une langue parmi celles disponibles dans votre compte Sellsy, ou laissez la langue du compte par défaut.

7. Automatisation (PRO uniquement)

Chemin : WooCommerce → Sellsy → Automatisation.

Génération automatique des factures

  • Activer l’automatisation — crée une facture Sellsy lorsque la commande passe à un statut sélectionné.
  • Condition d’émission — pour toutes les commandes, uniquement lorsque le SIRET est renseigné, ou uniquement lorsque le SIRET n’est pas renseigné.
  • Statuts de commande — par défaut : En cours et Terminée. Vous pouvez cocher d’autres statuts WooCommerce (hors brouillon de checkout).
  • Envoyer le PDF facture — déclenche l’e-mail WooCommerce dédié avec le PDF en pièce jointe après création.

Avoirs automatiques

  • Avoir automatique — crée un avoir Sellsy lorsqu’un remboursement WooCommerce est enregistré, si une facture Sellsy existe déjà pour la commande.
  • Envoyer le PDF avoir — e-mail dédié avec le PDF en pièce jointe.

Relances en cas d’échec

Si la création automatique de facture échoue pour une erreur temporaire côté Sellsy, PRO réessaie automatiquement plusieurs fois, avec un délai entre chaque tentative.

8. Avoirs (PRO uniquement)

Un avoir Sellsy peut être créé :

  • manuellement depuis le panneau Sellsy de la commande,
  • automatiquement à l’enregistrement d’un remboursement WooCommerce (si l’option est active),
  • ou via les actions groupées.

Prérequis :

  • licence PRO active,
  • facture Sellsy déjà créée pour la commande,
  • au moins un remboursement WooCommerce enregistré.

L’avoir est validé puis lié à la facture d’origine dans Sellsy. Les lignes suivent le remboursement WooCommerce (articles, livraison, frais). Une seule avoir Sellsy est gérée par commande. Le PDF est téléchargeable en admin, en actions groupées et depuis Mon compte ; il peut aussi être envoyé par e-mail.

9. Actions groupées (PRO uniquement)

Depuis la liste des commandes WooCommerce, sélectionnez plusieurs commandes puis :

  • Créer des factures Sellsy
  • Créer des avoirs Sellsy
  • Télécharger les PDF Sellsy — archive ZIP regroupant les documents disponibles.

Le traitement est séquentiel avec barre de progression, puis un récapitulatif des succès et des erreurs.

10. Gestion des commandes (panneau administrateur)

Sur l’écran d’édition d’une commande, le panneau Sellsy regroupe les actions liées au document.

FREE et PRO

  • Créer la facture — génération manuelle.
  • Télécharger le PDF.
  • Ouvrir dans Sellsy — lien direct vers le document.
  • Affichage du numéro, du statut (brouillon / finalisé / payée) et de la dernière erreur en cas d’échec.

PRO uniquement

  • Envoyer la facture par e-mail.
  • Créer un avoir, télécharger le PDF avoir, envoyer l’avoir par e-mail, ouvrir l’avoir dans Sellsy.

Colonne dans la liste des commandes

Une colonne Facture Sellsy affiche le statut / numéro du document et un accès rapide au PDF. En PRO, la ligne avoir (et son PDF) apparaît également.

11. Téléchargement des documents par les clients

  1. Le client se connecte à la boutique.
  2. Il ouvre Mon compte → Commandes → Voir pour la commande concernée.
  3. Si une facture Sellsy existe : bouton Télécharger la facture.
  4. En PRO, si un avoir existe : bouton Télécharger l’avoir.

Le téléchargement est sécurisé : seul le propriétaire de la commande (ou un administrateur) peut accéder au PDF.

12. E-mails PDF (PRO uniquement)

PRO enregistre deux e-mails WooCommerce dédiés (réglables dans WooCommerce → Réglages → E-mails) :

  • Facture Sellsy — e-mail dédié avec le PDF de facture en pièce jointe.
  • Avoir Sellsy — e-mail dédié avec le PDF d’avoir en pièce jointe.

Ils peuvent être déclenchés automatiquement (onglet Automatisation) ou manuellement depuis la commande. Selon les options d’automatisation, le PDF peut aussi être joint aux e-mails WooCommerce standards (commande en cours, terminée, facture client).

13. Paramètres avancés

Chemin : WooCommerce → Sellsy → Avancé.

Journaux de diagnostic

Activez les journaux uniquement en cas de besoin de diagnostic. Consultez ensuite WooCommerce → État → Journaux et ouvrez le journal Sellsy. Les identifiants sensibles y sont masqués.

Désinstallation

Option Conserver les réglages et les données de commande lors de la désinstallation. Si elle n’est pas cochée, la désinstallation FREE peut supprimer les réglages, les identifiants de connexion et les informations Sellsy liées aux commandes. La désinstallation PRO peut supprimer les réglages PRO et les données de licence (sous réserve de la même option de conservation).

14. Licence (PRO uniquement)

Chemin : WooCommerce → Sellsy → Licence.

  1. Saisissez la clé reçue après l’achat.
  2. Cliquez sur Activer.
  3. Le statut doit passer à actif.

Sans licence valide, l’automatisation, les avoirs, les actions groupées, les textes / langue / autoliquidation / OSS et les e-mails PDF restent indisponibles. Vous pouvez désactiver la licence pour la déplacer vers un autre domaine. Avec une licence active, PRO reçoit les mises à jour dans l’administration WordPress.

15. Limitations et points d’attention

  • Taxes Sellsy — chaque taux WooCommerce doit avoir une taxe Sellsy correspondante. Pour des taux français non standard, créez-les aussi dans Sellsy. Sinon la facture ne peut pas être créée.
  • Autoliquidation — nécessite n° de TVA + (société ou SIRET) + pays UE hors France, et une taxe d’autoliquidation (ou 0 %) active dans Sellsy.
  • OSS — repose sur les taux WooCommerce du pays de destination ; vérifiez votre configuration fiscale.
  • Avoirs — un seul avoir Sellsy par commande ; un remboursement WooCommerce est obligatoire.
  • Multi-devises — la devise de la commande WooCommerce est reprise sur le document Sellsy (ex. EUR, USD, GBP, CHF). Les devises doivent être disponibles dans votre compte Sellsy.

16. Support et liens utiles

Support : formulaire de contact ou hi@devikit.fr.

FAQ

Faut-il la version gratuite ?
Oui. PRO complète FREE et ne fonctionne pas sans elle.

Y a-t-il un quota de factures dans l’extension ?
Non. Les limites éventuelles dépendent de votre abonnement Sellsy, pas d’un plafond imposé par le plugin.

Puis-je facturer seulement les commandes avec SIRET ?
Oui, via la condition d’émission en PRO (Uniquement lorsque le SIRET est renseigné). L’inverse (sans SIRET) est aussi disponible.

Le délai de paiement est-il disponible en FREE ?
Oui. Il se configure dans l’onglet Documents (0 à 60 jours).

Quelle est la différence entre brouillon et finalisé ?
Le brouillon reste modifiable dans Sellsy. Le mode finalisé complète le document et lui attribue un numéro.

Pourquoi la création de facture échoue-t-elle sur les taxes ?
Le taux WooCommerce de la ligne n’a probablement pas de taxe Sellsy active correspondante. Créez / activez la taxe dans Sellsy (y compris pour les taux français non standard), puis réessayez.

Puis-je créer un avoir sans remboursement WooCommerce ?
Non. Créez d’abord un remboursement dans WooCommerce, puis générez l’avoir (manuel, automatique ou en masse).

L’extension marque-t-elle la facture comme payée dans Sellsy ?
Non. Cette intégration ne gère pas le marquage automatique « payée » ni le lettrage des paiements.

Les champs SIRET / TVA fonctionnent-ils avec WooCommerce Blocks ?
Oui. Ils apparaissent dans l’adresse de facturation. La case « Je souhaite une facture » est propre au checkout classique.