Con un Invoice Response (chiamato anche messaggi di stato) il destinatario comunica al mittente lo stato di elaborazione di una fattura. Pensi a una conferma di ricezione, all'approvazione per il pagamento o al rifiuto. Questo articolo descrive come inviare un Invoice Response tramite la PSB API conformemente allo standard Peppol BIS Invoice Response 3.0.

Senza messaggi di stato, un fornitore non può che sperare che la sua fattura sia arrivata correttamente e venga elaborata. Con gli Invoice Response il processo di fatturazione diventa trasparente: il mittente sa esattamente in quale fase si trova la fattura e può agire immediatamente in caso di rifiuto.

Lo standard Peppol BIS Invoice Response 3.0 definisce sei codici di stato:

Gli stati seguono un ordine logico: AB, IP, UQ, AP, PD. Lo stato RE può essere inviato in qualsiasi momento quando la fattura viene rifiutata.

Con un cambio di stato è possibile inviare un Reason code e un Action code per chiarire il motivo e l'azione desiderata.

Invii un Invoice Response tramite l'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."
}

La PSB genera automaticamente un messaggio Peppol BIS Invoice Response 3.0 e lo invia tramite la rete Peppol all'Access Point del mittente.

Per poter inviare Invoice Response, la Sua organizzazione deve essere registrata come destinatario Peppol con le capabilities SMP appropriate. Verifichi tramite:

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

La capability invoiceResponse deve avere lo stato on. In caso contrario, la attivi tramite:

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

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

Un flusso comune nell'elaborazione di una fattura d'acquisto:

1. Fattura ricevuta, evento webhook InvoiceReceived
2. Invoice Response inviato con stato AB (conferma ricezione)
3. Fattura verificata nel proprio sistema
4. Invoice Response inviato con stato IP (in elaborazione)
5. In caso di approvazione: Invoice Response con stato AP
6. Dopo il pagamento: Invoice Response con stato PD

Non è necessario inviare ogni stato intermedio. È consuetudine inviare almeno AB (conferma di ricezione) e AP o RE (giudizio finale).

Dopo l'invio di un Invoice Response, riceve un evento webhook InvoiceResponseSent come conferma che il messaggio è stato consegnato con successo al mittente.

La specifica completa del Peppol BIS Invoice Response 3.0 è disponibile su docs.peppol.eu. Gli endpoint PSB e i modelli di risposta sono disponibili su psb.econnect.eu.