Pular para o conteúdo principal

Mercado Livre — erros e como corrigir

Quando o Mercado Livre recusa uma chamada do idworks — porque a credencial expirou, porque o anúncio tem algo fora do padrão, porque uma mensagem foi moderada, porque a reclamação não permite mais a ação que você tentou — o canal devolve uma mensagem específica. Este artigo é o catálogo dessas mensagens: o que cada uma significa em linguagem de operador, onde ela aparece no idworks e como corrigir dentro do produto.

A integração com o Mercado Livre cobre muitos fluxos diferentes (anúncios, pedidos, envios, perguntas, mensagens, reclamações, promoções, conciliação financeira) e cada fluxo tem seu próprio conjunto de erros possíveis. Use o índice para pular direto para o tema do erro que você está vendo. Quando a mesma mensagem pode aparecer em situações diferentes, a seção lista todas as causas conhecidas.

A FAQ principal do canal (com a configuração dos parâmetros) está em Mercado Livre. Os erros mais comuns na publicação de anúncios também aparecem lá — este artigo é a referência completa.

Índice​

Conceito

Autenticação e credenciais

Anúncios — publicação e atualização

Pedidos, envios e fulfillment

Perguntas e respostas

Mensagens pós-venda

Reclamações

Promoções

Erros gerais e instabilidade

Referência rápida

Onde os erros do Mercado Livre aparecem no idworks?​

📍 Onde: menu lateral → Configurações → Integrações → Minhas Integrações → Mercado Livre, e nas telas do Hub correspondentes ao recurso afetado (Hub → Anúncios, Hub → Pedidos Integrados, Hub → Perguntas e Respostas, Hub → Mensagens, Hub → Reclamações, Hub → Promoções).

Os erros devolvidos pelo Mercado Livre aparecem em três lugares principais, dependendo do fluxo:

  • Status da integração — em Configurações → Integrações → Minhas Integrações, a integração do Mercado Livre tem um indicador de status. Quando algo persistente está errado (vínculo da conta expirou, autorização revogada), o status vira Erro.
  • Tela do recurso afetado — anúncios recusados aparecem com a mensagem do canal na linha do anúncio em Hub → Anúncios; pedidos que falharam na importação ficam visíveis em Hub → Pedidos Integrados com o motivo; perguntas, mensagens e reclamações aparecem com o status do canal em Hub → Perguntas e Respostas, Hub → Mensagens e Hub → Reclamações.
  • Painel do Mercado Livre — alguns erros (anúncio bloqueado, marca não validada, voltagem proibida) só são visíveis abrindo o anúncio direto no painel do canal.

Como interpretar a mensagem que o canal devolve?​

As mensagens do Mercado Livre vêm em inglês ou em uma mistura de inglês e português, e costumam citar o nome técnico do atributo (por exemplo SIZE_GRID_ID, GTIN, AGE_GROUP). O idworks repassa essa mensagem como ela vem, porque é nela que o canal indica qual atributo precisa de correção. As seções deste artigo organizam essas mensagens pelo sintoma e mostram o nome do atributo em maiúsculo entre crases (assim: GTIN) — é exatamente o que você vai ver na mensagem.

Cada erro tem uma destas três naturezas:

  • Bloqueante — o canal recusou a ação e nada foi salvo. Você precisa corrigir antes de tentar de novo.
  • Aviso — o canal aceitou a ação, mas avisou que ajustou algo (por exemplo, completou um atributo automaticamente, migrou a categoria). Você pode ignorar ou conferir o que mudou.
  • Instabilidade — o canal não respondeu a tempo ou está em manutenção. Não é problema do cadastro; basta tentar de novo em alguns minutos.

O status da integração caiu para "Erro" ou "Não Autenticado"​

A integração entra em Erro quando o Mercado Livre passou a recusar as chamadas do idworks, normalmente porque o vínculo da conta foi quebrado. Os motivos mais comuns:

  • O dono da conta no Mercado Livre trocou a senha ou revogou a permissão do idworks.
  • A integração ficou parada por mais de quatro meses sem nenhuma chamada — o canal invalida o vínculo automaticamente nesse caso.
  • O Mercado Livre detectou um evento interno (alteração de cadastro, fraude, desvinculação de dispositivo) e cortou o vínculo.

Como resolver:

  1. Acesse Configurações → Integrações → Minhas Integrações, localize a integração do Mercado Livre.
  2. Clique em Autenticar Integração (ícone de cadeado) e siga o fluxo: confirmar, fazer login no Mercado Livre com a conta de vendedor administrador e autorizar o idworks.
  3. Depois de autorizar, volte à tela de integrações — o status deve voltar para Ativo em alguns segundos.
  4. Confirme com a ação Validar credenciais (no grupo Credenciais de Acesso da configuração da integração).

Refazer a autenticação não apaga os anúncios, pedidos ou histórico já importados — só renova o vínculo da conta.

Por que o vínculo da conta expira e como reautenticar?​

O Mercado Livre dá ao idworks um vínculo curto (com validade de seis horas) e um vínculo longo (com validade de seis meses), usado para renovar o curto sempre que vence. O idworks faz essa renovação sozinho — você não precisa intervir. Mas o vínculo longo é invalidado em algumas situações:

  • Toda vez que ele é usado para renovar, o canal devolve um vínculo novo. Se duas instâncias do idworks tentarem usar o vínculo antigo, o canal invalida o que foi usado em segundo lugar.
  • Passados seis meses sem renovação, o vínculo longo expira.
  • O dono da conta revogou a permissão no painel do Mercado Livre, ou trocou a senha.

Em qualquer um desses casos, o caminho é o mesmo: refazer a autenticação como descrito em O status da integração caiu para "Erro" ou "Não Autenticado".

Mensagem "Sorry, the application cannot connect to your account"​

Mensagem exibida pelo Mercado Livre durante o login da autenticação ("Desculpe, o aplicativo não pode se conectar à sua conta"). Indica que a tentativa de autorizar o idworks foi recusada antes de chegar a gerar o vínculo. Os motivos confirmados pelo canal:

  • A URL de retorno cadastrada no aplicativo idworks mudou ou está diferente da que o canal recebeu.
  • O vendedor entrou com uma conta de colaborador, não com a conta principal/administrador.
  • A conta do vendedor tem dados pendentes de validação (documento, comprovante, endereço) ou alguma inabilitação aberta no Mercado Livre.

Como resolver:

  1. Confirme que está fazendo login com a conta principal do vendedor — não com um operador/colaborador.
  2. Abra o Mercado Livre direto no navegador e verifique se há pendências de cadastro ou avisos de inabilitação. Resolva-as primeiro.
  3. Tente a autenticação de novo a partir de Configurações → Integrações → Minhas Integrações → Autenticar Integração.
  4. Se persistir, abra um chamado com o suporte do idworks informando o erro — pode ser preciso ajustar a configuração do aplicativo do lado do idworks.

Mensagem "invalid_grant" — autorização inválida ou expirada​

