> ## Documentation Index
> Fetch the complete documentation index at: https://docs.fire.rest/llms.txt
> Use this file to discover all available pages before exploring further.
# Cancelar orden
> Cancela una orden existente en FIRE directamente desde FUEL sin necesidad de acceder al backoffice de FIRE.
Usa la pestaña **Cancelar orden** para enviar una solicitud de cancelación a FIRE sobre una orden que ya existe en el sistema. Es útil cuando necesitas limpiar órdenes de prueba, simular flujos de cancelación o verificar que FIRE transiciona correctamente una orden al estado cancelado.
La cancelación es irreversible. Una vez que una orden es cancelada en FIRE, no puede restaurarse. La operación solo tiene éxito para órdenes que se encuentren en un estado cancelable — típicamente `received` o `processing`. Las órdenes que ya están en estado `completed`, `cancelled` o `dispatched` devolverán un error.
## Antes de comenzar
Asegúrate de que tu contexto operativo esté configurado en la barra lateral: entorno, cuenta, país, vendor y tienda deben estar seleccionados. Las solicitudes de cancelación se envían al entorno de FIRE que tengas activo.
## Cómo cancelar una orden
Haz clic en **Cancelar orden** en la navegación superior. La pestaña muestra un único campo de búsqueda y un área de acción de cancelación.
Escribe el **External Order ID** (el ID que tu sistema asignó al crear la orden) o el **Order Code** (el código alfanumérico corto visible en la lista de órdenes de FIRE) en el campo de búsqueda.
Si inyectaste la orden desde **Orden individual** o **Batch**, el External Order ID aparece en la tarjeta de respuesta y en el registro de resultados del panel derecho.
Haz clic en **Buscar** para consultar la orden en FIRE antes de cancelar. FUEL mostrará el estado actual de la orden, el canal y la hora de creación para que puedas confirmar que es la orden correcta. Este paso es opcional — puedes proceder a cancelar sin buscar primero.
Haz clic en **Cancelar orden**. Aparece un diálogo de confirmación solicitándote que confirmes la acción. Revisa el identificador de la orden que se muestra en el diálogo y luego haz clic en **Confirmar** para continuar.
Una vez que la solicitud se complete, FUEL muestra la respuesta en crudo de FIRE:
* **Éxito** — FIRE devuelve el objeto de orden actualizado con estado `cancelled`. La tarjeta de respuesta se resalta en verde.
* **Error** — FIRE devuelve un código de error y un mensaje. Las causas más comunes son una orden no encontrada, un identificador inválido o que la orden se encuentre en un estado no cancelable.
## Referencia de respuesta
FIRE aceptó la cancelación. El cuerpo de la respuesta contiene el objeto completo de la orden con `"status": "cancelled"` y un timestamp `cancelledAt`.
FIRE rechazó la cancelación. Revisa el campo `message` en el cuerpo de la respuesta. Los mensajes más comunes incluyen `Order not found`, `Order already cancelled` y `Order cannot be cancelled in current state`.
## Notas
FUEL llama al endpoint de cancelación de FIRE en `POST /v1/orders/:id/cancel`. El `:id` utilizado es el ID interno de la orden en FIRE, resuelto a partir del External Order ID o el Order Code que proporcionaste. Si la búsqueda falla, FUEL mostrará un error de "no encontrado" antes de intentar la cancelación.
Si necesitas cancelar muchas órdenes a la vez, considera usar un script directamente contra la API de FIRE — la pestaña **Cancelar orden** está diseñada para cancelaciones individuales y específicas durante pruebas y depuración.