Publicar en Mercado Libre desde tu catálogo: por qué se traba y cómo se resuelve

Casi todos los que venden en Mercado Libre y además tienen tienda propia cargan cada producto dos veces. Una vez en la tienda, con sus fotos y su descripción. Otra vez en el marketplace, con las fotos de nuevo, la descripción de nuevo, y esa pantalla de atributos que pide cosas que nadie sabe de memoria.

Es un trabajo que se puede automatizar: la API oficial de Mercado Libre permite crear y mantener publicaciones desde otro sistema. Pero no es un botón de “exportar”. Entre el catálogo de tu tienda y una publicación válida hay una traducción, y esa traducción se traba siempre en los mismos cuatro puntos.

Este artículo es el mapa de esos cuatro puntos, escrito desde una integración que corre en producción hoy.

Por qué no alcanza con “mandar el producto”

Tu tienda y Mercado Libre modelan un producto distinto.

En tu tienda, un producto es más o menos lo que vos decidas: un nombre, un precio, unas fotos, tal vez unas opciones de talle o color. Los campos los definiste vos o los definió la plataforma, y nadie te obliga a completar nada que no quieras.

En Mercado Libre, una publicación es un objeto con reglas. Pertenece a una categoría del árbol del marketplace, y esa categoría determina qué información es obligatoria. No es un formulario flexible: es un contrato. Si falta un campo que la categoría exige, la publicación no se crea — devuelve un error y se queda afuera.

Por eso la primera vez que alguien intenta publicar masivamente desde su catálogo, el resultado típico no es “se publicaron 300 productos”. Es “se publicaron 12 y 288 dieron error”.

Punto 1 — La categoría no la elegís: se predice

Todo empieza acá, porque sin categoría no hay publicación. Y la categoría no es un dato que tu tienda tenga: tus categorías son las tuyas — “Camperas”, “Verano”, “Ofertas” — y las de Mercado Libre son las suyas, con su propio árbol de varios niveles.

Mercado Libre resuelve esto con una predicción: le mandás el título del producto y te devuelve la categoría que cree que corresponde, con su nivel de confianza. Funciona sorprendentemente bien para productos comunes y falla exactamente donde uno esperaría que falle: nombres de fantasía, productos de nicho, artículos que se llaman igual que otra cosa.

Lo que hay que hacer con eso: no confiar ciegamente. Una integración seria guarda la categoría predicha, la muestra para confirmación y recuerda la decisión. Porque la categoría no solo define dónde aparece el producto: define todo lo que viene después.

Por qué importa tanto

Elegir mal la categoría tiene dos costos, y el segundo es peor que el primero:

• El producto aparece donde nadie lo busca.
• Los atributos obligatorios que te va a pedir son los de esa categoría, no los del producto real — y vas a terminar completando campos que no tienen sentido para lo que vendés.

Punto 2 — Los atributos obligatorios (y los condicionales, que son los que rompen)

Cada categoría define su lista de atributos. Marca, modelo, material, tipo de prenda, potencia, capacidad — depende del rubro. Algunos son obligatorios siempre. Y hay un segundo grupo, más molesto: los condicionales, que son obligatorios solo en algunas categorías o solo si otro atributo tiene cierto valor.

Ese segundo grupo es el que rompe las publicaciones masivas, por una razón simple: no aparecen en la lista de “obligatorios” cuando uno mira la categoría por encima. Aparecen cuando el marketplace rechaza la publicación.

Lo que hay que hacer con eso: consultar los atributos de la categoría antes de armar la publicación, separar los obligatorios de los condicionales, y mapear cada uno contra un campo real de tu catálogo. Cuando no hay campo equivalente, hay dos salidas honestas: completarlo con un valor por defecto que sea cierto, o dejar el producto afuera y avisarlo. Lo que no sirve es inventar un valor para que la publicación pase.

Punto 3 — El GTIN: el código de barras que no siempre existe

El GTIN es el código de barras universal — el número que identifica a ese producto en cualquier comercio del mundo. Mercado Libre lo exige en varias categorías, y tiene sentido: es lo que le permite saber que la lámpara que vendés vos y la que vende otro son la misma lámpara.

