Sincronización de ventas
La sincronización de ventas de Mercado Libre
La sincronización de ventas es el proceso que transfiere automáticamente los datos de una venta realizada en tu cuenta de Mercado Libre a tu base de Odoo. Funciona en un solo sentido: la información viaja de Mercado Libre hacia Odoo y no al revés.
La sincronización se ejecuta automáticamente cada 20 minutos y busca las órdenes que cumplen dos criterios: que la fecha de la orden sea igual o posterior a la del campo fecha de última sincronización, y que la venta esté en estado pagada. Antes de crear una orden, Odumbo verifica que no exista ya en Odoo, para no generar duplicados.
Para ver las ventas sincronizadas, navega a Ventas ▸ Pedidos ▸ Pedidos de Venta. Puedes filtrarlas por equipo de ventas seleccionando Mercado Libre, porque todas las ventas sincronizadas se asignan automáticamente a ese equipo.
Además de crear la venta, Odumbo la confirma y crea la orden de entrega. Con eso Odoo reserva las cantidades vendidas y las descuenta del stock disponible, y eso pasa independientemente de si la venta está facturada o no.
Cada vez que una venta es creada o confirmada por Odumbo, un mensaje se registra en el chatter de la venta en Odoo. Este mensaje incluye el número de venta de Mercado Libre, el cual es un enlace directo a la publicación original en la plataforma. El texto del mensaje es "Created by Odumbo from MercadoLibre order x."
La sincronización de ventas se limita a la creación y confirmación de la venta. La generación de facturas y la validación de los procesos de despacho son acciones que se gestionan manualmente o a través de automatismos propios de Odoo, fuera del alcance de esta integración.
Sincronización de facturas hacia Mercado Libre
Las facturas se generan y se validan en Odoo: Odumbo no factura. Lo que hace la sincronización de facturas es buscar las facturas ya validadas en Odoo con un cron y subirlas individualmente a cada venta de Mercado Libre, para dejarlas a disposición del comprador, como Mercado Libre exige de forma obligatoria.
El proceso tiene dos pasos: generas las facturas en Odoo, de forma individual o masiva, y Odumbo las detecta automáticamente y las sube. El proceso no es inmediato: es diferido y puede tardar hasta 24 horas. Para hacer seguimiento, entra a la sección "Mis Ventas" dentro de Odumbo y revisa la columna "Factura subida", que indica si cada factura ya se sincronizó.
Para que funcione, la factura tiene que generarse y validarse automáticamente al confirmar la venta. La forma recomendada es usar tipos de pedido de venta, que también sirven para automatizar la creación o la validación de la entrega.
Puedes facturar una venta en un mes distinto al que ocurrió: la facturación diferida es posible y cargas la factura a mano en Mercado Libre. Si eres cliente de Adhoc, para eso hay que desactivar la facturación automática, porque la factura no se envía automáticamente a Mercado Libre y tienes que descargar el PDF y adjuntarlo manualmente. Hay un desarrollo en el roadmap para automatizar ese proceso, con un estimado de 4–5 meses.
La sincronización de facturas aplica únicamente a Mercado Libre, ya que las demás plataformas no lo requieren.
▶️ Video del flujo completo de carga de facturas
Datos que Odumbo completa en la orden de venta
Los campos que la integración completa al crear el pedido de venta en Odoo.
| Campo | Con qué se completa |
|---|---|
| Cliente | Si tildaste Odoo Partner, el contacto cuyo ID pusiste en Odoo Partner ID. Si no, Odumbo busca el contacto por número de identificación (DNI o CUIT) y, si no existe, lo crea con nombre y apellido, número de identificación, responsabilidad AFIP (Responsable inscripto, Monotributista, Exento o Consumidor final) y dirección de facturación: calle, ciudad y código postal. Odumbo prioriza los datos de facturación. |
| Dirección de entrega | Una dirección de envío asociada al contacto, con los datos cargados en Mercado Libre. |
| Productos | El producto de Odoo cuyo SKU coincide con el de la publicación. Si la publicación no tiene SKU o no hay coincidencia, se completa con un producto genérico llamado "Venta de MercadoLibre". |
| Cantidad | Las unidades vendidas. |
| Tarifa | La lista definida en Tarifa clásica o Tarifa premium, según el tipo de publicación. |
| Precio unitario | El precio total descontando el impuesto. |
| Precio total | El precio de la publicación de Mercado Libre. |
| Equipo de ventas | MercadoLibre si la venta se hizo en Mercado Libre, o MercadoShop si se hizo en Mercado Shop. |
| Compañía | La compañía configurada en los parámetros de la integración. |
| Documento de Origen | El número de la venta de Mercado Libre, con el formato "MercadoLibre Order x". |
| Tipo de Envío | El tipo de envío que informa Mercado Libre. |
| Vendedor y Equipo de Ventas | En la pestaña "Otra Información", según la parametrización inicial. |
Al abrir la transferencia de la venta, que está en la sección "Entrega" del encabezado, se adjuntan automáticamente las etiquetas de Mercado Libre en formato PDF y ZPL, listas para imprimir. En el chatter de la entrega quedan además el número de seguimiento y la fecha de entrega programada.
Opciones adicionales de la sincronización de ventas
Las opciones que puedes habilitar sobre la sincronización de ventas.
| Opción | Qué hace |
|---|---|
| Facturas | Odoo intenta entregar al cliente, a través de Mercado Libre, la factura generada en tu sistema. |
| Etiquetas | Las etiquetas de envío que Mercado Libre genera se sincronizan y se adjuntan a los movimientos de inventario o pickings de Odoo, en formato PDF y ZPL. |
| Cupones | Sincroniza la información de cupones aplicados a las ventas de Mercado Libre. |
| Fecha de Entrega | Sincroniza la fecha límite de entrega que Mercado Libre propone para cada venta y la refleja en la orden de venta de Odoo. |
| Mercado Envíos | Crea en Odoo el método de envío y agrega la línea de venta con el costo del envío. |
| MercadoLibre Fulfillment | Odumbo sí sincroniza las ventas Full. Un booleano de la integración permite desactivar la visualización de las ventas Full, y con eso puedes evitar que las ventas Full se sincronicen en Odoo. |
Los cinco métodos de envío disponibles hoy son Mercado Envíos (drop_off),
Mercado Envíos Places (xd_drop_off), Mercado Envíos Coleta
(cross_docking), Mercado Envíos Flex (self_services) y Mercado Envíos
Full (fulfillment). Al sincronizarse una venta se asocia el método
correspondiente y se agrega una línea con el costo de envío del usuario
comprador, que se muestra en la factura de la venta: según los
Términos y Condiciones de Mercado Envíos
(apartado 3, Costos y facturación), ese costo se factura al comprador.
En el caso de ventas de tipo Fullfilment de Mercado Libre, la configuración se realiza en un apartado específico. Para más detalles, consulta el video de configuración del almacén Fulfillment.
Más información sobre envíos y etiquetas en el Blog de Adhoc, en el ▶️ video de envíos y en la documentación de descuentos y promociones de MercadoLibre.
Configurar la sincronización de ventas
Activa la sincronización de ventas y define los parámetros con los que Odumbo crea las órdenes en Odoo.
Prerequisitos
- Un usuario del portal de Odumbo con acceso a la configuración de la integración.
- La cuenta de Odoo y la cuenta de Mercado Libre ya vinculadas.
Para configurar la sincronización de ventas:
- En Odumbo, entra a Integradores ▸ Integradores y selecciona el integrador de Mercado Libre.
- Abre la pestaña "Sincronización de Ventas".
- Activa la opción Ventas. Con eso se habilitan los campos de parametrización.
- Completa Compañía con la compañía a la que se asignan las ventas creadas.
- Completa Comercial con el vendedor por defecto de todas las ventas sincronizadas. Ese usuario necesita los permisos adecuados en Odoo.
- Completa Almacén con el almacén del que se consume el stock de los productos vendidos. Si la venta incluye productos con distinto almacén asignado en Odoo, el sistema prioriza el almacén del producto.
- Activa las opciones adicionales que necesites y guarda.
La integración queda configurada y lista para probarse.
Realiza siempre las pruebas de sincronización en un entorno de pruebas Sandbox de Odoo para evitar la creación de datos no deseados en tu entorno de producción.
Probar la sincronización de ventas
Corre una prueba antes de activar la sincronización automática.
Prerequisitos
- La integración con la sincronización de ventas configurada.
- Una base de Odoo de pruebas: el test crea ventas reales.
Para probar la sincronización:
- Haz clic en el botón "Testear".
- Espera unos segundos: el sistema busca y procesa las últimas cinco ventas de tu cuenta de Mercado Libre.
- Revisa el cartel de resultados, que lista si las ventas se crearon y cuál es su número de identificación en Odoo.
Si ocurre algún error, el sistema muestra un mensaje con el motivo.
Este proceso creará ventas reales en tu base de datos de Odoo. Por este motivo, es imprescindible realizarlo únicamente en un entorno de pruebas.
Verificar las ventas sincronizadas en Odoo
Comprueba en Odoo que las ventas del test llegaron completas.
Prerequisitos
- El test de sincronización ejecutado, con números de identificación de Odoo.
Para verificar las ventas:
- Ve a Ventas ▸ Órdenes ▸ Órdenes de venta y busca la venta por el número de identificación que devolvió el testeo.
- Comprueba que el contacto del cliente se creó con la información de facturación y de entrega.
- Comprueba que los productos de la venta están listados y vinculados por referencia interna (SKU). Si no coinciden, aparece el producto genérico "Venta de MercadoLibre".
- En el chatter, verifica los dos mensajes: el de creación por Odumbo con el link a la venta en Mercado Libre, y el de confirmación automática.
- En la pestaña "Otra Información", verifica que el Vendedor y el Equipo de Ventas son los de la parametrización inicial.
- Abre el proceso de despacho generado y, si la opción Etiquetas está activa y el tipo de envío es compatible, verifica que la etiqueta de Mercado Libre está adjunta en formato PDF o ZPL.
Si los seis puntos dan bien, la sincronización de ventas está funcionando.
Resincronizar ventas de fechas pasadas
Sirve para recuperar ventas de fechas pasadas que no se sincronizaron, o para re-sincronizar ventas de días atrás.
Prerequisitos
- Un usuario del portal con acceso a la configuración de la integración.
Para resincronizar ventas anteriores:
- Entra a la configuración de la integración en odumbo.com/web.
- Pasa la integración a borrador con el botón "Stop", que la detiene.
- Edita el campo de fecha que está al lado del tilde de Ventas y elige la fecha a partir de la cual quieres buscar ventas no sincronizadas.
- Guarda, confirma y reanuda la sincronización.
- Deja que la sincronización corra por sí sola.
Odumbo trae las ventas posteriores a esa fecha. Si la fecha abarca ventas que ya estaban cargadas, no se duplican mientras las haya creado la integración; las que se cargaron a mano no se pueden detectar, y esas sí se duplicarían. Con una fecha muy antigua, el proceso puede tardar.
Solución de problemas
No encuentro en Odoo la venta a partir del ID de Mercado Libre
El problema no produce un mensaje de error: la búsqueda por el número de venta de Mercado Libre no devuelve nada.
Ocurre cuando buscas por un campo que no guarda ese número, o cuando el campo "Documento Origen" no está visible.
Para resolverlo, activa el modo de desarrollador y filtra las ventas por Documento Origen contiene ID VENTA MercadoLibre. Ese campo, en la pestaña Otra información, es donde Odumbo guarda el número de la venta de Mercado Libre.
La venta se crea sin los campos extra que necesito
El problema no produce un mensaje de error: la venta se crea, pero sin Tipo de venta, sin Comercial o sin otro campo que tu flujo necesita.
Ocurre cuando la integración no tiene definidos valores por defecto para esos campos. Es lo mismo que hay que hacer para automatizar la creación o la validación de la entrega o de la factura.
Para resolverlo, define campos extras al momento de creación de una nueva venta:
- Entra a la configuración de la integración en odumbo.com/web y activa el modo de desarrollador.
- Edita el campo "Default Values" con un diccionario de pares campo/valor,
por ejemplo
{'type_id/.id':ID_TIPO_DE_VENTA, 'user_id/.id':ID_COMERCIAL}. - Para automatizar la entrega o la factura, crea antes un tipo de pedido de
venta con la configuración requerida y completa
{'type_id/.id': ID DEL TIPO DE PEDIDO DE VENTA}.
Hay dos campos, "Default Values" y "Fulfillment Default Values", para discriminar entre ventas normales y ventas Fulfillment: si el valor tiene que aplicar a los dos tipos de venta, complétalo en los dos campos.
Una excepción de venta bloquea la validación de la venta de Mercado Libre
El problema no produce un mensaje propio de la integración: la excepción de venta de Odoo bloquea la validación de una venta proveniente de MercadoLibre.
Ocurre cuando las reglas de excepción de venta de tu base aplican también a las ventas que crea la integración.
Para resolverlo, edita las excepciones de venta para que apliquen solo en determinadas condiciones —por ejemplo, cuando el equipo de ventas no es MercadoLibre—. Esa es la salida que evita saltear controles legítimos.
Workaround, si necesitas destrabar la operación ahora: activa el modo de
desarrollador en la configuración de la integración y coloca en los campos
"Default Values" y "Fulfillment Default Values" el diccionario
{'ignore_exception': 'True'}. Eso ignora todas las reglas, así que las
excepciones dejan de controlar también lo que sí querías controlar.
La venta llegó con el producto genérico "Venta de MercadoLibre"
En la línea de la orden de venta aparece:
Venta de MercadoLibre
Ocurre cuando la publicación no tiene SKU, o cuando el SKU de la publicación no coincide con la referencia interna (o el código de barras) del producto en Odoo. Sin ese match, no hay trazabilidad de la venta.
Para resolverlo, revisa la vinculación de productos y corrige el SKU de la publicación o la referencia interna del producto.
Una promoción de Mercado Libre llega a Odoo con el precio sin descuento
El problema no produce un mensaje de error: la venta se crea con el precio publicado y no con el precio final de la promoción. Por ejemplo, con precio publicado $100 y precio final con promoción $85, en Odoo puede ingresar como $100.
Ocurre porque Odumbo todavía no capta correctamente todas las promociones de Mercado Libre, y eso impacta en la facturación.
No hay resolución desarrollada todavía. Los descuentos, promociones, cupones y rebates se administran desde la Central de Promociones de Mercado Libre, donde el vendedor configura los precios promocionales. Dentro de la integración de Odumbo tienes que activar la función "Cupones" en la sección de sincronización de Ventas: con eso las ventas sincronizadas reflejan los descuentos aplicados y el precio final en MELI coincide con el precio final registrado en Odoo en los casos que Odumbo sí capta.
Antes de abrir un ticket
Adjunta:
- El nombre de la integración, el usuario y el número de sincronización.
- El número de la venta de Mercado Libre y el número de la orden en Odoo.
- Un video y las imágenes al detalle del error que observas.