A integração da VTEX com o Mercado Livre envia os produtos de uma política comercial e mantém preço e estoque atualizados no marketplace. O que ela não resolve é a ficha técnica: cada categoria tem os próprios atributos, a maioria dos produtos precisa de código de barras, e o que falta no cadastro trava o envio ou enfraquece o anúncio.
Quem chega aqui costuma ter um de três problemas: SKU que não sobe, anúncio pausado com o status Para revisar, ou produto mal posicionado na busca do Mercado Livre. Boa parte das causas que a VTEX e o Mercado Livre documentam está no cadastro. Este texto segue a ordem do trabalho: ligar, preencher a ficha, acertar código e fotos, conferir.
Como ligar a integração da VTEX com o Mercado Livre?
Antes de tudo, é preciso ter uma conta de vendedor no Mercado Livre. O conector é ligado no Admin, no módulo Marketplace, em Integrações, com as opções Mercado Livre Classic ou Premium. Os produtos enviados são os da política comercial escolhida no cadastro, e cada conta VTEX fica ligada a uma única conta no Mercado Livre. Depois, a conta VTEX precisa ser autorizada no Mercado Livre, passo que só o usuário titular pode fazer, entrando com o login de titular da conta no Mercado Livre. A VTEX ainda pede um SLA configurado na loja, sem o qual os pedidos do Mercado Livre não entram.
Segundo a página que explica como a integração funciona, o caminho tem dois sentidos:
- Da VTEX para o Mercado Livre: produto, preço e estoque. Mudanças de preço e de estoque na VTEX são atualizadas automaticamente nos anúncios; promoções customizadas não são repassadas.
- Do Mercado Livre para a VTEX: os pedidos, integrados só quando chegam com o status Paid.
O FAQ da integração lista três exceções que mudam a ordem do trabalho. As imagens são enviadas uma única vez, quando o anúncio é criado. Depois que o produto foi anunciado e vendido, a regra do Mercado Livre não aceita reenvio das informações do produto. Para mudá-las, é preciso excluir o anúncio, o que apaga o histórico e a relevância que ele tinha. A regra vale para esses dados: preço e estoque seguem a atualização automática descrita acima. E produto criado direto no painel do Mercado Livre não é atualizado pela VTEX.
Quem já vende no Mercado Livre ainda precisa migrar os anúncios existentes para não perder a relevância que eles já têm. A integração associa um SKU da VTEX a um único anúncio por vez, mas Clássico e Premium são configurações separadas, e o mesmo produto pode estar anunciado nos dois tipos. Por isso a planilha de migração pede os anúncios Clássico e os Premium separados, e o anúncio que fica fora dela não é atualizado pela integração nem tem os pedidos integrados. No cadastro do conector, quem migra preenche o ID da política comercial com 0: com o ID de uma política existente, a integração cria anúncios novos e duplica o catálogo no Mercado Livre. Se a dor é organizar pedidos e estoque entre vários marketplaces, o post sobre hub de integração, PIM ou gestor de feed separa os papéis.
O que a ficha técnica do Mercado Livre exige?
A ficha técnica, que a Central de Vendedores hoje chama de características do produto, é o conjunto de atributos que o Mercado Livre pede em cada categoria, como marca e modelo. Na integração, o envio passa pelo mapeamento de categorias e atributos, aberto no Admin pela integração do Mercado Livre, na opção Realizar mapeamento. Ali, cada categoria da loja corresponde a uma categoria do marketplace e os atributos obrigatórios aparecem marcados com asterisco. O produto precisa ter estoque e preço configurados antes do envio.
Faltar atributo não tem uma consequência só. A documentação de atributos do Mercado Livre e a Central de Vendedores separam três casos:
- Atributo marcado como obrigatório na categoria e ausente: a publicação volta com erro.
- Atributo que a categoria usa na ficha, mas que não é obrigatório para publicar: não impede a publicação e afeta a posição do anúncio nas listagens.
- Anúncio com poucas informações ou dados incorretos: pode ser pausado e ficar com o status Para revisar.
A própria VTEX avisa, no FAQ, que não consegue indicar quais atributos cada categoria exige, porque esse é um critério interno do Mercado Livre. A lista certa é a da categoria, no mapeamento. O que se resolve na loja é ter o dado: se o atributo não existe no cadastro, não há o que mapear. O post sobre atributos de produto mostra como organizar esse dicionário por família.
Como ficam as variações e o código de barras no Mercado Livre?
Com exceção de roupas, calçados e bolsas, a integração cria um anúncio por SKU, segundo o FAQ da VTEX. Um produto vendido em duas versões, por exemplo, vira dois anúncios, e cada um precisa dos próprios atributos obrigatórios. Para moda, as cores e os tamanhos são acertados no mapeamento, e a VTEX ainda pede a tabela de medidas do produto.
O código universal de produto, o GTIN (chamado de EAN no cadastro da VTEX), aparece em três regras:
- No Mercado Livre: a Central de Vendedores diz que ele é obrigatório para a maioria dos produtos, que o anúncio com o campo vazio pode ser pausado e que o código incorreto precisa ser corrigido para evitar a exclusão e a perda de exposição e qualidade do anúncio. Cada variação leva um código próprio.
- Sem código de fábrica: no anúncio criado pela Central de Vendedores, o produto artesanal ou sem código registrado tem a opção Meu produto não o tem, com o motivo. A documentação da VTEX não diz como a integração envia esse motivo, e o GTIN que a categoria exige continua obrigatório.
- Na VTEX: na tabela de erros de integração de estoque, o GTIN ausente, incorreto ou inválido no cadastro do SKU aparece como causa de erro, e o código correto deve vir do fornecedor ou do fabricante.
Os casos que dão trabalho, como variação com o código do pai, kit montado pela loja e produto sem código, estão no post sobre GTIN e EAN no e-commerce.
Que fotos o Mercado Livre aceita?
A página de imagens do Mercado Livre pede arquivos JPG, JPEG ou PNG de até 10 MB, aceita no mínimo 500 x 500 pixels e recomenda 1200 x 1200 pixels; foto abaixo do mínimo é recusada no envio. A quantidade máxima de fotos depende da categoria.
A Central de Vendedores acrescenta as orientações de conteúdo:
- Fundo branco ainda é obrigatório em categorias como Tecnologia, Beleza, Saúde e Supermercado; na maioria das outras, deixou de ser obrigatório.
- Produto centralizado, ocupando 95% da imagem.
- Nada sobreposto à foto: logotipo, assinatura, código QR, texto ou borda.
- A embalagem só aparece a partir da segunda foto.
Como a integração da VTEX envia as imagens uma única vez, a foto certa precisa estar no SKU antes de o anúncio ser criado. O jeito de manter um arquivo-mãe e uma versão por canal está no post sobre fotos de produto por canal.
SKU parado ou anúncio pausado: o que conferir
Primeiro o que impede o SKU de subir, depois o que pesa na posição; os itens saem das páginas oficiais citadas acima:
- Produto na política comercial da integração, ativo, com estoque e preço configurados, e com Exibir no site e Mostrar produto esgotado marcados: a VTEX lista as duas flags entre os campos que o produto precisa ter para ser integrado, e a falta delas aparece na tabela de erros como ProductId not found. A mesma opção, que o cadastro de produto da VTEX hoje chama de Mostrar quando estiver fora de estoque, faz o produto esgotado aparecer na vitrine da loja, então confira o efeito no seu site antes de marcar.
- Descrição preenchida: o FAQ da VTEX lista o SKU sem descrição como não integrado.
- Categoria mapeada e atributos obrigatórios (os marcados com asterisco) preenchidos; o FAQ da VTEX traz o erro da categoria que exige marca e modelo.
- GTIN válido em cada SKU onde a categoria exige o código.
- Dimensões e peso do pacote em todo SKU, qualquer que seja a modalidade do Mercado Envios: a VTEX registra que o Mercado Livre os exige no Mercado Envios 2 (em inglês) em algumas categorias e que pode estender a regra a novas categorias sem aviso. Num registro de outubro de 2026, a VTEX informa que eles passaram a ser exigidos também no Mercado Envios 1 (em inglês) de quem trabalha com ME1 e ME2; a integração ainda não envia esses dados no ME1, e o SKU pode ser recusado mesmo com o cadastro completo.
- Título com até 60 caracteres, o limite do Mercado Livre.
- Fotos prontas no SKU antes da criação do anúncio.
- Atributos da ficha que a categoria usa na busca, além dos obrigatórios.
Quando o anúncio já está pausado, as causas documentadas incluem: produto tirado da política comercial ou inativado, estoque abaixo do limite escolhido no cadastro do conector, ficha com poucos dados ou dados incorretos, código universal vazio e, segundo o guia de anúncios do Mercado Livre (em inglês), foto com logotipo ou texto promocional sobreposto. As páginas oficiais não descrevem um passo único para reativar: corrija a causa na origem e acompanhe o anúncio no painel do Mercado Livre.
Onde o AdCore Turbo entra
O AdCore Turbo reúne PIM e DAM e trabalha antes da integração, no cadastro. No PIM, cada família define os próprios atributos, e o painel mostra a completude de cada produto. A IA pode propor valores para os atributos da família que o produto ainda não tem, e alguém da equipe aceita ou recusa cada um. Na ficha do produto, cada SKU mostra o código de barras que tem, se é o próprio ou o herdado do modelo, e aponta o que falha no dígito verificador. No DAM, a foto ligada a um SKU conta na completude como a imagem do produto.
O que deixar pronto no catálogo da VTEX antes de ligar o canal está no post sobre cadastro de produtos na VTEX.
O AdCore Turbo não publica anúncios no Mercado Livre. O envio ao marketplace e o mapeamento de categorias e atributos continuam na integração da VTEX, e quais atributos cada categoria exige se lê ali. O que ele entrega é o cadastro com atributos, código de barras e fotos no lugar, para que o mapeamento tenha o que levar.