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

# Entenda a integração de logística

> Conheça os fluxos de rastreamento, eventos e confirmação de entrega da Onbeef.

A logística começa quando o pedido é despachado e termina quando a entrega é confirmada.

## Dois tipos de integração

<CardGroup cols={2}>
  <Card title="Integração de merchant" icon="store">
    Envia rastreamento por `POST /v1/orders/{orderId}/tracking` e valida códigos por `POST /v1/orders/{orderId}/validateCode`.
  </Card>

  <Card title="Operador de logística" icon="truck">
    Envia eventos por `POST /v1/logistics/deliveryUpdate` e confirma códigos por `POST /v1/logistics/confirmationCode`.
  </Card>
</CardGroup>

Os endpoints `/v1/logistics/*` usam os headers de autenticação descritos em suas páginas de referência. Eles não usam o token OAuth do merchant.

## Fluxo da entrega

```text theme={null}
READY_FOR_PICKUP → DISPATCHED → rastreamento → validação → DELIVERED
```

O campo `sendTracking` do pedido indica se a integração deve enviar atualizações de rastreamento.

## Eventos de logística

O operador pode informar estes estados:

| Evento              | Significado                   |
| ------------------- | ----------------------------- |
| `PENDING`           | Entrega criada.               |
| `ASSIGNED`          | Entregador atribuído.         |
| `PICKUP_ONGOING`    | Entregador a caminho da loja. |
| `PICKUP_ARRIVED`    | Entregador na loja.           |
| `PICKED_UP`         | Pedido retirado.              |
| `DELIVERY_ONGOING`  | Pedido em trânsito.           |
| `DELIVERY_FINISHED` | Pedido entregue.              |
| `REJECTED`          | Entrega recusada.             |
| `CANCELLED`         | Entrega cancelada.            |

## Código de entrega

Quando o pedido exigir um código, valide-o antes de concluir a entrega. O merchant e o operador de logística usam endpoints diferentes para essa ação.

<Card title="Gerenciar uma entrega" icon="route" href="/guides/delivery-flow">
  Veja o fluxo de merchant e o fluxo do operador de logística.
</Card>