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.
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:
389) über den PSBInvoiceReceived-Event an Ihren WebhookUm 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:
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.
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.
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.
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.
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.
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.
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.
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).
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.
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