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

# Configurando a Jadlog

> Integração oficial com a API da Jadlog para cotação, coleta e emissão de etiquetas.

A Jadlog atende tanto entregas expressas quanto encomendas fracionadas de e-commerce e B2B. É uma das transportadoras mais usadas por clientes do BulkRoute.

## O que você precisa

1. **Token de API Jadlog**: Gerado no portal [Jadlog para Clientes](https://www.jadlog.com.br).
2. **Código de Conta / Contrato Corrente**.
3. **Modal Contratado**: `.Package` (encomendas pequenas) ou `.Com` (carga fracionada).
4. **CNPJ do Pagador** (apenas números).

### Como obter

1. Acesse o portal Jadlog com suas credenciais de cliente
2. Vá em **Serviços Online** > **Webservice**
3. Gere o token de API
4. Anote o código da conta e o contrato corrente

## Configuração no Painel

1. Acesse **Transportadoras** > **Jadlog**.
2. Preencha os campos:
   * **Ambiente**: Produção (ou Homologação para testes)
   * **Token de Autorização**: token gerado no portal Jadlog
   * **Código da Conta**: seu código de cliente Jadlog
   * **Contrato Corrente**: número do contrato
   * **CNPJ Pagador**: CNPJ da empresa pagadora do frete
3. Selecione a modalidade contratual principal:
   * `.Package` — encomendas até 30kg, ideal para e-commerce
   * `.Com` — carga fracionada, ideal para móveis e volumes grandes
4. Escolha o formato padrão de etiqueta:
   * **PDF A4** (duas ou quatro etiquetas por folha)
   * **Térmica 100x150mm (ZPL/PDF)**
5. Clique em **Testar Conexão** — o BulkRoute faz uma cotação de teste interna.
6. Salve as configurações.

## Cubagem na Jadlog

A Jadlog usa fator de cubagem **300** (cm³ → kg):

```
Peso cubado = (Comprimento × Largura × Altura) ÷ 300
```

Cobrança pelo **maior** entre peso real e peso cubado.

### Exemplo

Sofá 200×90×85 cm, 40 kg real:

* Peso cubado: `(200 × 90 × 85) ÷ 300 = 5.100 kg`
* Como 5.100 > 40, cobra por **5.100 kg** (peso cubado)

<Note>
  O BulkRoute calcula isso automaticamente. Se o peso cubado for muito alto, considere dividir em volumes menores ou usar carrier com fator mais favorável.
</Note>

## Serviços disponíveis

| Serviço       | Descrição                        | Prazo típico   |
| :------------ | :------------------------------- | :------------- |
| `.Package`    | Encomenda expressa (até 30kg)    | 1-3 dias úteis |
| `.Com`        | Carga fracionada (acima de 30kg) | 2-5 dias úteis |
| `.Rodoviário` | Rodoviário nacional              | 3-7 dias úteis |
| `.Aéreo`      | Aéreo expresso                   | 1-2 dias úteis |

## Solicitação de Coleta

A Jadlog suporta coleta automática via API. Quando você cria um shipment no BulkRoute:

1. O BulkRoute solicita a coleta via API Jadlog
2. A Jadlog agenda a coleta no endereço de origem
3. O motorista da Jadlog chega no horário agendado
4. O status muda para `PICKED_UP` quando a coleta é confirmada

<Tip>
  Configure o **horário padrão de coleta** em **Transportadoras** > **Jadlog** > **Configurações avançadas**. O BulkRoute usa esse horário ao solicitar a coleta automaticamente.
</Tip>

## Etiquetas

A Jadlog fornece etiqueta própria via API. O BulkRoute gera automaticamente:

* **PDF A4** (2 etiquetas por folha)
* **ZPL 100×150mm** (térmica)

A etiqueta inclui:

* Código de rastreio Jadlog
* Código de barras 128
* Dados do remetente e destinatário
* Tipo de serviço (Package/Com)

## Rastreamento

A Jadlog não envia webhooks. O BulkRoute rastreia via **polling a cada 15 minutos**:

| Evento Jadlog        | Status BulkRoute   |
| :------------------- | :----------------- |
| Pedido coletado      | `PICKED_UP`        |
| Em trânsito          | `IN_TRANSIT`       |
| Em filial de destino | `IN_TRANSIT`       |
| Em rota de entrega   | `OUT_FOR_DELIVERY` |
| Entrega realizada    | `DELIVERED`        |
| Tentativa de entrega | `FAILED`           |

## Troubleshooting

| Problema               | Causa                      | Solução                              |
| :--------------------- | :------------------------- | :----------------------------------- |
| `401 Unauthorized`     | Token inválido ou expirado | Gerar novo token no portal Jadlog    |
| `422 Validation Error` | CNPJ ou contrato incorreto | Verificar dados cadastrais na Jadlog |
| Cotação vazia          | Faixa de CEP não atendida  | Verificar cobertura da Jadlog        |
| Coleta não agendada    | Fora do horário comercial  | Configurar horário de coleta         |
| Tracking parado        | API Jadlog instável        | Aguardar próximo ciclo de polling    |