Esta seção reúne orientações práticas para quando algo parecer fora do lugar na Vörn, como pedidos faltando, números divergentes ou telas sem atualização aparente. A proposta é sempre a mesma: isolar rapidamente se o problema é de contexto (conta, filtros, permissões), de integração (status e autenticação), de mapeamento (SKU e cadastros) ou de critério (diferenças de regra entre sistemas). Assim você resolve o que é simples sem abrir chamado e, quando precisar de suporte, já chega com evidências claras.
Pergunta: Os dados parecem não atualizar. O que isso normalmente significa?
Resposta: Na maioria dos casos, significa uma destas situações: você está olhando a conta errada, há um filtro ativo que está ocultando resultados, sua permissão não permite ver determinados dados, ou a integração que alimenta aquela informação está com falha de autenticação. Na Vörn, se a informação já entrou na plataforma, a IA e as telas passam a ter contexto imediatamente. Quando a informação não aparece, o mais comum é que ela ainda não tenha chegado por algum bloqueio de integração ou por critério de visualização.
Pergunta: Estão faltando pedidos. O que devo checar primeiro?
Resposta: Primeiro, confirme se você está na conta certa e se os filtros de status e período estão abertos o suficiente. Depois, valide se o canal de origem do pedido está incluído no filtro. Em seguida, cheque o status da integração daquele canal e se houve falha recente de autenticação. Por fim, valide se o pedido existe na origem e se ele está em um status que deveria ser importado pela Vörn.
Pergunta: Os números da Vörn diferem do sistema de gestão ou do canal. Isso é erro?
Resposta: Nem sempre. Diferenças costumam vir de critérios diferentes, como horário de corte, timezone, regras de cancelamento e devolução, agrupamento de pedidos, ou custos que ainda não estão cadastrados na Vörn para cálculo de margem. O caminho correto é comparar o mesmo período, o mesmo recorte e o mesmo critério nos dois lados antes de concluir que há um problema.
Pergunta: Qual é o checklist mínimo para diagnosticar rápido?
Resposta: Faça esta sequência, sempre na ordem: confirme se está na conta correta. Remova ou amplie filtros de período e status. Verifique se seu usuário tem permissão para aquela área. Confira o status da integração relacionada ao dado que está faltando. Verifique se existe indicação de última atualização exibida pela Vörn para aquela integração. Se houver erro ou autenticação vencida, reconecte. Se houver divergência de número, valide critérios e custos cadastrados antes de escalar.
Pergunta: Onde eu vejo se uma integração está saudável?
Resposta: Normalmente em Configurações, Integrações. A Vörn apresenta o status de cada conexão e sinaliza quando há necessidade de reautorização, credenciais inválidas ou falhas de comunicação. Ao abrir a integração específica, você deve conseguir identificar se ela está ativa, quando foi a última comunicação registrada e se existe alguma pendência.
Pergunta: O que significa uma integração ativa, mas com problema?
Resposta: Significa que a integração existe e está configurada, mas pode estar impedida de atualizar por algum motivo, como token expirado, escopo inválido, credencial alterada, bloqueio no canal de origem ou limitação temporária. Nesse caso, o status tende a indicar atenção, e a ação correta é revisar autenticação e permissões do usuário usado na conexão.
Pergunta: O que são escopos expirados no Mercado Livre?
Resposta: Escopos são permissões concedidas à integração para acessar dados e executar consultas. Se esses escopos expirarem ou forem revogados, a Vörn perde autorização para ler informações e a atualização pode parar. O sintoma típico é integração ativa, mas sem novos dados chegando, ou mensagens de autenticação inválida.
Pergunta: Como resolver escopos expirados no Mercado Livre?
Resposta: Reconecte a integração e refaça a autorização com um usuário que tenha permissão administrativa na conta do canal. Depois, confirme que o status voltou ao normal e valide com um pedido recente se os dados voltaram a entrar na Vörn.
Pergunta: O que costuma dar errado em autenticação no Tiny?
Resposta: Os problemas mais comuns são token incorreto, token revogado, usuário sem permissão adequada ou troca de senha que invalida credenciais. O sintoma costuma ser falha contínua de atualização ou erro de autorização no status da integração.
Pergunta: Como resolver problema de token ou usuário no Tiny?
Resposta: Gere ou recupere o token correto, confirme que ele pertence ao usuário certo, valide permissões desse usuário e atualize a credencial na integração dentro da Vörn. Depois, confira se a integração voltou a registrar comunicações e se os dados básicos, como pedidos e produtos, estão atualizando.
Pergunta: Quando faz sentido reprocessar ou resincronizar?
Resposta: Faz sentido quando você corrigiu uma causa raiz e precisa que a Vörn releia dados já existentes para refletir a correção. Exemplos típicos incluem reautorização de integração após falha de autenticação, correção de mapeamento de SKU, ajustes em regras que afetam cálculo ou classificação, ou quando o suporte orientar reprocessamento para recuperar consistência.
Pergunta: Qual é o impacto esperado ao reprocessar?
Resposta: O impacto costuma ser atualização de consistência, como corrigir vínculos, recompor status, recalcular visões e ajustar listagens. Dependendo do volume, pode levar algum tempo para a plataforma refletir tudo e é normal que, durante o processo, algumas telas pareçam incompletas momentaneamente. Em caso de operação crítica, a boa prática é fazer esse tipo de ação em um horário de menor movimento.
Pergunta: O que causa conflito de mapeamento de SKU?
Resposta: Geralmente, a mesma mercadoria aparece com códigos diferentes em sistemas distintos, ou existe reutilização de códigos para produtos diferentes ao longo do tempo. Isso pode gerar duplicidade de produtos, anúncios desconectados do cadastro correto e relatórios inconsistentes.
Pergunta: Como reconhecer que o problema é mapeamento e não integração?
Resposta: Quando os dados chegam, mas chegam bagunçados. Você vê duplicidade, produtos parecidos com estoques separados, anúncios sem vínculo com o produto esperado ou categorias incoerentes. Se o problema fosse integração, o sintoma mais comum seria ausência de atualização e falhas de autenticação, não inconsistência de estrutura.
Pergunta: Qual é a correção mais segura para mapeamento?
Resposta: Padronize um identificador principal para o produto, revise vínculos de variações, ajuste categorias e consolide duplicidades, garantindo que cada item represente uma mercadoria única. Depois, quando aplicável, reprocessar ajuda a refletir a correção de forma consistente em telas e relatórios.
Pergunta: O que é normal em “atraso” se a Vörn atualiza ao vivo?
Resposta: A Vörn reflete imediatamente o que entra na plataforma. O que pode variar é o tempo do dado sair da origem e chegar até a Vörn, por exemplo por limitações do canal, instabilidade momentânea, rate limit, bloqueio de autenticação ou indisponibilidade externa. Então, “normal” é o dado aparecer assim que a origem o disponibiliza para a integração e a Vörn consegue coletar.
Pergunta: O que é sinal de anomalia?
Resposta: É quando uma integração fica sem atualizar por um tempo incompatível com o comportamento normal da sua operação, especialmente se existem eventos novos na origem, ou quando o status da integração indica erro de autenticação, falha recorrente ou pendência. Também é anomalia quando há divergência grande e consistente mesmo após comparar critérios e filtros iguais entre sistemas.
Pergunta: O que eu devo enviar para o suporte para acelerar o diagnóstico?
Resposta: Envie sempre o nome da conta e da organização na Vörn, qual integração está envolvida, o horário em que você observou o problema e o horário do último dado correto. Inclua identificadores concretos, como número de pedido, SKU, ID do anúncio ou referência da mensagem de SAC, e descreva o passo a passo do que você fez antes do erro aparecer. Se possível, inclua prints da tela, do status da integração e do erro exibido.
Pergunta: Qual é o padrão de evidência que mais ajuda?
Resposta: Evidência com comparação. Um print da Vörn, um print da origem mostrando o mesmo item e o horário da divergência. Isso elimina suposições e permite que o suporte valide rapidamente se é critério, permissão, integração ou inconsistência de cadastro.
Pergunta: Quais são os erros mais comuns e o que fazer?
Resposta: As mensagens podem variar por integração e tela, mas os padrões mais comuns e as ações sugeridas são os seguintes.
Autenticação inválida, token expirado, escopo insuficiente. Ação sugerida: reconectar a integração, reautorizar com usuário administrativo e confirmar status saudável.
Permissão insuficiente, acesso negado. Ação sugerida: revisar perfil de acesso na Vörn e confirmar se o usuário tem permissão para aquela área e aquela conta.
Limite de requisições, temporariamente indisponível. Ação sugerida: aguardar e tentar novamente, validar se o canal está estável e verificar se o status da integração voltou ao normal.
Recurso não encontrado, pedido inexistente, anúncio não localizado. Ação sugerida: confirmar se o item existe na origem, se está no status esperado e se você está no ambiente correto dentro da Vörn.
Conflito de mapeamento, SKU duplicado, vínculo inválido. Ação sugerida: revisar padronização de SKU, corrigir vínculos de produto e anúncio e, quando aplicável, reprocessar para consolidar a correção.
Dados incompletos para cálculo, custo ausente, parâmetro não definido. Ação sugerida: completar cadastro de custos e parâmetros necessários, depois refazer a análise para evitar conclusões com margem distorcida.