Guía de integración de Tiendli con Mercado Libre

1. Traer publicaciones de Mercado Libre a Tiendli

1. En Mercado Libre, elegí la dirección Pull (ML a Tiendli) en Configurar.
2. Usá Actualizar para consultar las publicaciones en el listado Productos en Mercado Libre.
3. Marcá uno o varios artículos y usá Importar para traerlos a tu catálogo. La importación puede crear o actualizar productos existentes.
4. También podés ejecutar Sincronizar → Productos con Pull para conciliar los productos vinculados; este proceso puede incorporar publicaciones que aún no estén en Tiendli.

Las publicaciones con variantes y guías de talles se intentan agrupar e importar conservando sus atributos, imágenes y existencias. Una publicación pausada en Mercado Libre puede quedar pausada en Tiendli.

2. Publicar solo un producto de Tiendli en Mercado Libre

1. Conectá tu cuenta de vendedor en Mercado Libre y comprobá que indique Conectado.
2. En Catálogo → Productos, buscá un producto Activo que todavía no esté vinculado con Mercado Libre.
3. Completá su nombre, precio e imágenes públicas HTTPS. Para la publicación inicial directa, el producto debe ser simple, sin variantes.
4. Presioná Publicar en Mercado Libre, leé la confirmación y aceptá. Tiendli enviará únicamente ese producto y lo vinculará si Mercado Libre acepta la publicación.
5. Volvé a la integración para consultar el resultado. Las siguientes sincronizaciones Push podrán actualizar los artículos vinculados.

Importante: publicar puede generar cargos en Mercado Libre y exige cumplir los atributos, políticas, categoría y logística que ML determine. La categoría se predice desde el nombre; si ML rechaza datos obligatorios, revisá el error y completá la ficha. Para productos con variantes, creá la publicación inicialmente en Mercado Libre e importala desde Tiendli. El botón no envía en bloque todo el catálogo.

3. Visibilidad en Tiendli y estado en Mercado Libre

Los controles Ocultar en Tiendli / Mostrar en Tiendli aparecen para los artículos importados en la integración y en Catálogo → Productos. Al ocultar, se conserva la decisión local incluso si volvés a sincronizar. Actualmente no hay un control independiente para pausar un anuncio solo en ML y mantenerlo activo en Tiendli sin que un Pull vuelva a cambiar ese estado.

4. Precios distintos entre Tiendli y Mercado Libre

En Mercado Libre → Configurar → Precio por canal podés elegir Mismo precio, Ajuste porcentual, Ajuste fijo o Inteligente. El porcentaje o importe puede ser positivo para aumentar el precio de ML o negativo para reducirlo.

Para una excepción individual, buscá el producto importado en la integración y pulsá Regla general / Regla propia junto al símbolo de moneda. También podés simular el precio inteligente si ML devuelve sus costos. El redondeo comercial se aplica en la regla elegida.

La sincronización bidireccional conserva Tiendli como referencia cuando la regla modifica el precio de ML. Un Pull explícito de preciospuede recalcular el precio base desde ML. Si el producto tiene un precio anterior o de comparación configurado, la integración puede tomarlo como referencia en lugar del precio promocional actual. Revisá el resultado tras sincronizar y confirmá que ambas plataformas utilicen la misma moneda.

5. Stock, variantes, órdenes e historial

• Stock: elegí la dirección que represente dónde actualizás las existencias. La sincronización de stock está separada de precios y productos; los cambios pueden tardar hasta la siguiente ejecución.
• Variantes: la importación desde ML procesa talles, colores, combinaciones y fotos según los datos que devuelve su API. Para publicar desde Tiendli una ficha nueva con variantes, creala inicialmente en ML y luego importala.
• Órdenes: activá Órdenes, realizá Pull de Órdenes o Completa y comprobá la aparición de ventas en Tiendli. Los webhooks de ML pueden iniciar la importación, pero requieren que el vendedor esté correctamente vinculado.
• Estado de sincronización: Completa, Parcial o Error describen el resultado de una ejecución. Una sincronización parcial puede dejar algunos productos actualizados y otros sin cambios.
• Historial: desde la integración abrí Historial y revisá fecha, dirección, cantidad de éxitos, errores y últimas operaciones antes de repetir una sincronización.

6. Solución de problemas habituales

• Conexión caducada: comprobá el estado de OAuth y usá Reconectar si se revocó el acceso. No compartas Client Secret ni tokens con soporte público.
• Publicación rechazada: validá imagen, título, categoría, precio, permisos de la cuenta y atributos obligatorios en Mercado Libre. El error de ML puede indicar restricciones de la categoría o del país.
• Producto duplicado: no repitas una publicación cuyo envío haya tenido un resultado incierto; verificá primero en tu cuenta de Mercado Libre si se creó y contactá soporte para revisar el vínculo.
• Precios distintos a los esperados: revisá regla general y excepciones, dirección Pull/Push, moneda, precio de comparación y redondeo.
• Stock o estado inesperado: comprobá la última sincronización, variantes y si el artículo está pausado, oculto o archivado.
• Faltan órdenes: activá Órdenes, ejecutá Pull y confirmá en Historial que se procesaron. Una notificación webhook de otro vendedor no se aplica a tu tienda.
• Sincronización automática sin actividad: asegurate de que haya un servicio programado en ejecución. El interruptor solo no ejecuta un cron.

Para evitar cambios no deseados, comenzá con Pull y sincronizá Productos, Stock y Preciospor separado hasta verificar los resultados. Si la integración está parcialmente sincronizada, no repitas Completa sin revisar antes los errores.