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. Sem integração, o frete dela não aparecia 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. A tabela segue as mesmas regras das outras transportadoras: dias de processamento, acréscimos, bloqueios por CEP, descontos, frete grátis, agrupamento e relatórios. Recurso do plano Business.

Quando a tabela própria vale a pena

• Regional mais barata no seu estado. A transportadora contratada cobre o Sul ou o Sudeste com preço melhor que os Correios. Importe só as faixas que ela atende: fora delas, o cliente vê as outras opções normalmente.
• Frete grátis pela transportadora que você escolheu. Em vez de dar frete grátis no que vier mais barato, você dá só na tabela própria, onde a margem é sua.
• Contrato com tabela negociada. A transportadora tem API, mas a tarifa do seu contrato só existe na planilha que o comercial mandou.
• Entrega rápida na cidade. Áreas com prazo em minutos viram opção de entrega no mesmo dia, com descrição “Entrega em 45 minutos”.

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).
6. Acréscimo: o percentual e depois o valor fixo, os da tabela ou os das configurações gerais (veja Prazo e acréscimos, mais abaixo). O valor fixo entra por último, para o percentual não incidir sobre ele.

O prazo é o da área na planilha, mais o prazo extra da tabela, mais os dias de processamento das configurações gerais. Conta em dias úteis. Áreas com prazo em minutos não ganham dias.

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

Prazo: 4 dias úteis.

Com acréscimo de 10% e R$ 1,50 e 2 dias de processamento nas configurações gerais, a mesma cotação fica assim: R$ 36,45 + 10% = R$ 40,10, mais R$ 1,50 = R$ 41,60, em 6 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.

Prazo e acréscimos

A tabela própria usa as configurações gerais de Transportadoras → Geral, como as outras transportadoras:

• Dias de processamento somam sempre ao prazo da tabela. Não inclua esses dias na planilha, senão eles contam duas vezes.
• Acréscimos no frete (percentual e valor fixo) somam ao preço calculado pela tabela.

Quer um ajuste só para uma transportadora? Abra a transportadora em Tabelas de frete e use a seção Ajustes no frete:

Zero é diferente de vazio. 0 no valor adicional tira o acréscimo só dessa tabela; em branco, ela segue o geral. Cada campo mostra embaixo o valor geral que vale quando fica vazio.

A regra vale com ou sem a opção Permitir customização por transportadora ligada. Mais sobre acréscimos em Acréscimo de dias e de valor no frete .

Bloquear uma região

A planilha já limita a cobertura: CEP fora das faixas não recebe cotação. O bloqueio por CEP serve para tirar uma região por um tempo, sem mexer na planilha. Uma enchente, uma greve, uma rota suspensa.

Em Regras de frete → Bloqueios por CEP:

• Por transportadora, marque Tabelas próprias: todas as tabelas ativas somem naquela faixa.
• Por serviço ou tabela, marque só a tabela que quer tirar, por exemplo “Trans Sul”. As outras continuam aparecendo.

Frete grátis e descontos

A tabela própria entra nas campanhas de Regras de frete → Descontos:

• Mais barato da cotação: alcança a tabela quando ela é a opção mais barata.
• Uma transportadora: em Transportadora, escolha Tabelas próprias e marque em Tabelas com desconto as que a campanha cobre. Em Aplicar em, Todos os serviços marcados dá o desconto em cada tabela marcada; Apenas o mais barato entre eles dá só na mais barata daquela cotação.

Exemplo: frete grátis acima de R$ 299 só pela transportadora contratada. Crie um desconto de 100%, valor mínimo R$ 299, Uma transportadora → Tabelas próprias, com a tabela marcada. Ligue Mostrar barra e a barra de frete grátis mostra quanto falta para o cliente chegar lá.

Datas de início e fim, estados e valor mínimo funcionam como em qualquer campanha. Veja descontos de frete com agendamento .

Agrupamento de frete

No agrupamento de frete , cada tabela ativa aparece na lista de serviços de cada grupo:

• Marcada num grupo, a tabela disputa a vaga com os outros serviços e, se ganhar, aparece com o nome do grupo, como “Frete Econômico”.
• Sem marcação em nenhum grupo, ela continua aparecendo no checkout com o próprio nome, como opção extra. Ligar o agrupamento não esconde uma tabela que você não agrupou.

Relatórios

Pedidos pagos com a tabela própria entram em Painel e relatórios → Relatório detalhado, com o nome da tabela como transportadora. Em Por transportadora você compara o % volume e o custo absorvido dela com os das integradas. Se a tabela for excluída, os pedidos antigos continuam lá como “Tabela própria”.

A tabela não aparece na cotação? Confira

1. Plano Business. Fora dele, as tabelas param de cotar. O cadastro fica guardado e volta a valer quando a loja voltar ao Business.
2. Ativo ligado e tabela ativa. O Ativo da transportadora precisa estar ligado, e uma importação precisa estar ativada.
3. CEP dentro de alguma faixa da aba areas. CEP de São Paulo começando com zero? Confira se o Excel não apagou o zero.
4. Peso dentro das faixas, ou um excedente por kg para o que passar da última faixa.
5. Limites da operação. Peso e medidas máximas da transportadora.
6. Bloqueio por CEP ativo naquela faixa, em Regras de frete → Bloqueios por CEP.
7. No checkout, o CCS precisa estar ativo na loja.

O simulador de frete na tela Início ajuda a achar o motivo: simule o CEP e o peso do pedido e veja se a tabela responde.

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.

Que nome o cliente vê no checkout? O Nome exibido no checkout da transportadora. Se ela vencer um grupo do agrupamento de frete, aparece o nome do grupo.

Duas tabelas com o mesmo preço: qual ganha o desconto no mais barato? Em empate, vale a que aparece primeiro na cotação, em geral a cadastrada primeiro. Se quiser escolher, use Uma transportadora → Tabelas próprias e marque só a tabela que deve receber o desconto.

Dá para dar frete grátis pela tabela só em alguns estados? Dá. No desconto, escolha os estados da campanha. Fora deles, a tabela cota com o preço normal.