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.
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) orefunded(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_fromyrefunded_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.