Aparece como "Error validating grant. Your authorization code or refresh token may be expired or it was already used". É a forma mais comum de o canal dizer que o vínculo da conta precisa ser refeito. Causas confirmadas pelo canal:

  • O vínculo longo passou da validade de seis meses.
  • O vendedor revogou a autorização do idworks no painel do Mercado Livre.
  • Houve uma revogação interna no canal (alteração de senha, desvinculação de dispositivo, detecção de fraude).
  • O idworks tentou usar um vínculo que já tinha sido renovado em outro lugar.

Como resolver: refazer a autenticação. Caminho em O status da integração caiu para "Erro" ou "Não Autenticado".

Mensagem "invalid_client" — credenciais do aplicativo recusadas​

O Mercado Livre não reconheceu o aplicativo idworks (não a conta do vendedor). Normalmente é um problema do lado do idworks — chaves do aplicativo trocadas, aplicativo bloqueado pelo canal, ou alguma inconsistência de configuração interna.

Como resolver: abra um chamado com o suporte do idworks. Não há ação no produto que resolva — não tente reautenticar a integração até o suporte confirmar o ajuste.

Mensagem "forbidden" — sem permissão para o recurso​

Mensagem "You don't have permission to access the resource" ou "user not authorized". O canal aceitou a chamada (a credencial é válida), mas a conta autenticada não tem permissão para o recurso que foi pedido. Causas conhecidas:

  • A conta autenticada não é dona do anúncio, pedido ou reclamação que o idworks tentou acessar (acontece em multi-conta quando uma integração tenta enxergar dados de outra).
  • O recurso pertence a uma área (envios, fulfillment, claims) que não foi liberada pelo Mercado Livre para o aplicativo do idworks.
  • O endereço de origem das chamadas (IP) está bloqueado temporariamente pelo canal.

Como resolver:

  1. Confirme que a integração está autenticada com a conta dona do recurso. Em multi-conta, abra a integração da conta certa em Configurações → Integrações → Minhas Integrações.
  2. Se for o primeiro acesso a um recurso novo (por exemplo, primeira reclamação importada), aguarde alguns minutos — o canal libera as permissões gradativamente após a autenticação.
  3. Persistindo, abra chamado com o suporte com o número do anúncio/pedido afetado.

Mensagem "invalid_operator_user_id" — login com colaborador​

Durante a autenticação, o vendedor entrou com uma conta de operador/colaborador em vez da conta principal/administrador. O Mercado Livre só permite vincular aplicativos a partir da conta principal.

Como resolver: faça logout do Mercado Livre no navegador, entre de novo com a conta principal do vendedor e refaça a autenticação a partir de Configurações → Integrações → Minhas Integrações → Autenticar Integração.

O Mercado Livre devolveu "validation_error" ao publicar​

"Validation error" é a resposta genérica do canal quando o anúncio que o idworks tentou publicar não passou nas regras da categoria. A mensagem traz uma lista de causas — pode ser uma só ou várias ao mesmo tempo —, cada uma apontando para um atributo, imagem, preço, descrição ou variação. As seções a seguir cobrem cada tipo de causa que aparece com mais frequência.

Algumas causas são bloqueantes (o anúncio não foi salvo, você precisa corrigir) e outras são avisos (o canal completou ou ajustou sozinho, e você pode ignorar ou conferir). A diferença está sinalizada na mensagem, e o idworks só interrompe a sincronização nas causas bloqueantes.

Como resolver no geral:

  1. Leia a mensagem da sincronização na linha do anúncio em Hub → Anúncios.
  2. Identifique o atributo entre crases ou em maiúsculo na mensagem (SIZE_GRID_ID, GTIN, AGE_GROUP, BRAND...).
  3. Use a seção correspondente neste artigo para localizar onde corrigir no idworks.

Os atributos preenchidos não chegam ao anúncio​

Você preencheu atributos e especificações no idworks, mas eles não aparecem no anúncio e a sincronização trava ou volta com validation_error pedindo atributos que, na sua visão, já estão preenchidos. Há dois pontos a conferir:

  1. Envio de especificações habilitado — no grupo Integração de Produtos (em Configurações → Integrações → Mercado Livre), habilite Atualizar Especificações (atributos). Sem essa opção, o idworks não envia os atributos ao canal, então o anúncio publica sem eles.
  2. Atributos da categoria preenchidos no lugar certo — o anúncio precisa ter preenchidos os atributos que aquela categoria do Mercado Livre exige. Preencha-os na ficha do anúncio em Hub → Anúncios. Se o produto tem variações, alguns atributos têm que ser preenchidos em cada variação, não só no anúncio raiz.

Depois de ajustar, sincronize novamente em Hub → Anúncios.

Atributo obrigatório está em branco​

Mensagem "The attributes [ATRIBUTO] are required for category CATEGORIA and channel marketplace". A categoria escolhida exige um atributo que está em branco no idworks. É o motivo mais comum de recusa de publicação. Os casos mais frequentes nos atendimentos:

  • Condição do item / recondicionado — mensagem "GRADING tem valores de atributo inválidos. Cause_ID:480". Acontece em itens novos, usados ou recondicionados quando o atributo de condição não está preenchido (em recondicionados, falta o status do recondicionado).
  • ID de registro — mensagem "O atributo 'ID de registro' é obrigatório, verifique e atualize". Algumas categorias exigem registro de órgão regulador (ANVISA, INMETRO e similares).

Como resolver:

  1. Identifique na mensagem qual atributo falta (vem em maiúsculo, entre colchetes).
  2. Abra o anúncio em Hub → Anúncios e preencha o atributo exigido na ficha do anúncio, dentro da categoria correspondente.
  3. Se o valor vier do cadastro do produto (e não do anúncio), complete-o em Produtos → Listar Produtos → editar SKU.
  4. Salve e sincronize novamente.

Os atributos exigidos mudam com a categoria — se você trocar a categoria do anúncio, o canal pode passar a cobrar atributos novos.

Atributo condicional obrigatório (GTIN, marca, modelo)​

Mensagem "The attributes [ATRIBUTO] are required for category CATEGORIA. Check the attribute is present in the attributes list or in all variation's attributes_combination or attributes" acompanhada de conditional_required. Igual ao caso anterior, mas o atributo só é exigido em condições específicas da categoria (por exemplo, GTIN exigido só para marcas reconhecidas; MODEL exigido só para algumas linhas).

Como resolver:

  1. Preencha o atributo na ficha do anúncio em Hub → Anúncios.
  2. Se o produto tem variações, o atributo precisa ser preenchido em cada variação (não basta no anúncio raiz). Acesse Produtos → Listar Produtos → editar → aba de variações/grade e complete em todas.
  3. Sincronize novamente.

A categoria exige uma guia de tamanhos​

Mensagem "Attribute SIZE_GRID_ID is not valid" (ou variações citando o atributo de guia de tamanhos). Em categorias de moda e calçados, o Mercado Livre exige uma guia de tamanhos vinculada ao anúncio. Sem ela — ou com uma guia incompatível com a categoria — o anúncio não publica.

Como resolver: vincule a guia de tamanhos correta ao anúncio. O passo a passo está no artigo Grade de Tamanho. Escolha uma guia compatível com a categoria do anúncio em Hub → Grade de Tamanho e sincronize de novo.

