Conexión con MercadoLibre

Configure y autorice la integración de ALTUM ERP con su cuenta de MercadoLibre para sincronizar productos y recibir órdenes de forma automática.

Requisitos previos

• Cuenta de vendedor activa en MercadoLibre México.
• Permiso marketplace.configurar en ALTUM ERP (rol Administrador o Gerente).
• Acceso a la sección Marketplace del menú lateral.

Pantalla principal de configuración

Navegue a Marketplace → Configuración para acceder al panel de conexión.

La pantalla muestra dos secciones:

1. Tarjeta de Conexión — estado actual de la integración con MercadoLibre (siempre visible).
2. Formulario de Parámetros — intervalos de sincronización y opciones avanzadas (visible únicamente cuando la cuenta ya está conectada).

Conectar su cuenta de MercadoLibre

Paso 1: Iniciar el flujo OAuth

En la tarjeta de conexión, haga clic en el botón Conectar con MercadoLibre.

El sistema le redirigirá al sitio oficial de MercadoLibre para que autorice el acceso.

Paso 2: Autorizar el acceso en MercadoLibre

Inicie sesión con sus credenciales de vendedor y acepte los permisos solicitados. MercadoLibre redirigirá de vuelta a ALTUM ERP automáticamente.

Paso 3: Confirmar la conexión

Cuando regrese a ALTUM ERP, el sistema muestra una notificación de éxito y la tarjeta de conexión pasa al estado Conectado, mostrando:

• Nombre de usuario (nickname) del vendedor en MercadoLibre.
• ID de vendedor (sellerId).
• Fecha en que se estableció la conexión.

Si ocurre un error durante el flujo OAuth, la pantalla muestra el aviso “Error al conectar con MercadoLibre. Intente de nuevo.” y la tarjeta permanece en estado desconectado.

Configurar los parámetros de sincronización

Una vez conectada la cuenta, el formulario de parámetros se hace visible.

Parámetro	Descripción
Almacén de cumplimiento	Almacén cuyo inventario se usa para actualizar el stock en MercadoLibre. Si no se especifica, se usa el stock total de todos los almacenes.
Intervalo de sincronización de stock	Cada cuántos minutos se envían cambios de existencia a MercadoLibre (stockSyncIntervalMinutes).
Intervalo de consulta de órdenes	Cada cuántos minutos se consultan nuevas órdenes en MercadoLibre (orderPollIntervalMinutes).
Facturación automática	Cuando está activo, genera un CFDI automáticamente al importar una orden.
Sincronización activa	Habilita o deshabilita la sincronización periódica sin desconectar la cuenta.

Haga clic en Guardar cambios para aplicar los parámetros.

Desconectar la cuenta

Para revocar la integración, use el botón Desconectar dentro de la tarjeta de conexión. Esta acción:

• Elimina los tokens almacenados en ALTUM ERP.
• Detiene todas las sincronizaciones programadas.
• No elimina los mapeos de productos existentes ni las órdenes ya importadas.

Precaución

Al desconectar la cuenta, las sincronizaciones automáticas se detienen de inmediato. Reconecte para reanudarlas.

Reglas y validaciones

• Los tokens OAuth (acceso y refresco) se almacenan cifrados en la base de datos; ALTUM ERP nunca expone el token en texto claro.
• El sistema usa un webhook secret para validar las notificaciones entrantes de MercadoLibre.
• Solo puede existir una conexión de MercadoLibre activa por empresa (tenant).
• Para conectar una cuenta distinta, primero desconecte la cuenta actual.

Casos frecuentes

El botón “Conectar” no responde. Verifique que su sesión en ALTUM ERP siga activa y que su usuario tenga el permiso marketplace.configurar.

La pantalla muestra “Error al conectar” al regresar de MercadoLibre. Asegúrese de haber aceptado todos los permisos solicitados. Intente el flujo nuevamente desde el botón Conectar con MercadoLibre.

La tarjeta muestra “Conectado” pero no llegan órdenes. Confirme que la opción Sincronización activa esté habilitada y que el intervalo de consulta de órdenes sea mayor a cero.