Comunicar el estado de una factura al remitente a través de Peppol BIS Invoice Response 3.0.
Con un Invoice Response (también llamado mensajes de estado), usted como destinatario comunica el estado de procesamiento de una factura al remitente. Puede tratarse de una confirmación de recepción, una aprobación para pago, o un rechazo. Este artículo describe cómo enviar un Invoice Response a través de la API PSB conforme al estándar Peppol BIS Invoice Response 3.0.
Sin mensajes de estado, un proveedor solo puede esperar que su factura haya llegado correctamente y será procesada. Con los Invoice Responses, usted hace transparente el proceso de facturación: el remitente sabe exactamente en qué fase se encuentra la factura y puede actuar inmediatamente en caso de rechazo.
El estándar Peppol BIS Invoice Response 3.0 define seis códigos de estado:
Los estados siguen un orden lógico: AB, IP, UQ, AP, PD. El estado RE puede enviarse en cualquier momento si la factura es rechazada.
Al cambiar de estado, puede enviar un Reason code y un Action code para aclarar la razón y la acción deseada.
Envíe un Invoice Response a través del 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."
}
El PSB genera automáticamente un mensaje Peppol BIS Invoice Response 3.0 y lo envía a través de la red Peppol al Access Point del remitente.
Para poder enviar Invoice Responses, su organización debe estar registrada como destinatario Peppol con las capabilities SMP adecuadas. Verifíquelo mediante:
GET /api/v1/peppol/config HTTP/1.1
Host: psb.econnect.eu
Authorization: Bearer {access_token}
La capability invoiceResponse debe tener el estado on. Si no es así, actívela mediante:
PUT /api/v1/peppol/config HTTP/1.1
Host: psb.econnect.eu
Authorization: Bearer {access_token}
Content-Type: application/json
{
"invoiceResponse": {
"state": "on"
}
}
Un flujo común al procesar una factura de compra:
InvoiceReceivedNo es necesario enviar cada estado intermedio. Es habitual enviar como mínimo AB (confirmación de recepción) y AP o RE (veredicto final).
Después de enviar un Invoice Response, recibirá un evento webhook InvoiceResponseSent como confirmación de que el mensaje fue entregado exitosamente al remitente.
Envíe JSON a POST /api/v1/{partyId}/purchaseInvoice/{documentId}/response incluyendo entre otros status (por ejemplo AB, AP, RE), clarificationCode y actionCode, más una note opcional. La PSB construye un mensaje Peppol BIS Invoice Response 3.0 a partir de estos datos y lo entrega vía Peppol al remitente.
Su organización debe estar registrada en el SMP con la capability para Invoice Response. Verifique mediante GET /api/v1/peppol/config y si es necesario establezca invoiceResponse.state en on a través de PUT /api/v1/peppol/config. Sin una capability activa, el Access Point de la contraparte no puede entregar correctamente su respuesta.
No, no es obligatorio. Un enfoque habitual es enviar al menos un acuse de recibo (AB) y un veredicto final (AP, PD o RE). En caso de rechazo (RE), los códigos Reason y Action son relevantes para informar al remitente sobre el problema y la acción esperada.
La especificación completa del Peppol BIS Invoice Response 3.0 está disponible en docs.peppol.eu. Los endpoints PSB y los modelos de respuesta se encuentran en psb.econnect.eu.
Consultar los endpoints de response