> ## 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.

# Notificações de status de pedido

> Receba atualizações de status de pedido do Fire.

Conforme um pedido avança pelo Fire (aceito, em preparação, pronto, despachado, etc.), o Fire envia eventos `order.status_changed` para seu endpoint de webhook.

## Fluxo

```
Fire emite order.status_changed → Seu sistema recebe o evento → Seu sistema age sobre ele
```

## Payload do evento

```json theme={null}
{
  "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"
  }
}
```

## Status de pedido

| Status           | Descrição                                      |
| ---------------- | ---------------------------------------------- |
| `received`       | Pedido injetado com sucesso no Fire            |
| `accepted`       | O restaurante aceitou o pedido                 |
| `in_preparation` | A cozinha começou a preparar o pedido          |
| `ready`          | O pedido está pronto para retirada ou despacho |
| `dispatched`     | Entregue ao entregador                         |
| `delivered`      | Entregue ao cliente                            |
| `cancelled`      | O pedido foi cancelado                         |

## Passos de processamento

<Steps>
  <Step title="Verifique a assinatura">
    Valide `X-Fire-Signature`. Veja [Autenticação](/pt/authentication).
  </Step>

  <Step title="Confirme imediatamente">
    Retorne `200 OK` antes de processar.
  </Step>

  <Step title="Localize o pedido">
    Use `external_order_id` para encontrar o pedido no seu sistema.
  </Step>

  <Step title="Aja sobre a mudança de status">
    Notifique os agregadores, atualize seu banco de dados, dispare workflows — o que sua integração exigir.
  </Step>
</Steps>

## Cancelamentos

Se `status` for `cancelled`, aja sobre ele prontamente. Se seu sistema repassa pedidos para agregadores, alguns exigem confirmação de cancelamento dentro de uma janela de tempo curta.