O preço está abaixo do mínimo da categoria​

Mensagem "The category CATEGORIA requires a minimum price of VALOR". Cada categoria do Mercado Livre tem um preço mínimo — abaixo dele, o canal recusa a publicação.

Como resolver:

  1. Confirme o preço do produto em Produtos → Listar Produtos → editar SKU.
  2. Lembre-se de que o preço enviado ao canal pode estar ajustado pelas regras do grupo Integração de Produtos (percentual e valor de ajuste, frete grátis, arredondamento). Se a regra estiver puxando o preço para baixo, ajuste-a em Configurações → Integrações → Mercado Livre → Integração de Produtos.
  3. Se o produto realmente é mais barato que o mínimo da categoria, considere mudar a categoria do anúncio (em Hub → Anúncios) para uma compatível.

A categoria escolhida não permite publicar​

Mensagem "Is not allowed to post in category CATEGORIA. Make sure you're posting in a leaf category". Você escolheu uma categoria intermediária (um agrupador) em vez de uma categoria "folha". O Mercado Livre só aceita anúncios em categorias-folha.

Como resolver: em Hub → Anúncios, abra o anúncio e selecione uma subcategoria até chegar na mais específica disponível. O caminho na árvore termina quando não há mais subníveis para escolher.

O Mercado Livre pede um código de família​

Ao sincronizar, o canal pode pedir um código de família mesmo quando o produto, na sua visão, não faz parte de uma família. Isso acontece quando a categoria está no catálogo do Mercado Livre, onde produtos iguais são agrupados sob um item canônico (a "família").

Como resolver:

  1. Verifique no Mercado Livre se já existe um item de catálogo para o seu produto.
  2. Se existir, vincule o anúncio à família correspondente.
  3. Se não existir, use a opção de criar um novo item de catálogo no próprio canal. Depois de definida a família no Mercado Livre, refaça a sincronização em Hub → Anúncios.

A foto está abaixo do tamanho mínimo​

Mensagem "The photos must have a minimum size of 500 pixels on at least one side". As fotos do anúncio precisam ter pelo menos 500 pixels em um dos lados (largura ou altura).

Como resolver: substitua a foto em Produtos → Listar Produtos → editar SKU → seção de imagens, usando uma imagem maior. Depois sincronize de novo em Hub → Anúncios.

Imagem com falha no carregamento​

Mensagens "An error occurred while processing the photo. Please upload it again", "Picture id XYZ does not exist" ou "Items in category CATEGORIA cannot exceeds N pictures". O canal não conseguiu processar uma imagem ou recebeu mais imagens do que o limite da categoria.

Como resolver:

  1. Para falha no processamento, reenvie a imagem em Produtos → Listar Produtos → editar SKU → seção de imagens. Use o formato JPG ou PNG e confirme que o arquivo não está corrompido.
  2. Para limite excedido, reduza o número de imagens do produto até o máximo permitido pela categoria (varia entre categorias).
  3. Sincronize novamente em Hub → Anúncios.

O título está curto demais​

Mensagem "You should include more main features in the title to differentiate it from other products". O Mercado Livre exige títulos com mais informação sobre o produto: marca, modelo, características principais.

Como resolver: em Hub → Anúncios, abra o anúncio e edite o título acrescentando marca, modelo, cor, voltagem, capacidade, ou outro detalhe diferenciador. Salve e sincronize.

O título não combina com o gênero declarado​

Mensagem "Please make sure you enter a gender that matches the title of your listing". O título indica um gênero (masculino, feminino, infantil, unissex) diferente do que foi preenchido no atributo de gênero da ficha técnica.

Como resolver: em Hub → Anúncios, abra o anúncio e ajuste ou o título ou o atributo de gênero para que os dois fiquem coerentes. Sincronize novamente.

A descrição passou do limite de caracteres​

Mensagem "You exceeded the N character limit. Shorten the description". A descrição do anúncio tem mais caracteres do que a categoria aceita.

Como resolver: em Hub → Anúncios ou em Produtos → Listar Produtos → editar SKU → campo de descrição, encurte o texto para ficar dentro do limite. Se a descrição vem do produto, ajuste no cadastro do SKU; se foi escrita só no anúncio, ajuste lá. Sincronize de novo.

Código universal (EAN/GTIN) inválido ou em formato errado​

Mensagens "Product Identifier [GTIN] has invalid values", "Product Identifier [GTIN] contains values with invalid format" ou "The CÓDIGO_UNIVERSAL universal code has an incorrect format". O EAN/GTIN (código de barras) do produto não passou na validação do canal — tem caracteres inválidos, dígito verificador errado ou tamanho fora do padrão (8, 12, 13 ou 14 dígitos para os formatos EAN/UPC/GTIN).

Como resolver:

  1. Confira o código de barras no produto em Produtos → Listar Produtos → editar SKU → seção de identificadores.
  2. Use um EAN/GTIN válido — sem letras, sem espaços, com dígito verificador correto.
  3. Em produtos com variações, cada variação precisa de seu próprio código de barras válido (em Produtos → Listar Produtos → editar → aba de variações/grade).
  4. Sincronize novamente em Hub → Anúncios.

Código universal repetido em outra marca ou categoria​

Mensagens "Enter a universal code that you have not used in another brand listing/category listing", "Product Identifier [GTIN] with values XYZ corresponds to category CATEGORIA" ou "The CÓDIGO_UNIVERSAL universal code corresponds to the MARCA brand". O EAN/GTIN é válido, mas o Mercado Livre já tem esse código registrado para outra marca ou outra categoria. Não é permitido reutilizar.

Como resolver:

  1. Confirme com o fabricante que o EAN está correto — não estranho que seja outro código.
  2. Se o EAN estiver realmente correto, abra um chamado com o Mercado Livre (não com o idworks) para revisar o cadastro do código no canal — isso precisa ser resolvido do lado do Mercado Livre.
  3. Em último caso, mude o EAN do produto em Produtos → Listar Produtos → editar SKU para um código único e válido.

As variações do anúncio são recusadas​

Mensagem "The fields variations invalid for request call". O Mercado Livre recusou a grade de variações enviada — em geral por combinação repetida, variação sem código de barras ou grade incompleta.

Como resolver:

  1. Abra o produto em Produtos → Listar Produtos → editar → aba de variações/grade.
  2. Confirme que cada combinação é única (cor + tamanho não se repetem), que toda variação tem SKU e grade preenchidos, e que cada uma tem código de barras válido.
  3. Salve e sincronize novamente em Hub → Anúncios.

Detalhes de como montar a grade estão no artigo Variações.

As medidas e o peso da embalagem estão faltando ou em formato errado​

É o erro de publicação mais comum em produção. O Mercado Livre exige altura, largura, comprimento e peso da embalagem para calcular o frete, e recusa o anúncio quando esses dados faltam ou estão fora do padrão. As variações da mensagem:

  • "The attributes [seller_package_height, seller_package_width, seller_package_length, seller_package_weight] are all required" — falta preencher uma ou mais das quatro medidas.
  • "The packaging attributes [...] are too small for the product dimensions" — a embalagem informada é menor que o próprio produto (impossível).
  • "The attributes [...] are in the wrong format - Only integers are accepted for dimensions and weight, with centimeters 'cm' ... grams 'g' ..." — os valores precisam ser números inteiros, em centímetros (medidas) e gramas (peso). Valores com vírgula ou em outra unidade são recusados.
  • "One or more attributes for [...] do not have proper values for the product" — algum valor está zerado ou inválido.

