Tabela de contingência de frete
A Tabela de contingência de frete é um mecanismo de segurança para garantir que sua loja continue vendendo e calculando fretes normalmente, mesmo em momentos de instabilidade em integrações externas (como oscilações nos Correios durante eventos de alto tráfego como a Black Friday).
Quando o sistema detecta uma falha técnica ou lentidão excessiva no serviço do transportador principal, o mecanismo de contingência (Circuit Breaker) entra em ação de forma automática, utilizando a tabela de frete cadastrada na sua loja para calcular o valor e o prazo no checkout.
Por que cadastrar uma tabela de contingência?
- Garantia de vendas no checkout: Evita que o cliente final encontre erros no carrinho ou fique sem opções de frete ao tentar comprar.
- Preços e prazos reais: Permite que você defina taxas e prazos competitivos e adequados à sua operação, em vez de depender de valores genéricos.
- Autonomia na operação: Você tem total controle sobre os dados de frete cadastrados para sua loja.
Como configurar a tabela de contingência
Acessando a área de contingência
- Acesse o painel administrativo da sua loja.
- No menu lateral, navegue até Configurações > Configurações da Loja > Entrega > Contingência de frete.
- Na tela você poderá visualizar o status atual da sua tabela, a data da última atualização e o status de saúde da planilha.
Baixando o modelo e preparando os dados
- No painel de Contingência, clique em Baixar tabela para download do modelo padrão.
- Abra a planilha baixada e preencha as colunas com as faixas de CEP, prazos de entrega e valores correspondentes.
- Download de backup: Caso já possua uma tabela ativa na sua loja, você também pode utilizar o botão Baixar tabela da tabela ativa para exportar e conferir os dados vigentes.
Enviando e validando a planilha
- Após preencher ou atualizar a planilha, clique em Atualizar tabela.
- Selecione o arquivo salvo em seu computador e confirme o envio.
- O sistema realizará uma validação automática do arquivo antes de ativá-lo.
Importante: caso a planilha contenha erros (como estrutura de colunas incorreta, valores numéricos inválidos, campos vazios ou faixas de CEP mal formatadas), o envio será rejeitado pelo sistema. O painel exibirá uma mensagem indicando o problema exato (ex.: Linha 15 contém erro no valor do frete). Enquanto o erro não for corrigido na nova planilha, a versão anterior continuará ativa e elegível.
Alertas preventivos e manutenção da tabela
Para garantir que seus preços e prazos fiquem sempre atualizados e alinhados com seus custos operacionais, o painel exibirá alertas preventivos:
- Alerta de Atualização (180 dias): Um banner avisará se a sua tabela ativa não receber atualizações há mais de 180 dias, recomendando a revisão dos valores.
- Inconsistências de Cálculo: Alertas serão exibidos caso o sistema identifique divergências nas faixas de CEP ou valores cadastrados.
Como funciona a ativação automática no Checkout
Quando o cliente digita o CEP no carrinho de compras, a plataforma segue uma ordem lógica para entregar a cotação:
- Cotação Principal: O sistema tenta realizar a cotação em tempo real com o transportador (ex.: Correios) dentro do limite de tempo seguro (4 segundos).
- Ativação da Contingência: Se a integração principal apresentar falha técnica ou atingir o tempo limite, o sistema consulta automaticamente a Tabela de Contingência ativa da sua loja.
- Cotação Alternativa / Auxiliar: Caso a faixa de CEP não seja localizada na planilha ou a tabela não esteja cadastrada, o sistema utilizará as regras alternativas legadas configuradas na loja para evitar o bloqueio da compra.
Dica: A contingência atua de forma isolada por integração. Se a integração dos Correios oscilar, as demais transportadoras ativas na sua loja continuarão cotando normalmente via API em tempo real.
