> ## Documentation Index
> Fetch the complete documentation index at: https://docs.onbeef.app/llms.txt
> Use this file to discover all available pages before exploring further.

# Processe um pedido

> Consulte eventos e conduza cada pedido do aceite à entrega.

O fluxo combina polling de eventos, consulta do pedido e mudanças de estado.

<Steps>
  <Step title="Consulte os eventos">
    Chame `GET /v1/events:polling` com seu token:

    ```bash Sandbox theme={null}
    curl --request GET \
      --url https://api.dev.connect.onbeefapp.com.br/v1/events:polling \
      --header 'Authorization: Bearer <access_token>'
    ```

    Cada evento informa `eventId`, `eventType` e `orderId`.
  </Step>

  <Step title="Consulte o pedido">
    Use o `orderId` em `GET /v1/orders/{orderId}`. Valide itens, valores, cliente, pagamento e entrega antes de continuar.
  </Step>

  <Step title="Confirme os eventos processados">
    Envie os eventos para `POST /v1/events/acknowledgment`. Você pode confirmar vários eventos no mesmo array.

    <Note>
      Um evento não confirmado pode aparecer novamente no próximo polling.
    </Note>
  </Step>

  <Step title="Aceite o pedido">
    Chame `POST /v1/orders/{orderId}/confirm`. Informe os campos exigidos pela [referência do endpoint](/api-reference/orders/confirm).
  </Step>

  <Step title="Informe que o pedido está pronto">
    Chame `POST /v1/orders/{orderId}/readyForPickup` quando o preparo terminar.
  </Step>

  <Step title="Despache o pedido">
    Chame `POST /v1/orders/{orderId}/dispatch` quando o entregador retirar o pedido.
  </Step>

  <Step title="Conclua a entrega">
    Valide o código de entrega quando necessário. Depois, chame `POST /v1/orders/{orderId}/delivered`.
  </Step>
</Steps>

## Cancelamentos

<CardGroup cols={3}>
  <Card title="Solicitar" icon="circle-exclamation" href="/api-reference/orders/request-cancellation">
    Inicie o cancelamento de um pedido.
  </Card>

  <Card title="Aceitar" icon="circle-check" href="/api-reference/orders/accept-cancellation">
    Aceite uma solicitação recebida.
  </Card>

  <Card title="Negar" icon="circle-xmark" href="/api-reference/orders/deny-cancellation">
    Negue a solicitação e mantenha o pedido ativo.
  </Card>
</CardGroup>

## Referências rápidas

* [Consultar eventos](/api-reference/orders/get-events)
* [Confirmar eventos](/api-reference/orders/confirm-events)
* [Consultar pedido](/api-reference/orders/get-order)
* [Gerenciar a entrega](/guides/delivery-flow)