Tabela de frete própria: cote pela planilha da transportadora contratada

Muita transportadora regional não tem API. O contrato vem numa planilha: faixas de CEP, prazo, preço por peso e uma lista de taxas. Até agora, quem trabalhava com uma dessas transportadoras não conseguia mostrar o frete dela na loja.

Com a tabela de frete própria, você importa essa planilha e o Cota Frete cota por ela na página do produto, no carrinho e no checkout, ao lado das transportadoras integradas. Recurso do plano Business.

Antes de começar

• A cotação no checkout segue a regra de sempre: precisa do CCS ativo na loja.
• O peso padrão por item e as dimensões padrão da caixa vêm das configurações gerais, em Transportadoras → Geral. O peso padrão cobre produtos sem peso cadastrado; as dimensões entram no peso cubado.
• Tenha em mãos a tabela do contrato. Baixe a planilha modelo para ver o formato preenchido.

Monte a planilha

Um único arquivo .xlsx com duas abas, com estes nomes: areas e pesos. Outras abas são ignoradas.

Aba areas: uma linha por faixa de CEP

As taxas do contrato também entram nessa aba, uma coluna para cada:

• Percentual sobre o valor do pedido: ad_valorem, gris, iss, fluvial_insurance. Escreva o percentual: 0.3 é 0,3%.
• Valor fixo em reais: pedagio (ou toll), despacho (ou dispatch), tas, tde, trt, tsa.

Várias faixas de CEP podem usar o mesmo area_code. É o caso comum: a capital tem mais de uma faixa e todas custam igual.

Aba pesos: o preço de cada faixa de peso

Três cuidados que evitam quase todo erro

• CEP como texto. O Excel apaga o zero da frente dos CEPs de São Paulo (01001000 vira 1001000). Formate as colunas de CEP como texto antes de colar.
• Faixas não podem se sobrepor. Nem duas faixas de CEP, nem duas faixas de peso da mesma área. Faixas encostadas valem: 0 a 1 kg e 1 a 2 kg. O peso exato do limite fica na faixa de baixo.
• Toda área precisa de faixas de peso. Um area_code na aba areas sem linhas na aba pesos é erro.

Cadastre a transportadora e importe

1. No admin da Shopify, abra Cota Frete → Tabelas de frete e clique em Nova transportadora no menu lateral.
2. Em Identificação, preencha o Nome exibido no checkout e um Código único. A logo é opcional.
3. Em Tabela de frete, arraste a planilha ou clique para escolher o arquivo. O nome do arquivo aparece embaixo do campo.
4. Em Regras de cálculo e Limites da operação, preencha o que o contrato prevê (detalhes abaixo).
5. Clique em Salvar, na barra que aparece no topo da tela.

A transportadora entra no menu lateral e a planilha vai para a fila. O status passa por Na fila, Importando e termina em Pronta para ativar, Pronta, com avisos ou Falhou. Se você enviar outra planilha nesse meio tempo, ela espera a vez.

Confira a importação

No menu lateral, Importações lista todas as planilhas enviadas, com a transportadora, a data, o status e o resultado. Quando alguma falha, o item mostra quantas.

Abra uma importação para ver o detalhe:

• Problemas encontrados, com a aba, a linha e o que aconteceu. Ex.: aba areas, linha 12: faixa de CEP sobreposta à linha 8.
• Baixar planilha enviada, para corrigir exatamente o arquivo que subiu.
• Baixar relatório (CSV), com a lista de problemas para abrir no Excel ao lado da planilha.

Erro impede a ativação. Aviso não: uma faixa de peso sem faixa de CEP correspondente, por exemplo, só ocupa espaço.

Corrigiu? Volte na transportadora e use Importar nova tabela. A tabela em uso continua valendo até você ativar a nova.

Ative

1. Na importação sem erros, clique em Ativar tabela. Ou use Ativar no histórico da transportadora.
2. No topo da transportadora, ligue o Ativo e clique em Salvar.

O Ativo só libera quando existe uma tabela ativa. Assim não fica transportadora ligada sem preço para cotar.

Para conferir antes de publicar, use o simulador de frete na tela Início: ele roda o mesmo cálculo da loja.

Como o valor é calculado

Para cada CEP, o app acha a faixa da aba areas e segue esta ordem:

1. Preço da faixa de peso da área. Acima da última faixa, soma o excedente por kg sobre o peso que passou. Sem valor de excedente, a transportadora não aparece para esse peso.
2. Frete valor, se configurado na transportadora: percentual sobre o valor do pedido.
3. Taxas da planilha: as percentuais sobre o valor do pedido, as fixas em reais.
4. Frete mínimo: se o total ficou abaixo, vale o mínimo. O da área tem prioridade; o da transportadora cobre as áreas sem mínimo.
5. ICMS: só entra se você desligar Os preços da tabela já incluem ICMS. Nesse caso é somado por dentro: total ÷ (1 − alíquota).

Exemplo com a planilha modelo: pedido de R$ 220,00 e 3 kg para Belo Horizonte (área MGC).

Prazo: 4 dias úteis.

Regras de cálculo e limites

• Fator de cubagem: o que o contrato diz, em kg por m³. O padrão do rodoviário é 300; do aéreo, 166,7. O peso cubado é o volume da caixa padrão em m³ vezes o fator: uma caixa de 30 x 30 x 30 cm (0,027 m³) a 300 dá 8,1 kg. O app cobra o maior entre o peso real e o peso cubado. Deixe em branco se o contrato não prevê cubagem.
• Isenção de cubagem: abaixo desse peso real, em gramas, a cubagem é ignorada e vale o peso real.
• Frete valor: percentual sobre o valor do pedido. Se a planilha já traz ad_valorem, deixe em branco para não cobrar duas vezes.
• Frete mínimo e Excedente por kg: usados nas áreas da planilha que não trazem esses valores.
• Limites da operação: peso e medidas máximas que a transportadora aceita. Pedido acima dos limites não recebe cotação dela.

O que ainda não funciona com tabela própria

• Dias de processamento das configurações gerais ainda não somam ao prazo da tabela. Por enquanto, inclua esses dias no prazo da planilha.
• Bloqueios por CEP não alcançam a tabela própria. Se a transportadora não atende uma região, tire essa faixa da planilha.
• Descontos que miram uma transportadora ou um serviço também não alcançam. O desconto no mais barato da cotação alcança, se a tabela própria for a opção mais barata.

Perguntas rápidas

Posso ter mais de uma transportadora com tabela própria? Pode. Cada uma aparece no menu lateral de Tabelas de frete com a sua tabela e o seu status.

E se a transportadora mudar a tabela? Importe a planilha nova na mesma transportadora. A anterior fica no histórico como Substituída quando você ativar a nova.

Aceita CSV? Não. Use .xlsx com as abas areas e pesos.