Mapeo de Productos

Vincule los productos de su catálogo ALTUM ERP con publicaciones existentes en MercadoLibre para mantener precios y existencias sincronizados.

Requisitos previos

• Cuenta de MercadoLibre conectada (consulte Conexión con MercadoLibre).
• Publicaciones activas en MercadoLibre con el ID de artículo (MLA…).
• Permiso marketplace.configurar en ALTUM ERP.

Pantalla de Productos Marketplace

Navegue a Marketplace → Productos para ver la tabla de mapeos.

La tabla muestra los vínculos existentes con las columnas:

Columna	Descripción
Producto ALTUM	Nombre y código del producto en el catálogo propio.
Publicación MeLi	Título y enlace de la publicación en MercadoLibre.
Estado	PENDING, SYNCED, ERROR, PAUSED o CONFLICT.
Precio MeLi	Precio actual de la publicación en MercadoLibre (caché).
Stock MeLi	Existencia actual en MercadoLibre (caché).
Última sincronización	Fecha y hora del último envío exitoso.

Vincular un Producto Manualmente

Paso 1: Abrir el diálogo de vinculación

Haga clic en el botón Vincular Producto (esquina superior derecha).

Paso 2: Seleccionar el producto ALTUM

En el campo Producto, busque y seleccione el artículo de su catálogo.

Paso 3: Ingresar el ID de la publicación MercadoLibre

Escriba el ID del artículo en MercadoLibre (ejemplo: MLA123456789). El sistema consulta la API de MercadoLibre para obtener el título, precio y existencia actuales y los muestra como vista previa.

Nota

Si la publicación tiene variaciones (talla, color, etc.), también puede ingresar el ID de variación (meliVariationId) para vincular a una variante específica.

Paso 4: Confirmar la vinculación

Haga clic en Vincular. El sistema crea el mapeo con estado PENDING. En la próxima sincronización de stock, el estado pasará a SYNCED si la actualización es exitosa.

Detección automática de conflictos al vincular

Al crear el mapeo, el sistema compara el precio ALTUM con el precio de la publicación MercadoLibre. Si la diferencia supera el 5 %, el campo priceConflict se marca y la tabla muestra una advertencia visual.

Auto-Match por SKU

El botón Auto-Match intenta vincular automáticamente productos ALTUM con publicaciones MercadoLibre usando el campo codigo (SKU) del producto.

Cómo funciona el Auto-Match

1. El sistema consulta hasta 50 publicaciones activas de su cuenta de MercadoLibre.
2. Para cada producto seleccionado, busca una publicación cuyo atributo SELLER_SKU coincida exactamente con el codigo del producto (confianza 100 %).
3. Si no hay coincidencia exacta de SKU, intenta una coincidencia parcial por título (confianza 60 %).
4. Los resultados se muestran en el diálogo con el grado de confianza antes de crear los mapeos.

Precaución

Los emparejamientos por coincidencia parcial de título (confianza 60 %) deben revisarse manualmente antes de confirmar, ya que pueden no ser exactos.

Publicar en MercadoLibre

El botón Publicar en MeLi dispara una sincronización de stock para todos los mapeos en estado SYNCED o PENDING. El sistema muestra cuántos productos se publicaron exitosamente y cuántos fallaron.

Estados de sincronización

Estado	Significado
PENDING	Mapeo recién creado; pendiente de primer sincronización.
SYNCED	Última sincronización exitosa; stock y precio actualizados.
ERROR	La última sincronización falló. El campo lastSyncError contiene el detalle.
PAUSED	El producto en ALTUM no tiene stock disponible y la publicación fue pausada en MercadoLibre automáticamente. Cuando el stock se recupere, la publicación se reactiva.
CONFLICT	Se detectó una diferencia de precio o stock superior al umbral configurado (5 % para precio).

Eliminar un mapeo

Para desvincular un producto, use el control de eliminar en la fila correspondiente de la tabla. Esta acción:

• Borra el registro de mapeo de ALTUM ERP.
• No modifica ni elimina la publicación en MercadoLibre.

Reglas y validaciones

• Un producto ALTUM puede vincularse a una sola publicación de MercadoLibre a la vez.
• El stock enviado a MercadoLibre nunca es negativo; se envía 0 como mínimo.
• Cuando el stock del almacén de cumplimiento llega a cero, la publicación se pausa automáticamente en MercadoLibre (estado PAUSED).
• Cuando el stock vuelve a ser mayor que cero, la publicación se reactiva automáticamente.
• El sistema usa reintentos con retardo exponencial (1 s, 5 s, 15 s, 60 s, 300 s) ante errores de la API de MercadoLibre.

Casos frecuentes

El estado permanece en PENDING tras vincular. La sincronización se ejecuta en el intervalo configurado. Si transcurrió el intervalo y el estado no cambia, revise si la integración tiene Sincronización activa habilitada en Marketplace → Configuración.

El estado cambió a ERROR. Abra el detalle del mapeo para ver el mensaje en lastSyncError. Los errores de límite de tasa (rate limit) de MercadoLibre se resuelven solos en el siguiente intento.

Aparece un conflicto de precio (CONFLICT). Actualice el precio en ALTUM ERP o en MercadoLibre para que la diferencia sea menor al 5 %, luego inicie una sincronización manual.