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

# Gerencie uma entrega

> Envie rastreamento, trate eventos de logística e confirme a entrega.

Escolha o fluxo conforme o tipo da sua integração.

<Tabs>
  <Tab title="Merchant" icon="store">
    Use o token OAuth do merchant nos endpoints de pedidos.

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

      <Step title="Envie o rastreamento">
        Se `sendTracking` for `true`, envie atualizações para `POST /v1/orders/{orderId}/tracking`.

        O objeto `deliveryTrackingInfo` pode incluir evento, entregador, veículo, previsão e localização. Consulte o [payload completo](/api-reference/orders/delivery-updates).
      </Step>

      <Step title="Valide o código">
        Quando necessário, envie o código para `POST /v1/orders/{orderId}/validateCode`.
      </Step>

      <Step title="Conclua a entrega">
        Chame `POST /v1/orders/{orderId}/delivered` depois da entrega.
      </Step>
    </Steps>
  </Tab>

  <Tab title="Operador de logística" icon="truck">
    Use os headers `X-App-Id`, `X-App-MerchantId` e `X-App-Signature` descritos na referência.

    <Steps>
      <Step title="Envie eventos">
        Chame `POST /v1/logistics/deliveryUpdate` a cada mudança relevante da entrega.
      </Step>

      <Step title="Atualize o estado">
        Informe o tipo do evento, o pedido, o merchant e os dados exigidos para aquele estado.
      </Step>

      <Step title="Confirme o código">
        Chame `POST /v1/logistics/confirmationCode` antes de concluir uma entrega que exige confirmação.
      </Step>
    </Steps>
  </Tab>
</Tabs>

## Estados de logística

| Evento              | Momento                     |
| ------------------- | --------------------------- |
| `PENDING`           | Entrega criada.             |
| `ASSIGNED`          | Entregador atribuído.       |
| `PICKUP_ONGOING`    | Deslocamento até a loja.    |
| `PICKUP_ARRIVED`    | Chegada à loja.             |
| `PICKED_UP`         | Pedido retirado.            |
| `DELIVERY_ONGOING`  | Deslocamento até o cliente. |
| `DELIVERY_FINISHED` | Entrega concluída.          |
| `REJECTED`          | Entrega recusada.           |
| `CANCELLED`         | Entrega cancelada.          |

<Warning>
  Valide o código quando ele for exigido antes de marcar o pedido como entregue.
</Warning>