Facture électronique Sylius : plugin, API et intégration
Pour une intégration de la facture électronique avec Sylius en France, il n'existe pas à ma connaissance de solution officielle clé en main. Le plugin de facturation officiel crée les factures, un plugin communautaire peut y ajouter le format Factur-X, et la liaison par API avec une plateforme agréée reste un développement à prévoir. Le chantier se découpe donc en quatre : données, format, transmission et e-reporting. Mon conseil est de cadrer ces quatre points avant d'installer quoi que ce soit.
Ce que fait la pile Sylius aujourd'hui
Le Sylius Invoicing Plugin, sous licence MIT, crée une facture immuable lorsque la commande atteint un état donné (par défaut, à sa création) et permet au client comme à l'administrateur de la télécharger. Son dépôt signale aussi une collecte de télémétrie, à regarder pour votre conformité interne. Ce plugin produit un document de facture, mais pas un flux de facture électronique au sens de la réforme.
C'est là qu'intervient tmonier/sylius-facturx-plugin, un paquet tiers maintenu par une personne et non par Sylius. Il convertit le PDF du plugin officiel en PDF/A-3 contenant un fichier factur-x.xml au profil EN 16931, ce qui en fait un format mixte. Je n'ai pas audité son code : je le cite parce que sa fiche est précise sur ses limites, ce qui est déjà un bon signe à vérifier ensuite par une lecture du code.
| Besoin | Plugin officiel | Plugin Factur-X tiers | Reste à faire |
|---|---|---|---|
| Créer et stocker une facture | Oui | S'appuie dessus | Vérifier l'état déclencheur |
| Format structuré | Non indiqué | Factur-X EN 16931 | Tester avec votre plateforme |
| Identifiants du client professionnel | Non indiqué | Saisis par un administrateur | Les collecter à la commande |
| Avoirs et factures d'acompte | À vérifier | Non couverts | À développer si vous en émettez |
| Envoi à une plateforme agréée | Non | Non, mais un événement expose le XML et le PDF | Connecteur API |
| E-reporting | Non | Non | Extraction et envoi des données |
Les quatre chantiers de l'intégration
Le premier concerne les données. L'administration demande des mentions dans un champ dédié, comme le SIREN du fournisseur et du client. Or le tunnel d'achat d'une boutique ne demande souvent rien de tel. Il faut savoir qui est un professionnel français, recueillir son SIREN, et décider quoi faire s'il se trompe. Le plugin tiers indique que ces identifiants sont saisis par un administrateur, ce qui devient vite intenable à partir d'un certain volume.
Le deuxième concerne le format, celui de la liste officielle : UBL, CII ou format mixte. Une plateforme peut convertir certains flux, et c'est donc à vérifier avec elle avant de choisir votre méthode. Le troisième est la transmission : envoyer la facture, récupérer les statuts, gérer les rejets, et les afficher quelque part. Le connecteur dépend de la plateforme choisie, et c'est sa documentation d'API qui guide ce travail. Pensez aux erreurs : une facture rejetée à 2 heures du matin ne doit pas disparaître silencieusement.
Le quatrième est le e-reporting. Vos ventes à des particuliers et certaines opérations internationales impliquent une transmission de données. Pour une boutique grand public, c'est même le sujet central, et il touche aussi les données de paiement. Sur ce point, votre comptable doit valider les catégories et les règles de TVA : je m'occupe de la mécanique logicielle, pas de la qualification fiscale.
Le calendrier et votre version de Sylius
Si votre entreprise est une PME, l'émission s'impose au plus tard le 1er septembre 2027. La réception s'applique déjà depuis le 1er septembre 2026, mais elle touche vos factures fournisseurs et se règle rarement dans Sylius. Le détail figure dans mon article sur le calendrier de la réforme.
La version compte aussi. Le plugin Factur-X demande Sylius 2.2 ou 2.3, PHP 8.2 ou plus, et Symfony 6.4, 7.4 ou 8.0. Si votre boutique tourne encore en 1.14, dont le support de sécurité s'arrête le 31 décembre 2026, il serait dommage de financer une intégration sans se demander si la mise à niveau doit passer avant. Je ne dis pas qu'il faut toujours commencer par elle, mais les deux décisions doivent être prises ensemble.
Ce que vous devez demander à votre prestataire
Quelques questions suffisent à évaluer une proposition. Quelle plateforme agréée est visée, et figure-t-elle sur la liste officielle ? Comment le SIREN sera-t-il recueilli et contrôlé ? Que se passe-t-il pour un avoir, un remboursement partiel ou une facture rejetée ? Comment le e-reporting est-il couvert ? Qui surveille les erreurs une fois en production ? Si un plugin tiers est utilisé, qui le reprend si son auteur l'abandonne ? Une réponse qui se résume à « nous installons un plugin » ne répond qu'à un quart du sujet.
Quand cette intégration n'est pas la bonne solution
Tout développement n'est pas justifié. Si votre boutique envoie déjà ses commandes vers un logiciel comptable ou un ERP qui émet les factures, c'est peut-être à cet outil de porter l'obligation, et Sylius n'a alors qu'à lui passer des données propres. C'est souvent la voie la plus simple : posez d'abord la question à son éditeur et à votre comptable. À l'inverse, une entreprise avec de nombreuses entités et un SI très complexe aura besoin d'un intégrateur plus important qu'un développeur indépendant.
Je propose cette intégration, j'ai donc un intérêt dans le sujet, et je n'ai pas de boutique Sylius à vous présenter comme référence sur ce point précis. Mon expérience de Sylius vient notamment de la reprise de Coucouroucoucou, environ 15 000 commandes reprises avec clients et factures.
La prochaine étape
Faites l'inventaire de vos flux : ventes B2B en France, ventes aux particuliers, ventes à l'étranger, avoirs. Notez votre version de Sylius et l'outil qui fait foi pour votre comptabilité. Avec ces éléments, je peux vous dire précisément ce qui reste à faire, depuis la page intégration de la facturation électronique ou la page développeur Sylius freelance.