Peppol-Netzwerk – Self-Billing versenden

Verfügbar ab Version 2025-10-13

Self-Billing ermöglicht es Käufern, Rechnungen im Namen von Lieferanten auszustellen. B2Brouter stellt Self-Billing wie folgt dar:

Ausgehend: IssuedSelfInvoice über Peppol BIS3 Self-Billing.
Eingehend: ReceivedSelfInvoice, empfangen über Peppol mit aktivierter Empfangsfunktion im Konto des Lieferanten.

1. Vorbereitung

Eine Übersicht und Details zur Transportkonfiguration finden Sie im übergeordneten Leitfaden Eine Rechnung über Peppol senden.

2. Eine Self-Billing-Rechnung erstellen (IssuedSelfInvoice)

So stellen Sie eine Self-Billing-Rechnung über die API aus:

1. Verwenden Sie POST /accounts/{account}/invoices.
2. Setzen Sie invoice.type auf IssuedSelfInvoice.
3. Stellen Sie sicher, dass beim Kontakt transport_type_code auf peppol gesetzt ist und geben Sie pin_scheme sowie pin_value an.

Verhalten:

• B2Brouter erstellt eine IssuedSelfInvoice.
• Beim Versand über Peppol erzeugt B2Brouter eine UBL BIS3 Self-Billing Invoice (xml.ubl.invoice.bis3.selfbilling):
  • Der Lieferant in der UBL ist Ihr Kontakt.
  • Der Kunde in der UBL ist Ihr Unternehmen (Konto).
• Die JSON-Antwort enthält:
  • "type": "IssuedSelfInvoice"
  • "document_type_code": "xml.ubl.invoice.bis3.selfbilling" (schreibgeschütztes Feld, das das verwendete Format anzeigt)

Sie können Self-Billing-Rechnungen auch über andere Übertragungswege senden (z. B. internes B2Brouter). Wenn jedoch die Kontakt- und Länderkonfiguration Peppol Self-Billing unterstützt, empfehlen wir die Nutzung von Peppol, da dies eine bessere Interoperabilität und Nachverfolgbarkeit bietet.

3. Self-Billing-Rechnungen auflisten und abrufen

Verwenden Sie die Standard-Endpunkte für Rechnungen mit dem Filter type:

• type=IssuedSelfInvoice – Listet die von Ihnen ausgestellten Self-Billing-Rechnungen auf
• type=ReceivedSelfInvoice – Listet die von Ihnen empfangenen Self-Billing-Rechnungen auf

Rechnungen auflisten:
GET /accounts/{ACCOUNT_ID}/invoices?type=IssuedSelfInvoice

Rechnung abrufen:
GET /invoices/{INVOICE_ID}

4. Steuerberichterstattung

Self-Billing-Rechnungen werden unter denselben Regeln wie reguläre Rechnungen in Steuerberichte (Verifactu usw.) aufgenommen:

• Wenn für das Unternehmen ein Steuerbericht aktiviert ist (z. B. Verifactu in Spanien), werden Self-Billing-Rechnungen automatisch gemeldet, sofern zutreffend.
• In Verifactu wird Self-Billing im Namen des ausstellenden Unternehmens (Buyer) gemeldet.
• Zusätzliche Anforderungen der Steuerberichterstattung (z. B. Verifactu in Spanien) können abhängig von den Einstellungen des ausstellenden Kontos für Self-Billing-Rechnungen gelten.
• Self-Billing-Rechnungen von Verkäufern, die nicht Verifactu-pflichtig sind, werden von der Meldung ausgeschlossen.

5. Einschränkungen und bekannte Limitierungen

• Rechnungstyp vs. Dokumenttyp

  • Self-Billing verwendet für ausgehende Dokumente immer invoice.type = IssuedSelfInvoice.
  • Der Versuch, eine reguläre IssuedInvoice mit einem Self-Billing-Dokumenttyp zu senden (z. B. durch einen falsch konfigurierten Kontakt), schlägt mit einem 4xx-Fehler fehl:
    • "The self-billing document type cannot be used for ordinary invoices."

• Auswahl des Dokumenttyps

  • document_type_code in der Rechnung ist schreibgeschützt.
  • Der tatsächlich verwendete Dokumenttyp wird bestimmt durch:
    • die Kontaktkonfiguration (transport_type_code, document_type_code) und/oder
    • die Peppol-SMP-Fähigkeiten des Lieferanten.

Empfehlungen für den produktiven Einsatz:

• Testen Sie den gesamten Ablauf in der Sandbox zwischen zwei Testkonten (verwenden Sie Staging für größere oder systemübergreifende Abläufe).
• Überprüfen Sie sowohl die JSON-API-Antworten als auch die versendeten UBL-Dateien.
• Überwachen Sie die Integrationsprotokolle (API-Anfragen) für Payloads, Antworten und Fehlerdetails.