Os Correios não disponibilizam tabela offline oficial. Mesmo assim, é possível gerar uma tabela compatível com o plugin de forma extra-oficial e usar pra cálculo offline.
Onde gerar a tabela
Use o serviço planilha.xpagencia.com.br. É de terceiros, gratuito.
- Acesse o site.
- Selecione Correios como transportadora.
- Selecione formato VTEX — é o mais próximo do que o plugin espera.
- Preencha origem (CEP da loja), serviços que você usa (PAC, SEDEX) e gere a tabela.
- Aguarde — pode demorar vários minutos.
Converter pra CSV
A tabela vem em XLS. O plugin aceita só CSV/TXT, então é preciso converter:
- Suba pro Google Drive e baixe como CSV (recomendado).
- Ou use convertio.co.
Mais detalhes no artigo Modelo de tabela CSV.
Importar no plugin
Depois de gerar e converter, é o fluxo padrão:
- Suba o CSV no método de envio.
- Mapeie as colunas (auto-detecção geralmente acerta).
- Salve.
Se quiser PAC e SEDEX como métodos separados, gere duas tabelas (uma por serviço) e crie dois métodos de envio independentes na mesma área de entrega.
Divergência de valores: o que esperar
A tabela offline gera valores muito próximos do cálculo online dos Correios, mas não 100% idênticos. Isso é normal.
Por que diverge
O Brasil tem cerca de 1 milhão de CEPs e ~40 faixas de peso. Uma tabela que cobrisse tudo individualmente teria milhões de linhas — inviável.
O serviço gera a tabela usando ~245 faixas de CEP que, na prática, cobrem todo o país com agrupamentos lógicos. Em mais de 96% dos casos o cálculo é adequado. Pra alguns CEPs com precificação especial dos Correios, pode haver pequena diferença.
Detalhes em Valores divergentes do online.
Quando a precisão é crítica
Se sua operação não tolera nenhuma divergência (ex: contrato fechado com a transportadora baseado em valor exato), a única opção é integração online direta com a API dos Correios — fora do escopo do Frete Offline.
Pra a maioria das lojas, a tabela offline gera resultados suficientemente bons, com vantagens de performance e independência de API.
Atualizando a tabela
Os Correios alteram preços/prazos sem aviso. É boa prática regerar a tabela pelo menos a cada 3 meses ou sempre que a transportadora anunciar reajuste.
Se você usa modo banco de dados, lembre de reimportar após subir o CSV novo.