Pomocí Invoice Response (také nazývaného stavové zprávy) jako příjemce oznamujete stav zpracování faktury odesílateli. Jde například o potvrzení přijetí faktury, schválení k platbě nebo zamítnutí. Tento článek popisuje, jak přes PSB API odešlete Invoice Response v souladu se standardem Peppol BIS Invoice Response 3.0.

Bez stavových zpráv se dodavatel musí jen doufat, že jeho faktura byla správně přijata a zpracována. S Invoice Responses děláte fakturační proces transparentním: odesílatel přesně ví, v jakém stadiu se faktura nachází, a při zamítnutí může okamžitě jednat.

Standard Peppol BIS Invoice Response 3.0 definuje šest stavových kódů:

Stavy následují logické pořadí: AB, IP, UQ, AP, PD. Stav RE se může odeslat kdykoli, pokud je faktura zamítnuta.

Při změně stavu můžete přiložit Reason code a Action code k objasnění důvodu a požadované akce.

Invoice Response odešlete přes 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": "Faktura schválena k platbě."
}

PSB automaticky vygeneruje zprávu Peppol BIS Invoice Response 3.0 a odešle ji přes síť Peppol na Access Point odesílatele.

Pro odesílání Invoice Responses musí být Vaše organizace registrována jako Peppol příjemce se správnými SMP capabilities. Zkontrolujte to přes:

GET /api/v1/peppol/config HTTP/1.1
Host: psb.econnect.eu
Authorization: Bearer {access_token}

Capability invoiceResponse musí mít stav on. Pokud tomu tak není, aktivujte ji přes:

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

{
  "invoiceResponse": {
    "state": "on"
  }
}

Běžný flow při zpracování nákupní faktury:

1. Faktura přijata, webhook event InvoiceReceived
2. Odeslání Invoice Response se stavem AB (potvrzení přijetí)
3. Kontrola faktury ve vlastním systému
4. Odeslání Invoice Response se stavem IP (ve zpracování)
5. Při schválení: Invoice Response se stavem AP
6. Po zaplacení: Invoice Response se stavem PD

Nemusíte odesílat každý mezistav. Běžné je odesílat minimálně AB (potvrzení přijetí) a AP nebo RE (konečné rozhodnutí).

Po odeslání Invoice Response obdržíte webhook event InvoiceResponseSent jako potvrzení, že zpráva byla úspěšně doručena odesílateli.

Kompletní specifikaci Peppol BIS Invoice Response 3.0 najdete na docs.peppol.eu. PSB endpointy a modely odpovědí jsou na psb.econnect.eu.