Conector Odoo ↔ Mercado Libre Informe Cotizaciones.
Desarrollo, integración y validación funcional
BettaERP.com
Resumen ejecutivo
| Indicador | Resultado |
|---|---|
| Módulos desarrollados | 8 |
| Líneas de código | 17.738 |
| Modelos de datos | 26 |
| Endpoints de API | 30 |
| Pruebas automatizadas | 135 |
| Campos definidos | 392 |
| Período de desarrollo | Julio a agosto de 2026 |
| Versión actual | 19.0.2.7.1 |
| Plataforma | Odoo 19 Community |
| Alcance de Mercado Libre | Arquitectura preparada para 7 países |
No se trata de una configuración ni de la instalación de un módulo de terceros. Es un conector desarrollado específicamente para esta implementación, sin dependencia de licencias comerciales externas.
La base tecnológica, el código fuente, los componentes reutilizables y los activos de desarrollo permanecen bajo titularidad de BettaERP, salvo acuerdo escrito en contrario.
El sistema conecta la cuenta de Mercado Libre con Odoo en ambos sentidos. Desde Mercado Libre ingresan publicaciones, ventas, preguntas, mensajes, reclamos y devoluciones. Desde Odoo se gestionan precios, stock, respuestas, mensajes de postventa y nuevas publicaciones.
Toda comunicación hacia Mercado Libre se procesa mediante una cola asíncrona. Así, una demora o indisponibilidad temporal de la API externa no interrumpe operaciones internas de Odoo, como la validación de un remito.
Alcance funcional
| Bloque | Qué resuelve |
| Conexión de cuentas | Autorización mediante OAuth 2.0 con PKCE y renovación automática del token. La arquitectura contempla operar cuentas de distintos países; cada cuenta requiere su propia configuración, autorización y validación. |
| Publicaciones | Espejo local de cada publicación de Mercado Libre, tanto simples como con variantes, vinculado al producto de Odoo. Incluye importación masiva del catálogo completo, sin el límite de mil ítems de la paginación habitual. |
| Alta de publicaciones | Asistente desde la ficha de producto de Odoo. Predice categorías, obtiene atributos requeridos, carga fotografías y publica productos con sus variantes. |
| Precio y stock | La tarifa de Odoo determina el precio publicado. El stock se toma del depósito definido, con colchón y tope configurables. Los envíos se procesan mediante cola, con reintentos y registro de errores. |
| Ventas | Cada orden genera cliente y pedido de venta en Odoo. Incluye datos fiscales, condición de IVA argentina, comisiones de Mercado Libre y confirmación automática opcional. |
| Importación de ventas | Importación incremental mediante marca de agua y modo histórico para recuperar operaciones anteriores. |
| Logística | Seguimiento de envíos e impresión de etiquetas PDF, individuales o por lote. |
| Postventa | Gestión de preguntas, mensajería, reclamos y devoluciones desde Odoo. Incluye plantillas de mensajes automáticos según el estado de la compra. |
| Atención al cliente | Mesa única para responder preguntas, mensajes y reclamos sin cambiar de pantalla. Incluye fotos, archivos adjuntos, ficha del comprador y uso adaptado a celular. |
| Publicidad | Gestión de Product Ads con métricas de clics, impresiones, costo y ACOS. |
| Tablero | Pantalla propia dentro de Odoo con indicadores de venta, salud del catálogo, centro de operaciones y avisos. |
| Perfiles y permisos | Perfiles de Usuario y Responsable, con aislamiento por compañía. El perfil operativo no accede a credenciales ni puede eliminar registros sensibles. |
| Avisos en tiempo real | Recepción de notificaciones para que ventas, preguntas y cambios de publicaciones ingresen a Odoo sin esperar el siguiente ciclo programado. |
Arquitectura del conector
El desarrollo se distribuye en ocho módulos independientes: un núcleo de integración y siete extensiones especializadas. Esta arquitectura permite incorporar funcionalidades de forma ordenada y aislar el impacto de cada actualización.
| Módulo | Función y datos técnicos |
| Núcleo del conector: bettaerp_mercadolibre | Integra cuentas, publicaciones, órdenes, envíos, postventa, publicidad, permisos y tablero. 9.833 líneas de código · 19 archivos de datos · 7 archivos de pruebas. |
| Live Desk: betta_mercadolibre_desk | Centro de atención para mensajes, preguntas y reclamos, con ficha del comprador y visualización adaptada a celular y tablet. 2.642 líneas de código · navegación maestro-detalle. |
| Precios por tarifa: betta_mercadolibre_listprice | Odoo gobierna el precio publicado. Incluye precios por variante, resolución en lote y asistente de recálculo masivo. 1.421 líneas de código · 277 líneas de pruebas. |
| Stock, SKU y vínculo: betta_mercadolibre_catalogo | Relación entre catálogo, stock publicado, SKU y emparejamiento de productos con publicaciones. 1.448 líneas de código · 420 líneas de pruebas. |
| Chat con adjuntos: betta_mercadolibre_chat | Mensajería con compradores dentro de Odoo, con fotografías y archivos PDF para postventa y reclamos. 703 líneas de código · 3 endpoints de mensajería. |
| SKU automático: be_sku_automatic | Generación de referencias internas breves y sin duplicados para cada variante. 550 líneas de código · 260 líneas de pruebas. |
| Plantillas de publicación: bettaerp_mercadolibre_plantilla | Guarda atributos de categoría y descripciones por producto para reutilizarlos al publicar. 555 líneas de código · 164 líneas de pruebas. |
| Sandbox y pruebas: bettaerp_mercadolibre_bearer_access_token | Herramientas de desarrollador para token, renovación manual y usuarios de prueba. 484 líneas de código · 96 líneas de pruebas. |
Desarrollo e implementación
La integración se desarrolló durante aproximadamente cinco a seis semanas, desde fines de julio de 2026 y durante agosto.
El trabajo incluyó investigación y análisis de la API de Mercado Libre, desarrollo del conector, pruebas de publicaciones, gestión de productos y variantes, vinculación mediante SKU, sincronización de stock, recepción de órdenes, gestión de precios, validaciones, resolución de errores y pruebas funcionales dentro del entorno Odoo.
Una integración con una plataforma externa requiere un ciclo continuo de implementación y verificación: se publica un cambio, se prueba contra Mercado Libre, se revisa la respuesta real de la plataforma, se corrige y se vuelve a validar.
Esto implicó instalaciones y actualizaciones repetidas de módulos sobre distintas bases de datos, publicación de productos reales y de prueba, simulación de errores, revisión de registros del servidor y validación funcional de cada ajuste.
Verificación y calidad
| Aspecto | Alcance validado |
| Entornos de prueba | Se utilizaron seis bases de datos independientes, separadas del entorno productivo, para probar instalaciones, actualizaciones y migraciones sin comprometer la operación. |
| Pruebas automatizadas | 135 casos se ejecutan ante cada cambio para detectar regresiones funcionales. |
| Pruebas contra API real | Publicaciones, ventas, preguntas y mensajes fueron validados contra Mercado Libre mediante usuarios de prueba. |
| Avisos en tiempo real | Se configuró y verificó el canal de notificaciones para ventas, preguntas y cambios de ítems. |
| Versiones registradas | El proyecto cuenta con 41 versiones registradas. Se retiraron 826 líneas de código durante reescrituras y mejoras de diseño. |
| Validaciones funcionales | Cada bloque fue revisado y ajustado en precio, stock, SKU y presentación antes de considerarse finalizado. |
Dedicación efectiva del período
| Concepto | Valor |
| Semanas de desarrollo concentrado | 5 a 6 |
| Jornadas trabajadas, de lunes a sábado | 30 a 36 |
| Horas por jornada | 6 |
| Horas efectivamente trabajadas | 180 a 216 horas |
La dedicación efectiva incluye desarrollo, investigación, pruebas, correcciones, reuniones y validaciones.
Estimación de esfuerzo de desarrollo
La dedicación efectiva corresponde al tiempo realmente trabajado durante el período.
La estimación de desarrollo equivalente expresa el esfuerzo técnico que demandaría construir este alcance por encargo, considerando volumen de código, integraciones externas, modelos de datos, pantallas, pruebas automatizadas y documentación.
La estimación equivalente no representa horas trabajadas ni horas facturadas.
Núcleo del conector
| Bloque de trabajo | Estimación equivalente |
| Publicaciones: espejo local, variantes, importación masiva y estados | 32 a 40 h |
| Ventas: importación incremental e histórica, pedidos y datos fiscales | 30 a 38 h |
| Tablero e interfaz propia dentro de Odoo | 26 a 34 h |
| Asistente de publicación: categorías, atributos, fotografías y variaciones | 22 a 28 h |
| Postventa: preguntas, mensajería, reclamos y devoluciones | 22 a 28 h |
| Vistas, menús y empaquetado | 14 a 18 h |
| Conexión de cuentas: OAuth, arquitectura multicuenta y renovación de token | 14 a 18 h |
| Perfiles de usuario, permisos y aislamiento por compañía | 10 a 14 h |
| Cola de sincronización asíncrona | 10 a 14 h |
| Envíos y etiquetas PDF | 10 a 14 h |
| Recepción de avisos en tiempo real | 8 a 10 h |
| Publicidad: campañas y ACOS | 8 a 10 h |
| Subtotal núcleo | 206 a 266 h |
Módulos de extensión
| Bloque de trabajo | Estimación equivalente |
| Mesa de atención al cliente, con uso desde celular y tablet | 40 a 52 h |
| Precios gobernados por tarifa de Odoo, con recálculo masivo | 30 a 38 h |
| Stock publicado, SKU y emparejamiento con catálogo | 28 a 36 h |
| Chat con comprador, fotografías y archivos adjuntos | 16 a 22 h |
| Generación automática de SKU de variantes | 14 a 18 h |
| Plantillas de publicación por producto y categoría | 12 a 16 h |
| Sandbox: token, usuarios de prueba y credenciales | 8 a 12 h |
| Subtotal extensiones | 148 a 194 h |
Trabajo transversal
| Bloque de trabajo | Estimación equivalente |
| Correcciones y reestructuración del código | 34 a 44 h |
| Pruebas automatizadas | 24 a 32 h |
| Entorno, despliegue y pruebas contra API real de Mercado Libre | 16 a 22 h |
| Documentación técnica | 10 a 14 h |
| Subtotal trabajo transversal | 84 a 112 h |
Total estimado de desarrollo equivalente
438 a 572 horas
La diferencia con la dedicación efectiva responde al conocimiento acumulado sobre Odoo, la aplicación de patrones técnicos ya validados, herramientas de asistencia al desarrollo y una arquitectura modular que aceleró etapas específicas de implementación.
Fallas detectadas y corregidas
| Situación corregida | Impacto evitado |
| El tope de stock en cero publicaba stock cero. | El catálogo podía quedar sin unidades disponibles en Mercado Libre. |
| La importación de ventas traía solo las últimas 50 operaciones. | En días de alto volumen podían quedar ventas sin recuperar. Se implementó importación incremental e histórica. |
| El código interno se enviaba como código de barras. | Mercado Libre recibía un GTIN inválido que podía afectar la publicación. |
| El envío de precio y stock no sincronizaba datos. | Odoo no transmitía correctamente sus valores a Mercado Libre. |
| El envío de SKU podía despausar publicaciones. | Se evitó reactivar ítems pausados intencionalmente. |
| La validación de remitos quedaba ligada a Mercado Libre. | Se evitó que una demora de API afectara operaciones de inventario. |
| La importación traía solo 50 publicaciones. | Se evitó que catálogos grandes quedaran incompletos. |
| Los datos fiscales del comprador no llegaban. | Se corrigió el servicio de facturación para crear información fiscal correctamente. |
| Ventas con datos fiscales no generaban pedido. | Se corrigió el vínculo con la compañía y el flujo de alta de cliente. |
| El SKU llegaba vacío desde Mercado Libre. | Se corrigió la lectura de atributos y el emparejamiento de productos. |
| Publicaciones matriz sin producto visible. | Se corrigió la visualización y relación de publicaciones con variantes. |
Sustento técnico y operativo
El proyecto cuenta con control de versiones, 135 pruebas automatizadas, 41 reglas de permisos, dos perfiles de usuario con aislamiento por compañía y 12 documentos técnicos de arquitectura y uso.
Estas prácticas permiten mantener el conector de forma controlada, validar cambios antes de aplicarlos y preservar la consistencia funcional de la integración.
Continuidad y mantenimiento
El valor de referencia del módulo de integración es de USD 1.000 + IVA, abonado por única vez. Para Avelia, por ser cliente de BettaERP y contar con servicios ya brindados, aplicaremos una bonificación comercial excepcional de USD 500 + IVA sobre este valor.
Les enviaremos la correspondiente orden de venta cotizada para que quede todo documentado. El pago puede organizarse de manera flexible, acompañando el ritmo de implementación y la operación de la empresa.
En este caso se realizó una excepción por urgencia: se priorizó avanzar rápidamente con el desarrollo y la puesta en marcha antes de formalizar los tiempos estimados y la cotización previa. La intención fue responder a una necesidad operativa inmediata de Avelia.
De todos modos, consideramos importante dejar en claro el costo de implementación y el alcance realizado, para que el trabajo continúe bajo una modalidad transparente y previsible para ambas partes.
Mercado Libre es una plataforma externa y puede modificar sus APIs, políticas, permisos, estructuras de datos o condiciones operativas. Por este motivo, las adecuaciones necesarias ante futuros cambios de Mercado Libre no se encuentran incluidas en el valor inicial del módulo.
Para estos casos, pueden elegir entre dos modalidades de mantenimiento:
Mantenimiento mensual: USD 25 + IVA por mes, para mantener la integración compatible ante cambios técnicos u operativos de Mercado Libre dentro del alcance original.
Mantenimiento por intervención: sin cargo mensual fijo. Si un cambio requiere una adecuación, se analiza su impacto y se presenta una cotización específica según el alcance y las horas necesarias.
Las nuevas funcionalidades, ampliaciones de alcance o desarrollos adicionales se analizarán y cotizarán por separado, independientemente de la modalidad de mantenimiento elegida.
Situación actual
El conector se encuentra instalado y operativo sobre Odoo 19, con la cuenta de Mercado Libre conectada, publicaciones sincronizando y ventas ingresando de forma incremental.
Las funcionalidades detalladas en este informe se encuentran desarrolladas y operativas.
Activación pendiente de Product Ads
El módulo de publicidad está desarrollado y probado. Para que Mercado Libre devuelva información de campañas, debe habilitar Product Ads dentro de la aplicación correspondiente.