MercadoLibre¶
Con esta integración vendes en MercadoLibre sin salir de Agapanto: publicas productos de tu inventario, el stock y el precio se mantienen sincronizados, las órdenes pagadas llegan solas y se convierten en facturas locales, y respondes preguntas y mensajes de compradores desde el mismo panel. Está en Menú → MercadoLibre (ruta /app/mercadolibre).
Cuándo usar esta sección¶
- Ya vendes (o quieres empezar a vender) en MercadoLibre Colombia y no quieres llevar el inventario dos veces.
- Necesitas que cada venta de MercadoLibre quede facturada en Agapanto, con su cliente, su consecutivo y su movimiento de inventario.
- Quieres atender preguntas de compradores y el chat post-venta con el contexto de la orden a la mano.
De la orden en MercadoLibre a la factura local¶
flowchart LR
A[Comprador paga en ML] --> B[Orden llega a Agapanto]
B --> C{¿Auto-facturar activo?}
C -- Sí --> D[Factura creada sola]
C -- No --> E[Botón Facturar en la pestaña Órdenes]
E --> D
D --> F[Cliente + consecutivo + inventario descontado]Las órdenes llegan por notificaciones de MercadoLibre y, como respaldo, con una importación automática cada hora. También puedes traerlas a mano con Importar. Solo se facturan órdenes pagadas cuyos items estén mapeados a un producto local (ver Órdenes y facturas).
Las pestañas del módulo¶
La insignia de arriba a la derecha resume la conexión: Conectado, Token por vencer, Token vencido o Sin conectar. El token se renueva solo; si lo ves vencido, ve a Conectar.
Páginas de esta sección¶
| Página | Para qué |
|---|---|
| Conectar | Guardar el App ID y el Secret key de tu aplicación, autorizar la cuenta con Conectar con MercadoLibre, activar la facturación automática y ver el resumen. |
| Publicar productos | Publicar un producto desde su ficha (categoría, precio base, margen, tipo de publicación) y administrar todas las publicaciones: sincronizar, pausar, activar. |
| Órdenes y facturas | Importar órdenes, facturarlas una a una o en bloque, ver el detalle con items y envío, y descargar la guía. |
| Preguntas y mensajes | Responder preguntas pre-venta y chatear con el comprador de una orden. |
Permisos y módulos involucrados¶
| Permiso | Lo necesitas para |
|---|---|
ACCESO_MERCADOLIBRE |
Ver la entrada del menú y usar todas las pestañas del módulo. Es el único permiso de la integración. |
| Módulo (feature flag) | Qué habilita |
|---|---|
MERCADO_LIBRE |
Activa el módulo para tu empresa: sin él la entrada MercadoLibre no aparece en el menú. |
Si no ves el menú
El módulo MERCADO_LIBRE se activa por empresa; pide a quien administra tu cuenta que lo revise en Módulos y feature flags. El permiso se asigna por rol en Roles y permisos.
La pestaña MercadoLibre de cada producto
Una vez guardadas las credenciales, la ficha de cada producto en Inventario → Productos muestra una pestaña MercadoLibre desde donde se publica. Publicar siempre empieza ahí, no en este módulo.
Siguiente: Conectar.