Menu
Feedback
Comece aqui

Troubleshooting

Troubleshooting
Meus pedidos do Mercado Livre apresentam erros
Publicado em28/06/2024
Última atualização em14/08/2025
2 min de leitura

Quando ocorre um erro de integração em pedidos entre um marketplace e o Mercado Livre, uma mensagem de erro é informada em cada pedido.

Os pedidos apresentam erros de integração por ID de Loja Oficial no Mercado Livre cadastrado incorretamente ou por Categorias inexistentes no Mercado Livre. Para verificar se um pedido contém erros de integração, no Admin VTEX, acesseMarketplace > Conexões > Pedidos ou digite Pedidos na barra de busca.

Solução

Para corrigir erros de integração em pedidos do Mercado Livre, considere as seguintes opções: verificar o ID da loja oficial no Mercado Livre e verificar correspondência de categorias para erros de integração de pedidos.

Verificando o ID da loja oficial no Mercado Livre

Caso sua loja tenha o status de Loja Oficial no Mercado Livre, é necessário informar no cadastro do conector o ID fornecido pelo Mercado Livre.

Para validar se foi inserido o ID correto, acesse Marketplace > Conexões > Marketplaces e Integrações e siga os passos abaixo:

  1. Busque pelo conector Mercado Livre.
  2. Clique em Editar.
  3. Verifique o ID cadastrado no campo ID da Loja Oficial no Mercado Livre.
  4. Caso o campo esteja vazio ou com o ID incorreto, insira a informação correta.
  5. Clique em Salvar.

Verificando correspondências de categorias

Ao realizar o mapeamento de categorias e atributos para o Mercado Livre, é necessário que os atributos de cada categoria cadastradas na VTEX correspondam aos atributos das categorias existentes no Mercado Livre.
Se algum dos atributos for preenchido incorretamente, a integração retornará um erro no seguinte formato:
A categoria selecionada no atributo category_meli não existe no Mercado Livre.

Para verificar as categorias e atributos enviados, acesse Marketplace > Conexões > Marketplaces e Integrações e siga os passos abaixo:

  1. Busque pelo conector Mercado Livre.
  2. Clique em Editar.
  3. Clique em Realizar mapeamento.
  4. Clique na categoria que apresenta o erro.
  5. Realize novamente o mapeamento conforme as categorias e atributos existentes no Mercado Livre.

Para identificar o atributo indicado na mensagem de erro, consulte o número inicial dos códigos determinados pelo Mercado Livre. Clique no nome do seu país para fazer o download da planilha de referência:

Contribuidores
2
Photo of the contributor
Photo of the contributor
+ 2 contributors
Isso foi útil?
Sim
Não
Sugerir edições (GitHub)
Contribuidores
2
Photo of the contributor
Photo of the contributor
+ 2 contributors
Nesta página
Ainda tem dúvidas?
Pergunte à comunidade
Encontre soluções e compartilhe ideias na VTEX Community
Junte-se à nossa comunidade
Solicite suporte à VTEX
Receba assistência personalizada com nossos especialistas
Abra um ticket de suporte
GitHubDeveloper PortalComunidadeFeedback