{"section":"tutorials","requestedLocale":"es","requestedSlug":"mercado-libre-faq","locale":"es","slug":"mercado-libre-faq","path":"docs/es/tutorials/integraciones/visión-de-conjunto-de-integraciones/mercado-libre-faq.md","branch":"main","content":"Esta guía tiene el objetivo de responder a las preguntas más frecuentes sobre la integración con Mercado Libre. Para navegar, utilice la siguiente tabla de contenido: \n\n## Anuncios/Productos\n\n### ¿Por qué no logro enviar la descripción de mi producto en HTML a Mercado Libre?\n\nExisten tres formas de enviar a Mercado Libre la descripción de un producto:\n\n- Rellenar el campo **Descripción de producto**\n- Crear una especificación de producto\n- Crear una plantilla en el Centro de mensajes (opcional)\n\n> ℹ️ Consulta el artículo de Mercado Libre [“Cómo describir tus productos”](https://www.mercadolibre.com.ar/ayuda/completar_datos_productos_3147#:~:text=Ingres%C3%A1%20desde%20Modificar%2C%20en%20el%20listado%20de%20publicaciones.&text=Ahora%20bien%2C%20si%20ten%C3%A9s%20muchas,las%20publicaciones%20ordenadas%20por%20categor%C3%ADa.) para obtener sugerencias sobre cómo describir tus productos.\n\n##### Rellenar el campo Descripción de producto\n\nIngresa a *PRODUCTOS > Catálogo > Productos y SKU* en el Admin VTEX y haz clic en el botón `Modificar`. Luego, rellena el campo **Descripción de producto** con la descripción que quieras para tu producto.\n\nTambién puedes usar la ruta [PUT Update Product](https://developers.vtex.com/vtex-rest-api/reference/catalog-api-put-product) y rellenar el campo **Description** con la descripción que desees para tu producto.\n\n##### Crear una especificación de producto\n\n[Crea una especificación de producto](/es/tracks/catalogo-101--5AF0XfnjfWeopIFBgs3LIQ/4fcdmJzQ6QYA9zWf3bLWin) llamada `plaintext_description_meli` y complétala con la descripción que quieras para tu producto.\n\nTambién puedes usar la ruta [POST Create Specification](https://developers.vtex.com/vtex-rest-api/reference/catalog-api-post-specification) y rellenar el campo **Name** con `plaintext_description_meli` y el campo **Description** con la descripción que desees para tu producto.\n\n##### Crear una plantilla en el Centro de mensajes (opcional)\n\nEl [Centro de mensajes](/es/docs/tutorials/como-funciona-el-message-center) en un módulo que se encarga de configurar y enviar emails en VTEX a través de una plantilla de mensajes. La ventaja de crear una plantilla para describir tus productos es que, si tu tienda anuncia muchos productos en Mercado Libre, todos ellos tendrán una descripción estándar y personalizada.\n\nAntes de crear la plantilla, debes [rellenar el campo Descripción del anuncio](#rellenar-el-campo-descripcion-del-anuncio). Este campo será importante para crear una descripción exclusiva para tu producto. Después de rellenar el campo, ingresa a *CLIENTE > Centro de mensajes > Plantillas* en el Admin VTEX y busca la tarjeta **Bridge - Integração Mercado Livre**.\n\nNo es necesario completar los campos relacionados con el email, solamente el **campo HTML** utilizando el lenguaje HTML para definir el formato de la descripción que deseas. Una vez que crees una plantilla de descripción, todos tus productos anunciados en Mercado Libre tendrán el mismo formato de descripción.\n\nNão é necessário preencher os campos relacionados ao e-mail, somente o **campo HTML**. Te recomendamos crear una descripción estándar para tus productos. La descripción que se completó en el campo `Descripción de producto` se usará dentro del **campo HTML**.\n\nA continuación, encontrarás un ejemplo de una plantilla de descripción de productos. Los valores entre `[ ]` deben reemplazarse por la descripción que vayas a elegir.\n\n```\n[Tienda de Gustavo]<br />\n[Entrega en todo Brasil]<br />\n[Directo de fábrica]<br />\n{{TÍTULO}}<br />\n{{DESCRIPCIÓN}}<br />\n\n<br />[DUDAS FRECUENTES]<br />\n<br />[¿EL PRODUCTO ES NUEVO?]<br />\n<br />[Sí, todos nuestros productos son nuevos.]<br />\n```\n\nLos campos `{{TÍTULO}}` y `{{DESCRIPCIÓN}}` usarán la información del producto que se completó en los campos **Nombre** e **Descripción de producto** en *PRODUCTOS > Catálogo > Productos y SKU* en el Admin VTEX.\n\nLa descripción personalizada de tu anuncio en Mercado Libre se mostrará en el siguiente formato:\n\nTienda de Gustavo\nEntrega en todo Brasil\nDirecto de fábrica\n\\{\\{TÍTULO\\}\\}\n\\{\\{DESCRIPCIÓN\\}\\}\n\nDUDAS FRECUENTES\n¿EL PRODUCTO ES NUEVO?\nSí, todos nuestros productos son nuevos.\n\n### ¿Por qué mi anuncio fue pausado en Mercado Libre?\n\nLa pausa en el anuncio del Mercado Libre ocurre básicamente por dos motivos:\n\n1. Cuando el producto es removido de la política comercial vinculada a Mercado Libre o desactivado, el anuncio será pausado.\nPara realizar la integración con Mercado Libre, es necesario definir una política comercial; es decir, establecer una diferenciación de catálogo y/o logística entre los diferentes canales de venta en una tienda. [Lea más](/es/docs/tracks/configurar-politica-comercial-para-mercado-libre).\n2. Cuando el producto alcanza el stock mínimo registrado, el anuncio será pausado. El valor del stock mínimo es definido en el panel de configuración de Mercado Libre en el Bridge de VTEX.\n\nAl registrar un producto, es necesario establecer una cantidad mínima de stock de ese ítem. Cuando el número de productos alcanza el límite establecido, el anuncio es pausado en Mercado Libre. El valor mínimo de stock es definido en el panel de configuración de Mercado Libre de VTEX.\n\n### ¿Qué significa el error “The attributes [BRAND, MODEL] are required for category MLBXXXX”\n\nLa categoría en cuestión exige el mapeo de marca y modelo. Esta información debe estar presente en la plantilla de mapeo. Formato de ejemplo:\n\n![mercadolivre faq erro](https://cdn.statically.io/gh/vtexdocs/help-center-content/refs/heads/main/docs/es/tutorials/integraciones/visión-de-conjunto-de-integraciones/mercado-libre-faq_1.JPG)\n\n### ¿Por qué mi anuncio está desactivado en Mercado Libre?\n\nVTEX no desactiva anuncios en ML, solamente los pausa.\n\n### ¿Cómo cambiar la imagen de un producto en Mercado Libre?\n\nEl envío de las imágenes de un producto ocurre sólo una vez, cuando el anuncio se crea en Mercado Libre. Por lo tanto, si el producto tiene su imagen alterada en VTEX después de haber sido integrado con Mercado Libre, esta información no será actualizada.\n\nUn posible workaround es eliminar el anuncio en Mercado Libre y enviar la información del producto nuevamente al Mercado Libre, reindexando el producto en VTEX. Sin embargo, al realizar esta acción, usted debe saber que todo el histórico de este anuncio será excluido en Mercado Libre. Se creará un nuevo anuncio, sin ninguna relación con la información del anuncio anterior.\n\n### ¿Por qué el título de mi anuncio aparece cortado en Mercado Libre?\n\nMercado Libre tiene una limitación de 60 caracteres para el nombre del anuncio. Por lo tanto, al elegir el formato del Título del anuncio en el panel de configuración de Mercado Libre en el Bridge de VTEX, tenga en cuenta esta restricción de 60 caracteres.\n\n### ¿Cómo puedo reenviar la información de los productos al Mercado Libre?\n\nPor regla de Mercado Libre, no se puede reenviar información de los productos luego de que ya se anunciaron y vendieron. Deberás eliminar el anuncio del producto y modificar la información que deseas.\n\nSi el producto aún no se vendió, podrás hacer modificaciones. Si la modificación es en el valor de la variación/atributo, el cambio se debe hacer en la [página de mapeo](/es/docs/tracks/mapear-categorias-y-atributos-de-los-productos-para-mercado-libre-mapper). Si la modificación es en el valor de la especificación del producto, consulta el artículo [Registrar especificaciones de producto](/es/tracks/catalogo-101--5AF0XfnjfWeopIFBgs3LIQ/4fcdmJzQ6QYA9zWf3bLWin).\n\n> ⚠️ Luego de eliminar un producto, no es posible recuperar la relevancia del anuncio.\n\n### ¿Por qué mi producto fue categorizado equivocadamente en Mercado Libre?\n\nLos errores de categorización tienen que ver con el nombre y el precio del producto. Para la correcta categorización de sus productos, es necesario hacer [upload de la plantilla de mapeo](https://assets.ctfassets.net/alneenqid6w5/qyDp7OSL5YAGaGKagWiK0/07900f41a952a460185e18f9db190eb1/Planilha_de_Mapeamento_do_Mercado_Livre.xlsx). Esa plantilla se utilizará en las etapas de categorización, variación y atributos de su producto. Para saber más, consulte este [artículo](/es/tracks/configurar-integracao-do-mercado-livre--2YfvI3Jxe0CGIKoWIGQEIq/5XNeiye4rS4oao2MueSUeA#categorizacao).\n\n### ¿Por qué Mercado Libre devuelve errores de atributo después del mapeo?\n\nCada categoría de producto en Mercado Libre exige atributos diferentes. Por ejemplo, para un zapato de adulto, puede ser necesario indicar en la plantilla de mapeo los códigos de los atributos Color principal y Talla de zapato para adulto.\n\nPor otro lado, para cada una de esas categorías de producto, algunos atributos no se aceptan. Para el mismo zapato de adulto, por ejemplo, no se puede atribuir un código relativo a Talla de cinturón.\n\nVTEX no puede indicar exactamente cuáles atributos tiene que ser completados para cada categoría, puesto que este es un criterio interno de Mercado Libre.\n\nSin embargo, estos atributos son bastante claros (Color principal, Color secundario, Talla de zapato para adulto, Talla de cinturón, Talla de ropa para bebés, etc.). Se deben escoger los atributos pertinentes a cada producto.\n\nSi alguno de estos atributos se completa de forma incorrecta (por ejemplo, si se asignó un código relativo a Talla de cinturón para un zapato), Integraciones va a mostrar un error con el siguiente formato:\n\n![mercadolivre faq erro2](https://cdn.statically.io/gh/vtexdocs/help-center-content/refs/heads/main/docs/es/tutorials/integraciones/visión-de-conjunto-de-integraciones/mercado-libre-faq_2.JPG)\n\nEn este caso, tenemos dos ejemplos de errores en el mismo mensaje.\nEl primero de estos indica que el atributo cuyo código comienza con el número `113000` es necesario para la categoría escogida y no fue ingresado en la plantilla de mapeo. Vea la plantilla a continuación:\n\n![mercadolivre faq erro3](https://cdn.statically.io/gh/vtexdocs/help-center-content/refs/heads/main/docs/es/tutorials/integraciones/visión-de-conjunto-de-integraciones/mercado-libre-faq_3.JPG)\n\nEl segundo error muestra que el atributo cuyo código empieza con el número `63000`, ingresado en la última columna de la plantilla anterior, es inválido para la categoría escogida.\n\n#### ¿Cómo identificar el atributo faltante o inválido?\n\nLos códigos de cada variación de atributo comienzan con el mismo número. Por ejemplo, todos los códigos relativos a **Color principal** comienzan en 33000 y corresponden al siguiente formato: 33000_Amarillo_52007. Mientras que los códigos relativos a **Color secundario** comienzan en 43000. Ejemplos: `43000_Azul claro_52093` y `43000_Rosa_52058`.\n\nPara identificar el atributo señalado en el mensaje de error, consulte el número inicial de los códigos determinados por Mercado Libre. Haga clic en el nombre de su país para bajar la plantilla de referencia:\n\n1. [Brasil](https://assets.contentful.com/alneenqid6w5/22NlNdUIBK8qWic8cYw2sg/11c88bb0b439c7c7f8ce5909923af3d6/Brasil.zip)\n2. [Argentina](https://assets.contentful.com/alneenqid6w5/3c61gJrH7GWOywMCGMECg4/dc7a2ce73a99d41345dde2092eb1fec6/Argentina.rar)\n3. [Colômbia](https://assets.contentful.com/alneenqid6w5/5RePTJoKrYi4qA66WCCYKw/33910300057806b554d566210aa2310a/Colombia.rar)\n4. [México](https://assets.contentful.com/alneenqid6w5/3Z3xgpPyvuYEAIO2me4GSG/e4f4198463d8a3ba05124a30031302fa/Mexico.rar)\n\n### ¿Por qué mis anuncios en Mercado Libre no tienen los SKUs agrupados?\n\nCon excepción de los productos de ropa, calzado y bolsas, la integración crea solamente un anuncio por SKU. Así, los SKUs no se agrupan en un solo anuncio en Mercado Libre.\n\n### ¿Por qué las especificaciones/atributos de mis SKU no se envían al Mercado Libre?\n\nCon excepción de los SKUs de ropa, para enviar las variaciones y los atributos de los SKUs de cualquier categoría es necesario crear la plantilla de mapeo. Para más información, lea el artículo [Mapeo de categorías, variaciones y atributos de Mercado Libre](/es/docs/tracks/mapear-categorias-y-atributos-de-los-productos-para-mercado-libre-mapper).\n\n### ¿Cómo borrar un anuncio en Mercado Libre?\n\nLa finalización del anuncio debe realizarse directamente en Mercado Libre. En caso de que no desee que un producto sea enviado nuevamente a Mercado Libre, recuerde eliminarlo de la política comercial vinculada a Mercado Libre.\n\n### ¿Cómo hago para reenviar información de los productos a Mercado Libre?\n\nEn caso de que un anuncio haya sido finalizado y usted desee reenviarlo a Mercado Libre, basta con reindexar el producto deseado en VTEX para que la información sea reenviada a Mercado Libre.\n\n### ¿Por qué no puedo actualizar la información de mi producto en Mercado Libre?\n\nEn este escenario, es posible que estos productos que no tengan su información actualizada hayan sido creados directamente en el panel de Mercado Libre. No recomendamos la creación de productos directamente en el Panel de Mercado Libre. La información de los productos creados directamente en Mercado Libre no se actualizará por VTEX.\n\n### Entendiendo los errores del Bridge\n\n`Items in category ML…. cannot exceeds XX pictures.`\n\nExplicación:\nEl comportamiento de la integración es el siguiente:\nExiste el elemento principal del anuncio y este contiene las variaciones (que son los SKUs en VTEX). Cada vez que un producto posee variaciones, todas sus imágenes son agregadas en ese elemento principal.\n\nCada categoría tiene su propia especificación de cuántas imágenes pueden ser añadidas, en la categoría MLA3697 solo se permite 12 imágenes para este elemento principal. Vea en el enlace las condiciones de esta [categoría](https://api.mercadolibre.com/categories/MLA3697)\n\n![mercadolivre faq erro4](https://cdn.statically.io/gh/vtexdocs/help-center-content/refs/heads/main/docs/es/tutorials/integraciones/visión-de-conjunto-de-integraciones/mercado-libre-faq_4.JPG)\n\n`SKU no integrado, pues el mismo no posee descripción`\n\nExplicación:\n Para los nuevos SKUs, al enviarlos a Mercado Libre (originalmente Meli) su descripción de flujo es:\n1.    Buscar si posee una especificación de producto llamada `plaintext_description_meli`. En caso afirmativo, la enviamos como descripción; \n2.   Buscar si posee un template de Mercado Libre. Si es así, lo enviamos como descripción (para garantizar que el template esté funcional, verificar si aparece en el preview).\n3.    Buscar si posee una descripción en el catálogo. Si es así, la enviamos como descripción.\n4.    En caso de que no posea ninguno de los pasos anteriores, registramos el error en el Bridge de \"SKU no integrado pues el mismo no posee descripción\".\n\n## Logística\n\n### ¿Por qué mi pedido con \"Acordar con el comprador\" no se integró en el Bridge?\n\nNo recomendamos el uso del tipo de entrega Acordar con el comprador. En pedidos realizados con ese tipo de entrega, como no tenemos la información de la dirección de entrega, el pedido no se integrará con VTEX.\n\nPara que un pedido sea integrado correctamente, es necesario que el mismo tenga la información de entrega. De esta forma, siempre recomendamos el uso de Mercado Envíos para los pedidos realizados en Mercado Libre.\n\n### ¿Por qué mis pedidos están yendo a la tabla de contingencia en vez del envío VTEX?\n\nAl calcular el envío de un pedido, la integración hace una simulación de fulfillment. Esta respuesta toma generalmente 200 ms. Mercado Libre posee un límite de tiempo de espera de 400 ms y si la respuesta de la simulación sobrepasa este tiempo, el envío será a través de la tabla de contingencia. Generalmente, ese tiempo es largo cuando la operación logística de la cuenta es compleja (por ejemplo: muchas transportadoras registradas).\n\n## Configuraciones\n\n### ¿Por qué mis pedidos no se integran con Mercado Libre?\n\nEn el caso de Mercado Libre, cuando el token de integración se desactiva, sin importar el motivo, los pedidos realizados en el marketplace no se envían a la plataforma de VTEX. Para resolver este error, será necesario repetir el proceso de integración.\n\nDicho esto, el primer paso es acceder al registro de esta integración:\n\n1. Acceda al módulo __Marketplace__\n2. Haga clic en __Integraciones__ \n3. Busque el __panel__ de Mercado Libre\n4. Haga clic en el __engranaje__ <img class=\"shadow-4\" src=\"https://cdn.statically.io/gh/vtexdocs/help-center-content/refs/heads/main/docs/es/tutorials/integraciones/visión-de-conjunto-de-integraciones/mercado-libre-faq_5.png\" />\n5. Haga clic en __Editar configuración__\n\nA partir de ahí, tenemos que rehacer el proceso de integración.\n\n6. Haga clic en el botón __Desactivada__ \n7. Haga clic en __Guardar configuración__\n\nEspere cerca de 15 minutos. A continuación, prosiga:\n\n8. Acceda de nuevo a __registro de integración__. Solo tiene que repetir los cinco primeros pasos del tutorial\n9. Haga clic en el botón __Activada__ \n10. Haga clic en __Guardar configuración__\n\nHecho esto, espere otros 15 minutos. Ahora comienza la etapa más importante del proceso.\n\n11. Acceda al __panel__ de Mercado Libre \n12. Haga el __login__ con la cuenta que desea integrar\n13. Rehaga el __[proceso de autorización](/es/docs/tracks/autorizar-la-integracion-de-mercado-libre-en-el-panel-de-vtex)__\n14. __Guarde__ las configuraciones.\n\n¡Listo! De este modo, su integración volverá a funcionar con normalidad dentro de unos pocos minutos."}