Tabelas de Frete — Troubleshooting

Troubleshooting de Tabelas de Frete

Este guia ajuda a resolver as dúvidas e problemas mais comuns ao configurar e usar tabelas de frete.

1. “O pedido falhou com erro de prazo não encontrado”

O envio falha quando a automação tenta fazer a solicitação de coleta com um prazo (ex.: D1) que não existe mais na tabela de frete da integração.

Causa mais comum: a tabela foi editada e o prazo foi removido ou renomeado, mas a automação de envio ainda referencia o prazo antigo.

O que fazer:

Acesse Operação > Automações de envio e localize a automação que falhou.
Edite a automação e altere o prazo para um que exista na tabela, ou mude a ação para mais barato / mais rápido.
Alternativamente, edite a tabela de frete e adicione novamente o prazo que a automação espera.

2. “O pedido falhou como ‘fora de cobertura’”

O envio falha com status “fora de cobertura” quando o CEP ou distância do destino não está mapeado em nenhuma faixa da tabela de frete, e a integração tem a cobertura restrita ativada.

O que fazer:

Adicionar a faixa: edite a tabela de frete e inclua o CEP ou faixa de km que cobre o destino do pedido.
Desativar a restrição: se quiser que o envio seja tentado mesmo para destinos não mapeados, desative a cobertura restrita na integração de transportadora.

3. “Nenhuma opção aparece na cotação / simulação de frete”

Quando a cotação não retorna nenhuma opção, pode ser que:

Nenhuma integração cobre o destino — Verifique se as integrações da filial estão ativas e se as tabelas de frete têm faixas para aquele CEP ou distância.
O peso está fora das faixas da tabela — Confira se a tabela tem faixas de peso suficientes para o peso do pedido.
A integração não tem tabela vinculada — Verifique na tela de Integrações de Transportadora se a integração tem uma tabela de frete associada.

4. “Não consigo excluir a tabela”

Tabelas com integrações vinculadas não podem ser excluídas. O botão de excluir fica desabilitado com uma explicação.

O que fazer:

Acesse Operação > Integrações de transportadora.
Localize as integrações que usam esta tabela (veja a coluna “Tabela de frete”).
Edite cada integração e altere a tabela de frete para outra, ou remova o vínculo.
Após desvincular todas as integrações, volte à tela de tabelas e exclua.

5. “O upload do arquivo deu erro”

Verifique se o arquivo está no formato correto:

Tabela de CEP: arquivo Excel (.xlsx) com uma única aba. Cada linha contém CEP inicial, CEP final, faixas de peso com preços, valor por kg adicional e o prazo (ex.: “D1”, “D3”, “EXP60”) como coluna.
Tabela de Raio: arquivo Excel (.xlsx) com múltiplas abas. Cada aba deve ter o nome do prazo (ex.: “D1”, “EXP60”). Os nomes de aba válidos seguem o padrão D seguido de número (D1, D2, D10) ou EXP seguido de número (EXP60, EXP120).

Erros comuns no arquivo:

Faixas de CEP sobrepostas (CEP) — Duas faixas no mesmo prazo não podem cobrir os mesmos CEPs.
CEP início maior que CEP fim (CEP) — O CEP inicial deve ser menor ou igual ao CEP final.
Nome da aba inválido (Raio) — Use apenas “D1”, “D2”, “EXP60”, etc. Sem espaços ou caracteres especiais.
Valores duplicados de km ou peso (Raio) — Cada faixa de km ou peso deve ser única dentro do prazo.

6. “Editei a tabela e as automações ficaram inválidas”

Ao remover ou renomear prazos na tabela, automações que usam prazo específico com o prazo antigo ficam inválidas (indicador vermelho).

O que fazer:

No modal de edição da tabela, clique nas abas de automações (envio, reenvio, inatividade).
Localize as automações com indicador vermelho.
Ajuste o prazo de cada automação para um prazo que existe na tabela, ou mude a ação para mais barato / mais rápido.
Salve.

7. “A data de entrega esperada está errada na cotação”

A data de entrega esperada depende de vários fatores além do prazo da tabela:

Horário de corte — Se o pedido foi criado depois do horário de corte da integração, a contagem do prazo começa no próximo dia útil. Veja Horário de corte.
Dias de operação — Dias em que a transportadora não opera são pulados na contagem.
Feriados — Feriados cadastrados são pulados na contagem.
Regras de cotação — Regras de cotação podem alterar a data de entrega calculada.

Verifique o horário de corte na integração de transportadora e os dias de operação configurados.

8. “Não tenho acesso à tela de Tabelas de Frete”

O acesso à tela depende das permissões configuradas na sua conta. Entre em contato com o administrador da conta ou com o suporte da Abbiamo para verificar se o módulo de tabelas de frete está habilitado.