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

# Gestão de Envios & Etiquetas

> Como emitir pedidos, gerar etiquetas de envio e organizar a expedição física.

Depois que um pedido é aprovado e a melhor transportadora é selecionada, o registro passa a ser um **Shipment (Envio)** no BulkRoute.

## 1. Visualizando seus Envios

Acesse o menu **Shipments**. Todas as suas cargas são exibidas em uma tabela operacional completa com:

* Código do Pedido / Nota Fiscal
* Transportadora atribuída
* Status atualizado em tempo real
* Destinatário e Cidade de Entrega
* Ações rápidas (Imprimir Etiqueta, Ver Rastreio, Cancelar)

### Filtros e busca

* **Busca por tracking code, pedido ou destinatário**
* **Filtro por status**: PENDING, PICKED\_UP, IN\_TRANSIT, OUT\_FOR\_DELIVERY, DELIVERED, FAILED
* **Filtro por transportadora**
* **Filtro por período**
* **Exportar CSV/PDF** (geração assíncrona via BullMQ — você recebe por e-mail quando pronto)

### Kanban de Status (Pipeline)

Alternando para a visão de Kanban, você vê seus envios organizados em colunas por status — útil para a equipe de expedição acompanhar o fluxo do dia:

```
PENDING → LABEL_GENERATED → DISPATCHED → PICKED_UP → IN_TRANSIT → OUT_FOR_DELIVERY → DELIVERED
```

## 2. Emissão de Etiquetas

O BulkRoute padroniza a emissão de etiquetas, independentemente da transportadora parceira:

* **Formato Térmico Padrão (100x150 mm)**: Compatível com impressoras Zebra, Argox, Elgin e Datamax.
* **Formato Folha A4 (PDF)**: Ideal para impressão comum em papel adesivo com picote.

<Tip>
  Transportadoras que não fornecem etiqueta por API própria têm etiquetas geradas automaticamente pelo motor interno do BulkRoute com código de barras Code-128 legível em qualquer triagem.
</Tip>

## 3. Criando um Envio Manualmente

Para criar um envio sem passar pela cotação (ex: frete já negociado fora do sistema):

1. Acesse **Shipments** > **Novo Envio**
2. Preencha os dados do destinatário:
   * Nome, CPF/CNPJ, telefone, e-mail
   * CEP (autocompleta endereço via BrasilAPI)
   * Número, complemento, referência
3. Preencha os dados da carga:
   * Peso, dimensões, valor declarado
   * Quantidade de volumes
   * Tipo de carga (frágil, refrigerado, etc.)
4. Selecione a transportadora (ou deixe o orquestrador escolher)
5. Clique em **Criar Envio**

O BulkRoute gera o tracking code, cria a etiqueta e notifica o destinatário.

## 4. Criando um Envio 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",
    "recipient": {
      "name": "João Silva",
      "document": "12345678900",
      "phone": "11999999999",
      "email": "joao@exemplo.com",
      "address": {
        "street": "Av. Paulista",
        "number": "1000",
        "complement": "Apto 150",
        "district": "Bela Vista",
        "city": "São Paulo",
        "state": "SP"
      }
    },
    "items": [
      {
        "sku": "SOFA-3L",
        "description": "Sofá 3 lugares",
        "weight": 40,
        "length": 200,
        "width": 90,
        "height": 85,
        "value": 2500,
        "quantity": 1
      }
    ]
  }'
```

## 5. Agendamento de Entrega

Para clientes que suportam janelas de entrega (frota própria e alguns carriers):

1. Ao criar o envio, expanda **Agendamento**
2. Selecione a **data** desejada
3. Selecione a **janela** disponível (ex: 08h-12h, 13h-18h)
4. O sistema valida a disponibilidade em tempo real
5. O destinatário recebe a confirmação por WhatsApp/SMS/e-mail

### Reagendamento pelo cliente

O cliente pode reagendar a entrega sem contato com o SAC:

1. O link de rastreio inclui um botão **Reagendar**
2. O cliente seleciona nova data/janela
3. O sistema valida e confirma automaticamente

## 6. Cancelamento e Reversa

### Cancelar um envio

1. Abra o shipment no painel
2. Clique em **Cancelar**
3. Confirme o motivo (ex: cliente desistiu, endereço errado)
4. Se a coleta já foi solicitada, o BulkRoute cancela junto à transportadora

### Logística reversa

Para devoluções:

1. Abra o shipment original
2. Clique em **Gerar Etiqueta de Retorno**
3. O BulkRoute cria um `return_shipment` vinculado
4. O cliente recebe um link para agendar a coleta reversa
5. A devolução é rastreada como um shipment separado

<Note>
  A etiqueta de retorno usa a mesma transportadora do envio original por padrão. Você pode escolher uma diferente se preferir economizar.
</Note>