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

# Como Despachar uma Carga

> Crie um envio, gere etiqueta e despache para a transportadora — ou para sua frota própria.

## Quando usar

Você já cotou e quer transformar a cotação em um envio real. O despacho cria o shipment, gera a etiqueta e notifica a transportadora (ou sua frota).

## Despachar via painel

### 1. Criar o envio

1. Acesse **Pedidos** > **Envios** (`/admin/shipments`)
2. Clique em **Novo Envio**
3. Preencha os dados:
   * **Remetente** (CEP de origem, nome, contato)
   * **Destinatário** (CEP de destino, nome, CPF/CNPJ, telefone)
   * **Itens** (peso, dimensões, valor, quantidade)
   * **Transportadora** (escolha da cotação ou selecione manualmente)
4. Salve — o shipment é criado com status `PENDING`

### 2. Gerar etiqueta

1. No envio criado, clique em **Gerar Etiqueta**
2. O BulkRoute chama a API da transportadora e gera o PDF
3. Baixe e imprima a etiqueta (formato 100×150mm)
4. Cole na caixa/volume

<Note>
  Algumas transportadoras não têm API de etiqueta. Nesses casos, o BulkRoute gera uma **etiqueta genérica** (PDF 100×150mm) com os dados do envio — funciona para qualquer carrier.
</Note>

### 3. Despachar

1. Com a etiqueta colada, clique em **Despachar**
2. O status muda para `DISPATCHED`
3. A transportadora é notificada (ou sua frota recebe a rota)

## Despacho em lote

Se você tem vários envios prontos para a mesma transportadora:

1. Acesse **Orquestra** > **Cotações** ou **Pedidos** > **Envios**
2. Selecione os envios (checkbox)
3. Clique em **Despachar Todos**
4. O BulkRoute despacha todos de uma vez

## Despacho para frota própria

Se você tem frota própria e quer despachar com seus motoristas:

1. Acesse **Campo** > **Despacho Frota** (`/admin/dispatch`)
2. Os envios atribuídos à frota própria aparecem no pipeline
3. Selecione o motorista
4. Clique em **Despachar** — o motorista recebe a rota no app

<Accordion title="Status do envio durante o despacho">
  * `PENDING` → envio criado, aguardando etiqueta
  * `LABEL_GENERATED` → etiqueta gerada, pronto para despachar
  * `DISPATCHED` → despachado para a transportadora
  * `PICKED_UP` → carga coletada na expedição
  * `IN_TRANSIT` → em trânsito
  * `OUT_FOR_DELIVERY` → em rota de entrega
  * `DELIVERED` → entregue
</Accordion>

<Accordion title="Despacho via API">
  ```bash theme={null}
  curl -X POST "https://api.bulkroute.com.br/api/orders" \
    -H "X-API-Key: bk_live_..." \
    -H "Content-Type: application/json" \
    -d '{
      "destinationZip": "01310100",
      "originZip": "80000000",
      "carrierCode": "braspress",
      "items": [...],
      "recipient": { "name": "...", "document": "...", "phone": "..." }
    }'
  ```

  A resposta retorna o `trackingCode` e o status inicial `PENDING`.
</Accordion>