Estado de devolución de los pedidos en la API

La API de pedidos indica si un pedido se ha devuelto total o parcialmente y desde cuándo, para que tu ERP o tus integraciones puedan tener en cuenta las devoluciones gestionadas en OpenTiendas.

· Versión 4.117.4

Hasta ahora, un pedido devuelto completamente no se podía distinguir de uno cancelado desde la API. A partir de esta versión, los pedidos incluyen dos campos nuevos:

  • refund_status: not_refunded (sin devoluciones), partially_refunded (devuelto en parte) o refunded (devuelto completamente, también el envío y las comisiones). Es el mismo criterio que el dashboard, que muestra «Devuelto completamente».
  • refunded_at: la fecha en que el pedido quedó devuelto completamente. También la tienen los pedidos devueltos antes de esta versión.

Solo cuentan las devoluciones completadas: una devolución pendiente no cambia el estado hasta que se completa.

Nuevos filtros en el listado de pedidos

  • Por refund_status, con uno o varios valores. Los estados de envío (fulfillment_status) y de liberación de almacén (warehouse_release_status) también admiten ahora varios valores.
  • Por refunded_at_from y refunded_at_to, para pedir solo las devoluciones nuevas desde la última sincronización.

El filtro is_canceled no cambia: true sigue devolviendo los pedidos cancelados y los devueltos completamente, como en el dashboard. Para obtener solo los cancelados, combínalo con refund_status=not_refunded.

Ver la documentación

Incluida en la versión 4.117.4Ver todo lo que trae