Conectar

Aquí enlazas tu cuenta de MercadoLibre con Agapanto: guardas las credenciales de tu aplicación, autorizas el acceso y decides si las órdenes pagadas se facturan solas. Está en Menú → MercadoLibre → pestaña Conexión (ruta /app/mercadolibre?tab=conexion).

Permiso

Necesitas ACCESO_MERCADOLIBRE y que el módulo MERCADO_LIBRE esté activo en tu empresa.

Un vistazo

Menú → MercadoLibre → Conexión

storefrontMercadoLibreConectado 1

linkConexiónsellPublicacionesreceipt_longÓrdeneshelpPreguntas

key Credenciales

Cree una aplicación en developers.mercadolibre.com.co y copie aquí sus credenciales.

App ID (client_id)1234567890123456

Secret key (client_secret)•••••••• (sin cambios)

Guardar credenciales 2

link Conexión

check_circle Conectado como usuario ML 987654321

Estado del token: valid (renueva automáticamente; vence en 5 h)

Desconectarstorefront Reconectar 3

tune Facturación automática

Crear factura local automáticamente cuando la orden queda pagada 4

Responsable de las facturas automáticasAna Restrepo

Guardar ajustes

insights Resumen

Publicaciones

12

Órdenes

48

Sin facturar

3

Preguntas pendientes

1

5

Pestaña Conexión de Panadería Los Manjares con la cuenta ya autorizada y la facturación automática encendida.

1. 1 Insignia de estado: Conectado, Token por vencer, Token vencido o Sin conectar.
2. 2 Credenciales: App ID (client_id) y Secret key (client_secret) de tu aplicación. El secreto nunca se vuelve a mostrar; si el campo dice •••••••• (sin cambios) ya hay uno guardado.
3. 3 Conexión: muestra el usuario ML y el estado del token. Conectar con MercadoLibre (o Reconectar si ya estás conectado) abre MercadoLibre para autorizar; Desconectar borra los tokens.
4. 4 Facturación automática: el interruptor crea la factura local sola cuando la orden queda pagada; exige elegir un Responsable de las facturas automáticas.
5. 5 Resumen (solo con la cuenta conectada): publicaciones activas, órdenes importadas, órdenes sin facturar y preguntas pendientes.

Dónde conseguir el App ID y el Secret key

MercadoLibre no entrega estas claves con tu cuenta de vendedor: hay que crear una aplicación en su portal de desarrolladores.

1. Entra a developers.mercadolibre.com.co con la misma cuenta con la que vendes y crea una aplicación nueva.
2. Como URL de redirección usa la que te indique el equipo de Agapanto para tu instalación (termina en /mercadolibre/autenticar). Si no coincide, MercadoLibre rechaza la autorización.
3. Al guardar, el portal te muestra el App ID y el Secret key. Cópialos tal cual en los campos de la tarjeta Credenciales.

Conectar la cuenta

1. Pega el App ID (client_id) y el Secret key (client_secret) y pulsa Guardar credenciales. Verás Credenciales guardadas.
2. Pulsa Conectar con MercadoLibre. Se abre una pestaña nueva con la pantalla de autorización de MercadoLibre; aparece el aviso Complete la autorización en la pestaña que se abrió y regrese aquí.
3. Autoriza el acceso en MercadoLibre. Al volver a Agapanto verás MercadoLibre conectado correctamente y la insignia pasa a Conectado; se habilitan las pestañas Publicaciones, Órdenes y Preguntas.

ReconectarDesconectar

Si el token quedó vencido o cambiaste de cuenta de MercadoLibre, pulsa Reconectar: repite la autorización sin borrar nada.

Desconectar pregunta Se eliminarán los tokens de acceso. Las publicaciones y órdenes ya importadas se conservan. ¿Continuar? Al aceptar, la empresa queda Sin conectar; las credenciales (App ID y secreto) se mantienen para volver a conectar cuando quieras.

Facturación automática

Activa Crear factura local automáticamente cuando la orden queda pagada, elige el Responsable de las facturas automáticas (un usuario de tu empresa, que quedará como responsable en cada factura) y pulsa Guardar ajustes. Desde ese momento, cada orden que llegue pagada, ya sea por notificación de MercadoLibre o por importación, genera su factura sin que hagas nada. El detalle de qué necesita una orden para facturarse está en Órdenes y facturas.

Sin responsable no hay facturación automática

Si enciendes el interruptor sin elegir responsable, el sistema avisa Seleccione el responsable para la facturación automática y no guarda. Si más tarde ese usuario deja de existir, las facturas automáticas se omiten en silencio hasta que asignes otro.

El token se renueva solo

Agapanto renueva el token de acceso automáticamente cada hora antes de que venza. Solo necesitas Reconectar si la insignia dice Token vencido durante más de un día o si MercadoLibre revocó el permiso.

¿Problemas?

• El botón Conectar con MercadoLibre está apagado. No hay App ID guardado. Escríbelo en App ID (client_id) y guarda las credenciales.
• Al volver de MercadoLibre veo "La conexión con MercadoLibre falló". La URL de redirección de tu aplicación no coincide con la de Agapanto, o el Secret key está mal copiado. Revisa ambos en el portal de desarrolladores y repite Conectar.
• No aparecen las pestañas Publicaciones, Órdenes ni Preguntas. Solo se muestran con la cuenta autorizada. Si la insignia dice Sin conectar, completa la autorización.
• No veo la entrada MercadoLibre en el menú. Falta el módulo MERCADO_LIBRE en tu empresa o tu rol no tiene ACCESO_MERCADOLIBRE (Roles y permisos).

Siguiente: Publicar productos.