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

# Despache um pedido

> Informe que a entrega começou.

Chame este endpoint quando o entregador retirar o pedido e iniciar a entrega.

## Parâmetros de rota

<ParamField path="orderId" type="string (uuid)" required>
  Identificador único do pedido sendo despachado. Gerado pela Onbeef e retornado no evento do pedido.
</ParamField>

## Corpo da requisição

Este endpoint não exige corpo de requisição.

## Resposta

### 202: Aceito

A requisição de despacho foi aceita para processamento. O status do pedido é atualizado para refletir que está saindo para entrega.

### 401: Não autorizado

Retornado quando a requisição não inclui credenciais de autenticação válidas.

### 404: Não encontrado

Nenhum pedido foi encontrado com o `orderId` informado.

## Exemplo de requisição

<CodeGroup>
  ```bash Sandbox theme={null}
  curl --request POST \
    --url "https://api.dev.connect.onbeefapp.com.br/v1/orders/f47ac10b-58cc-4372-a567-0e02b2c3d479/dispatch" \
    --header "Authorization: Bearer <token>"
  ```

  ```bash Produção theme={null}
  curl --request POST \
    --url "https://api.connect.onbeefapp.com.br/v1/orders/f47ac10b-58cc-4372-a567-0e02b2c3d479/dispatch" \
    --header "Authorization: Bearer <token>"
  ```
</CodeGroup>

<Tip>
  Após despachar um pedido, você pode usar o endpoint [Atualizações de entrega](/api-reference/orders/delivery-updates) para enviar localização e status em tempo real à Onbeef enquanto o pedido está em trânsito, enriquecendo a experiência do cliente.
</Tip>

<Warning>
  Só chame este endpoint depois que o entregador tiver retirado fisicamente o pedido. Chamá-lo cedo demais: enquanto o entregador ainda está a caminho da sua loja: dará ao cliente informações imprecisas sobre o status da entrega.
</Warning>