Como resolver:

  1. Abra o produto em Produtos → Listar Produtos → editar SKU.
  2. Preencha as quatro medidas: Altura, Largura, Comprimento e Peso (o peso é o total, já com a embalagem e qualquer invólucro).
  3. Use números inteiros, medidas em centímetros e peso em gramas. Confirme que a embalagem é igual ou maior que o produto.
  4. Em produtos com variações, confira as medidas em cada variação (aba de variações/grade).
  5. Salve e sincronize novamente em Hub → Anúncios.

Não é possível ativar o anúncio sem estoque​

Mensagens "Is not possible to activate an item without stock", "Stock of item should be more than 0 if you want to activate it" ou "item.variations.missing_available_quantity". O Mercado Livre não deixa ativar um anúncio com estoque zero. As causas:

  • O produto está com saldo zerado no idworks.
  • O estoque de segurança consumiu todo o saldo (o idworks envia ao canal o saldo disponível menos o estoque de segurança).
  • Alguma variação ficou sem quantidade informada.

Como resolver:

  1. Confira o saldo do produto em Produtos → Listar Produtos → editar SKU.
  2. Revise as regras de estoque do canal em Configurações → Integrações → Mercado Livre → Integração de Produtos: Estoque de segurança, Estoque fixo, Percentual disponibilidade de estoque e Armazéns para somar quantidade. Se o estoque de segurança estiver alto demais, o saldo enviado pode zerar.
  3. Em produtos com variações, garanta que cada variação tenha saldo.
  4. Em Hub → Anúncios, use Atualizar disponibilidade de estoque e sincronize.

A variação está sem imagem​

Mensagem "Null or Empty is not valid for item.variations.picture_ids field". Cada variação do anúncio precisa de pelo menos uma imagem — não basta a imagem do anúncio principal.

Como resolver: em Hub → Anúncios → editar anúncio → passo Imagens das Variações, adicione ao menos uma imagem em cada variação. Você pode usar o botão de aplicar a mesma imagem a várias variações de uma vez. Salve e sincronize.

As imagens do anúncio são obrigatórias​

Mensagem "Item pictures are mandatory for listing type gold_special". O tipo de anúncio escolhido (anúncio premium/clássico) exige imagens, e o anúncio foi enviado sem nenhuma.

Como resolver: adicione as imagens em Produtos → Listar Produtos → editar SKU → seção de imagens, ou no próprio anúncio em Hub → Anúncios. Depois sincronize.

Mensagem "Cannot add variations to an item with family name". O anúncio está vinculado a um item de catálogo (família) do Mercado Livre, e itens de catálogo não aceitam variações próprias — a ficha do produto é definida pela família.

Como resolver: escolha um caminho em Hub → Anúncios:

  • Se você precisa de variações próprias (cor, tamanho), publique o anúncio fora do catálogo.
  • Se quer manter no catálogo, publique sem variações — uma publicação por produto.

Não dá para alterar as variações de um anúncio em revisão ou com vendas​

Mensagem "variations is not modifiable. - Cannot update item ITEM [status:under_review, has_bids:true]". O Mercado Livre bloqueia a alteração da grade de variações quando o anúncio está em moderação (under_review) ou já teve vendas/ofertas (has_bids).

Como resolver:

  1. Se está em revisão, aguarde a moderação terminar e sincronize depois.
  2. Se o anúncio já vendeu, o canal não permite mexer na grade de variações de um anúncio ativo com histórico. Para reestruturar as variações, encerre o anúncio e publique um novo em Hub → Anúncios.

Veja também Anúncio em revisão, encerrado ou bloqueado.

Não dá para excluir uma variação que ainda tem estoque​

Mensagem "Item variation cannot be deleted. Warehouse stock is available for this product". Você tentou remover uma variação que ainda tem saldo em estoque — o sistema bloqueia para você não perder esse saldo sem querer.

Como resolver: zere o estoque da variação primeiro (em Produtos → Listar Produtos → editar SKU → variações/grade) e só então remova a variação. Em seguida, sincronize em Hub → Anúncios.

A categoria do anúncio ficou em branco​

Mensagem "invalid property type: [category_id] expected Alphanumeric String but was String value:" (com o valor vazio). O anúncio foi enviado sem categoria definida.

Como resolver: em Hub → Anúncios → editar anúncio → passo Categoria, selecione a categoria navegando a árvore até o nível mais específico (categoria-folha). Salve e sincronize. Veja também A categoria escolhida não permite publicar.

A conta de marca precisa de uma Loja Oficial​

Mensagem "Users type brand have to provide a official store id". A conta é de marca/fabricante, e o Mercado Livre exige que o anúncio seja vinculado a uma Loja Oficial.

Como resolver: em Hub → Anúncios → editar anúncio → passo Loja oficial, selecione a loja oficial da conta. Se nenhuma loja aparecer na lista, ela precisa ser habilitada antes no painel do Mercado Livre. Depois sincronize.

O User Product (família do catálogo) foi duplicado​

Mensagem "User product was duplicated". Em contas que usam User Product (agrupamento de anúncios sob um item canônico), o idworks tentou criar uma família que já existe — o canal não permite duplicar.

Como resolver: em Hub → Anúncios → editar anúncio → passo Título, no campo Família, vincule o anúncio à família já existente em vez de criar uma nova. Salve e sincronize.

A condição do anúncio é inválida ou não pode mais ser alterada​

Mensagens "GRADING has invalid attribute values" ou "Cannot set Condition from Attribute when Item has Bids". A condição do anúncio (Novo, Usado, Recondicionado) está com valor inválido, ou você tentou mudar a condição de um anúncio que já teve vendas/ofertas — o que o Mercado Livre não permite.

Como resolver:

  1. Para condição inválida: em Hub → Anúncios → editar anúncio → passo Condição, escolha um valor válido (Novo / Usado / Recondicionado) compatível com a categoria.
  2. Se o anúncio já vendeu e você precisa trocar a condição, o canal trava a alteração. Encerre o anúncio e publique um novo com a condição correta.

O valor de um atributo não está na lista aceita​

Mensagem "Attribute [ATRIBUTO] is not valid, item values [(...)]" (por exemplo, INSTALLATION_METHOD). Você preencheu um atributo com um texto livre onde o Mercado Livre espera uma das opções da lista daquela categoria. O valor enviado não consta entre os aceitos.

Como resolver: em Hub → Anúncios → editar anúncio → ficha do anúncio, localize o atributo apontado na mensagem e escolha um dos valores oferecidos pela lista do Mercado Livre (não digite um valor próprio). Salve e sincronize.

O prazo de disponibilidade/fabricação está inválido​

Mensagem "Sale term MANUFACTURING_TIME to be deleted - Invalid value 'null', it should be integer". O anúncio tem um prazo de disponibilidade/fabricação configurado com valor inválido (vazio onde o canal espera um número de dias).

