Cancelar pedidos - Riqra

POST /orders/{id}/cancel cancela un pedido que aún no fue despachado. Requiere el scope orders:write y devuelve el pedido actualizado, con el mismo formato que GET /orders/{id}. Sin cuerpo, la llamada toma todos los valores por defecto:

curl -X POST "https://api-v2.riqra.com/public/v1/orders/0b2e9f5a-1c3d-4e6f-8a9b-0c1d2e3f4a5b/cancel" \
  -H "Authorization: Bearer rq_live_tu_api_key"

Todos los campos del cuerpo son opcionales — la referencia del endpoint documenta cada uno y su valor por defecto:

curl -X POST "https://api-v2.riqra.com/public/v1/orders/0b2e9f5a-1c3d-4e6f-8a9b-0c1d2e3f4a5b/cancel" \
  -H "Authorization: Bearer rq_live_tu_api_key" \
  -H "Content-Type: application/json" \
  -d '{ "reason": "INVENTORY", "note": "Sin stock en almacén", "notifyCustomer": true }'

Un pedido en AWAITING_REVIEW también se puede cancelar: es la forma de rechazarlo. Para ese caso existe el motivo REVIEW_REJECTED, que solo se acepta mientras el pedido está en AWAITING_REVIEW y se rechaza en cualquier otro. El crédito vuelve a la línea del cliente y el stock sigue lo que indique restock, como en cualquier cancelación.

Cómo leer un pedido cancelado

El objeto cancellation es null mientras el pedido no esté cancelado. Cuando lo está, trae:

Campo	Contenido
`cancellation.reason`	El motivo elegido, o el código automático si lo canceló la plataforma. Trata cualquier valor desconocido como `OTHER`: los pedidos migrados conservan el motivo original de su plataforma de origen.
`cancellation.note`	La nota interna. Nunca se le muestra al comprador.
`cancellation.byMemberId`, `cancellation.byName`	El operador que canceló desde el panel. Ambos son `null` cuando canceló la plataforma o una integración: una API key identifica a la organización, no a una persona.

La fecha de cancelación sigue en la raíz del pedido, junto al resto de fechas del ciclo de vida: cancelledAt.