Tout ce que vous voudriez savoir avant d'installer.
Un regard détaillé sur le fonctionnement de DataFirefly Factur-X SW — Facture électronique Shopware 6 : ZUGFeRD & XRechnung 3.0, pourquoi nous l'avons conçu ainsi, et la réflexion derrière les fonctionnalités ci-dessus.
La facture électronique n'est plus optionnelle
En Allemagne, toute entreprise doit pouvoir recevoir des e-factures B2B depuis janvier 2025, et l'obligation d'émission se déploie par paliers jusqu'en 2028. Le B2G exige déjà XRechnung avec Leitweg-ID. En France, le mandat Factur-X impose la réception dès septembre 2026 et l'émission en 2026-2027 selon la taille de l'entreprise. Si votre boutique Shopware vend en B2B ou facture des administrations, l'e-facture conforme EN 16931 devient une condition pour être payé.
Ce que le natif Shopware ne couvre pas
Shopware propose une sortie ZUGFeRD basique depuis la version 6.6.10, mais elle ne produit pas de XRechnung 3.0, ne gère pas le Leitweg-ID, n'existe pas sur les versions 6.5 et 6.6 antérieures, et ses données vendeur restent limitées aux réglages de document. DfFacturX est une suite de conformité complète : profils multiples, données vendeur riches par canal de vente, instructions de paiement SEPA, catégories TVA automatiques, pièce jointe e-mail et outillage de régénération.
XRechnung 3.0 et Leitweg-ID, sans bricolage
Facturer une administration allemande exige un XML XRechnung avec une référence acheteur BT-10 — le Leitweg-ID — que Shopware ne sait pas stocker. Le plugin installe à l'activation un champ personnalisé dédié sur la fiche client et sur la commande : saisissez le Leitweg-ID une fois sur le client, il est repris sur toutes ses factures, avec possibilité de le surcharger commande par commande et une valeur de repli configurable. Le XML produit inclut le processus métier Peppol, le contact vendeur BG-6 et les adresses électroniques exigées par le validateur KOSIT.
Un PDF hybride, pas un document de plus
Pour les profils Factur-X et ZUGFeRD, le XML est embarqué directement dans le PDF de facture généré par Shopware, par mise à jour incrémentale : fichier factur-x.xml attaché, relation AF de type Data, métadonnées XMP PDF A-3 avec le schéma d'extension Factur-X complet. Le média du document est remplacé en place — le PDF que votre client télécharge depuis son compte ou reçoit par e-mail est l'e-facture hybride. Si une structure PDF exotique empêche l'embedding, le plugin bascule proprement : le XML reste disponible en pièce jointe e-mail et via la console, et un avertissement est journalisé.
Un modèle comptable qui passe les validateurs
La norme EN 16931 est exigeante : montants nets, lignes négatives interdites, ventilation TVA par catégorie, totaux cohérents au centime. DfFacturX convertit les commandes TTC en modèle net via les taxes calculées de Shopware, transforme les promotions en remises au niveau document avec leur ventilation par taux, déclare les frais de port en charges document, et utilise le champ RoundingAmount BT-114 pour absorber toute dérive d'arrondi : le GrandTotal du XML est toujours strictement égal au total de la commande Shopware. Les taux à 0 pour cent reçoivent automatiquement la bonne catégorie — K intracommunautaire, G export, Z — avec motif d'exonération.
Automatique, et jamais bloquant
La génération se déclenche à la création du document de facture, quel que soit le canal : admin, Flow Builder ou API. Le mode B2B uniquement restreint la génération aux commandes professionnelles. Le XML est joint automatiquement aux e-mails de commande. Et par conception, une erreur d'e-facture ne bloque jamais la création de la facture elle-même : l'incident est journalisé et la commande console df:facturx:generate permet de régénérer après correction, avec changement de profil à la volée et export du XML vers un fichier.
Validez avant la mise en production
La documentation inclut une checklist de validation complète : commandes TTC et HT, promotion, frais de port, vente intracommunautaire avec numéro de TVA, export hors UE. Exportez le XML en une commande et soumettez-le au validateur KOSIT pour XRechnung ou au validateur Mustang pour Factur-X et ZUGFeRD. Vous partez en production en sachant exactement ce que vos clients et leurs outils comptables vont recevoir.
Il n’y a pas encore d’avis.