Como resolver: em Hub → Anúncios → editar anúncio, informe um número inteiro de dias no campo de Disponibilidade de estoque (prazo até despachar). Quanto maior o prazo, menor a exposição do anúncio — use o menor valor real. Salve e sincronize.

A retirada em mãos não é permitida para quem tem vários armazéns​

Mensagem "local pick up not allowed for multi warehouse seller". Você marcou que aceita retirada do produto em mãos, mas a conta tem vários armazéns/depósitos, e o Mercado Livre não permite retirada local nessa configuração.

Como resolver: em Hub → Anúncios → editar anúncio → passo Retirada, escolha Não concordo (desligar a retirada pessoal). Salve e sincronize.

O anúncio ficou inválido ("item.id.invalid")​

Mensagens "item.id.invalid" ou "Invalid item id". A referência do anúncio no Mercado Livre está inválida — o anúncio foi removido e recriado no canal, ou o vínculo no idworks aponta para um anúncio que não existe mais.

Como resolver:

  1. Abra o anúncio no painel do Mercado Livre e confirme se ele ainda existe.
  2. Se foi removido/recriado, em Hub → Anúncios use Desvincular e depois Vincular Anúncio ao anúncio correto, ou publique um novo.

É um caso próximo de Anúncio não localizado no canal.

A marca exige validação do vendedor​

Mensagem "Seller is not authorized for this brand and category". A marca declarada no anúncio precisa de validação prévia do vendedor no Mercado Livre — para algumas marcas conhecidas, o canal exige comprovar que o vendedor compra do distribuidor oficial.

Como resolver: a ação é fora do idworks, no Mercado Livre. Acesse o painel do canal em Vendas → Preferências de vendas → Validações, selecione Validar marca, escolha a marca em questão e anexe as faturas de compra. Depois que a marca for validada pelo canal, sincronize o anúncio novamente no idworks.

Voltagem entre 100 V e 199 V (Argentina)​

Mensagem "It is not allowed to sell products of this voltage in Argentina". Aplica-se a contas no Mercado Livre da Argentina — o canal não permite vender produtos com voltagem nessa faixa.

Como resolver: não há ação no idworks. O produto não pode ser anunciado nessa conta com essa voltagem.

Atributos de venda em pacote inconsistentes​

Mensagem detalhada começando com "You added VALOR in the CAMPO field" envolvendo SALE_FORMAT, UNITS_PER_PACK ou NET_WEIGHT. Os atributos de venda em pacote/granel estão inconsistentes entre si. As regras do canal:

  • Se preencher quantidade por pacote (UNITS_PER_PACK), também precisa preencher formato de venda (SALE_FORMAT).
  • Se o formato é Unidade, a quantidade por pacote tem que ser 1.
  • Se o formato é Pacote, a quantidade por pacote tem que ser maior que 1.
  • Se o formato é Peso, o peso líquido (NET_WEIGHT) precisa estar preenchido.

Como resolver: em Hub → Anúncios ou em Produtos → Listar Produtos → editar SKU, ajuste os três atributos (formato de venda, quantidade por pacote, peso líquido) seguindo as combinações válidas. Sincronize novamente.

Registro sanitário ou de órgão regulador (ANVISA, INMETRO) incorreto​

Mensagens "The value you entered in ATRIBUTO is incorrect. An example is: EXEMPLO" ou, em português, "O valor que você inseriu em 'Número de registro/certificação INMETRO' está incorreto". Categorias reguladas exigem um número de registro/certificação (ANVISA, INMETRO, registro sanitário) em um formato específico, e o valor informado não está nesse padrão.

Como resolver: em Hub → Anúncios ou em Produtos → Listar Produtos → editar SKU → atributos, ajuste o número de registro/certificação para seguir exatamente o exemplo que o canal mostrou na mensagem (mesma quantidade de dígitos e separadores). Confirme o número correto na embalagem ou no certificado do produto. Sincronize de novo.

Anúncio em revisão, encerrado ou bloqueado ("Item.invalid")​

Mensagens "Item.invalid", "Item status is not allowed (under_review)" ou "Item status is not allowed (closed)". O canal recusou a sincronização (de produto, preço, estoque ou descrição) porque o anúncio em si está num estado que não aceita alterações.

  • Em revisão (under_review) — o Mercado Livre está moderando o anúncio. Você não pode alterar enquanto a revisão estiver aberta.
  • Encerrado (closed) — o anúncio foi encerrado no canal (pelo vendedor, por inatividade ou por moderação).
  • Bloqueado — o anúncio está suspenso por alguma violação de política.

Como resolver:

  1. Abra o anúncio no painel do Mercado Livre e confira o status real.
  2. Se está em revisão, aguarde — o canal libera entre minutos e horas.
  3. Se está encerrado, decida: você quer reativá-lo (no painel do Mercado Livre, depende da categoria) ou desvinculá-lo no idworks e publicar um novo. A desvinculação fica em Hub → Anúncios → ação Desvincular.
  4. Se está bloqueado, resolva a pendência apontada pelo Mercado Livre (geralmente uma política de venda) antes de tentar sincronizar de novo.

Anúncio não localizado no canal​

Mensagem "Anúncio não localizado no canal" (essa mensagem é traduzida pelo idworks). O idworks tentou consultar um anúncio que não existe mais no Mercado Livre — foi excluído, ou nunca chegou a ser publicado por causa de outro erro.

Como resolver:

  1. Abra o anúncio no painel do Mercado Livre — confirme se ele realmente não existe (link quebrado, mensagem de "anúncio não encontrado").
  2. Se ele foi removido no canal, em Hub → Anúncios use a ação Desvincular para soltar o vínculo no idworks.
  3. Publique um novo anúncio a partir do produto em Hub → Anúncios → Novo Anúncio.

Vídeo do YouTube foi rejeitado​

Mensagem "Item video id was dropped". O Mercado Livre desativou a inclusão de vídeos do YouTube em anúncios de Marketplace — agora o canal aceita apenas Clips (formato próprio do Mercado Livre).

Como resolver: não há ação dentro do idworks que reaproveite o vídeo do YouTube. Para incluir um vídeo no anúncio, grave/edite o conteúdo como Clip direto no aplicativo do Mercado Livre.

Código ANATEL inválido ou não informado​

Mensagens "item.attribute.anatel_homologation_number.invalid" ou "item.attribute.anatel_homologation_number.missing", com texto "Declaro que este produto é homologado pela Anatel e assumo responsabilidade legal caso não esteja em conformidade com a regulamentação". Categorias de eletrônicos com transmissão de rádio (Wi-Fi, Bluetooth, etc.) exigem código de homologação Anatel.

Como resolver: em Hub → Anúncios ou em Produtos → Listar Produtos → editar SKU → atributos, preencha o código de homologação Anatel que consta na embalagem ou no manual do produto. Confirme que ele está em conformidade com a regulamentação antes de declarar. Sincronize de novo.

O pedido não foi importado​

