Deutschland — E-INVOICE DE (Unified API)

In Deutschland unterstützt fiskaly das Senden von E-Rechnungen. Die E-Rechnung wird vom Bundesministerium der Finanzen (BMF) geregelt. Alle elektronischen Rechnungen müssen der EN 16931 entsprechen, die durch Formate wie XRechnung, ZUGFeRD oder Peppol BIS 3.0 Billing erfüllt wird, und müssen 8 Jahre lang in einem gesetzeskonformen elektronischen Format archiviert werden (§14b UStG).

fiskaly generiert EN 16931-konforme E-Rechnungen und stellt sie über einen von zwei Kanälen zu. Den Kanal legen Sie pro Rechnung beim Empfänger fest (recipients[].invoicing): per E-Mail — als ZUGFeRD oder XRechnung — oder über das PEPPOL-Netzwerk als XRechnung.

Diese Seite behandelt die Deutschland-spezifischen Anforderungen, die die Allgemeine Schritt-für-Schritt-Integration ergänzen. Stellen Sie sicher, dass Ihnen die folgenden Daten des Steuerpflichtigen vorliegen, bevor Sie fortfahren:

• vat_id_number — Umsatzsteuer-Identifikationsnummer (Umsatzsteuer-ID)
• credentials.tax_number — Steuernummer im ELSTER-Format (Steuernummer)
• name — Eingetragener Firmenname und Handelsname des Unternehmens oder der natürlichen Person
• address — Eingetragene Geschäftsadresse des Unternehmens oder der natürlichen Person

E-Rechnungen versenden: Empfängeranforderungen

Um eine E-Rechnung zu versenden, geben Sie den Empfänger und den Zustellweg direkt im Record der Rechnung an. Wenn Sie die Rechnung (TRANSACTION::INVOICE) mit createRecord erstellen, fügen Sie den Empfänger dem recipients-Array hinzu.

Wie in der Allgemeinen Schritt-für-Schritt-Integration beschrieben, muss jeder Empfänger vom Typ BUSINESS sein und einen ausgefüllten invoicing-Block haben. Zusätzlich zu den Standardangaben jeder E-Rechnung (Name, Adresse, Steueridentifikation des Empfängers, Rechnungspositionen usw.) kommt in Deutschland der Zustellkanal beim Empfänger hinzu:

• recipients[].type = BUSINESS
• recipients[].invoicing.type = EMAIL oder PEPPOL — der Zustellkanal
• recipients[].invoicing.email — (nur EMAIL) die E-Mail-Adresse des Empfängers
• recipients[].invoicing.format — (nur EMAIL, optional) das Dokumentformat
• recipients[].invoicing.identifier — (nur PEPPOL) der PEPPOL Network Identifier des Empfängers

invoicing.type	Zusätzlich erforderlich	Wie fiskaly zustellt
EMAIL	invoicing.email	Per E-Mail an diese Adresse, als ZUGFeRD oder XRechnung je nach invoicing.format.
PEPPOL	invoicing.identifier	An den PEPPOL-Endpunkt des Empfängers als XRechnung.

Sie wählen den Kanal pro Rechnung, nicht dauerhaft pro Empfänger — dasselbe Unternehmen kann eine Rechnung per E-Mail und die nächste über PEPPOL erhalten.

📘Wichtig

Ohne den invoicing-Block wird die E-Rechnung erstellt, aber nicht an den Empfänger zugestellt.

Versand über PEPPOL

Setzen Sie beim Empfänger in Ihrem createRecord-Request:

• recipients[].invoicing.type = PEPPOL
• recipients[].invoicing.identifier — der PEPPOL Network Identifier des Empfängers

Dafür müssen zwei Voraussetzungen erfüllt sein: Die PEPPOL-Registrierung muss bereits erfolgt sein, und der PEPPOL Network Identifier des Empfängers muss Ihnen vorliegen. Um das Identifier-Schema kümmert sich fiskaly.

Auf diesem Weg versandte Rechnungen werden als XRechnung erzeugt, die Peppol BIS 3.0-konform ist. recipients[].invoicing.format spielt hier keine Rolle — auf diesem Kanal ist das Format nicht wählbar.

📘B2G wird noch nicht unterstützt

Der Versand an deutsche öffentliche Auftraggeber (B2G) wird noch nicht unterstützt, daher ist die Adressierung über die Leitweg-ID nicht verfügbar.

Versand per E-Mail: Dokumentformat auswählen

Wenn der Kanal EMAIL ist, entscheiden Sie, welches Dokumentformat fiskaly erzeugt. Setzen Sie es beim selben Empfänger in Ihrem createRecord-Request über recipients[].invoicing.format:

Wert	Format
ZUGFERD_V2 (Standard)	ZUGFeRD — ein hybrides Dokument: ein menschenlesbares PDF/A-3 mit eingebettetem strukturiertem XML.
XRECHNUNG_V3	XRechnung — eine reine strukturierte XML-Rechnung, ohne PDF-Ebene.

Das Feld ist optional: Wenn Sie es weglassen, erzeugt fiskaly ZUGFERD_V2. Beide Formate entsprechen der EN 16931.