La integración de VTEX con Mercado Libre envía los productos de una política comercial y mantiene precio y stock actualizados en el marketplace. Lo que no resuelve es la ficha técnica: cada categoría tiene sus propios atributos, la mayoría de los productos necesita código de barras, y lo que falta en el registro frena el envío o debilita el anuncio.
Quien llega hasta aquí suele tener uno de tres problemas: un SKU que no sube, un anuncio pausado con el estado «Para revisar» o un producto mal posicionado en la búsqueda de Mercado Libre. Buena parte de las causas que VTEX y Mercado Libre documentan está en el registro. Este texto sigue el orden del trabajo: activar, completar la ficha, resolver código y fotos, revisar.
¿Cómo activar la integración de VTEX con Mercado Libre?
Antes que nada, hace falta tener una cuenta de vendedor en Mercado Libre. El conector se activa en el Admin, en el módulo Marketplace, en Integraciones, con las opciones Mercado Libre Classic o Premium. Los productos enviados son los de la política comercial elegida en el registro, y cada cuenta VTEX queda vinculada a una sola cuenta en Mercado Libre. Después, la cuenta VTEX debe autorizarse en Mercado Libre, un paso que solo puede dar el usuario titular, iniciando sesión con el usuario titular de la cuenta en Mercado Libre. VTEX también pide un SLA configurado en la tienda, sin el cual los pedidos de Mercado Libre no entran.
Según la página que explica cómo funciona la integración, el camino tiene dos sentidos:
- De VTEX a Mercado Libre: producto, precio y stock. Los cambios de precio y de stock en VTEX se actualizan automáticamente en los anuncios; las promociones personalizadas no se envían.
- De Mercado Libre a VTEX: los pedidos, que se integran solo cuando llegan con el estado Paid.
El FAQ de la integración enumera tres excepciones que cambian el orden del trabajo. Las imágenes se envían una sola vez, cuando se crea el anuncio. Una vez que el producto se anunció y se vendió, la regla de Mercado Libre no permite reenviar la información del producto. Para cambiarla, hay que eliminar el anuncio, lo que borra su historial y la relevancia que tenía. La regla vale para esos datos: el precio y el stock siguen la actualización automática descrita arriba. Y un producto creado directamente en el panel de Mercado Libre no lo actualiza VTEX.
Quien ya vende en Mercado Libre necesita además migrar los anuncios existentes para no perder la relevancia que ya tienen. La integración asocia un SKU de VTEX a un único anuncio por vez, pero Clásico y Premium tienen configuraciones separadas, y el mismo producto puede anunciarse en ambos tipos. Por eso la plantilla de migración separa los anuncios Clásicos de los Premium, y el anuncio que queda fuera de ella no lo actualiza la integración ni tiene sus pedidos integrados. En el registro del conector, quien migra completa el ID de política comercial con 0: con el ID de una política existente, la integración crea anuncios nuevos y duplica el catálogo en Mercado Libre. Si el problema es ordenar pedidos y stock entre varios marketplaces, el post sobre hub de integración, PIM o gestor de feed separa los roles.
¿Qué exige la ficha técnica de Mercado Libre?
La ficha técnica, que el Centro de vendedores de Mercado Libre hoy llama «características del producto», es el conjunto de atributos que Mercado Libre pide en cada categoría, como marca y modelo. En la integración, el envío pasa por el mapeo de categorías y atributos, que se abre en el Admin desde la integración de Mercado Libre, en la opción «Realizar mapeo». Allí cada categoría de la tienda corresponde a una categoría del marketplace, y los atributos obligatorios aparecen marcados con asterisco. El producto necesita tener stock y precio configurados antes del envío.
Que falte un atributo no tiene una sola consecuencia. La documentación de atributos de Mercado Libre y las notas del Centro de vendedores (en portugués) separan tres casos:
- Atributo marcado como obligatorio en la categoría y ausente: la publicación devuelve un error.
- Atributo que la categoría usa en la ficha, pero que no es obligatorio para publicar: no impide la publicación y afecta la posición del anuncio en los listados.
- Anuncio con pocos datos o datos incorrectos: puede pausarse y quedar con el estado «Para revisar».
La propia VTEX avisa, en el FAQ, que no puede indicar qué atributos exige cada categoría, porque ese es un criterio interno de Mercado Libre. La lista correcta es la de la categoría, en el mapeo. Lo que se resuelve en la tienda es tener el dato: si el atributo no existe en el registro, no hay nada que mapear. El post sobre atributos de producto muestra cómo organizar ese diccionario por familia.
¿Cómo quedan las variaciones y el código de barras en Mercado Libre?
Fuera de ropa, calzado y bolsas, la integración crea un anuncio por SKU, según el FAQ de VTEX. Un producto vendido en dos versiones, por ejemplo, se convierte en dos anuncios, y cada uno necesita sus propios atributos obligatorios. Para moda, los colores y las tallas se resuelven en el mapeo, y VTEX pide además la tabla de tallas del producto.
El código universal de producto, el GTIN (llamado EAN en el registro de VTEX), aparece en tres reglas:
- En Mercado Libre: el Centro de vendedores dice que es obligatorio para la mayoría de los productos, que el anuncio con el campo vacío puede pausarse y que el código incorrecto debe corregirse para evitar la eliminación y la pérdida de exposición y calidad del anuncio. Cada variación lleva un código propio.
- Sin código de fábrica: en el anuncio creado desde el Centro de vendedores, el producto artesanal o sin código registrado tiene la opción «Mi producto no lo tiene», con el motivo. La documentación de VTEX no dice cómo la integración envía ese motivo, y el GTIN que la categoría exige sigue siendo obligatorio.
- En VTEX: en la tabla de errores de integración de stock, el GTIN ausente, incorrecto o inválido en el registro del SKU aparece como causa de error, y el código correcto debe venir del proveedor o del fabricante.
Los casos que dan trabajo, como la variación con el código del padre, el kit armado por la tienda y el producto sin código, están en el post sobre GTIN y EAN en el e-commerce.
¿Qué fotos acepta Mercado Libre?
La página de imágenes de Mercado Libre pide archivos JPG, JPEG o PNG de hasta 10 MB, acepta como mínimo 500 x 500 píxeles y recomienda 1200 x 1200 píxeles; una foto por debajo del mínimo se rechaza en el envío. La cantidad máxima de fotos depende de la categoría.
Las notas del Centro de vendedores agregan las pautas de contenido:
- El fondo blanco sigue siendo obligatorio en categorías como Tecnología, Belleza, Salud y Supermercado; en la mayoría de las otras, dejó de ser obligatorio.
- Producto centrado, que ocupe el 95% de la imagen.
- Nada superpuesto a la foto: logotipo, firma, código QR, texto o borde.
- El empaque solo aparece a partir de la segunda foto.
Como la integración de VTEX envía las imágenes una sola vez, la foto correcta tiene que estar en el SKU antes de que se cree el anuncio. Cómo mantener un archivo maestro y una versión por canal está en el post sobre fotos de producto por canal.
SKU que no sube o anuncio pausado: qué revisar
Primero lo que impide que el SKU suba, después lo que pesa en la posición, todo tomado de las páginas oficiales citadas arriba:
- Producto en la política comercial de la integración, activo, con stock y precio configurados, y con «Mostrar en la tienda» y «Mostrar producto agotado» marcados: VTEX incluye las dos opciones entre los campos que el producto necesita para integrarse, y su falta aparece en la tabla de errores como ProductId not found. La misma opción, que la página Agregar o editar productos de VTEX hoy llama «Mostrar cuando está sin stock», hace que el producto agotado aparezca en la vitrina de la tienda, así que revisa el efecto en tu sitio antes de marcarla.
- Descripción completa: el FAQ de VTEX lista el SKU sin descripción como no integrado.
- Categoría mapeada y atributos obligatorios (los marcados con asterisco) completos; el FAQ de VTEX trae el error de la categoría que exige marca y modelo.
- GTIN válido en cada SKU donde la categoría exige el código.
- Dimensiones y peso del paquete en todo SKU, sea cual sea la modalidad de Mercado Envíos: VTEX registra que Mercado Libre los exige en Mercado Envíos 2 en algunas categorías y que puede extender la regla a nuevas categorías sin aviso. En un registro de octubre de 2026, VTEX informa que también pasaron a exigirse en Mercado Envíos 1 para quienes trabajan con ME1 y ME2; la integración todavía no envía esos datos en ME1, y el SKU puede ser rechazado aun con el registro completo.
- Título de hasta 60 caracteres, el límite de Mercado Libre.
- Fotos listas en el SKU antes de la creación del anuncio.
- Atributos de la ficha que la categoría usa en la búsqueda, además de los obligatorios.
Para un anuncio ya pausado, las causas documentadas incluyen: producto retirado de la política comercial o desactivado, stock por debajo del mínimo elegido en el registro del conector, ficha con pocos datos o datos incorrectos, código universal vacío y, según la guía de anuncios de Mercado Libre (en inglés), fotos con logotipo o texto promocional superpuesto. Las páginas oficiales no describen un paso único para reactivarlo: corrige la causa en el origen y da seguimiento al anuncio en el panel de Mercado Libre.
Dónde entra AdCore Turbo
AdCore Turbo reúne PIM y DAM y trabaja antes de la integración, en el registro. En el PIM, cada familia define sus propios atributos, y el panel muestra la completitud de cada producto. La IA puede proponer valores para los atributos de la familia que el producto todavía no tiene, y alguien del equipo acepta o rechaza cada uno. En la ficha del producto, cada SKU muestra su código de barras, si es propio o heredado del modelo, y señala el que falla en el dígito verificador. En el DAM, la foto vinculada a un SKU cuenta en la completitud como la imagen del producto.
Lo que conviene dejar listo en el catálogo de VTEX antes de activar el canal está en el post sobre registro de productos en VTEX.
AdCore Turbo no publica anuncios en Mercado Libre. El envío al marketplace y el mapeo de categorías y atributos siguen en la integración de VTEX, y qué atributos exige cada categoría se consulta allí. Lo que entrega es el registro con atributos, código de barras y fotos en su lugar, para que el mapeo tenga con qué trabajar.