Causas possíveis quando um pedido feito no Mercado Livre não aparece no idworks:

  • A opção Importar pedidos está desligada — confira em Configurações → Integrações → Mercado Livre → Integração de Vendas.
  • O pedido é de uma modalidade que está desligada (normal, Fulfillment, Flex, transferência Fulfillment) — cada uma tem seu próprio botão no mesmo grupo de parâmetros.
  • A integração está em Erro ou Não Autenticado — refaça a autenticação como em O status da integração caiu para "Erro" ou "Não Autenticado".
  • A Data inicial para importação de pedidos está depois da data do pedido — ajuste em Integração de Vendas.
  • O parâmetro Incluir somente pedidos não faturados está habilitado e o pedido já tem nota fiscal emitida pelo canal — nesse cenário, o idworks pula.
  • O SKU do pedido não foi encontrado no idworks e a opção Criar oferta automaticamente está desligada — habilite-a, ou cadastre o SKU em Produtos → Listar Produtos e refaça o vínculo em Hub → Anúncios.

Confira o status em Hub → Pedidos Integrados; pedidos que falharam na importação aparecem com o motivo na linha.

A etiqueta de envio não saiu​

Para pedidos Mercado Envios (ME2, Flex, Fulfillment), o idworks consulta automaticamente a etiqueta quando a opção Consultar etiqueta automaticamente está habilitada (em Configurações → Integrações → Mercado Livre → Integração de Vendas). A etiqueta pode não aparecer porque:

Confira o status real do envio em Hub → Pedidos Integrados → abrir o pedido → seção de envio. Use a ação Reconsultar etiqueta para forçar uma nova consulta.

Mensagem "Delays Not Found for shipment"​

Mensagem que aparece com 404 no log de consulta de atrasos do envio. Não é um erro — é a resposta normal do canal quando o envio não está atrasado. O idworks só registra atrasos quando o canal sinaliza algum; sem sinalização, fica em branco.

Como resolver: nada a fazer. Ignore esse caso específico.

O envio ficou em "Aguardando documentação fiscal"​

O envio ficou parado no canal porque o Mercado Livre está esperando uma nota fiscal que ainda não chegou — pode ser a NF de venda (pedido normal), a NF de remessa para o FULL (transferência Fulfillment), ou a NF de devolução simbólica.

Como resolver:

  1. Confirme que a NF foi emitida no idworks em Vendas → Pedidos.
  2. Confira se o XML foi enviado ao canal — para pedidos Fulfillment, a opção Emails para enviar NFe fulfillment (em Integração de Vendas) deve estar preenchida com o e-mail do Mercado Livre.
  3. Se o XML foi enviado, aguarde o canal processar (pode levar minutos a horas).
  4. Se a NF não foi emitida ainda, emita-a em Vendas → Pedidos → ação Emitir NF.

O envio foi cancelado (label expirada, fora de área, FULL)​

Status do envio mudou para Cancelado com motivos como label_expired, out_of_range, unfulfillable, closed_store, fraudulent, service_unavailable, cancelled_manually ou closed_by_user. Significados:

  • Label expirada (label_expired) — o vendedor não fez o envio dentro do prazo da etiqueta. A etiqueta precisa ser gerada de novo.
  • Fora de área (out_of_range) — o endereço do comprador está fora da área coberta pela modalidade escolhida (Flex, por exemplo, tem áreas restritas).
  • FULL indisponível (unfulfillable) — o produto deixou de ser elegível para Fulfillment (estoque, dimensões, categoria).
  • Loja fechada (closed_store) — a loja do vendedor está fechada no canal.
  • Cancelado manualmente — o próprio comprador ou vendedor cancelou pelo painel do Mercado Livre.
  • Fraudulento — o canal detectou risco de fraude e cancelou o envio.

Como resolver:

  1. Acesse o pedido em Hub → Pedidos Integrados e veja o motivo registrado.
  2. Para label expirada ou fora de área, oriente o comprador a fazer um novo pedido com modalidade compatível.
  3. Para FULL indisponível, confira se o produto ainda tem estoque no FULL e se atende às regras de categoria do programa.
  4. Os demais motivos não têm ação no idworks — o pedido fica como cancelado.

A pergunta foi banida ou está em revisão​

Status da pergunta importada como BANNED (banida) ou UNDER_REVIEW (em revisão). O canal moderou ou suspeitou da pergunta — geralmente por dados pessoais, link externo ou linguagem inadequada.

Como resolver:

  • BANNED — a pergunta não pode ser respondida pelo canal nem pelo idworks. Nada a fazer.
  • UNDER_REVIEW — aguarde o canal concluir a moderação. Quando concluir, a pergunta vira UNANSWERED (não respondida) ou BANNED.

Acompanhe em Hub → Perguntas e Respostas.

Não foi possível cadastrar a pergunta do anúncio X​

Mensagem "Não foi possível cadastrar a pergunta do anúncio X do Meli. Cadastrar o anúncio no sistema." (mensagem traduzida pelo idworks). O comprador fez uma pergunta em um anúncio do Mercado Livre que não está vinculado a nenhum anúncio no idworks.

Como resolver:

  1. Em Hub → Anúncios, use o botão Vincular Anúncio e busque o anúncio do Mercado Livre pelo número.
  2. Vincule-o ao produto/SKU correspondente no idworks.
  3. As perguntas seguintes desse anúncio passarão a entrar normalmente em Hub → Perguntas e Respostas.

Para importar todos os anúncios já existentes no canal, habilite Importar Anúncios em Configurações → Integrações → Mercado Livre → Importação de Anúncios.

O comprador está bloqueado para fazer perguntas​

O vendedor bloqueou o comprador para perguntas. Não é exatamente um erro — é a configuração esperada. O Mercado Livre devolve a lista de compradores bloqueados, e o idworks ignora perguntas vindas deles.

Como resolver: para desbloquear, acesse o painel do Mercado Livre → Vendas → Configurações de perguntas → Compradores bloqueados e remova o comprador da lista.

A mensagem foi moderada e não chegou ao comprador​

A mensagem que você enviou ao comprador pelo idworks foi enviada ao canal, mas o Mercado Livre moderou e bloqueou. Motivos possíveis:

  • Linguagem inadequada (OUT_OF_PLACE_LANGUAGE).
  • Link de rede social (SOCIAL_NETWORK_LINK) — não pode citar Facebook, Instagram, WhatsApp, etc.
  • Link encurtado (LINK_SHORT_URL).
  • Mensagem automática de integrador (AUTOMATIC_MESSAGE) — mensagens iguais enviadas em massa são bloqueadas.
  • Dados pessoais (PERSONAL_DATA) — telefone, CPF, e-mail no corpo da mensagem.
  • Link do Mercado Pago (LINK_MERCADOPAGO) — não pode forçar pagamento por fora do checkout.
  • Link para outros meios de pagamento (ML_LINKS_PAYPAL) — Paypal e similares.
  • Fuga de reclamação (EVASION_CLAIM_SELLER) — tentativa de resolver fora do canal de reclamação oficial.

Como resolver: reescreva a mensagem em Hub → Mensagens sem o conteúdo bloqueado e envie de novo. Mensagens automáticas em massa devem ser variadas — não envie o mesmo texto para todos os compradores.

