Order Response | eConnect

Cuando como proveedor recibe un pedido, una modificación o una anulación, envía una Order Response de vuelta para informar al comprador de lo que hará con el pedido. La Order Response es un elemento central del perfil Peppol Advanced Ordering.

Endpoint

POST /api/v1/{partyId}/salesOrder/{documentId}/response

El {partyId} es el identificador Peppol del proveedor. El {documentId} es el ID del pedido recibido al que responde.

Códigos de estado

La Order Response contiene un código de estado que indica qué hará con el pedido:

Código

Nombre

Cuándo usar

Acknowledged

Ha recibido el pedido y es legible. Utilice esto como confirmación intermedia mientras evalúa el pedido.

Accepted

Acepta el pedido completamente y lo ejecutará.

Conditionally Accepted

Acepta el pedido pero con modificaciones (por ejemplo plazo de entrega o cantidades ajustados). Agregue las líneas de pedido modificadas a la response.

Rejected

Rechaza el pedido. El comprador debe enviar un nuevo pedido si el pedido debe ejecutarse de todos modos.

Consejo: puede enviar múltiples responses para el mismo pedido. Comience por ejemplo con AB (confirmación de recepción) y envíe después AP (aceptado) una vez que el pedido sea aprobado internamente.

Ejemplo de flujo

Un escenario típico de Advanced Ordering se presenta así:

El comprador envía un pedido vía POST /{partyId}/purchaseOrder/send
El proveedor recibe el pedido vía el webhook OrderReceived
El proveedor descarga el pedido vía GET /{partyId}/salesOrder/{documentId}/download
El proveedor envía una response AB (confirmación de recepción)
El proveedor evalúa el pedido internamente
El proveedor envía una response AP (pedido aceptado)
El comprador recibe la response vía el webhook OrderResponseReceived

Aceptación condicional (CA)

Con una response CA (Conditionally Accepted), indica que acepta el pedido pero con ajustes. La response contiene entonces una versión modificada de las líneas de pedido. El comprador puede decidir en base a esto si el pedido modificado es aceptable.

Las posibles razones para una response CA incluyen un plazo de entrega ajustado, una cantidad modificada (stock limitado) o artículos de reemplazo.

Topics webhook

Topic

Dirección

Cuándo

OrderResponseSent

Proveedor

La response fue enviada con éxito al comprador

OrderResponseReceived

Comprador

La response del proveedor fue recibida

Cuerpo de la solicitud

La response se envía como documento XML UBL OrderResponse en el body de la solicitud, con content-type application/xml. El documento debe contener la referencia correcta al pedido original.

Consulte la documentación Swagger en psb.econnect.eu para la estructura XML exacta y los campos obligatorios.

Preguntas frecuentes

¿Cuándo utilizo AB, AP, CA o RE en una Order Response?

AB significa que el pedido ha sido recibido y es legible, a menudo como paso intermedio. AP es la aceptación completa y ejecución. CA es la aceptación con modificaciones; se incluyen las líneas de pedido ajustadas. RE rechaza el pedido; el comprador debe entonces enviar un nuevo pedido si la compra debe continuar.

¿Puedo enviar varias Order Responses para el mismo pedido?

Sí. Puede, por ejemplo, enviar primero AB una vez que haya incorporado el pedido y posteriormente AP cuando la aprobación interna esté completada. Esto se ajusta a una cadena Advanced Ordering típica con el webhook OrderResponseReceived del lado del comprador.

¿Cómo llamo técnicamente al endpoint de Order Response?

Utilice POST /api/v1/{partyId}/salesOrder/{documentId}/response con {partyId} como identificador Peppol del proveedor y {documentId} como ID del pedido recibido. El body es un XML UBL OrderResponse con Content-Type: application/xml y la referencia correcta al pedido original.

Consulte la especificación API completa en psb.econnect.eu para ejemplos de payloads y mensajes de error.

Abrir la referencia API