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

> Passo a passo para conectar suas credenciais da API REST da Braspress.

A Braspress é especializada em transporte fracionado de cargas e encomendas por todo o território nacional. É uma das transportadoras mais usadas por clientes do BulkRoute para móveis, autopeças e carga volumosa.

## Pré-requisitos

Para configurar a Braspress no BulkRoute, solicite ao seu executivo de contas ou acesse o Portal Braspress corporativo para obter:

1. **CNPJ da Conta Contratual** (apenas números).
2. **Usuário de Integração (Webservice/API)**.
3. **Senha da API**.
4. **Tipo de Frete Contratual**: Rodoviário (padrão) ou Aéreo.

### Como obter as credenciais

1. Acesse o [Portal Braspress](https://www.braspress.com) com suas credenciais
2. Vá em **Serviços** > **Webservice**
3. Solicite o acesso à API para sua conta
4. Anote o usuário e senha de integração
5. Confirme o CNPJ da conta contratual com seu executivo

## Como Configurar no BulkRoute

1. No menu **Transportadoras**, selecione **Braspress**.
2. Preencha o formulário:
   * **Ambiente**: Produção (ou Homologação se estiver testando contrato piloto).
   * **CNPJ Pagador**: CNPJ da sua empresa cadastrado no contrato.
   * **Usuário**: Usuário fornecido pela Braspress.
   * **Senha**: Senha fornecida pela Braspress.
   * **Modal**: Rodoviário ou Aéreo.
3. Clique em **Testar Conexão**. O BulkRoute fará uma cotação de teste interna.
4. Clique em **Salvar Configurações**.

## Cubagem na Braspress

A Braspress usa fator de cubagem **300** (rodoviário) ou **167** (aéreo):

```
Peso cubado (rodoviário) = (Comprimento × Largura × Altura) ÷ 300
Peso cubado (aéreo)      = (Comprimento × Largura × Altura) ÷ 167
```

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

### Exemplo prático

Móvel 120×60×40 cm, 25 kg real (rodoviário):

* Peso cubado: `(120 × 60 × 40) ÷ 300 = 960 kg`
* Como 960 > 25, cobra por **960 kg** (peso cubado)

<Warning>
  O peso cubado pode ser muito maior que o peso real para cargas volumosas. O BulkRoute mostra o peso cobrado na cotação para você saber exatamente quanto vai pagar.
</Warning>

## Serviços disponíveis

| Serviço             | Descrição               | Prazo típico   |
| :------------------ | :---------------------- | :------------- |
| Rodoviário Nacional | Carga fracionada padrão | 3-7 dias úteis |
| Aéreo               | Carga expressa aérea    | 1-2 dias úteis |
| Rodoviário Expresso | Cotação com prioridade  | 2-4 dias úteis |

## Emissão de Etiquetas & Rastreio

### Etiquetas

As etiquetas da Braspress geradas pelo BulkRoute contêm:

* **Código de barras 2D** exigido nas unidades de triagem
* **Número do conhecimento (CT-e)**
* **Dados do remetente e destinatário**
* **Tipo de serviço contratado**

Formatos disponíveis:

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

### Rastreamento

O rastreamento é atualizado automaticamente por nosso serviço de sincronização periódica a cada **15 minutos**.

A Braspress não envia webhooks — o BulkRoute faz polling automático.

| Evento Braspress             | Status BulkRoute   |
| :--------------------------- | :----------------- |
| Coleta realizada             | `PICKED_UP`        |
| Em trânsito                  | `IN_TRANSIT`       |
| Chegada na filial de destino | `IN_TRANSIT`       |
| Em rota de entrega           | `OUT_FOR_DELIVERY` |
| Entrega realizada            | `DELIVERED`        |
| Ocorrência registrada        | `FAILED`           |

## Solicitação de Coleta

A Braspress suporta solicitação de coleta via API. Quando você cria um shipment:

1. O BulkRoute solicita a coleta via API Braspress
2. A Braspress confirma o agendamento
3. O motorista chega no endereço de origem
4. Status muda para `PICKED_UP` quando a coleta é confirmada

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

## Troubleshooting

| Problema               | Causa                      | Solução                                    |
| :--------------------- | :------------------------- | :----------------------------------------- |
| `401 Unauthorized`     | Usuário ou senha inválidos | Verificar credenciais no portal Braspress  |
| `422 Validation Error` | CNPJ não cadastrado        | Confirmar CNPJ com seu executivo Braspress |
| Cotação vazia          | Faixa de CEP não atendida  | Verificar cobertura da Braspress na região |
| Peso cubado muito alto | Carga volumosa             | Considerar dividir em volumes menores      |
| Tracking parado        | API Braspress instável     | Aguardar próximo ciclo de polling (15min)  |
| Coleta não confirmada  | Fora do horário comercial  | Configurar horário de coleta no painel     |