Notificaciones de estado de orden

A medida que una orden avanza por Fire (aceptada, en preparación, lista, despachada, etc.), Fire envía eventos order.status_changed a tu endpoint de webhook.

Flujo

Fire emite order.status_changed → Tu sistema recibe el evento → Tu sistema actúa sobre él

Payload del evento

{
  "event": "order.status_changed",
  "data": {
    "fire_order_id": "fire_order_abc",
    "external_order_id": "uber_order_9876",
    "channel_id": "channel_abc123",
    "status": "in_preparation",
    "previous_status": "accepted",
    "updated_at": "2025-01-15T14:35:00Z"
  }
}

Estados de orden

Estado	Descripción
`received`	Orden inyectada exitosamente en Fire
`accepted`	El restaurante aceptó la orden
`in_preparation`	La cocina comenzó a preparar la orden
`ready`	La orden está lista para retiro o despacho
`dispatched`	Entregada al repartidor
`delivered`	Entregada al cliente
`cancelled`	La orden fue cancelada

Pasos de procesamiento

Verifica la firma

Valida X-Fire-Signature. Consulta Autenticación.

Confirma de inmediato

Devuelve 200 OK antes de procesar.

Busca la orden

Usa external_order_id para encontrar la orden en tu sistema.

Actúa sobre el cambio de estado

Notifica a los agregadores, actualiza tu base de datos, dispara workflows — lo que tu integración requiera.

Cancelaciones

Si status es cancelled, actúa sobre él de inmediato. Si tu sistema retransmite órdenes a agregadores, algunos requieren confirmación de cancelación dentro de una ventana de tiempo corta.

Primeros pasos

Configuración

Trabajando con eventos

Guías

Notificaciones de estado de orden

Flujo

Payload del evento

Estados de orden

Pasos de procesamiento

Cancelaciones

​Flujo

​Payload del evento

​Estados de orden

​Pasos de procesamiento

​Cancelaciones

Flujo

Payload del evento

Estados de orden

Pasos de procesamiento

Cancelaciones