A conversa está bloqueada (pedido cancelado)​

Mensagem "blocked_conversation_send_message_forbidden" com motivo "blocked_by_cancelled_order". O pedido foi cancelado no canal, e o Mercado Livre bloqueia o envio de novas mensagens em pedidos cancelados — exceto se já existia conversa antes do cancelamento, e ainda assim só por 30 dias após a última mensagem do comprador.

Como resolver: se ainda houver janela aberta (comprador mandou mensagem nos últimos 30 dias), a conversa fica liberada. Caso contrário, não há ação — o canal não aceita novas mensagens.

A mensagem passou de 350 caracteres​

Mensagem "The message content is too long, max characters allowed are 350". O Mercado Livre limita mensagens pós-venda a 350 caracteres (para o vendedor).

Como resolver: reescreva o texto em Hub → Mensagens ficando abaixo de 350 caracteres. Se precisar passar mais informação, divida em mensagens separadas.

Não foi possível enviar mensagem em pedido Fulfillment ainda não entregue​

Mensagem "You can not send the message because the purchase is Mercado Envíos Full and has not been yet delivered". Pedidos no programa Fulfillment (FULL) só liberam a mensageria após a entrega — antes disso, qualquer suporte é tratado pelo próprio Mercado Livre.

Como resolver: aguarde a entrega. Após o status virar Entregue, a conversa fica liberada em Hub → Mensagens.

Anexo passou do limite ou tem extensão inválida​

Mensagens "File attachment is bigger than 25 Mb", "File name cannot include characters like /, \" ou "The message exceeds the allowed number of attachments: 25". As regras do canal para anexos em mensagens:

  • Tamanho máximo: 25 MB por arquivo.
  • Formatos aceitos: JPG, PNG, PDF, TXT.
  • Nome do arquivo não pode ter caracteres / ou \.
  • Máximo de 25 anexos por mensagem.

Como resolver: comprime ou divide o arquivo, renomeia removendo caracteres especiais, e reanexa em Hub → Mensagens.

O destinatário não pertence ao pedido​

Mensagens "Receiver does not belong to order" ou "Access denied for user X to order Y". O idworks tentou enviar uma mensagem para um usuário que não é nem o comprador nem o vendedor daquele pedido.

Como resolver: confirme em Hub → Pedidos Integrados que o pedido tem o comprador correto vinculado. Se houver inconsistência, o problema é de cadastro do pedido — abra um chamado com o suporte do idworks.

A ação que tentei não está disponível para o estado da reclamação​

Mensagens "Action AÇÃO not available for player" — onde AÇÃO pode ser refund, allow_partial_refund, allow_return, open_dispute, send_message_to_complainant ou send_message_to_mediator. A reclamação está num estado em que aquela ação específica não é permitida — a janela já passou, ou a ação contraria o fluxo atual da reclamação (por exemplo, tentar abrir disputa quando o canal já decidiu).

Como resolver:

  1. Abra a reclamação em Hub → Reclamações e confira o estado atual e o histórico.
  2. Veja quais ações estão disponíveis na tela — só essas podem ser executadas.
  3. Se a ação esperada não aparece, é porque o canal não permite mais — resolva pelo painel do Mercado Livre, se houver alternativa.

A reclamação não foi encontrada​

Mensagem "Resource not found" ao consultar uma reclamação. O número da reclamação não existe mais no canal, ou nunca pertenceu à conta autenticada.

Como resolver:

  1. Confirme o número no painel do Mercado Livre.
  2. Se a reclamação realmente foi removida (o que é raro), nada a fazer — o registro fica como histórico no idworks.
  3. Se o problema é de conta, confirme em Configurações → Integrações que a integração ativa é a da conta dona da reclamação.

Anexo da reclamação não encontrado​

Mensagem "Attachment not found [claim: ID - fileName: ARQUIVO]". O arquivo anexo da reclamação foi referenciado, mas o canal não consegue mais entregá-lo — pode ter sido removido ou ter expirado.

Como resolver: peça ao comprador ou ao Mercado Livre que reenvie o anexo pelo canal oficial. O idworks só consegue baixar o que o canal mantém disponível.

Usuário não autorizado na reclamação​

Mensagem "user not authorized" específica em reclamações. A conta autenticada não é parte dessa reclamação — não é nem comprador nem vendedor.

Como resolver: confirme que a integração autenticada é da conta correta. Em multi-conta, troque para a integração da conta certa em Configurações → Integrações → Minhas Integrações.

"Desconto precisa ser superior a 5%" ou "não pode ser maior que 80%"​

Mensagens "Desconto precisa ser superior a 5%" ou "Desconto não pode ser maior que 80%" (traduzidas pelo idworks). Validações que o próprio idworks aplica antes de enviar a promoção ao Mercado Livre — o canal não aceita descontos fora dessa faixa.

Como resolver: em Hub → Promoções, ajuste o valor promocional do item para que o desconto fique entre 5% e 80% do preço original. Sincronize a promoção de novo.

"Item esta em revisão e não pode ser incluído promoção"​

Mensagem "Item esta em revisão e não pode ser incluído promoção" (traduzida pelo idworks). O anúncio está com status em revisão (under_review) no Mercado Livre, e o canal não permite inclusão em promoção enquanto a moderação não terminar.

Como resolver: aguarde o canal concluir a revisão. Acompanhe em Hub → Anúncios o status real do anúncio. Quando voltar para ativo, inclua na promoção em Hub → Promoções.

O item está encerrado e não pode entrar na promoção​

Mensagem "Item status is not allowed (closed)" ao incluir item em promoção. O anúncio está encerrado no Mercado Livre — não aceita nenhuma alteração, inclusive promoção.

Como resolver: reative o anúncio no painel do Mercado Livre (quando a categoria permite) ou publique um novo anúncio em Hub → Anúncios. Depois inclua na promoção.

"No offers found for item"​

Mensagem "No offers found for item" ao tentar remover um item de uma promoção. O canal está dizendo que não há oferta desse item na promoção — ou seja, ele nunca entrou, ou já tinha saído antes.

Como resolver: nada a fazer. O idworks trata esse caso como sucesso internamente — o estado final é "item fora da promoção", que é o que você queria.

Mensagem "Too Many Requests" — ritmo de chamadas alto demais​

Mensagens "Too Many Requests" ou "local_rate_limited". O Mercado Livre limita o ritmo de chamadas do idworks — passa de cerca de 1500 chamadas por minuto por vendedor, ele recusa as próximas até o ritmo voltar ao normal.

Como resolver:

  • Em rotina, o idworks distribui as chamadas para evitar isso. Se você está vendo essa mensagem com frequência, é sinal de uma sincronização em massa rodando junto com a operação normal.
  • Aguarde alguns minutos — as chamadas que falharam são reagendadas automaticamente pelo idworks.
  • Se persistir, abra chamado com o suporte do idworks informando o número da conta e o horário.

"Bad Gateway", "Service not available", "Gateway Timeout"​

Mensagens "Bad Gateway", "Service not available", "Gateway Timeout". São sinais de instabilidade temporária do lado do Mercado Livre — não dependem do seu cadastro.

