Pomocou Invoice Response (tiež nazývaného stavové správy) ako príjemca oznamujete stav spracovania faktúry odosielateľovi. Ide napríklad o potvrdenie prijatia faktúry, schválenie na platbu alebo zamietnutie. Tento článok popisuje, ako cez PSB API odošlete Invoice Response v súlade so štandardom Peppol BIS Invoice Response 3.0.

Bez stavových správ sa dodávateľ musí len nádejať, že jeho faktúra bola správne prijatá a spracovaná. S Invoice Responses robíte faktúrový proces transparentným: odosielateľ presne vie, v akom štádiu sa faktúra nachádza, a pri zamietnutí môže okamžite konať.

Štandard Peppol BIS Invoice Response 3.0 definuje šesť stavových kódov:

Stavy nasledujú logické poradie: AB, IP, UQ, AP, PD. Stav RE sa môže odoslať kedykoľvek, ak je faktúra zamietnutá.

Pri zmene stavu môžete priložiť Reason code a Action code na objasnenie dôvodu a požadovanej akcie.

Invoice Response odošlite cez 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": "Faktúra schválená na platbu."
}

PSB automaticky vygeneruje správu Peppol BIS Invoice Response 3.0 a odošle ju cez sieť Peppol na Access Point odosielateľa.

Na odosielanie Invoice Responses musí byť Vaša organizácia registrovaná ako Peppol príjemca so správnymi SMP capabilities. Skontrolujte to cez:

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

Capability invoiceResponse musí mať stav on. Ak tomu tak nie je, aktivujte ju cez:

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

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

Bežný flow pri spracovaní nákupnej faktúry:

1. Faktúra prijatá, webhook event InvoiceReceived
2. Odoslanie Invoice Response so stavom AB (potvrdenie prijatia)
3. Kontrola faktúry vo vlastnom systéme
4. Odoslanie Invoice Response so stavom IP (v spracovaní)
5. Pri schválení: Invoice Response so stavom AP
6. Po zaplatení: Invoice Response so stavom PD

Nemusíte odosielať každý medzistav. Bežné je odosielať minimálne AB (potvrdenie prijatia) a AP alebo RE (konečné rozhodnutie).

Po odoslaní Invoice Response obdržíte webhook event InvoiceResponseSent ako potvrdenie, že správa bola úspešne doručená odosielateľovi.

Kompletnú špecifikáciu Peppol BIS Invoice Response 3.0 nájdete na docs.peppol.eu. PSB endpointy a modely odpovedí sú na psb.econnect.eu.