> ## 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 o SSW Sistema de Transportes

> Como conectar transportadoras que utilizam o sistema SSW (Webservice de Cotação e Rastreamento).

Muitas das principais transportadoras rodoviárias de carga pesada e móveis do Brasil utilizam o sistema **SSW** como backoffice logístico. O BulkRoute tem um adaptador único que funciona com qualquer transportadora baseada em SSW.

## Transportadoras que usam SSW

| Transportadora    | Sigla SSW                        |
| :---------------- | :------------------------------- |
| TNT Mercurio      | `TNT`                            |
| Rodonaves         | `RTE`                            |
| Expresso Prudente | `EXP`                            |
| Transmetal        | `MTL`                            |
| Jamef             | `JAM`                            |
| Tegma             | `TGM`                            |
| Andriolo          | `AND`                            |
| Outras            | Verifique com sua transportadora |

<Note>
  Se sua transportadora não está listada mas usa SSW, você pode configurá-la usando a sigla correta. O BulkRoute funciona com qualquer carrier SSW.
</Note>

## Dados Necessários

Para integrar com uma transportadora baseada em SSW, você precisará de:

1. **Domínio/Sigla da Transportadora** (ex: `TNT`, `RTE`, `EXP`, etc.).
2. **CNPJ do Remetente/Pagador**.
3. **Usuário SSW Webservice**.
4. **Senha SSW Webservice**.

### Como obter

1. Solicite ao seu executivo de contas da transportadora
2. Ou acesse o portal da transportadora > **Webservice / Integração**
3. Gere as credenciais de webservice
4. Anote a sigla SSW da transportadora

## Passo a Passo no BulkRoute

1. Em **Transportadoras**, selecione **SSW** (ou a transportadora específica que opera sob o SSW).
2. Insira as credenciais no formato solicitado:
   * **Sigla da Transportadora**: Conforme registrado no SSW.
   * **CNPJ**: CNPJ da sua matriz ou filial expedidora.
   * **Usuário e Senha**.
3. Defina se a transportadora aplica taxa de coleta ou agendamento específico.
4. Clique em **Testar Conexão**.
5. Salve e ative a transportadora.

## Cubagem no SSW

O SSW usa fator de cubagem **300** (padrão rodoviário):

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

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

<Tip>
  Se a sua transportadora usa SSW mas não possui webservice de cotação liberado, você pode exportar a planilha de tabela de frete deles e importá-la diretamente na aba [Planilha Offline](/transportadoras/planilha).
</Tip>

## Etiquetas

O SSW fornece etiqueta própria via webservice. O BulkRoute gera automaticamente:

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

A etiqueta inclui:

* Código de rastreio SSW
* Código de barras 128
* Número do conhecimento (CT-e)
* Dados do remetente e destinatário

## Rastreamento

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

| Evento SSW           | Status BulkRoute   |
| :------------------- | :----------------- |
| Coletado             | `PICKED_UP`        |
| Em trânsito          | `IN_TRANSIT`       |
| Em filial de destino | `IN_TRANSIT`       |
| Em rota de entrega   | `OUT_FOR_DELIVERY` |
| Entregue             | `DELIVERED`        |
| Ocorrência           | `FAILED`           |

## Troubleshooting

| Problema               | Causa                       | Solução                                    |
| :--------------------- | :-------------------------- | :----------------------------------------- |
| `401 Unauthorized`     | Usuário/senha inválidos     | Verificar credenciais com a transportadora |
| `422 Validation Error` | Sigla incorreta             | Confirmar sigla SSW com a transportadora   |
| Cotação vazia          | Faixa de CEP não atendida   | Verificar cobertura da transportadora      |
| Tracking parado        | API SSW instável            | Aguardar próximo ciclo de polling          |
| Carrier não encontrado | Sigla não cadastrada no SSW | Verificar sigla com seu executivo          |