Como Gerar Etiquetas

​

Quando usar

​

Gerar etiqueta pelo painel

1. Acesse Pedidos > Envios (/admin/shipments)
2. Abra o envio (ou selecione vários na lista)
3. Clique em Gerar Etiqueta
4. O PDF é gerado e baixado automaticamente
5. Imprima em uma impressora térmica ou comum

​

Etiqueta da transportadora vs etiqueta genérica

​

Etiqueta da transportadora

• O BulkRoute chama a API da transportadora
• Gera o PDF no formato da transportadora
• Inclui código de barras e dados no padrão dela

​

Etiqueta genérica (BulkRoute)

• O BulkRoute gera uma etiqueta genérica em PDF (100×150mm)
• Inclui: remetente, destinatário, código de rastreio, código de barras
• Funciona para qualquer transportadora

​

Reimprimir etiqueta

1. Abra o envio
2. Clique em Reimprimir Etiqueta
3. O PDF é gerado novamente

​

Cancelar etiqueta

1. Abra o envio
2. Clique em Cancelar Etiqueta
3. O BulkRoute notifica a transportadora (quando suportado)
4. O status muda para CANCELLED

​

Etiqueta pública (link temporário)

1. Abra o envio
2. Clique em Link Público da Etiqueta
3. O BulkRoute gera um link temporário (expira em 24h)
4. Compartilhe o link — a pessoa pode baixar e imprimir

# Gerar
curl -X POST "https://api.bulkroute.com.br/api/labels" \
  -H "X-API-Key: bk_live_..." \
  -H "Content-Type: application/json" \
  -d '{ "shipmentId": "shp_123" }'

# Baixar PDF
curl -X GET "https://api.bulkroute.com.br/api/labels/{trackingCode}/download" \
  -H "X-API-Key: bk_live_..." \
  -o etiqueta.pdf

# Link público (24h)
curl -X POST "https://api.bulkroute.com.br/api/labels/{trackingCode}/public-link" \
  -H "X-API-Key: bk_live_..."