Tabela de Frete

A Tabela de Frete registra os valores negociados em contrato entre a sua marca e a transportadora. É nela que você cadastra quanto custa cada faixa de peso, para cada faixa de destino (CEP ou quilometragem), separado por prazo de entrega.

Ela está vinculada a uma integração de transportadora e é usada para:

• Calcular o valor do frete e a data de entrega esperada na cotação
• Validar o prazo de envio na solicitação de coleta
• Fornecer as opções de frete para as automações de envio

---

Tipos de tabela

---

Como a tabela é organizada

Toda tabela de frete segue a mesma hierarquia:

1. Tabela — contém um ou mais prazos
2. Prazo (ex.: D1, D3, D7, EXP60, EXP120) — dentro de cada prazo, há uma ou mais faixas de destino
3. Faixa de destino — uma faixa de CEP (na tabela de CEP) ou uma faixa de quilometragem (na tabela de raio), com preços por faixa de peso

Tabela de CEP

Cada prazo contém faixas de CEP de destino (ex.: 01000-000 a 01999-999). Para cada faixa, você define preços por faixa de peso — por exemplo, até 1 kg, até 5 kg, até 10 kg — e opcionalmente um valor por kg adicional.

Como criar: via upload de arquivo CSV. O arquivo contém as colunas de CEP inicial, CEP final, as faixas de peso com seus preços, valor por kg adicional e o prazo.

Tabela de Raio

Cada prazo contém faixas de distância em quilômetros (ex.: 0–5 km, 5–10 km, 10–20 km). Para cada faixa de km, você define preços por faixa de peso e opcionalmente um valor por km adicional acima da quilometragem máxima.

Como criar: via upload de planilha Excel. Cada aba da planilha representa um prazo (ex.: aba "D1", aba "D3", aba "EXP60"). Dentro de cada aba, as linhas são as faixas de km e as colunas são as faixas de peso.

---

Vínculo com integração de transportadora

A tabela de frete é vinculada a uma integração de transportadora. Cada integração pode ter uma tabela associada — do tipo CEP ou do tipo raio.

• A tabela pertence a uma modalidade (ex.: CARRO, MOTO, CONVENCIONAL, PAC).
• Várias integrações podem compartilhar a mesma tabela de frete.
• O tipo de tabela (CEP ou raio) é definido na integração.

---

Horário de corte

O horário de corte é configurado na integração de transportadora e impacta diretamente como a data de entrega esperada é calculada a partir dos prazos da tabela.

• Define o horário limite do dia para que a solicitação de coleta seja considerada "hoje".
• Se o pedido entra antes do horário de corte: a contagem do prazo começa no mesmo dia.
• Se o pedido entra depois do horário de corte: a contagem do prazo começa no próximo dia útil de operação.

---

Cobertura restrita

A cobertura restrita é uma opção configurada na integração de transportadora. Quando ativada:

• Se o destino do pedido não está coberto por nenhuma faixa da tabela de frete (o CEP não cai em nenhuma faixa de CEP, ou a distância não cai em nenhuma faixa de km), o envio falha automaticamente como "fora de cobertura".
• O pedido aparece como falho na tela de pedidos.

Quando desativada (padrão), o envio é tentado normalmente mesmo que o destino não esteja mapeado na tabela.

---

Onde a tabela é usada

Na cotação

Quando o sistema calcula opções de frete (no checkout, na criação do pedido ou automaticamente), ele consulta as tabelas de frete das integrações ativas da filial:

• Para cada prazo da tabela, verifica se o destino está coberto e calcula o preço pela faixa de peso.
• Calcula a data de entrega esperada usando o prazo, o horário de corte, os dias de operação e feriados.
• Retorna as opções disponíveis com preço, prazo e transportadora.

Na solicitação de coleta

Quando um envio é criado (manual ou via automação), o sistema valida que o prazo escolhido existe na tabela de frete da integração. Se o prazo não for encontrado, o envio falha.

Nas automações

As automações de envio, reenvio e inatividade podem usar a tabela de frete de duas formas:

• Prazo específico: a automação aponta diretamente para uma integração + prazo (ex.: Correios/PAC/D3). O prazo precisa existir na tabela.
• Mais barato ou mais rápido: o sistema realiza uma cotação automática usando as tabelas de frete de todas as integrações ativas e escolhe a melhor opção. Nesse caso, a automação se adapta automaticamente a mudanças na tabela.

---

Erros comuns

Prazo não encontrado

O que acontece: a automação de envio tenta fazer a solicitação de coleta do pedido com um prazo específico (ex.: D1), mas esse prazo não existe mais na tabela de frete da integração. O pedido vai para falho.

Causa mais comum: a tabela de frete foi editada (um prazo foi removido ou renomeado) sem atualizar as automações de envio que referenciavam aquele prazo.

Como resolver: atualize a automação para usar o novo prazo disponível na tabela, ou mude a ação da automação para mais barato ou mais rápido — assim ela se adapta automaticamente às opções da tabela.

Fora de cobertura

O que acontece: o destino do pedido não cai em nenhuma faixa da tabela de frete (o CEP ou a distância não está mapeado), e a integração está com cobertura restrita ativada. O pedido vai para falho como "fora de cobertura".

Como resolver: adicione a faixa de CEP ou km na tabela de frete, ou desative a cobertura restrita na integração se quiser que o envio seja tentado mesmo para destinos não mapeados.

Nenhuma opção na cotação

O que acontece: a automação com ação mais barato ou mais rápido não encontra nenhuma opção de frete. Nenhuma integração da filial cobre aquele destino, ou a tabela não tem faixas para aquele CEP/km/peso.

Como resolver: verifique se as integrações da filial estão ativas e se as tabelas de frete cobrem o destino do pedido.

---

Links relacionados

• Prazos de Entrega — códigos de prazo usados nas tabelas (D0, D1, EXP60, etc.)
• Integração de Transportadora — onde a tabela é vinculada
• Cotação de Frete — como a tabela é usada para calcular preço e prazo
• Automação de Envio — automações que dependem dos prazos da tabela
• Automação de Reenvio — fallback quando o envio falha
• Automação de Inatividade — ação quando o envio fica parado