Alles, was Sie wissen sollten bevor Sie installieren.
Ein detaillierter Blick darauf, wie DataFirefly Factur-X SW — E-Rechnung für Shopware 6: ZUGFeRD & XRechnung 3.0 funktioniert, warum wir es so gebaut haben und der Gedanke hinter den Funktionen oben.
Die E-Rechnung ist keine Option mehr
Seit Januar 2025 muss jedes Unternehmen in Deutschland B2B-E-Rechnungen empfangen können, und die Ausstellungspflicht greift stufenweise bis 2028. Der B2G-Bereich verlangt bereits XRechnung mit Leitweg-ID. In Frankreich schreibt das Factur-X-Mandat den Empfang ab September 2026 und die Ausstellung 2026-2027 je nach Unternehmensgröße vor. Wenn Ihr Shopware-Shop B2B verkauft oder Behörden Rechnungen stellt, wird die EN 16931 konforme E-Rechnung zur Voraussetzung dafür, bezahlt zu werden.
Was das native Shopware nicht abdeckt
Shopware bietet seit Version 6.6.10 eine einfache ZUGFeRD-Ausgabe, erzeugt aber keine XRechnung 3.0, kennt keine Leitweg-ID, existiert nicht auf den älteren Versionen 6.5 und 6.6, und die Verkäuferdaten bleiben auf die Dokumenteinstellungen beschränkt. DfFacturX ist eine vollständige Compliance-Suite: mehrere Profile, umfangreiche Verkäuferdaten je Verkaufskanal, SEPA-Zahlungsangaben, automatische Steuerkategorien, E-Mail-Anhang und Werkzeuge zur Neuerzeugung.
XRechnung 3.0 und Leitweg-ID, ohne Umwege
Eine Rechnung an eine deutsche Behörde erfordert ein XRechnung-XML mit der Käuferreferenz BT-10 — der Leitweg-ID — für die Shopware keinen Speicherort kennt. Das Plugin legt bei der Aktivierung ein eigenes Zusatzfeld am Kunden und an der Bestellung an: einmal am Kunden hinterlegt, wird die Leitweg-ID auf allen seinen Rechnungen übernommen, mit Überschreibung je Bestellung und konfigurierbarem Fallback. Das erzeugte XML enthält den Peppol-Geschäftsprozess, den Verkäuferkontakt BG-6 und die vom KOSIT-Validator geforderten elektronischen Adressen.
Ein Hybrid-PDF, kein weiteres Dokument
Bei den Profilen Factur-X und ZUGFeRD wird das XML per inkrementellem Update direkt in das von Shopware erzeugte Rechnungs-PDF eingebettet: angehängte Datei factur-x.xml, AF-Beziehung vom Typ Data, PDF A-3 XMP-Metadaten mit vollständigem Factur-X Extension Schema. Das Dokumentmedium wird an Ort und Stelle ersetzt — das PDF, das Ihr Kunde aus seinem Konto herunterlädt oder per E-Mail erhält, ist die hybride E-Rechnung. Verhindert eine exotische PDF-Struktur die Einbettung, degradiert das Plugin sauber: das XML bleibt als E-Mail-Anhang und per Konsole verfügbar, und eine Warnung wird protokolliert.
Ein Rechnungsmodell, das die Validatoren besteht
Die EN 16931 ist anspruchsvoll: Nettobeträge, keine negativen Positionen, Steueraufschlüsselung je Kategorie, centgenaue Summen. DfFacturX rechnet Brutto-Bestellungen über die kalkulierten Steuern von Shopware ins Nettomodell um, wandelt Promotions in Nachlässe auf Dokumentebene mit Aufschlüsselung je Steuersatz um, weist Versandkosten als Dokumentzuschläge aus und nutzt das Feld RoundingAmount BT-114, um jede Rundungsdifferenz abzufangen: die Endsumme im XML entspricht immer exakt dem Bestellwert in Shopware. Nullsteuersätze erhalten automatisch die richtige Kategorie — K innergemeinschaftlich, G Ausfuhr, Z — samt Befreiungsgrund.
Automatisch, und niemals blockierend
Die Erzeugung startet bei der Erstellung des Rechnungsdokuments, unabhängig vom Kanal: Admin, Flow Builder oder API. Der Nur-B2B-Modus beschränkt die Erzeugung auf gewerbliche Bestellungen. Das XML wird automatisch an Bestell-E-Mails angehängt. Und per Design blockiert ein E-Rechnungsfehler niemals die Erstellung der Rechnung selbst: der Vorfall wird protokolliert, und der Konsolenbefehl df:facturx:generate ermöglicht die Neuerzeugung nach der Korrektur, mit Profilwechsel im Aufruf und XML-Export in eine Datei.
Validieren Sie vor dem Livegang
Die Dokumentation enthält eine vollständige Validierungs-Checkliste: Brutto- und Netto-Bestellungen, Rabatt, Versandkosten, innergemeinschaftliche Lieferung mit USt-IdNr., Ausfuhr in Drittländer. Exportieren Sie das XML mit einem Befehl und prüfen Sie es mit dem KOSIT-Validator für XRechnung oder dem Mustang-Validator für Factur-X und ZUGFeRD. Sie gehen live und wissen genau, was Ihre Kunden und deren Buchhaltungssysteme erhalten.
Es gibt noch keine Rezensionen.