Za pomocą Invoice Response (nazywanego również komunikatem statusowym) odbiorca przekazuje nadawcy status przetwarzania faktury. Może to być potwierdzenie odbioru, zatwierdzenie do zapłaty lub odrzucenie. Ten artykuł opisuje, jak wysłać Invoice Response przez PSB API zgodnie ze standardem Peppol BIS Invoice Response 3.0.

Bez komunikatów o statusie dostawca może jedynie mieć nadzieję, że jego faktura dotarła poprawnie i jest przetwarzana. Dzięki Invoice Response proces fakturowania staje się przejrzysty: nadawca wie dokładnie, na jakim etapie znajduje się faktura, i może natychmiast podjąć działanie w przypadku odrzucenia.

Standard Peppol BIS Invoice Response 3.0 definiuje sześć kodów statusu:

Statusy podążają w logicznej kolejności: AB, IP, UQ, AP, PD. Status RE może być wysłany w dowolnym momencie, gdy faktura zostaje odrzucona.

Przy zmianie statusu można wysłać Reason code i Action code, aby wyjaśnić przyczynę i oczekiwane działanie.

Invoice Response wysyła się przez endpoint PurchaseInvoice:

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": "Factuur goedgekeurd voor betaling."
}

PSB automatycznie generuje komunikat Peppol BIS Invoice Response 3.0 i wysyła go przez sieć Peppol do Access Point nadawcy.

Aby móc wysyłać Invoice Response, Państwa organizacja musi być zarejestrowana jako odbiorca Peppol z odpowiednimi capabilities SMP. Sprawdzenie:

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

Capability invoiceResponse musi mieć stan on. Jeśli tak nie jest, należy ją aktywować:

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

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

Typowy przepływ przy przetwarzaniu faktury zakupowej:

1. Faktura otrzymana, zdarzenie webhook InvoiceReceived
2. Wysyłka Invoice Response ze statusem AB (potwierdzenie odbioru)
3. Weryfikacja faktury we własnym systemie
4. Wysyłka Invoice Response ze statusem IP (w przetwarzaniu)
5. W przypadku zatwierdzenia: Invoice Response ze statusem AP
6. Po zapłacie: Invoice Response ze statusem PD

Nie jest konieczne wysyłanie każdego statusu pośredniego. Zwyczajowo wysyła się przynajmniej AB (potwierdzenie odbioru) i AP lub RE (ocena końcowa).

Po wysłaniu Invoice Response otrzymują Państwo zdarzenie webhook InvoiceResponseSent jako potwierdzenie pomyślnego dostarczenia wiadomości do nadawcy.

Pełna specyfikacja Peppol BIS Invoice Response 3.0 jest dostępna na docs.peppol.eu. Endpointy PSB i modele odpowiedzi dostępne są na psb.econnect.eu.