Como funciona o Frete Offline

O Frete Offline calcula o frete a partir de uma tabela que você mesmo carrega — sem depender de API externa, sem custo por consulta, com resposta instantânea no checkout.

A regra é simples: você fornece um CSV com faixas de CEP, peso e custos. O plugin lê o carrinho, descobre o CEP do cliente e o peso total, encontra a linha que combina e exibe o método de envio.

Por que offline

• Sem custo por requisição. APIs de cálculo cobram a cada checkout. Aqui o cálculo é local.
• Resposta instantânea. Sem ida e volta com servidor da transportadora.
• Sempre disponível. Se a API da transportadora cair, seu checkout não cai junto.
• Controle total. Você define cada faixa, cada custo, cada prazo.

Componentes principais

1. Tabela CSV — fonte de verdade. Cada linha é uma regra (faixa de CEP + faixa de peso → custo + prazo).
2. Mapeamento de colunas — você indica ao plugin quais colunas do CSV correspondem a CEP inicial, custo, prazo, etc.
3. Configurações do método — taxas extras, classe de entrega, frete grátis global, unidade de medida.
4. Modo de armazenamento — leitura direta do CSV (padrão) ou importação para banco de dados (recomendado pra tabelas grandes).

Modos de armazenamento

O modo banco de dados pode reduzir o tempo de cálculo em até 90% em tabelas grandes. Veja Modo banco de dados.

Fluxo de uma cotação

1. Cliente coloca produto no carrinho e informa CEP.
2. Plugin calcula o peso total do pacote (com peso extra opcional).
3. Plugin procura na tabela a linha que cobre aquele CEP e aquele peso.
4. Se encontra, aplica taxas adicionais (manuseio/carrinho), checa frete grátis e exibe o método.
5. Se não encontra, o método não aparece no checkout.

Próximos passos

• Primeira configuração — passo a passo do zero
• Modelo de tabela CSV — formato e download de exemplo
• Mapeamento de colunas — como apontar o que é o quê