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.