Como resolver: aguarde alguns minutos e refaça a ação. Sincronizações automáticas são reagendadas pelo idworks. Se a mensagem persistir por mais de 30 minutos, confira o status do canal no painel do Mercado Livre e, se houver incidente em andamento, é só aguardar a normalização.

Mensagem "Internal Server Error"​

Mensagem "Internal Server Error". Erro inesperado do lado do Mercado Livre, sem indicação de causa específica. Diferente das mensagens de instabilidade acima, esta indica que o canal recebeu a chamada mas não conseguiu processar.

Como resolver:

  1. Aguarde alguns minutos e refaça a ação.
  2. Se persistir, anote o horário e o recurso (anúncio, pedido, reclamação) e abra chamado com o suporte do idworks — pode ser preciso pedir ao Mercado Livre para revisar o caso específico.

Mensagem "Resource not found"​

Mensagem "Resource not found" genérica. O recurso que o idworks tentou acessar (anúncio, pedido, pergunta, mensagem, envio, reclamação) não existe mais no Mercado Livre ou nunca pertenceu a essa conta.

Como resolver: depende do recurso. Veja a seção específica:

Como saber o que cada mensagem significa em uma frase​

Tabela de bolso com a tradução rápida das mensagens mais frequentes:

Mensagem do Mercado LivreEm uma fraseOnde corrigir
validation_errorAnúncio não passa nas regras da categoriaHub → Anúncios + atributos do SKU
seller_package_* (all required / too small / wrong format)Medidas e peso da embalagem faltando ou inválidosProdutos → Listar Produtos → editar SKU (altura, largura, comprimento, peso inteiros)
Is not possible to activate an item without stockAnúncio sem estoque para ativarSaldo do produto + estoque de segurança em Integração de Produtos
Users type brand have to provide a official store idConta de marca sem Loja OficialHub → Anúncios → passo Loja oficial
User product was duplicatedFamília do catálogo duplicadaHub → Anúncios → passo Título → Família
item.id.invalid / Invalid item idReferência do anúncio inválidaHub → Anúncios → desvincular e revincular
invalid_grantVínculo da conta expirou ou foi quebradoConfigurações → Integrações → Mercado Livre → Autenticar Integração
invalid_clientAplicativo idworks com problemaChamado com o suporte do idworks
forbiddenSem permissão para o recursoConfirmar conta autenticada
Too Many RequestsRitmo de chamadas alto demaisAguardar — reagendado automaticamente
Internal Server ErrorErro inesperado no canalAguardar e refazer
Bad Gateway / Service not available / Gateway TimeoutInstabilidade do canalAguardar
Resource not foundRecurso não existe maisConfirmar no painel do Mercado Livre
Item.invalid / under_review / closedAnúncio em estado que não aceita alteraçãoPainel do Mercado Livre + Hub → Anúncios
Item status is not allowed (under_review)Anúncio em moderaçãoAguardar
No offers found for itemItem já fora da promoçãoNada a fazer
conversation_blocked / blocked_by_cancelled_orderConversa bloqueada por cancelamentoSem ação no idworks
Delays Not Found for shipmentEnvio sem atrasoIgnorar — não é erro

Quando a recomendação é só "refazer a autenticação"​

Quase metade dos erros que travam a integração tem a mesma solução: reautenticar. Use este atalho mental — se a mensagem é uma das abaixo, vá direto para Configurações → Integrações → Minhas Integrações → Autenticar Integração:

  • invalid_grant
  • Sorry, the application cannot connect to your account
  • Status da integração em Erro ou Não Autenticado
  • Vários forbidden em chamadas que antes funcionavam
  • Acesso revogado no painel do Mercado Livre

Se depois de reautenticar o erro voltar, aí sim é problema diferente — siga a seção específica deste artigo. Se nem após reautenticar a integração ficar Ativa, abra chamado com o suporte informando o nome da conta e o horário da última tentativa.

Resumo de parametrizações​

Os erros listados neste artigo são afetados pelos mesmos parâmetros da integração principal — não há grupo de parametrizações próprio só para erros. Os parâmetros mais relevantes para corrigir ou prevenir os erros desta página estão em Configurações → Integrações → Mercado Livre, distribuídos pelos grupos abaixo. A descrição completa de cada um está na FAQ principal em Mercado Livre.

ParâmetroSubmenu (grupo)Quando ajustar
Importar pedidosIntegração de VendasPedido não importou — habilitar para retomar a importação.
Incluir pedidos normais / fulfillment / flex / transferencia fulfillmentIntegração de VendasPedido de uma modalidade específica não está entrando — habilitar a modalidade.
Incluir somente pedidos não faturadosIntegração de VendasPedido com NF do canal não entra — desabilitar se quiser todos.
Data inicial para importação de pedidosIntegração de VendasPedido antigo não importa — ajustar a data.
Consultar etiqueta automaticamenteIntegração de VendasEtiqueta não foi baixada — habilitar para consulta automática.
Criar oferta automaticamenteIntegração de VendasPedido com SKU desconhecido não importa — habilitar para vincular automaticamente.
Atualizar Especificações (atributos)Integração de ProdutosAtributos do anúncio não estão sendo enviados — habilitar.
Atualizar preço / estoque / descrição / ImagemIntegração de ProdutosSincronização específica não acontece — habilitar a ação desejada.
Percentual / Valor de ajuste no preçoIntegração de ProdutosPreço enviado está abaixo do mínimo da categoria — recalcular o ajuste.
Importar AnúnciosImportação de AnúnciosPerguntas chegam para anúncios não vinculados — habilitar para importar todos os anúncios do canal.

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. Como os erros tratados neste artigo são corrigidos em várias telas (configuração da integração, hub de anúncios, hub de pedidos, hub de mensagens, hub de reclamações, hub de promoções, cadastro de produto), os privilégios mais usados são:

PrivilégioLibera
Visualizar integraçõesAcessar a tela de integrações e ver o status da integração do Mercado Livre.
Editar parametrizações empresaConfigurar parâmetros, autenticar e validar credenciais da integração.
Visualizar anúncios do hubAcessar Hub → Anúncios para corrigir atributos, sincronizar e desvincular anúncios.
Editar anúncios do hubEditar a ficha do anúncio (categoria, atributos, título, descrição, imagens).
Visualizar pedidos integradosAcessar Hub → Pedidos Integrados para acompanhar pedidos com problema de importação ou envio.
Visualizar mensagens do hubAcessar Hub → Mensagens para responder e reenviar mensagens moderadas.
Visualizar reclamações do hubAcessar Hub → Reclamações para tratar reclamações.
Visualizar perguntas do hubAcessar Hub → Perguntas e Respostas.
Visualizar promoções do hubAcessar Hub → Promoções para ajustar itens e descontos.
Editar produtosEditar SKUs em Produtos → Listar Produtos (atributos, identificadores, imagens, variações).

Configure os perfis de acesso em Configurações → Perfis de Acesso vinculando os privilégios necessários aos grupos de usuários que vão tratar os erros. Quando o usuário não tem o privilégio, a tela ou ação correspondente fica desabilitada.

Última atualização em