Rechnungsstatus an den Absender zurückmelden über Peppol BIS Invoice Response 3.0.
Mit einer Invoice Response (auch Statusnachrichten genannt) melden Sie als Empfänger den Verarbeitungsstatus einer Rechnung an den Absender zurück. Denken Sie an eine Bestätigung, dass die Rechnung empfangen, zur Zahlung freigegeben oder abgelehnt wurde. Dieser Artikel beschreibt, wie Sie über die PSB API eine Invoice Response gemäß dem Peppol BIS Invoice Response 3.0 Standard versenden.
Ohne Statusnachrichten kann ein Lieferant nur hoffen, dass seine Rechnung korrekt angekommen ist und verarbeitet wird. Mit Invoice Responses machen Sie den Rechnungsprozess transparent: Der Absender weiß genau, in welchem Stadium sich die Rechnung befindet, und kann bei einer Ablehnung sofort handeln.
Der Peppol BIS Invoice Response 3.0 Standard definiert sechs Statuscodes:
Die Status folgen einer logischen Reihenfolge: AB, IP, UQ, AP, PD. Der Status RE kann jederzeit gesendet werden, wenn die Rechnung abgelehnt wird.
Bei einer Statusänderung können Sie einen Reason Code und einen Action Code mitsenden, um den Grund und die gewünschte Aktion zu erläutern.
Versenden Sie eine Invoice Response über den PurchaseInvoice-Endpoint:
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",
"note": "Rechnung zur Zahlung freigegeben."
}
Der PSB generiert automatisch eine Peppol BIS Invoice Response 3.0 Nachricht und sendet diese über das Peppol-Netzwerk an den Access Point des Absenders.
Um Invoice Responses versenden zu können, muss Ihre Organisation als Peppol-Empfänger mit den richtigen SMP-Capabilities registriert sein. Prüfen Sie dies über:
GET /api/v1/peppol/config HTTP/1.1
Host: psb.econnect.eu
Authorization: Bearer {access_token}
Die Capability invoiceResponse muss den Status on haben. Falls nicht, aktivieren Sie sie über:
PUT /api/v1/peppol/config HTTP/1.1
Host: psb.econnect.eu
Authorization: Bearer {access_token}
Content-Type: application/json
{
"invoiceResponse": {
"state": "on"
}
}
Ein üblicher Ablauf bei der Verarbeitung einer Eingangsrechnung:
InvoiceReceivedSie müssen nicht jeden Zwischenstatus senden. Üblich ist es, mindestens AB (Empfangsbestätigung) und AP oder RE (Endbeurteilung) zu senden.
Nach dem Versenden einer Invoice Response erhalten Sie ein Webhook-Event InvoiceResponseSent als Bestätigung, dass die Nachricht erfolgreich an den Absender zugestellt wurde.
Sie posten JSON an POST /api/v1/{partyId}/purchaseInvoice/{documentId}/response mit unter anderem status (zum Beispiel AB, AP, RE), clarificationCode und actionCode, plus einer optionalen note. Die PSB erstellt daraus eine Peppol BIS Invoice Response 3.0-Nachricht und stellt diese über Peppol dem Absender zu.
Ihre Organisation muss in der SMP mit der Capability für Invoice Response registriert sein. Prüfen Sie GET /api/v1/peppol/config und setzen Sie bei Bedarf invoiceResponse.state über PUT /api/v1/peppol/config auf on. Ohne aktive Capability kann das Access Point der Gegenseite Ihre Response nicht korrekt zustellen.
Nein, das ist nicht verpflichtend. Ein gängiger Ansatz ist mindestens eine Empfangsbestätigung (AB) und ein Endurteil (AP, PD oder RE). Bei einer Ablehnung (RE) sind Reason- und Action Codes relevant, um dem Absender mitzuteilen, was nicht stimmt und welcher nächste Schritt erwartet wird.
Die vollständige Spezifikation des Peppol BIS Invoice Response 3.0 finden Sie unter docs.peppol.eu. Die PSB-Endpoints und Response-Modelle stehen unter psb.econnect.eu.
Response-Endpoints ansehen