Simulação Frete
A tela de Simulação Frete é onde você roda uma cotação de frete dentro do idworks — informa o CEP de destino, os produtos ou volumes a serem enviados, e o sistema devolve o preço e o prazo de cada transportadora cadastrada. É a mesma engine que atende o carrinho dos canais externos (marketplaces, e-commerce), mas aqui você usa de forma interna: para tirar dúvidas de cliente, simular antes de fechar pedido, comparar transportadoras, conferir se uma nova tabela de preço ficou consistente.
O resultado mostra todas as transportadoras habilitadas, classificadas em Atende, Não Atende, Fora da faixa ou Excluído por regra. Para as que atendem, você vê preço final, prazo total e o detalhamento de cada componente do frete (frete base, gris, advalorem, pedágio, taxas de difícil acesso, ICMS) — útil para entender por que uma transportadora ficou mais cara que outra.
A cotação só funciona se a configuração estiver completa: empresa com endereço, transportadora cadastrada como fornecedor com cubagem definida, faixa de CEP atendida, tabela de preço por peso, produtos com peso e dimensões (quando simular por Produto), e — opcionalmente — Regras Simulação Frete para ajustar prazo/preço/exclusões. A seção Antes de cotar: o que precisa estar configurado lista todos os pré-requisitos com o caminho de cada um.
Índice
Conceito
- O que é a tela Simulação Frete?
- Quando usar esta tela?
- Quais simulações ficam guardadas no histórico?
Antes de cotar
- Antes de cotar: o que precisa estar configurado
- Passo 1 — Endereço da empresa
- Passo 2 — Cadastrar transportadora como fornecedor
- Passo 3 — Configurar cubagem e horário de corte
- Passo 4 — Cadastrar faixa de CEP atendida
- Passo 5 — Cadastrar tabela de preço por peso
- Passo 6 — Produtos com peso e dimensões
- Passo 7 — (opcional) Regras de Simulação Frete
- Checklist final antes da primeira cotação
Rodando a cotação
- Como abrir uma simulação nova?
- Qual a diferença entre Simular por Produto e Simular por Volume?
- Como informar o CEP destino?
- Como adicionar produtos na cotação?
- Como adicionar volumes manuais na cotação?
- O que faz o botão Refazer Simulação?
Lendo o resultado
- O que significa cada status da transportadora?
- Como o preço final é calculado?
- Como o prazo final é calculado?
- O que é cubagem e por que ela aparece no resultado?
- Por que o ICMS varia entre transportadoras?
- Por que algumas transportadoras vieram zeradas?
Diagnóstico
- A cotação não devolveu nenhuma transportadora — o que verificar?
- Apareceu "CEP destino XXXXXXXX não existe" — o que fazer?
- Apareceu "Peso precisa ser maior que zero" — o que fazer?
- Telas de apoio para diagnóstico
Referência rápida
O que é a tela Simulação Frete?
É a calculadora de frete oficial do idworks. Você informa de onde sai (o endereço da empresa), para onde vai (CEP destino), o que vai dentro (produtos ou volumes com peso e dimensões), e o sistema percorre todas as transportadoras cadastradas e habilitadas para responder com preço e prazo.
Cada simulação fica salva no histórico com:
- Cabeçalho: CEP destino, peso total, dimensões totais, valor da nota, descrição, usuário que rodou, integração de origem (se veio de canal externo).
- Resultado por transportadora: preço, prazo, situação (atende / não atende / excluído / fora da faixa) e o detalhamento de cada componente do preço (frete base, gris, advalorem, pedágio, taxas e impostos).
📍 Onde: menu lateral → Logística → Simulação Frete.
Quando usar esta tela?
Os cenários mais comuns:
- Atendimento ao cliente: cliente liga perguntando "quanto custa o frete para o meu CEP?" e você roda uma simulação direta.
- Conferência de tabela nova: cadastrou uma transportadora ou alterou tabela de preço e quer confirmar se ficou correta antes de virar para os canais.
- Antes de fechar um pedido grande: simular para escolher a transportadora certa.
- Negociação com transportadora: comparar o frete real cobrado versus o cotado no idworks.
- Diagnóstico: quando uma transportadora some dos canais ou um pedido cobrou preço estranho, rodar uma simulação na tela ajuda a entender o que aconteceu.
Quais simulações ficam guardadas no histórico?
Todas ficam — tanto as feitas a partir desta tela quanto as feitas pelos canais externos (marketplace pedindo cotação no carrinho, e-commerce simulando frete na vitrine). A coluna Integração mostra de onde veio cada simulação:
- Vazio = simulação interna feita por um usuário do idworks.
- Preenchido = simulação vinda de canal externo (mostra o nome do marketplace/e-commerce).
A listagem é ordenada do mais recente para o mais antigo, com até 5000 registros por página.
Antes de cotar: o que precisa estar configurado
Para a simulação devolver resultados utilizáveis, sete coisas precisam estar prontas. As três primeiras dependem dos cadastros básicos da operação (endereço da empresa, transportadora cadastrada como fornecedor); da quarta em diante são específicas para que o motor de frete funcione.
| Passo | O que configurar | Onde |
|---|---|---|
| 1 | Endereço completo da empresa | Configurações → Minhas Empresas |
| 2 | Cadastro da transportadora como fornecedor | Cadastros → Fornecedores |
| 3 | Cubagem, leilão e horário de corte da transportadora | Cadastros → Fornecedores (aba Transportadora) |
| 4 | Faixa de CEP atendida pela transportadora | Cadastros → Fornecedores (aba CEPs) |
| 5 | Tabela de preço por peso | Cadastros → Fornecedores (aba Tabela de Preço) |
| 6 | Peso e dimensões dos produtos | Cadastros → Listar Produtos |
| 7 | Regras Simulação Frete (opcional) | Logística → Regras Simulação Frete |
Os próximos tópicos detalham cada passo.
Passo 1 — Endereço da empresa
O motor de frete precisa saber de onde sai o pedido. Vai em Configurações → Minhas Empresas e confirme que estão preenchidos:
- CEP da empresa.
- Estado (UF).
- Cidade (com código IBGE — em geral preenchido automático quando você seleciona a cidade na lista).
Por que importa:
- O estado é usado no cálculo do ICMS interestadual (estado origem ≠ estado destino).
- A cidade é usada para detectar se origem e destino são da mesma cidade — neste caso, o sistema zera o ICMS.
- O CEP vira o ponto de origem da rota.
Sem esses três campos preenchidos corretamente, o ICMS pode vir errado e o cálculo da rota pode ficar inconsistente.
Passo 2 — Cadastrar transportadora como fornecedor
Toda transportadora que vai aparecer na simulação é cadastrada em Cadastros → Fornecedores com:
- Tipo do fornecedor = Transportadora.
- Razão social e CNPJ.
- Categoria de fornecedor com tipo "Transportadora".
- Modalidade da transportadora (Rodoviário, Aéreo, etc. — cadastrada em Logística → Modalidade Transportadora).
Esse cadastro é o ponto de partida. Enquanto a transportadora não estiver como fornecedor, nenhum dos passos seguintes funciona.
Passo 3 — Configurar cubagem e horário de corte
Ainda dentro do cadastro do fornecedor (na aba específica de Transportadora), preencha:
- Habilitar leilão de frete = Sim. Esta opção é o que coloca a transportadora dentro do "pool" que a simulação consulta. Sem ela, a transportadora fica cadastrada mas é ignorada pela cotação.
- Índice de cubagem (kg/m³): padrão de mercado é 167 para rodoviário. Aéreo costuma ser 333 ou 500. A cubagem transforma o volume da carga em "peso equivalente" — se o pacote ocupa muito espaço com pouco peso, o frete é calculado pela cubagem.
- Peso isento de cubagem: peso bruto abaixo do qual a cubagem é desconsiderada. Útil para evitar que pacotes pequenos paguem por cubagem.
- Horário de corte: hora-limite do dia para a transportadora pegar o pacote no mesmo dia (ex.: 14:00). Cotações rodadas depois desse horário adicionam 1 dia ao prazo automaticamente.
- Dias úteis adicionais fixos: dias que sempre são somados ao prazo dessa transportadora (ex.: 1 dia de manuseio interno).
- ICMS já incluído: marque quando a tabela da transportadora já inclui o ICMS (o sistema não soma o imposto novamente).
- Penalidade do leilão: percentual de ajuste aplicado sobre o total — útil se você quer favorecer ou desfavorecer essa transportadora no resultado final.
Passo 4 — Cadastrar faixa de CEP atendida
Cada transportadora atende faixas de CEP específicas. Cadastre todas as faixas na aba CEPs do fornecedor:
- CEP de e CEP até: limites da faixa (ex.:
01000-000a09999-999para a Grande São Paulo). - Tipo de tabela: nome da tabela de preço que se aplica naquela faixa (ex.: "Capital", "Interior", "Norte"). É a chave de ligação com a tabela do passo seguinte.
- Prazo (dias úteis): prazo base da transportadora para entregar nessa faixa.
- Gris (%) — percentual de Gris (gerenciamento de risco). Aplicado sobre o valor da nota.
- Gris mínimo (R$) — piso em reais quando o percentual ficar abaixo.
- Advalorem (%) — percentual de seguro. Mesmo esquema do Gris.
- TDE — Taxa de Difícil Entrega: percentual e valor mínimo.
- Taxa de despacho, dificuldade de acesso, SECCAT, restrição de tráfego, administração, CTE, SUFRAMA, seguro fluvial, outras taxas e taxas fixas: cada uma com seu valor por faixa.
- Pedágio: valor + valor por fração (m³). O sistema calcula
pedagio = ceil(cubagem / fracao) * valor_pedagio.
Sem faixa de CEP cadastrada para o CEP que está sendo cotado, a transportadora vem como "Não Atende".
Passo 5 — Cadastrar tabela de preço por peso
Na aba Tabela de Preço do fornecedor, cadastre por tipo de tabela (mesmo nome usado no passo anterior):
- Tipo de tabela (ex.: "Capital").
- Peso de (kg) e Peso até (kg): faixa de peso.
- Valor (R$): preço do frete para aquela faixa de peso.
Exemplo simplificado:
| Tipo | Peso de | Peso até | Valor |
|---|---|---|---|
| Capital | 0 | 1 | R$ 15,00 |
| Capital | 1,001 | 5 | R$ 22,00 |
| Capital | 5,001 | 10 | R$ 35,00 |
| Capital | 10,001 | 30 | R$ 70,00 |
| Capital | 30,001 | -1 | R$ 2,50 (por kg adicional) |
A última linha com Peso até = -1 é a linha de extrapolação: quando o peso passa do maior valor cadastrado, o sistema cobra o preço da última faixa + (peso atual - peso máximo da última faixa) × valor por kg. Sem essa linha, pesos acima do máximo voltam como Fora da faixa.
Passo 6 — Produtos com peso e dimensões
Quando você for cotar por Produto, cada SKU precisa ter peso e dimensões cadastradas em Cadastros → Listar Produtos:
- Peso (kg).
- Largura (cm), Altura (cm), Comprimento (cm).
Se algum desses campos estiver vazio, a cotação a partir do canal externo gera erro (visível em Logística → Erros Simulação Frete) — e na simulação interna por Produto, a tela bloqueia o salvamento da linha com mensagem de campo obrigatório.
Dica: se sua operação tem muitos produtos sem dimensão e você não consegue cadastrar todos imediatamente, use a opção Simular por Volume (passo a passo abaixo) — você informa peso e medidas direto na tela, sem precisar puxar do cadastro.
Passo 7 — (opcional) Regras de Simulação Frete
As Regras Simulação Frete (ver artigo dedicado) permitem ajustar o resultado da cotação após o cálculo base. Configuradas em Logística → Regras Simulação Frete, podem:
- Adicionar dias no prazo (ex.: +1 dia para certo estado).
- Alterar o preço em R$ ou em % (sobre o frete ou sobre o valor da nota).
- Fixar o preço (frete grátis acima de R$ X).
- Excluir transportadoras (ex.: bloquear uma transportadora em pedidos vindos de certo marketplace).
São opcionais — sem regras, a simulação devolve o cálculo cru das transportadoras. Com regras, você customiza o resultado por estado, faixa de valor, tipo de produto, integração de origem, etc.
Checklist final antes da primeira cotação
| ✓ | Item |
|---|---|
| ☐ | Endereço da empresa preenchido (UF, CEP, cidade com IBGE). |
| ☐ | Pelo menos uma transportadora cadastrada como fornecedor. |
| ☐ | Transportadora com "Habilitar leilão de frete" = Sim. |
| ☐ | Índice de cubagem informado. |
| ☐ | Pelo menos uma faixa de CEP que cubra o destino que você quer testar. |
| ☐ | Tipo de tabela informado na faixa de CEP. |
| ☐ | Tabela de preço por peso preenchida (com faixas que cubram o peso). |
| ☐ | Para Simular por Produto: SKU com peso e dimensões. |
Quando todos esses itens estão prontos, a primeira simulação deve devolver pelo menos uma linha com Atende = Sim.
Como abrir uma simulação nova?
- Acesse Logística → Simulação Frete.
- Clique em Simular Frete no canto superior direito.
- A janela abre vazia, pronta para preencher.
- Preencha Conta (apenas multi-empresa), Simular por (Produto ou Volume), CEP destino e os itens.
- Clique em Simular.
O resultado abre em uma nova aba dentro do idworks, mostrando o detalhe das transportadoras.
Qual a diferença entre Simular por Produto e Simular por Volume?
| Simular por Produto | Simular por Volume | |
|---|---|---|
| Quando usar | Você quer cotar um pedido real com SKUs já cadastrados. | Você quer cotar um envio sem amarrar com SKU (caixa avulsa, pedido genérico, conferência rápida). |
| Como informar | Selecione o produto pela busca; o sistema puxa peso e dimensões automaticamente. | Você digita peso, altura, largura, comprimento e valor da nota direto na tabela. |
| Quantidade | Cada linha tem campo Quantidade — o sistema multiplica peso e dimensões pela quantidade antes de cotar. | Cada linha é uma caixa independente — o que você digita é o que vai. |
| Pré-requisito | SKU com peso e dimensões cadastrados. | Nenhum (você informa tudo na tela). |
| Onde o motor pega os dados | Cadastro do produto (peso, altura, largura, comprimento). | O que você digitou. |
Quando estiver em dúvida: comece por Volume — é mais rápido e independe do cadastro estar completo. Use Produto quando quiser simular um pedido real cliente-a-cliente.
Como informar o CEP destino?
No campo CEP destino da janela de simulação, digite o CEP no formato 00000-000 (a máscara aplica o hífen automático). Quando completar 8 dígitos:
- O sistema consulta automaticamente a base de CEPs e preenche Endereço, Bairro, Cidade, UF.
- Se o CEP não existir ou estiver inválido, aparece o aviso "CEP não encontrado" e os campos ficam vazios.
Também é possível usar o botão de lupa ao lado do campo para forçar a busca, ou pressionar Enter depois de digitar.
Como adicionar produtos na cotação?
- Com a janela de simulação aberta no modo Produto, clique em Adicionar Produto (acima da tabela).
- Na linha nova, no campo Nome, digite o nome, código de referência ou código SKU do produto. O autocomplete sugere produtos cadastrados.
- Selecione o produto da lista — o sistema preenche peso, altura, largura e comprimento.
- Informe a Quantidade.
- (Opcional) Informe Valor da nota se quiser que o frete considere taxas percentuais (Gris, Advalorem) sobre esse valor.
- Clique em Salvar (ícone de disquete na linha).
Repita para cada produto do pedido. Pode também Editar ou Remover linhas pela coluna de Ações.
Se ao salvar aparecer mensagem dizendo que algum campo (peso, altura, largura, comprimento) é obrigatório, é porque o produto está sem aquele dado no cadastro. Vá em Cadastros → Listar Produtos, complete e volte para a simulação.
Como adicionar volumes manuais na cotação?
- Com a janela aberta no modo Volume, clique em Adicionar Volume.
- Na linha nova, informe:
- Peso (kg).
- Altura (cm).
- Largura (cm).
- Comprimento (cm).
- (Opcional) Valor da nota em reais.
- Clique em Salvar (disquete da linha).
Adicione quantos volumes precisar — cada linha vira uma "caixa" no envio. O motor de cotação trata o conjunto como um envio único somando pesos, somando larguras, e pegando a maior altura e o maior comprimento entre os volumes (depois aplica cubagem por transportadora).
O que faz o botão Refazer Simulação?
Na lista de simulações já feitas, cada linha tem um botão Refazer Simulação (ícone de seta circular). Ao clicar, o sistema:
- Abre a janela de simulação com os campos CEP destino, Descrição e o volume já preenchidos com os dados da simulação original.
- Trava o modo em Volume (não dá para trocar para Produto na refazenda).
Útil quando uma cotação saiu de um canal externo (marketplace) e você quer rodar a mesma com o catálogo atual para conferir se algum cadastro mudou ou se uma regra nova entrou em vigor.
O que significa cada status da transportadora?
No resultado da simulação, cada transportadora vem com um destes status:
| Status | Significado |
|---|---|
| Atende | A transportadora atende o CEP, tem tabela de preço para o peso da carga, e devolveu preço e prazo. Frete válido. |
| Não Atende | A transportadora não tem faixa de CEP cadastrada que cubra o CEP destino. Cadastre uma faixa em Cadastros → Fornecedores → CEPs para incluir esse destino. |
| Fora da faixa | A transportadora cobre o CEP mas o peso ultrapassa a maior faixa cadastrada na tabela de preço (e não há linha de extrapolação Peso até = -1). Cadastre faixas de peso maiores ou inclua linha de extrapolação. |
| Excluído | Foi removida do resultado por uma regra ativa em Regras Simulação Frete (ação 9 — Excluir transportadoras). |
Apenas transportadoras com status Atende entram no comparativo de preço/prazo.
Como o preço final é calculado?
O preço final que aparece para o cliente (ShippingShowValue) é o resultado desta soma:
- Frete base (
ShipingValue): valor da faixa de peso encontrada na tabela do passo 5. - + Gris: percentual sobre o valor da nota (ou mínimo cadastrado).
- + Advalorem: percentual de seguro sobre o valor da nota.
- + Pedágio: valor por fração cúbica vezes a cubagem.
- + Outras taxas: acesso difícil, despacho, TDE, SECCAT, restrição de tráfego, administração, CTE, SUFRAMA, seguro fluvial, outras.
- = Subtotal.
- + ICMS (calculado sobre o subtotal, conforme estado destino).
- = Total da transportadora.
- + Ajuste do leilão (penalidade percentual da transportadora, se houver).
- + Ajuste de regra (Regras Simulação Frete, quando alguma se aplica).
- = Valor mostrado ao cliente.
Quando a transportadora tem Arredondamento de preço configurado, o valor final é ajustado para terminar no decimal definido (ex.: arredondar para terminar em ,90).
Cada componente aparece detalhado no resultado — basta expandir a linha da transportadora para conferir.
Como o prazo final é calculado?
O prazo (TotalShowDaysTime) é a soma de:
- Prazo base da transportadora (
DaysTime— vem da faixa de CEP atendida). - + Dias úteis adicionais fixos (
CarrierAdditionalBusinessDays— cadastrado no fornecedor). - + Dia de corte (
CutDaysTime— 1 quando a cotação rodou depois do horário de corte da transportadora, 0 antes). - + Dias por regra (
RuleAdditionalDays— quando uma regra de simulação adiciona dias). - = Prazo final mostrado ao cliente.
O que é cubagem e por que ela aparece no resultado?
Cubagem é uma forma de cobrar frete por volume em vez de só por peso bruto. Pacotes leves mas grandes (almofadas, caixas de eletrônicos vazios, bolas) ocupam espaço no caminhão sem pesar muito — o frete por cubagem garante que o cliente pague proporcional ao espaço usado.
Fórmula:
cubagem (kg) = (largura × altura × comprimento em metros) × índice de cubagem
Onde o índice de cubagem (CarrierCubageKmM) varia por transportadora:
- Rodoviário (padrão): 167 kg/m³.
- Aéreo: 333 ou 500 kg/m³.
O motor compara peso bruto com cubagem e usa o maior dos dois para procurar na tabela de preço. Mas, se o peso bruto for menor que o "peso isento de cubagem" (CarrierCubageFreeWeight) cadastrado, a cubagem é ignorada e a tabela é consultada pelo peso bruto.
No resultado, você vê:
- Peso real: o peso digitado (ou somado dos produtos).
- Peso cubado: o peso pela fórmula de cubagem.
- Peso usado: qual dos dois prevaleceu (o maior).
Por que o ICMS varia entre transportadoras?
O ICMS aplicado ao frete depende de:
- Estado de origem (UF da empresa).
- Estado de destino (UF do CEP cotado).
- Cidade origem = cidade destino? → ICMS = 0.
- Configuração da transportadora: se ela tem "ICMS já incluído" marcado, o sistema não aplica imposto adicional (a tabela dela já inclui).
Por isso, o mesmo CEP cotado em duas transportadoras pode ter ICMS diferente — uma já vem com imposto na tabela, outra não.
Por que algumas transportadoras vieram zeradas?
Quando uma linha aparece com Subtotal, Total e Valor mostrado em branco/zero, é porque o status é diferente de Atende (Não Atende, Fora da faixa, Excluído). Nestes casos, o sistema mantém a linha visível para você ver o motivo da ausência, mas não calcula preço.
A cotação não devolveu nenhuma transportadora — o que verificar?
Checagem em ordem:
- Endereço da empresa: UF, CEP, cidade preenchidos? (Passo 1)
- Transportadora habilitada para leilão de frete? (Passo 3 — "Habilitar leilão de frete" = Sim)
- Faixa de CEP cobrindo o destino? Veja em Cadastros → Fornecedores → CEPs se há linha que inclua o CEP testado.
- Tabela de preço para o peso? (Passo 5 — peso da simulação precisa estar dentro de alguma faixa cadastrada)
- Regras Simulação Frete ativas? Pode ter uma regra excluindo todas as transportadoras (ação 9) por condição que se aplica ao pedido.
Se mesmo com tudo configurado a tela não devolveu nada, abra um chamado — pode ser que a lista interna de transportadoras habilitadas para leilão precise ser regerada (acontece automaticamente quando você salva alteração em fornecedor ou regra, mas vale conferir com o suporte).
Apareceu "CEP destino XXXXXXXX não existe" — o que fazer?
O CEP digitado não consta na base de CEPs do idworks. Possibilidades:
- Erro de digitação: confira na consulta dos Correios se o CEP é válido.
- CEP novo: CEPs criados recentemente podem demorar para chegar na base. Se o CEP é válido nos Correios mas o idworks não reconhece, abra chamado para atualização da base.
- CEP de área rural ou extremidade: alguns CEPs são genéricos para grandes áreas e podem não estar na base detalhada.
Cada vez que isso acontece pela tela ou pelos canais externos, o erro fica registrado em Logística → Erros Simulação Frete com tipo "CEP não localizado".
Apareceu "Peso precisa ser maior que zero" — o que fazer?
A soma dos pesos dos volumes/produtos ficou em zero. Causas mais comuns:
- Cadastrou produto sem peso (campo Peso vazio em Cadastros → Listar Produtos).
- Digitou peso zerado no modo Volume.
Solução: complete o cadastro do produto ou ajuste o peso na tela de simulação.
Telas de apoio para diagnóstico
| Tela | O que ajuda |
|---|---|
| Cadastros → Fornecedores | Conferir cadastro da transportadora, faixas de CEP atendidas, tabela de preço, índice de cubagem, horário de corte, penalidade do leilão. |
| Cadastros → Listar Produtos | Conferir peso e dimensões dos SKUs. |
| Logística → Regras Simulação Frete | Ver regras ativas que podem estar ajustando preço/prazo ou excluindo transportadoras. |
| Logística → Erros Simulação Frete | Ver erros gerados pelos canais externos (SKU sem dado, CEP inválido, mapeamento ausente). |
| Configurações → Minhas Empresas | Conferir endereço da empresa (origem da rota). |
Privilégios da tela
Esta tela tem privilégios próprios que controlam o que cada usuário pode fazer. Configure os perfis de acesso em Configurações → Perfis de Acesso vinculando os privilégios abaixo aos grupos desejados. Quando o usuário não tem o privilégio, a ação correspondente fica desabilitada na tela.
| Privilégio | Libera |
|---|---|
| Visualizar Simulação Frete | Acessa a tela, a lista de simulações já feitas e o detalhe de cada uma. Sem este privilégio, o item de menu nem aparece. |
| Criar Simulação Frete | Botão Simular Frete habilitado para abrir a janela de cotação nova. |
Não existem privilégios separados para editar ou excluir — uma simulação criada não é editável (cada cotação é um snapshot do momento) e não pode ser apagada da tela.