El problema aparece con todo lo que legítimamente no tiene código universal: productos artesanales, marca propia, hechos a medida, importados sin registro. Son una parte enorme del comercio uruguayo.

La salida no es dejarlos afuera ni inventar un número. El marketplace contempla el caso: se puede declarar explícitamente que el producto no tiene código universal, y por qué. Es un campo más, pero hay que saber que existe — si no, la publicación se rechaza y el mensaje de error no dice exactamente eso.

Punto 4 — Las variantes: el mismo producto, cargado distinto de cada lado

Acá está el error más caro, porque no falla al publicar: falla después, cuando la sincronización ya está andando.

Tu tienda modela el talle M azul de una remera de una manera. Mercado Libre lo modela como una variación dentro de la publicación, con su propia identidad. Las dos estructuras se parecen lo suficiente como para que un mapeo apresurado parezca correcto — y lo suficientemente distinto como para que el stock termine descontándose de la variante equivocada.

Cuando eso pasa, no se nota enseguida. Se nota cuando un cliente compra un talle que no había y hay que cancelarle la venta.

Lo que hay que hacer con eso: tratar la correspondencia entre variantes como un dato en sí mismo, que se construye una vez, se verifica y se sostiene. No como algo que se deduce cada vez comparando nombres.

El detalle chico que aparece siempre: el título

El título de una publicación tiene un tope duro de 60 caracteres. No es una sugerencia: si el título es más largo, la publicación se rechaza.

Parece menor hasta que uno mira su propio catálogo y descubre que la mitad de los nombres de producto —los que incluyen marca, modelo, medida y color— se pasan cómodamente. Entonces hay que decidir cómo se acorta: qué se conserva, qué se saca, y si eso se hace con una regla o producto por producto.

Es el ejemplo perfecto de lo que hace lenta una publicación masiva. No es la parte difícil. Es que hay diez detalles así, y todos aparecen recién cuando ya estás publicando.

Lo que hace una integración que no rompe nada

Todo lo anterior explica una decisión de diseño que puede sonar exagerada y no lo es: una integración con Mercado Libre debería arrancar apagada.

Es lo que hicimos en la integración que hoy corre para un cliente que vende en Shopify y en el marketplace. El servicio arranca en modo lectura: recorre los dos catálogos, arma la correspondencia producto por producto y deja registrada cada acción que habría ejecutado — sin tocar la cuenta. Recién cuando esa comparación muestra que el apareo es correcto para un tramo del catálogo, se habilita la escritura de ese tramo.

La razón es que un puente que empieza escribiendo rompe el catálogo del cliente antes de que nadie llegue a revisarlo. Y limpiar publicaciones duplicadas o stock mal descontado cuesta bastante más que esperar unos días.

Lo demás que sostiene una integración seria es de la misma familia:

• Reintentos con espera creciente cuando una plataforma no responde, en vez de perder el evento.
• Una pasada completa periódica que compara los dos catálogos enteros, como red de seguridad de lo que los avisos en tiempo real no hayan cubierto.
• Alertas cuando algo se desvía, para enterarse antes que el cliente.

Entonces: ¿automatizar la publicación o no?

Depende de dos cosas, y ninguna es el tamaño de la empresa.

Cuánto se mueve tu catálogo. Si publicás diez productos por año, cargarlos a mano es más barato que cualquier automatización. Si entran productos todas las semanas, o si los precios cambian por temporada, el trabajo manual se vuelve una tarea fija que nunca baja.

Cuánta estructura tiene tu catálogo. Un catálogo con variantes, con varios depósitos o con reglas de precio por canal es un catálogo donde el error humano tiene muchas oportunidades de aparecer. Ahí la automatización no solo ahorra tiempo: evita ventas que hay que cancelar.

Si estás en el primer caso, no construyas nada todavía. Si estás en el segundo, lo que sigue no es elegir una herramienta: es mirar cómo está cargado tu catálogo hoy, porque de eso depende cuánto trabajo hay antes de la primera publicación.