Dieser Abschnitt fasst die häufigsten Stolpersteine und ihre Lösungen zusammen.
Neu-Erzeugung nach Konfigurationsänderung
Bereits erzeugte XML-Dateien werden nicht automatisch aktualisiert. Nach einer Konfigurationsänderung erzeugen Sie betroffene Rechnungen neu:
bin/magento cache:clean config
bin/magento geissweb:einvoice:generate-xml --invoice-id=123 --force
XML-Inhalt prüfen
# Erzeugtes XML formatiert ansehen
cat var/export/e-invoices/invoice_000000123.xml | xmllint --format -
# Bestimmte Summen-Elemente herausfiltern
grep -E "(TaxBasisTotalAmount|TaxTotalAmount|GrandTotalAmount)" var/export/e-invoices/invoice_000000123.xml
Rundungsdifferenzen
Die Umsatzsteuer wird auf Belegebene je Steuersatz berechnet (siehe Betragsberechnung). Dadurch sind kleine Differenzen (≤ 1 Cent pro Steuersatz) gegenüber einer positionsweisen Rundung möglich. Prüfen Sie mit:
bin/magento geissweb:einvoice:verify-amounts --invoice-id=000000123
Die Geschäftsregeln BR-CO-13 und BR-CO-15 müssen dabei erfüllt sein.
Häufige Validierungsfehler
| Fehler | Ursache | Lösung |
|---|---|---|
| BR-DE-1 | Zahlungsanweisung (BG-16) fehlt | IBAN (BT-84) und Zahlungsart-Code (BT-81) hinterlegen |
| BR-DE-5/6/7 | Verkäuferkontakt unvollständig | Kontaktname (BT-41), Telefon (BT-42), E-Mail (BT-43) ergänzen |
| BR-DE-15 | Käuferreferenz (BT-10) fehlt | Käuferreferenz setzen (Käufer) |
| BR-DE-17 | USt-IdNr. oder Steuernummer fehlt | BT-31 oder BT-32 hinterlegen |
| BR-CO-13 | Steuerbasis stimmt nicht | BT-109 = BT-106 − BT-107 + BT-108 prüfen |
| BR-CO-15 | Bruttobetrag stimmt nicht | BT-112 = BT-109 + BT-110 prüfen |
Detaillierte Lösungswege zu XRechnung-Regeln finden Sie unter XRechnung. Für die vollständige Geschäftsregel-Prüfung verwenden Sie zusätzlich einen vollständigen EN-16931-/XRechnung-Validierungsdienst.
Weiterer Support
Erreichen Sie unseren Support über die GEISSWEB Knowledge Base.