Vincular productos de Flobu con Mercado Libre

Qué vas a lograr

• Entender qué significa realmente una vinculación de productos entre Flobu y Mercado Libre.
• Ejecutar el proceso Vincular Productos y revisar el resultado en la tabla Productos Vinculados.
• Confirmar si una variante quedó enlazada a una publicación real y decidir si corresponde activar o pausar su sincronización.

---

Paso a paso en Flobu

Cómo funciona la interfaz de Flobu en este tutorial

• Menú lateral: en este tutorial usarás Integraciones > Mercado Libre.
• Panel central: trabajarás en la pestaña Productos, donde Flobu muestra Productos Vinculados, el botón Vincular Productos, el botón Actualizar y la tabla de relaciones locales con Mercado Libre.
• Acciones clave: usarás Vincular Productos, Actualizar y el switch de Sincronización por fila.
• Alcance de este tutorial: aquí enlazarás variantes locales con publicaciones ya existentes en Mercado Libre. Esta pantalla no crea publicaciones nuevas en MELI y no reemplaza la gestión completa del marketplace.

1) Entender qué requisito debe cumplirse antes de vincular

1. Entra al dashboard de tu tienda.
2. Abre Integraciones > Mercado Libre.
3. Entra a la pestaña Productos.
4. Antes de pulsar nada, revisa el mensaje informativo azul que aparece en esta sección.
5. Flobu deja claro un requisito fundamental: para que la sincronización se active, el producto debe estar creado tanto en Flobu como en Mercado Libre con el mismo SKU. El sistema hará el match automáticamente usando ese dato.
6. Si una variante local no tiene SKU, o si el SKU de MELI no coincide, Flobu no podrá vincularla correctamente.
7. También debes considerar otro filtro importante del sistema: la tabla y el proceso trabajan sobre variantes locales cuyo producto esté en estado available. Por eso, este tutorial no aplica para productos ocultos, borradores o no disponibles.
8. Si aún no ves vinculaciones, la interfaz puede mostrar el estado vacío Aún no hay vinculaciones. Eso no significa que Mercado Libre esté desconectado; significa que Flobu todavía no encontró coincidencias locales-publicación que pueda enlazar.

Resultado esperado: entendiste que la vinculación en Flobu depende de coincidencias por SKU y de productos locales disponibles, no de una creación manual desde esta misma pantalla.

2) Ejecutar "Vincular Productos" y dar tiempo al proceso real

1. En la parte superior de Productos Vinculados, haz clic en Vincular Productos.
2. El tooltip del botón ya anticipa su comportamiento real: busca productos en Mercado Libre con el mismo SKU que en Flobu y los enlaza automáticamente.
3. Al pulsarlo, Flobu no completa la relación al instante en el navegador. Lo que hace es disparar un proceso en segundo plano.
4. Si todo sale bien, verás un mensaje que indica que la vinculación fue iniciada y que puede tardar unos minutos. Esa advertencia es importante porque este paso no funciona como un formulario síncrono.
5. Mientras el proceso corre, puedes usar Actualizar para volver a consultar la tabla. Ten en cuenta que Actualizar no lanza el match; solo refresca lo que el backend ya tenga registrado en ese momento.
6. Si la tabla sigue vacía inmediatamente después de iniciar el proceso, no concluyas que falló de inmediato. Primero da tiempo al match en segundo plano.
7. Si aun después de refrescar no aparece nada, vuelve al requisito del paso anterior: revisa que los productos existan en ambos lados, que compartan el mismo SKU y que el producto local esté en estado available.

Resultado esperado: iniciaste correctamente el proceso Vincular Productos y entendiste que el resultado aparece después, no en el mismo clic.

3) Confirmar el enlace en la tabla y controlar la sincronización

1. Cuando la vinculación encuentra coincidencias, la tabla deja de mostrar el estado vacío y empieza a listar filas reales.
2. Cada fila representa una relación local entre una variante de Flobu y una publicación de Mercado Libre.
3. En la columna Producto Local verás: imagen, nombre de variante, SKU y precio.
4. En la columna Publicación en Mercado Libre, una fila ya vinculada muestra el meli_item_id como enlace saliente. Si aún dice Sin vincular, Flobu todavía no encontró o no confirmó una coincidencia válida para esa variante.
5. En la columna Stock local verás la referencia de unidades locales.
6. En la columna Sincronización tienes el switch que controla si Flobu debe enviar automáticamente el stock a Mercado Libre. Una vinculación creada puede quedar con sincronización activa y luego mostrar estados como: Pendiente, Sincronizado o Error de sincronización.
7. Si el producto no tiene meli_item_id, la fila muestra Sin publicación. Eso significa que todavía no existe un enlace válido hacia una publicación concreta.
8. Si la vinculación quedó correcta y quieres que Flobu siga enviando stock a MELI, deja el switch activo. Si no quieres enviar cambios automáticos para esa fila, apaga el switch. Ese cambio se guarda desde la misma tabla y Flobu responde con mensajes como Estado actualizado.

Resultado esperado: confirmaste que Flobu vinculó correctamente al menos una variante con una publicación de Mercado Libre y supiste leer su estado operativo en la tabla.

---

Checklist final rápido

• Entré a Integraciones > Mercado Libre > Productos.
• Revisé el requisito de que Flobu y Mercado Libre compartan el mismo SKU.
• Entendí que este flujo no crea publicaciones nuevas en Mercado Libre.
• Inicié el proceso con Vincular Productos.
• Entendí que el match corre en segundo plano y no termina en el mismo clic.
• Usé Actualizar para volver a consultar la tabla.
• Verifiqué si las filas muestran un meli_item_id enlazado o si siguen en estado Sin vincular.
• Revisé el switch de Sincronización para decidir si el stock debe enviarse automáticamente.
• Entendí la diferencia entre Sin publicación, Pendiente, Sincronizado y Error de sincronización.

---

Errores comunes

• Creer que "Vincular Productos" crea publicaciones nuevas en Mercado Libre. En realidad, intenta enlazar publicaciones existentes usando coincidencias por SKU.
• Lanzar el match sin revisar los SKU. Si el código local no coincide con el SKU o seller_sku en MELI, Flobu no podrá enlazar la variante.
• Esperar resultados instantáneos después del clic. El proceso corre en segundo plano; conviene refrescar la tabla después de un momento.
• Confundir "Actualizar" con "Vincular Productos". Actualizar solo recarga la tabla; no ejecuta el proceso de match.
• Interpretar "Sin publicación" como un error del panel. Muchas veces solo significa que la variante todavía no tiene una publicación enlazada en MELI.
• Dejar activa la sincronización sin revisar si era la variante correcta. Una vez vinculada, el stock local puede empezar a reflejarse automáticamente en Mercado Libre.