Erros Simulação Frete
A tela de Erros Simulação Frete é o diário de bordo das tentativas de cotação de frete que deram errado. Sempre que um marketplace, e-commerce ou outro canal externo pede uma cotação de frete para o idworks e o sistema não consegue calcular (porque falta um dado, o SKU não tem peso, o CEP não existe, etc.), o erro fica registrado nesta tela com tipo, CEP destino, SKU envolvido, integração e data.
A tela é somente consulta — não dá para criar, editar nem excluir registros. A ideia é justamente que ela funcione como lista de pendências: cada linha aqui é uma chamada de cotação que o cliente final não recebeu resposta, e o caminho para resolver está em outra tela do idworks (cadastro de produto, vínculo de SKU, configuração da integração).
Por padrão a tela mostra os 3000 erros mais recentes da empresa, ordenados do mais recente para o mais antigo. Use os filtros de Conta e Data log no painel da direita para focar em um período específico ou em uma das contas do grupo.
Índice
Conceito
- O que é a tela de Erros Simulação Frete?
- Quem gera esses erros?
- Quando um erro aparece aqui?
- O que cada coluna significa?
Tipos de erro
- Variação canal não localizada
- SKU não localizado
- CEP não localizado
- SKU sem peso cadastrado
- SKU sem dimensões cadastradas
- Tipo integração de venda não localizada
Uso da tela
- Como filtrar erros por período?
- Como filtrar por conta (operação multi-empresa)?
- Os erros somem com o tempo?
- Por que o mesmo SKU aparece várias vezes?
- Tem alerta automático quando um erro novo aparece?
Receitas práticas
- Receita: usar a tela como checklist de cadastros incompletos
- Receita: monitorar lançamentos novos no marketplace
Referência rápida
O que é a tela de Erros Simulação Frete?
É um histórico: toda vez que um canal externo (marketplace, e-commerce, marketplace via hub) pediu uma cotação de frete e o idworks não conseguiu responder, sobrou aqui o registro do que foi pedido e qual foi a causa do erro. A tela mostra as 3000 ocorrências mais recentes.
Cada linha responde basicamente:
- Quando aconteceu (data e hora).
- Qual integração fez a chamada (Mercado Livre, Tray, Carrefour, Madeira Madeira, etc.).
- Qual CEP o cliente final queria cotar.
- Qual SKU do canal estava na cotação (quando o erro é sobre um produto).
- Qual o tipo do problema (um de 6 motivos catalogados).
📍 Onde: menu lateral → Logística → Erros Simulação Frete.
Quem gera esses erros?
Quem registra os erros é o endpoint público de cotação de frete do idworks, que é chamado pelos canais de venda (marketplaces e e-commerces) sempre que precisam mostrar o frete na vitrine.
Quando esse endpoint:
- Recebe uma chamada que não consegue calcular (faltam dados de produto, CEP inválido, integração não reconhecida).
- Devolve uma mensagem de erro para o canal.
- Grava simultaneamente o ocorrido nesta tela para você ver depois.
Como o registro acontece no momento real da cotação, esta tela funciona como um espelho dos pedidos perdidos por falha de cadastro ou configuração.
Quando um erro aparece aqui?
Os erros vêm sempre de chamadas externas: alguém — o site do marketplace, o carrinho do e-commerce — quis cotar o frete e o idworks não conseguiu responder com sucesso. Os 6 motivos catalogados estão descritos em detalhe abaixo.
A tela não registra:
- Cotações feitas internamente pelo idworks (PDV, simulações na ficha do pedido, recotação manual).
- Cotações que tiveram sucesso — só erros caem aqui.
- Erros de outras partes do sistema (etiqueta, pedido, contas a pagar). Cada módulo tem seu próprio log.
O que cada coluna significa?
| Coluna | O que mostra |
|---|---|
| Data | Data e hora exata em que a cotação foi tentada (formato dia/mês/ano hora:minuto:segundo). |
| Tipo do erro | Um dos 6 motivos catalogados — Variação canal não localizada, SKU não localizado, CEP não localizado, SKU sem peso, SKU sem dimensões, Tipo integração de venda não localizada. |
| CEP destino | CEP que o cliente final usou na cotação. Sempre com 8 dígitos (zeros à esquerda quando o CEP começa com 0). |
| SKU canal | Código de produto que o marketplace enviou na cotação. Aparece preenchido em erros de tipo Variação canal não localizada, SKU sem peso e SKU sem dimensões. Em erros de CEP fica vazio. |
| Integração | Qual integração originou a chamada. O texto traz o tipo da integração + o nome dado pela empresa (ex.: "Mercado Livre - Minha Loja ML"). |
| Código da integração | Identificador numérico da integração (útil para abrir direto a tela da integração em outra aba). |
| Conta | Empresa do grupo dona da integração (relevante apenas em operações multi-empresa). |
Variação canal não localizada
Quando aparece: o canal de venda enviou um código de SKU que não está vinculado a nenhum produto no idworks para essa integração específica.
Cenário típico: você cadastrou um produto novo no Mercado Livre, mas esqueceu de fazer o de/para entre o código do Mercado Livre e o código do produto no idworks. O cliente do Mercado Livre tenta cotar o frete, o ML envia o código dele, o idworks olha a tabela de mapeamento, não encontra correspondência e grava o erro.
Como resolver:
- Anote o SKU canal mostrado na linha do erro.
- Identifique a integração envolvida.
- Acesse Marketplaces → Listar de/para SKU (ou a tela equivalente do canal usado).
- Cadastre o vínculo entre o SKU do canal e o SKU do idworks correspondente.
Por que importa: sem o vínculo, nenhuma cotação desse produto vai funcionar pelo canal — todo cliente que tentar comprar vê erro. Esses erros são prioridade alta para resolver.
SKU não localizado
Quando aparece: o canal mandou um código de SKU que nem cadastro tem no idworks (não está nem em produto, nem em variação de produto).
Diferença para o erro anterior: "Variação canal não localizada" significa que o produto existe no idworks mas falta o vínculo com o código do canal. "SKU não localizado" significa que o produto sequer existe no idworks.
Como resolver:
- Pegue o SKU canal mostrado na linha.
- Verifique no canal de venda qual o produto que está usando esse código.
- Cadastre o produto no idworks em Cadastros → Listar Produtos.
- Crie o vínculo do SKU (mesmo procedimento da "Variação canal não localizada" depois de cadastrar).
CEP não localizado
Quando aparece: o CEP destino enviado pelo cliente final não foi encontrado na base de CEPs do idworks (CEP que não existe nos Correios, CEP em formato inválido, CEP de área rural sem cadastro).
Como resolver:
- Verifique o CEP destino registrado na linha — se for um número claramente inválido (poucos dígitos, todos iguais, etc.), provavelmente o cliente final digitou errado e não há ação possível do seu lado.
- Se o CEP parecer válido mas não estiver sendo reconhecido, abra um chamado de suporte para revisão da base de CEPs do idworks.
- Quando o CEP é correto mas a área é rural/extrema, a transportadora pode não atender mesmo — confirme se o produto é vendável para essa região.
Observação: esse erro não está sob seu controle na maioria das vezes; ver de tempos em tempos serve para identificar regiões problemáticas onde os clientes têm mais dificuldade.
SKU sem peso cadastrado
Quando aparece: o canal achou o produto no idworks, mas o cadastro está com o campo Peso vazio. Sem peso, a transportadora não consegue calcular o frete (peso é um dos dados obrigatórios da cubagem).
Como resolver:
- Acesse Cadastros → Listar Produtos.
- Busque o produto pelo SKU canal mostrado na linha de erro.
- Abra o cadastro e preencha o campo Peso (em kg) no bloco de dimensões.
- Salve.
Boa prática: ao fechar a tela de Erros, faça um filtro pelo tipo "SKU sem peso cadastrado" e use como lista de afazeres — é provavelmente a categoria que dá mais retorno imediato porque você resolve cadastrando uma informação simples.
SKU sem dimensões cadastradas
Quando aparece: o produto está no idworks, mas falta largura, altura ou comprimento no cadastro. As transportadoras exigem cubagem (peso + dimensões) para calcular o frete em muitos casos (sobretudo objetos grandes em relação ao peso).
Como resolver: mesmo caminho do erro anterior — abra o produto em Cadastros → Listar Produtos e preencha os três campos de dimensão (largura, altura, comprimento) em centímetros. Salve.
Dica: dimensões grandes mas peso pequeno (almofadas, caixas vazias) costumam ser justamente os casos em que o frete varia muito da dimensão — manter os três campos sempre preenchidos evita erros em transportadoras que cubam por volume.
Tipo integração de venda não localizada
Quando aparece: uma chamada externa chegou tentando se identificar como uma integração de venda, mas o tipo de integração informado não é suportado pelo endpoint de cotação. Em geral, esse erro indica:
- Tentativa de chamada de um canal ainda não habilitado no idworks (ex.: marketplace que você está testando mas ainda não foi liberado).
- Configuração incorreta no painel do canal (URL errada, parâmetro de tipo errado).
- Tentativa de uso por alguém que não deveria estar chamando o endpoint (com URL parecida mas vinda de outro sistema).
Como resolver:
- Verifique em Configurações → Integrações se a integração que está aparecendo no erro está cadastrada e ativa para a sua empresa.
- Se for um canal novo que ainda não está disponível, abra um chamado para o suporte solicitar a habilitação.
- Se persistir vindo de uma origem desconhecida, vale registrar para análise de segurança.
Como filtrar erros por período?
Por padrão, a tela tras os 3000 erros mais recentes (sem limitar data). Para focar em um intervalo:
- Abra o painel de Filtros (botão no canto superior direito da tela).
- No campo Data log, escolha o intervalo (data de início e data de fim).
- Aplique o filtro.
Os erros listados passam a ser apenas os que aconteceram dentro do período escolhido (Data log é o RecordTimestamp do erro).
Dicas:
- Use intervalos curtos (1-7 dias) para resolver problemas recentes.
- Use intervalos maiores (30 dias) para ter visão de tendência — quais tipos de erro têm aumentado.
Como filtrar por conta (operação multi-empresa)?
Empresas que operam com várias contas (multi-CNPJ) podem filtrar os erros por uma conta específica:
- Abra os Filtros.
- No campo Conta, selecione a conta desejada da lista.
- Aplique.
Em operações single-account, esse filtro não aparece — a tela já mostra direto os erros da conta única.
Os erros somem com o tempo?
A tela mostra sempre os 3000 mais recentes — então erros antigos vão saindo da visualização conforme novos chegam. Não há expiração automática no banco; os registros antigos continuam no histórico do sistema, mas a tela limita a 3000 para performance.
Implicação prática:
- Em operações com alto volume de cotações, os erros do mês passado provavelmente já saíram da tela.
- Use o filtro de data para "voltar no tempo" se precisar consultar período antigo.
- Mantenha o hábito de resolver erros toda semana para que a lista reflita problemas atuais, não problemas crônicos arrastados.
Por que o mesmo SKU aparece várias vezes?
Cada tentativa de cotação gera uma linha — então um SKU com problema vai gerar tantos erros quantas forem as cotações tentadas. Por exemplo: produto sem peso cadastrado num anúncio popular do Mercado Livre pode gerar dezenas ou centenas de erros por dia.
O que fazer:
- Resolva o cadastro uma vez (preencher peso/dimensão, criar vínculo do SKU) e as próximas cotações daquele SKU param de aparecer.
- Quando perceber muitas linhas com o mesmo SKU canal, é sinal de alta demanda por aquele produto — priorize o cadastro.
Tem alerta automático quando um erro novo aparece?
Por enquanto, não. A tela é consulta passiva — você precisa abri-la para ver. Boa prática: incluir na rotina diária ou semanal do time uma passada por aqui, principalmente quando:
- Subiu produto novo em um canal.
- Alterou configuração de integração.
- Houve mudança de tabela de frete em alguma transportadora.
Receita: usar a tela como checklist de cadastros incompletos
Quando você assume uma operação que já tem catálogo razoável mas suspeita de cadastros incompletos:
- Filtre por últimos 7 dias.
- Anote todos os SKU canal que aparecem em erros do tipo SKU sem peso e SKU sem dimensões.
- Vá em Cadastros → Listar Produtos, busque um a um e preencha as informações faltantes.
- Repita o filtro depois de 2-3 dias e veja a lista reduzir.
Resultado: você resolve a maior parte das falhas de cotação sem precisar fazer auditoria item a item no catálogo inteiro — a tela já apontou quais produtos estão sendo procurados pelos clientes.
Receita: monitorar lançamentos novos no marketplace
Toda vez que você cria um produto novo em um marketplace:
- Lance o anúncio normalmente.
- Em 1-2 dias, abra esta tela.
- Filtre por Conta = sua loja e Data log = últimos 2 dias.
- Se aparecer Variação canal não localizada com o SKU do produto novo, vá em Marketplaces → Listar de/para SKU e crie o vínculo.
Resultado: você fecha o gap de cadastro antes que ele vire perda de vendas em larga escala.
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 |
|---|---|
| Erros Simulação Frete | Acessa a tela e a lista de erros (filtros de conta e período). Sem este privilégio, o item de menu nem aparece. |
Como a tela é só de consulta, não existem privilégios separados para criar, editar ou excluir.