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

# Visão Geral de Transportadoras

> Como funcionam as conexões de transportadoras no BulkRoute e os modelos de integração disponíveis.

O BulkRoute possui adaptadores nativos para mais de 30 transportadoras e operadores logísticos no Brasil, além de permitir o uso de tabelas em planilha e frota própria.

## Modelos de Conexão

| Tipo                            | Descrição                                                                                            | Exemplos                                     |
| :------------------------------ | :--------------------------------------------------------------------------------------------------- | :------------------------------------------- |
| **API Direta Homologada**       | Cotação e emissão de etiqueta em tempo real diretamente nos servidores da transportadora.            | Braspress, Jadlog, SSW, Correios, Azul Cargo |
| **Frota Própria**               | Cálculo por quilometragem / raio de CEP com despacho direto para o aplicativo do motorista (PWA).    | Veículos e motoristas cadastrados por você   |
| **Planilha Offline / Fallback** | Tabelas contratuais de frete cadastradas em CSV/Excel para cotações mesmo sem internet ou API ativa. | Tabelas regionais de frete dedicado          |

## Transportadoras homologadas

### API Direta

| Transportadora                          | Tipo                       | Status     |
| :-------------------------------------- | :------------------------- | :--------- |
| [Braspress](/transportadoras/braspress) | Rodoviário + Aéreo         | ✅ Produção |
| [Jadlog](/transportadoras/jadlog)       | Package + Com              | ✅ Produção |
| [SSW](/transportadoras/ssw)             | Rodoviário (multi-carrier) | ✅ Produção |
| [Correios](/transportadoras/correios)   | SEDEX, PAC, Mini Envios    | ✅ Produção |
| Azul Cargo                              | Aéreo                      | ✅ Produção |
| Lalamove                                | Same-day                   | ✅ Produção |
| Kombex                                  | Rodoviário                 | ✅ Produção |
| DHL                                     | Express internacional      | ✅ Produção |
| FedEx                                   | Express internacional      | ✅ Produção |

### Frota Própria

| Recurso                                         | Status     |
| :---------------------------------------------- | :--------- |
| [Frota Própria](/transportadoras/frota-propria) | ✅ Produção |
| App do Motorista (PWA)                          | ✅ Produção |
| Roteirização OSRM                               | ✅ Produção |
| Tracking GPS em tempo real                      | ✅ Produção |

### Planilha Offline

| Recurso                                         | Status     |
| :---------------------------------------------- | :--------- |
| [Planilha CSV/Excel](/transportadoras/planilha) | ✅ Produção |
| Múltiplas tabelas simultâneas                   | ✅ Produção |
| Etiqueta genérica (PDF 100×150mm)               | ✅ Produção |

## Como Ativar uma Transportadora no seu Painel

1. Acesse o **Painel do BulkRoute** > **Transportadoras**.
2. Localize a transportadora desejada e clique em **Configurar**.
3. Ative o botão **Habilitar Transportadora**.
4. Preencha os campos obrigatórios (geralmente Usuário, Senha/Token e CNPJ do pagador).
5. Clique em **Testar Conexão**. O sistema fará um *ping* de validação em tempo real.
6. Salve as alterações. A partir desse instante, a transportadora já responderá nas suas cotações.

<Note>
  Você sempre utiliza suas **próprias negociações e tabelas contratuais** diretamente com as transportadoras. O BulkRoute não intermedia repasses financeiros nem retém taxas de frete.
</Note>

## Orquestração Multi-Carrier

Quando você ativa múltiplas transportadoras, o BulkRoute consulta todas em paralelo a cada cotação:

```mermaid theme={null}
graph TD
    A[Cotação Solicitada] --> B[Braspress API]
    A --> C[Jadlog API]
    A --> D[SSW API]
    A --> E[Correios API]
    A --> F[Frota Própria]
    A --> G[Planilha Offline]
    B --> H[Orquestrador]
    C --> H
    D --> H
    E --> H
    F --> H
    G --> H
    H --> I[Melhor opção por custo-benefício]
```

### O que o orquestrador considera

1. **Preço** — menor custo
2. **Prazo** — menor tempo de entrega
3. **Score de qualidade** — histórico de performance do carrier
4. **Cobertura** — faixa de CEP atendida
5. **Capacidade** — peso e dimensões suportados
6. **Restrições** — regras de negócio (ex: não enviar frágil via carrier X)

### Score de qualidade

Cada carrier tem um **scorecard** baseado em:

* Taxa de entrega no prazo
* Taxa de avarias
* Taxa de extraviados
* Tempo médio de trânsito
* Número de ocorrências

O score (0-100) influencia a decisão:

* **≥ 85**: Auto-assign (orquestrador escolhe automaticamente)
* **60-84**: Human decision (requer aprovação manual)
* **\< 60**: Rejected (carrier descartado)

Você pode ver o scorecard de cada carrier em **Transportadoras** > carrier > **Scorecard**.

## Configurações por Carrier

Cada transportadora tem suas próprias configurações:

| Configuração            | Descrição                                |
| :---------------------- | :--------------------------------------- |
| **Ambiente**            | Produção ou Homologação                  |
| **Credenciais**         | Usuário, senha, token, CNPJ              |
| **Serviços ativos**     | Quais serviços cotar (ex: SEDEX + PAC)   |
| **Formato de etiqueta** | PDF A4 ou ZPL 100×150mm                  |
| **Horário de coleta**   | Horário padrão para solicitar coleta     |
| **Markup**              | Margem aplicada sobre o preço do carrier |
| **Ativo/Inativo**       | Toggle para incluir/excluir das cotações |

## Markup de Frete

Você pode aplicar um **markup** (margem) sobre o preço do carrier:

```
Preço final = Preço carrier × (1 + markup%)
```

Exemplo:

* Preço carrier: R\$ 50,00
* Markup: 15%
* **Preço final: R\$ 57,50**

O markup pode ser configurado:

* **Por carrier**: diferente para cada transportadora
* **Por faixa de CEP**: diferente por região
* **Por tipo de carga**: diferente para frágil vs normal

<Tip>
  O markup é aplicado **depois** da cotação — o carrier não sabe que você aplicou margem. O cliente final vê apenas o preço final.
</Tip>