Gestão de Envios & Etiquetas

​

1. Visualizando seus Envios

• 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)

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

​

2. Emissão de Etiquetas

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

​

3. Criando um Envio Manualmente

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

​

4. Criando um Envio via API

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

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

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

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