Você gerou a tabela, configurou tudo e o cálculo está funcionando — mas notou que pra alguns CEPs específicos o valor não bate exatamente com o que o site da transportadora mostra. É normal e tem explicação.
O plugin é "burro" — ele só lê a tabela
O Frete Offline não fala com nenhuma transportadora. Ele lê o CSV que você subiu, encontra a linha que combina com CEP + peso e devolve o custo.
Se o valor está errado, ele vem da tabela — não tem como o plugin "ajustar" o que não vem dele.
Isso significa que a correção é sempre na origem:
- Confirma que sua tabela está atualizada.
- Confirma que o mapeamento de colunas está correto.
- Se o problema é com Correios/JadLog (tabela gerada externamente), avalie se é divergência aceitável.
Quando a tabela é gerada externamente (Correios/JadLog)
Se você usa o serviço de geração de tabelas (tipo planilha.xpagencia.com.br) pra criar tabelas dos Correios ou JadLog, divergências pequenas em CEPs específicos são esperadas.
Por que diverge
O Brasil tem cerca de 1 milhão de CEPs ativos. Uma tabela detalhada por CEP individual teria milhões de linhas — inviável de carregar e calcular.
O gerador agrupa CEPs em ~245 faixas que cobrem todo o país. Cada faixa tem o mesmo custo médio. Pra mais de 96% dos CEPs o cálculo é adequado. Pra os outros poucos, pode haver pequena diferença porque:
- Algumas localidades têm precificação especial dos Correios (por motivos logísticos).
- Faixas grandes nivelam preço pra cidades distantes dentro da mesma faixa.
- Os Correios mudam preço sem aviso e a tabela pode estar defasada.
Quanto é "pequeno"
Geralmente até R$ 2-3 de diferença pra CEPs problemáticos, em pacotes médios. Se a diferença está consistentemente acima disso, vale regenerar a tabela.
Quando regenerar
- A cada 3-6 meses.
- Sempre que a transportadora anunciar reajuste.
- Se você notar várias reclamações de clientes sobre o valor cobrado.
Não esqueça de reimportar se você estiver usando modo banco de dados.
Quando a tabela vem da própria transportadora
Se a tabela é fornecida diretamente pela sua transportadora (acordo comercial, contrato), divergência não é aceitável — o problema é com a tabela ou com o mapeamento.
Cheque:
- Versão da tabela está atual?
- Colunas estão mapeadas no campo correto?
- Unidade de peso está coerente entre site e tabela?
Quando não há solução offline
Se você precisa de valor 100% idêntico ao do site da transportadora pra todos os CEPs, sem margem pra divergência, o caminho é integração online direta — fora do escopo do Frete Offline.
Pra a maioria das lojas, a precisão da tabela offline é suficiente, e os benefícios (performance, custo zero por consulta, independência de API) compensam as pequenas variações.