# 4.1 A tela Transportadoras

> Como a tela Transportadoras está organizada: a coluna de abas com o status de cada transportadora, os avisos do topo e as seções que se repetem em toda aba.

Fonte: https://www.cotafrete.app/manual/transportadoras/tela-transportadoras/
Planos: Widget, Basic, Business · no checkout, requer o Carrier Calculated Shipping (CCS) da Shopify
No app: Transportadoras
Atualizado em 25/10/2026

---

Uma transportadora integrada é uma empresa de entrega com a qual o Cota Frete conversa pela API (interface de programação). Quando o cliente digita o CEP, o app pergunta à API de cada transportadora ativa quanto custa e quanto demora levar aquele pacote até ali. A resposta volta com preço e prazo, passa pelas regras da loja e aparece na tela.

A tela **Transportadoras** é onde você diz ao app com quais transportadoras ele deve conversar e em nome de qual contrato.

![Tela Transportadoras com a lista de abas à esquerda e a aba Correios aberta](https://www.cotafrete.app/manual/images/manual/transportadoras-tela.webp)

## Como a tela está organizada

A tela tem duas colunas. Na esquerda, a lista de abas. Na direita, o conteúdo da aba escolhida.

| Aba | Para quê |
|---|---|
| **Geral** | Configurações que valem para todas as transportadoras. Veja [Aba Geral](https://www.cotafrete.app/manual/transportadoras/aba-geral/) |
| **Correios**, **Total Express**, **J&T Express**, **Jadlog**, **Loggi**, **Lalamove**, **R3 Express** | Uma transportadora por aba, com as credenciais do contrato e os serviços. A **Gollog** aparece só para lojas em que a equipe do Cota Frete habilitou a integração. Veja [Gollog](https://www.cotafrete.app/manual/transportadoras/gollog/) |
| **Fretes Próprios** | A entrega que a própria loja faz (motoboy, entregador, retirada) e as tabelas de frete importadas. Veja [Fretes Próprios](https://www.cotafrete.app/manual/fretes-proprios/) |
| **Caixas** | As medidas dos produtos, a caixa padrão e as caixas em que a loja despacha. Veja [A aba Caixas](https://www.cotafrete.app/manual/produtos-e-caixas/tela-caixas/) |

Os gateways de frete (Melhor Envio, Frenet, Intelipost, SmartEnvios e SuperFrete) ficam numa tela separada, [Gateways de frete](https://www.cotafrete.app/manual/gateways-de-frete/), com a mesma organização.

### O status na coluna da esquerda

Embaixo do nome de cada aba aparece o status, com um ponto colorido:

| Status | O que quer dizer |
|---|---|
| **Configurado** ou **Pendente** (na aba Geral) | Se as configurações gerais obrigatórias estão salvas |
| **2 serviços ativos** | A transportadora está ativa, com credenciais válidas, e oferece esse número de serviços |
| **Inativo** | A transportadora está desligada ou ainda não foi configurada |
| **Sem cotações** (ponto vermelho) | A transportadora parou de devolver cotações. Veja abaixo |

## Os avisos do topo

Dois avisos podem aparecer acima das abas:

- **Ative o CCS para cotar frete no checkout.** A loja ainda não tem o Carrier Calculated Shipping (CCS, "cotação calculada pela transportadora") ativo. Sem ele, a cotação funciona na página do produto, no carrinho e na gaveta, mas não no checkout. Veja [Ativar o CCS na Shopify](https://www.cotafrete.app/manual/checkout/ativar-ccs/).
- **"Correios está sem retornar cotações"** (ou "2 transportadoras estão sem retornar cotações"). O app testa cada transportadora ativa a cada 5 minutos. Quando uma para de responder, o aviso aparece aqui, na tela Início e na própria aba da transportadora. Enquanto durar, as opções dela não aparecem no checkout. O aviso some sozinho quando as cotações voltam. Para receber esse aviso por e-mail, veja [Avisos de instabilidade](https://www.cotafrete.app/manual/transportadoras/aba-geral/#avisos-de-instabilidade).

## O que se repete em toda aba de transportadora

Cada aba segue a mesma estrutura. Entender uma ajuda a configurar todas.

### Cabeçalho e o interruptor Ativo

No topo da aba ficam o logo, o nome e um selo de situação: **Ativo**, **Inativo** ou **Credenciais inválidas**. À direita, o interruptor **Ativo** liga ou desliga a transportadora. Só transportadoras ativas entram na cotação. Desligar é o jeito de tirar uma transportadora da loja sem apagar as credenciais: quando voltar a usar, basta ligar de novo.

### Credenciais

Os campos que identificam o seu contrato. Variam de transportadora para transportadora: os Correios com contrato pedem idCorreios, código de acesso à API e cartão de postagem, a J&T Express pede quatro credenciais, a R3 Express pede só um código.

O **CEP de Origem** só aparece na aba da transportadora quando a opção **Permitir customização por transportadora**, da aba Geral, está ligada. Com ela desligada, todas cotam a partir do CEP da aba Geral.

Ao salvar, o app testa as credenciais na transportadora. Se algo estiver errado, aparece o aviso **Erro ao validar credenciais** e o selo muda para **Credenciais inválidas**. Senhas, tokens e chaves salvos não voltam a aparecer na tela: veja [Segurança e troca de credenciais](https://www.cotafrete.app/manual/transportadoras/credenciais/).

### Serviços do contrato

Cada transportadora oferece um ou mais serviços (PAC e SEDEX nos Correios, Package e Expresso na Jadlog). Em **Serviços do contrato**, ligue os que a loja quer mostrar ao cliente. O selo ao lado do título conta quantos estão selecionados. Sem nenhum, a aba avisa: "Selecione pelo menos um serviço para realizar cotações corretamente."

Ligue só os serviços que estão no seu contrato. Serviço ligado sem contrato não devolve cotação.

### Parâmetros de cálculo

Aparece só com **Permitir customização por transportadora** ligada. Tem o **Peso adicional**, em gramas, somado ao peso de todo pacote daquela transportadora (útil para o peso da embalagem). Na Total Express, tem também **Calcular ICMS**.

Acréscimos de valor e de prazo **não ficam mais nas abas das transportadoras**. A tela avisa: "Acréscimos e prazos extras ficam em Regras de frete". Veja [Acréscimo](https://www.cotafrete.app/manual/regras-de-frete/acrescimo/).

### Salvar

As mudanças só valem depois de clicar em **Salvar** na barra da Shopify, no topo da tela.

## Plano

Todas as transportadoras podem ser configuradas em todos os planos, desde o Widget. O plano decide **onde** a cotação aparece, não quais transportadoras a loja pode usar: no Widget, na página do produto, no carrinho e na gaveta; a partir do Basic, também no checkout, com o CCS ativo na loja.

## Quantas transportadoras ativar

Pelo menos duas. As APIs de transportadora saem do ar de vez em quando, e o app não tem tabela de contingência. Com duas origens de cotação ativas, a loja continua cotando quando uma delas falha.

Mais transportadoras significa mais opções para o cliente, mas também uma lista maior na tela. Se a lista ficar longa, uma regra de [agrupamento](https://www.cotafrete.app/manual/regras-de-frete/agrupar/) junta serviços parecidos numa opção só.