> ## 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 Gerar Etiquetas

> Gere e imprima etiquetas de envio em PDF — para qualquer transportadora.

## Quando usar

Você criou o envio e precisa da etiqueta para colar na caixa antes de despachar. O BulkRoute gera etiquetas em PDF para todas as transportadoras.

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

<Note>
  **Formato padrão:** 100×150mm (formato de etiqueta térmica). Funciona em impressoras Zebra, Bixolon e similares.
</Note>

## Etiqueta da transportadora vs etiqueta genérica

O BulkRoute gera dois tipos de etiqueta:

### Etiqueta da transportadora

Quando a transportadora tem API de etiqueta (Braspress, Jadlog, SSW, Correios, etc.):

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

Quando a transportadora **não** tem API de etiqueta:

* 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

Se a etiqueta rasgou, sujou ou você perdeu o arquivo:

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

## Cancelar etiqueta

Se o envio foi cancelado:

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)

Se você precisa enviar a etiqueta para alguém que não tem acesso ao painel:

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

<Accordion title="Gerar etiqueta via API">
  ```bash theme={null}
  # 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_..."
  ```
</Accordion>