Self-Billing-Rechnung empfangen über die API

Self-Billing-Dokumente empfangen: SMP-Capabilities und Verarbeitungsablauf.

Als Lieferant empfangen Sie Self-Billing-Rechnungen von Ihren Käufern. Der Käufer erstellt die Rechnung in Ihrem Namen und sendet sie über das Peppol-Netzwerk. Dieser Artikel beschreibt, welche Registrierung Sie benötigen und wie Sie die empfangenen Dokumente verarbeiten.

Wie kommen Self-Billing-Rechnungen an?

Self-Billing-Rechnungen werden auf dieselbe Weise zugestellt wie reguläre Eingangsrechnungen. Der PSB sendet eine Webhook-Benachrichtigung und Sie können das Dokument über den PurchaseInvoice-Endpoint herunterladen. Der Unterschied liegt in der Registrierung und dem Dokumenttyp.

Der Empfangsablauf:

  1. Der Käufer versendet eine Self-Billing-Rechnung (InvoiceTypeCode 389) über den PSB
  2. Das Peppol-Netzwerk leitet das Dokument an Ihren Access Point weiter
  3. Der PSB sendet ein InvoiceReceived-Event an Ihren Webhook
  4. Sie laden das Dokument herunter und verarbeiten es
SMP-Registrierung

Um Self-Billing-Rechnungen empfangen zu können, muss Ihre Organisation in der Peppol SMP registriert sein. Welche Registrierung Sie benötigen, hängt von der Variante ab:

NLCIUS-Variante

Wenn Sie bereits für den Empfang regulärer NLCIUS-Rechnungen registriert sind, müssen Sie nichts Zusätzliches tun. Self-Billing-Rechnungen mit InvoiceTypeCode 389 werden über dasselbe Profil zugestellt. Der PSB erkennt den Dokumenttyp automatisch.

BIS Self-Billing 3.0

Für das BIS Self-Billing 3.0 Profil ist eine separate Registrierung erforderlich. Dieses Profil hat eine eigene CustomizationID und ProfileID und erfordert eine spezifische SMP-Konfiguration.

Konfigurieren Sie die Self-Billing-Capability über die Peppol Config API:

PUT /api/v1/peppol/config HTTP/1.1
Host: psb.econnect.eu
Authorization: Bearer {access_token}
Content-Type: application/json

{
  "selfBilling": {
    "state": "on"
  }
}

Ohne diese Registrierung können Käufer, die das BIS Self-Billing 3.0 Profil verwenden, Sie nicht über einen Peppol SMP-Lookup finden.

Webhook konfigurieren

Verwenden Sie dasselbe Topic wie für reguläre Eingangsrechnungen:

{
  "action": "https://mein-system.de/webhook/invoices#meinSecretKey",
  "topics": ["InvoiceReceived"]
}

Self-Billing-Rechnungen kommen als InvoiceReceived-Events an. Sie können sie von regulären Rechnungen unterscheiden, indem Sie den InvoiceTypeCode im XML-Dokument prüfen: 389 für eine Self-Billing-Rechnung, 261 für eine Self-Billing-Gutschrift.

Dokument herunterladen und verarbeiten

Laden Sie das Dokument auf dieselbe Weise herunter wie eine reguläre Eingangsrechnung:

GET /api/v1/{partyId}/purchaseInvoice/{documentId}/download HTTP/1.1
Host: psb.econnect.eu
Authorization: Bearer {access_token}

Optional können Sie mit targetDocumentTypeId das Dokument in einem anderen Format anfordern, falls Ihr eigenes System dies erfordert.

Self-Billing-Rechnung erkennen

Nach dem Herunterladen können Sie im XML-Dokument prüfen, ob es sich um eine Self-Billing-Rechnung handelt:

<!-- InvoiceTypeCode 389 = Self-Billing-Rechnung -->
<InvoiceTypeCode>389</InvoiceTypeCode>

<!-- InvoiceTypeCode 261 = Self-Billing-Gutschrift -->
<InvoiceTypeCode>261</InvoiceTypeCode>

Bei einer Self-Billing-Rechnung ist die AccountingSupplierParty Ihre Organisation (der Lieferant), während die AccountingCustomerParty der Käufer ist, der die Rechnung erstellt hat.

Invoice Response zurücksenden

Nach dem Empfang können Sie eine Invoice Response an den Käufer zurücksenden, um die Verarbeitung zu bestätigen oder die Rechnung abzulehnen. Der Ablauf ist identisch mit dem für reguläre Rechnungen:

POST /api/v1/{partyId}/purchaseInvoice/{documentId}/response HTTP/1.1
Host: psb.econnect.eu
Authorization: Bearer {access_token}
Content-Type: application/json

{
  "status": "AP",
  "clarificationCode": "NON",
  "actionCode": "NOA"
}

Siehe Invoice Response versenden für die vollständige Übersicht der Statuscodes und Clarification Codes.

Aufbewahrung

Die Aufbewahrungsregeln für Self-Billing-Dokumente sind dieselben wie für reguläre Eingangsrechnungen: 90 Tage nach Empfang, 7 Tage nach Download. Rufen Sie Dokumente rechtzeitig ab und speichern Sie sie in Ihrem eigenen System.

Häufig gestellte Fragen
Benötige ich separate Webhooks für Self-Billing?

Nein, Self-Billing verwendet dasselbe Topic wie reguläre Eingangsrechnungen: InvoiceReceived. Sie unterscheiden Self-Billing in Ihrer Verarbeitung, indem Sie im XML den InvoiceTypeCode lesen (389 für Rechnung, 261 für Gutschrift).

Welche SMP-Registrierung benötige ich für NLCIUS versus BIS Self-Billing 3.0?

Wenn Sie bereits NLCIUS-Eingangsrechnungen empfangen, deckt diese Registrierung auch NLCIUS-Self-Billing mit Code 389 oder 261 ab. Für BIS Self-Billing 3.0 ist eine separate Capability erforderlich; setzen Sie selfBilling.state über PUT /api/v1/peppol/config auf on, sonst können Käufer Sie für dieses Profil in der SMP nicht finden.

Wie lade ich eine eingegangene Self-Billing-Rechnung herunter und kann ich das Format ändern?

Verwenden Sie GET /api/v1/{partyId}/purchaseInvoice/{documentId}/download wie bei jeder Eingangsrechnung. Mit dem Queryparameter targetDocumentTypeId können Sie ein anderes Zielformat anfordern, wenn Ihr Backend-System es benötigt. Prüfen Sie nach dem Download im XML, welche Partei Lieferant und welche Käufer ist gemäß AccountingSupplierParty und AccountingCustomerParty.


Ob Sie als Lieferant NLCIUS oder BIS Self-Billing 3.0 empfangen, hängt davon ab, was der Käufer versendet. Stellen Sie sicher, dass Sie die richtige SMP-Registrierung für die Varianten haben, die Ihre Käufer verwenden. Im Zweifelsfall: registrieren Sie sich für beide.

API-Dokumentation ansehen