ZUGFeRD-Rechnungen
Das ZUGFeRD Add-on ermöglicht die Erstellung von standardkonformen elektronischen Rechnungen innerhalb der PRINT LOUNGE. Die erzeugten Rechnungen enthalten einen integrierten XML-Datensatz, der automatisiert an das PDF-Dokument angehängt wird. Dies unterstützt eine medienbruchfreie, digitale Verarbeitung sowie eine revisionssichere Archivierung gemäß ZUGFeRD-Spezifikation.
Besonderheiten bei der Nutzung
Es müssen alle Rechnungspositionen vollständig aufgeführt werden.
Texte und Bedingungen aus der verwendeten Rechnungsvorlage werden im XML-Teil nicht übernommen.
Konfigurations- und Anwendungsleitfaden
1. Aktivierung der ZUGFeRD-Funktionalität
In den Einstellungen des ZUGFeRD Add-ons in der PRINT LOUNGE kann die Option „ZUGFeRD-Rechnungen erstellen“ aktiviert werden.
Nach Aktivierung ist die Einstellung zu speichern.
2. Konfiguration eines abweichenden Rechnungsstellers
In den Konfigurationseinstellungen besteht die Möglichkeit, einen vom Shop abweichenden Rechnungssteller zu hinterlegen.
Folgende Informationen sind dafür erforderlich:
Name des Rechnungsstellers
Adresse: Straße 1–3, PLZ, Ort, Land, ggf. Subdivision
Steuerliche Angaben: Steuernummer, USt-IdNr.
Kontaktdaten: Ansprechpartner, E-Mail, Telefonnummer
Die eingegebenen Daten werden in den XML-Anteil der Rechnung übernommen.
3. Erstellung von ZUGFeRD-Rechnungen
Die Erstellung erfolgt über den gewohnten Rechnungserstellungsprozess innerhalb der PRINT LOUNGE.
Der XML-Anteil wird dabei automatisch an das generierte PDF-Dokument angehängt.
Hinweis für Rechnungsdokumente mit Hintergrundebenen
Bei der Verwendung eines PDF-Hintergrunds für Rechnungen (z. B. Briefpapier) muss das hinterlegte Dokument ohne Komprimierung gespeichert sein. Andernfalls kann die ZUGFeRD-XML-Datei nicht korrekt mit der PDF zusammengeführt werden.
Empfehlung: Verwendung eines unkomprimierten PDF in der Version 1.3.
Übersicht: Inhalte der ZUGFeRD-Rechnung
Die ZUGFeRD-Rechnung enthält strukturierte Daten zu Verkäufer, Käufer, Positionen sowie zu zusätzlichen Kosten wie Versand oder Rabatten. Die folgende Übersicht zeigt die wichtigsten Informationen und deren Herkunft.
Verkäufer (Rechnungsaussteller)
ZUGFeRD-Feld (Beschreibung, offizieller Bezeichner, Code) | Quelle / Herkunft | Hinweise |
|---|---|---|
Verkäufer-Name (Firma)
Code: BT-1 | Shop-Firmierung oder alternativer Rechnungssteller | Name des Rechnungsausstellers |
Verkäufer-Adresse (Straße, PLZ, Ort, Land)
Code: BT-63 | Shop-Adresse oder alternative Angabe | Vollständige Adresse des Verkäufers |
Steuernummer des Verkäufers
Code: BT-92 | Shop-Steuernummer oder alternative Angabe | Steuerliche Identifikationsnummer |
USt-IdNr. Verkäufer
Code: BT-92 | Shop- oder manuell eingegebene USt-IdNr | Umsatzsteuer-ID (B2B-Relevanz) |
E-Mail Verkäufer
Code: BT-76 | Shop-Kontaktdaten | Kontakt-E-Mail |
Telefon Verkäufer
Code: BT-77 | Shop-Kontaktdaten | Kontakttelefonnummer |
Verkäufer-ID (intern)
Code: BT-3 | Automatisch generierte ID (z.B. Kundennummer) | Interne Identifikation |
Käufer (Rechnungsempfänger)
ZUGFeRD-Feld (Beschreibung, offizieller Bezeichner, Code) | Quelle / Herkunft | Hinweise |
|---|---|---|
Käufer-Name
Code: BT-71 | Rechnungsadresse aus Bestellung | Name des Rechnungsempfängers |
Käufer-Adresse (Straße, PLZ, Ort, Land)
Code: BT-72 | Rechnungsadresse aus Bestellung | Vollständige Adresse des Käufers |
USt-IdNr. Käufer
Code: BT-92 | Falls vorhanden (insb. B2B-Kunden) | Umsatzsteuer-Identifikationsnummer |
E-Mail Käufer
Code: BT-76 | Kundenkonto oder Rechnungsadresse | Kontakt-E-Mail des Käufers |
Telefon Käufer
Code: BT-77 | Kundenkonto oder Rechnungsadresse | Kontakttelefonnummer des Käufers |
Kundenreferenz / Bestellnummer
Code: BT-83 | Optional: interne Referenz | Kundeninterne Nummer oder Referenz (smarty-fähig) |
Innerhalb der Kundenreferenz steht das Order-Objekt zur Verfügung, worüber unter anderem auch der Bestellcode ausgelesen werden kann (bspw. {$order->orderCode}.
Rechnungspositionen
ZUGFeRD-Feld (Beschreibung, offizieller Bezeichner, Code) | Quelle / Herkunft | Hinweise |
|---|---|---|
|
|
|
|
|
|
Positionsnummer
Code: BT-102 | Interne Positionsnummer | Nummer der Rechnungsposition |
|
|
|
|
|
|
Produkt-/Positionsbezeichnung
Code: BT-121 | Artikel-/Service-Titel | Name des Artikels oder Services |
|
|
|
|
|
|
Produktbeschreibung (optional)
Code: BT-122 | Langbeschreibung | Beschreibung des Produkts |
|
|
|
|
|
|
Brutto-Einzelpreis
Code: BT-147 | Preis inkl. Umsatzsteuer | Einzelpreis inklusive MwSt |
|
|
|
|
|
|
Netto-Einzelpreis
Code: BT-146 | Preis exkl. Umsatzsteuer | Netto-Preis pro Einheit |
|
|
|
|
|
|
Menge
Code: BT-141 | Bestellte Stückzahl | Anzahl der bestellten Einheiten |
|
|
|
|
|
|
Mengeneinheit (Standard: Stück C62)
Code: BBT-79 | Einheit der Menge | Standard ist Stück (C62) |
Steuersatz der Position
Code: BT-150 | Umsatzsteuersatz der Position | z.B. 19 % |
Zuschläge & Abschläge (Allowance/Charge)
ZUGFeRD-Feld (Beschreibung, offizieller Bezeichner, Code) | Quelle / Herkunft | Hinweise |
|---|---|---|
Zuschläge & Abschläge (AllowanceCharge)
Code: BT-146 (AllowanceCharge) | Versandkosten, Rabatte, Zahlungsgebühren, Gutschriften | Werden als eigene Positionen abgebildet |
Gesamtsummen
ZUGFeRD-Feld (Beschreibung, offizieller Bezeichner, Code) | Quelle / Herkunft | Hinweise |
|---|---|---|
Nettobetrag (Steuerbemessungsgrundlage)
Code: BT-129 | Summe aller Nettopositionen | Basis für Steuerberechnung |
Steuerbetrag gesamt
Code: BT-130 | Gesamtsteuerbetrag | Summe der Umsatzsteuer |
Gesamtbetrag brutto
Code: BT-131 | Endbetrag inkl. Steuer und Zuschläge | Zu zahlender Gesamtbetrag |
Fälliger Betrag
Code: BT-132 | Tatsächlich fälliger Betrag | Betrag, der gezahlt werden muss |
Weitere wichtige Felder
ZUGFeRD-Feld (Beschreibung, offizieller Bezeichner, Code) | Quelle / Herkunft | Hinweise |
|---|---|---|
Rechnungsnummer
Code: BG-1 | Eindeutige Rechnungsnummer | Identifikation der Rechnung |
Rechnungsdatum
Code: BG-2 | Datum der Rechnungserstellung | Erstellungsdatum |
Liefer-/Leistungsdatum
Code: BG-5 | Datum der Lieferung oder Leistung | Relevantes Leistungsdatum |
Zahlungsziel (Fälligkeitsdatum)
Code: BT-68 | Zahlungsfrist | Fälligkeitsdatum der Zahlung |
Kunden-Referenz aus Auftrag
Code: BG-23 | Kundeninterne Referenz (z.B. Bestellnummer) | Optional, interne Referenz |
Steuerkennzeichnungen (TaxCategoryCode)
Code | Bedeutung |
|---|---|
S | Regulär besteuert (z.B. 19 %) |
Z | Steuerfrei (z.B. Auslandsgeschäft) |
ZZZ | Sonstige / nicht spezifiziert |