A tela Transportadoras
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.

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 |
| 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 |
| Fretes Próprios | A entrega que a própria loja faz (motoboy, entregador, retirada) e as tabelas de frete importadas. Veja Fretes Próprios |
| Caixas | As medidas dos produtos, a caixa padrão e as caixas em que a loja despacha. Veja A aba Caixas |
Os gateways de frete (Melhor Envio, Frenet, Intelipost, SmartEnvios e SuperFrete) ficam numa tela separada, 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.
- “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.
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.
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.
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 junta serviços parecidos numa opção só.