Keď príjemca oznámi stav Vašej faktúry prostredníctvom Invoice Response (stavové správy), PSB odošle notifikáciu na Váš webhook. Ako odosielateľ tak viete, či bola faktúra schválená, zamietnutá, alebo či príjemca potrebuje doplňujúce informácie. Tento článok popisuje, ako tieto notifikácie zachytíte a spracujete.

Po odoslaní faktúry môže príjemca cez sieť Peppol odosielať späť stavové správy. PSB automaticky priradí každý prijatý Invoice Response k Vašej pôvodnej faktúre a publikuje webhook event.

Flow:

1. Odošlete faktúru cez PSB
2. Príjemca spracuje faktúru a odošle Invoice Response
3. PSB prijme response správu a priradí ju k Vašej faktúre
4. Váš webhook obdrží event InvoiceResponseReceived

Zaregistrujte hook na topic InvoiceResponseReceived:

POST /api/v1/hook

{
  "action": "https://mijn-systeem.nl/webhook/responses#mijnSecretKey",
  "topics": ["InvoiceResponseReceived"]
}

Webhook payload obsahuje documentId pôvodnej faktúry a responseDocumentId správy Invoice Response.

Stiahnite kompletnú správu Invoice Response cez API:

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

Správa obsahuje stavový kód, prípadné clarification codes a voliteľný komentár od príjemcu.

Prijatý stavový kód udáva, v akom štádiu sa faktúra u príjemcu nachádza:

Pri stavoch UQ a RE je dôležité prečítať si priložený Reason code a Action code. Tieto udávajú, čo je problém a akú akciu príjemca od Vás očakáva. Pozrite si článok Odoslanie Invoice Response pre kompletný prehľad Reason a Action codes.

Aby ste ako odosielateľ mohli prijímať Invoice Responses, musí byť Vaša organizácia registrovaná v Peppol SMP s capability invoiceResponse. Bez tejto registrácie Access Point príjemcu nemôže response správu doručiť.

Skontrolujte a aktivujte capability:

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

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

Niekoľko odporúčaní na spracovanie Invoice Responses:

• Priraďte k faktúre: použite documentId z payloadu na priradenie response k správnej faktúre vo Vašej administrácii.
• Zobrazte stav: sprístupnite stav faktúry Vašim používateľom. Indikátor "schválené" alebo "zamietnuté" predchádza zbytočným otázkam.
• Reagujte na zamietnutia: pri stave RE je bežné faktúru opraviť a odoslať novú verziu. Pozor: použite nový X-EConnect-DocumentId, pretože ide o nový dokument.
• Uchovajte audit trail: každý prijatý Invoice Response uložte ako súčasť histórie faktúry.

Invoice Responses sú v sieti Peppol voliteľné. Nie každý príjemca ich odosiela. Ale keď sa používajú, poskytujú cenné informácie o faktúrovom procese.