En esta página se encuentra la guía de integración con Odoo. Siguiendo el paso a paso podrán conectar a su ERP con Ventiapp.

Esta integración fue desarrollada utilizando la API de Odoo a través del protocolo JSON-RPC, permitiendo una comunicación directa y estructurada entre Ventiapp y su instancia de Odoo. A través de esta interfaz, es posible ejecutar operaciones como:

• Inyección de pedidos.
• Consulta y sincronización de inventarios.
• Consulta y sincronización de precios (Próximamente).

Agregar y conectar módulo

Para comenzar la conexión de Odoo con Ventiapp, desde nuestro panel vamos a navegar hasta el siguiente punto:

Iniciales en la esquina superior derecha > Configuración > Módulos > Odoo.

Para operar con Odoo es necesario autenticarse. Para ello, se requieren los siguientes datos, indispensables para establecer la comunicación:

• URL de la instancia de Odoo (https://nuestronombre.odoo.com).
• Nombre de la base de datos.
• Correo electrónico del usuario.
• Contraseña del usuario.

Una vez completados estos campos, daremos click en Autenticar para realizar la conexión con el sistema de Odoo y pasar a configurar las acciones del módulo.

Inyección de pedidos

Este módulo permite inyectar los pedidos de su cuenta de Ventiapp en Odoo.

Los pedidos que comenzarán a inyectarse en Odoo serán aquellos correspondientes al día en curso a partir del momento en que se establezca la conexión con Ventiapp. 

Además, en caso de que existan demoras en la actualización de su estado, se contempla un tiempo de tolerancia de hasta 21 días posteriores a la fecha de creación del pedido.

Para que los pedidos se inyecten correctamente, deben cumplirse las siguientes condiciones:

• El estado del pedido debe ser "pagado", o algún estatus equivalente.
• El pedido no debe haber sido previamente inyectado o encontrarse en el ERP. Si el pedido ya se encuentra en el ERP, el pedido no podrá volver a inyectarse desde Ventiapp para evitar alguna duplicidad. El pedido únicamente puede volver a inyectarse desde Ventiapp si éste directamente en Odoo se cancela y elimina.
• Los productos (SKU) deben existir en Odoo con un identificador idéntico, tomando como referencia el campo "default_code" / "Referencia interna" para la coincidencia.
• Información adicional de los pedidos inyectados se verá reflejada en su correspondiente apartado de "Notas internas".

Configuración de Ventas

Para establecer la inyección de ventas de Ventiapp hacia Odoo, se tendrán que configurar las siguientes secciones:

• Activar inyector: Es necesario activarlo para que las ventas sean inyectadas al ERP de manera automática. El proceso de sincronización se ejecutará automáticamente cada 10 minutos, realizando 3 intentos de inyección automática (Si no lograron inyectarse automáticamente se tendrán que inyectar manualmente desde el detalle de las ventas). La activación del inyector habilitará la edición de las siguientes configuraciones. Si desean inyectarse las ventas de manera manual, pueden activar el inyector, configurarlo, y posteriormente desactivarlo e inyectar manualmente las ventas deseadas desde la sección de Ventas.
• Activar cancelaciones: Si tenemos una venta y la inyectamos a Odoo desde Ventiapp, pero pasa cierto tiempo y es cancelada, se podrá realizar la cancelación desde Ventiapp hacia Odoo de manera automática (Para ventas de Meli, Liverpool y Shopify).
• Incluir comisión (ML): Incluirá la comisión de Meli en el detalle de las ventas en Odoo, no afecta en el monto de las ventas. (No es compatible con todas las versiones de Odoo, si muestran error al inyectarlas, se recomienda desactivar este check).
• ID Compañía: Se debe seleccionar la compañía que hayan configurado en su Odoo.
• Item de envío: Es de vital importancia crear este producto en Odoo para poder visualizar el costo de envío en la inyección de ventas. Este producto debe contar con las siguientes características:

01.- Desmarcar las casillas de "Ventas", "Gastos", "Punto de venta" y "Compras".

02.- Tipo de Producto: Servicio.

03.- Referencia interna: SHIPPING-VA (De preferencia, pero pueden asignar el nombre que deseen).

04.- No es necesario definir un precio, ya que Ventiapp se encargará de fijar el costo del envío de cada pedido (de acuerdo a lo que proporciona el canal de la venta).

• Fecha de pedido: Hora de la orden en la que se genera en el canal o llega a Ventiapp, algunas tienen otro huso horario.
• Nomenclatura de pedido:

01.- Consecutivos de Odoo: Inyecta ventas con los consecutivos del ERP, son los números consecutivos que Odoo asigna. Por ejemplo: "S00296".

02.- Claves por canal: Inyecta ventas con los consecutivos de los canales de sus correspondientes ventas. Por ejemplo, para Meli "2000013099500000", y para Amazon "701-2521000-1313000".

• Estado de pedido:

01.- Presupuesto: Se inyecta la venta sin apartar el stock.

02.- Pedido de venta: Se inyecta la venta y aparta el stock.

• Impuesto: Les agrega el impuesto deseado. En caso de no seleccionar alguna opción, Odoo calculará automáticamente los impuestos correspondientes, siempre que en su ERP los productos estén configurados con sus impuestos adecuados. (Si se tiene más de un impuesto, por ejemplo, IVA e IEPS, se recomienda no seleccionar ninguna opción y configurar los impuestos directamente en sus productos en Odoo).

Configuración de Clientes

Para crear un pedido/presupuesto en Odoo es necesario indicar un cliente, por lo que en Ventiapp contaremos con un campo para indicar el número ID del cliente que se estaría usando.

Contaremos con tres maneras para definir los clientes:

• Cliente por venta: En Odoo se creará un cliente con la información de su venta correspondiente. Al crearse el cliente a partir de la información de la venta, no es necesario asignar un ID en Ventiapp.

• Cliente único: Todas las ventas que se inyecten a Odoo se harán con este cliente creado en el ERP. Es necesario asignar el número ID de dicho cliente.

• Cliente por canal: Definimos en el ERP un cliente para cada canal que tengamos integrado en Ventiapp. Es necesario asignar el número ID de los canales correspondientes.

ID de Cliente

Para obtener el número ID debemos ingresar al detalle del cliente en Odoo, y en la URL de la pagina identificaremos este campo como "#id=", como se observa a continuación:

Configuración de Almacenes (Drop Off)

• Único: Todas las ventas con logística "Drop Off" se inyectarán hacia dicho almacén seleccionado, sin distinguir canales.

• Por canal: Dependiendo de los canales que tengamos conectados se nos mostrará la opción para indicar el almacén al cual se inyectarán las ventas que sean de este tipo.

Configuración de Almacenes (Fulfillment)

• Único: Todas las ventas con logística "Fulfillment" se inyectarán a dicho almacén seleccionado, sin distinguir canales.

• Por canal: Dependiendo de los canales que tengamos conectados (y que cuenten con la integración de Fulfillment) se nos mostrará la opción para indicar el almacén del que ligarán las ventas que sean de este tipo.

Inyección manual de pedidos

En la sección de Ventas podemos utilizar filtros para identificar los pedidos de mejor manera. Cuando conectemos Odoo, se habilitarán los siguientes filtros en dicha sección:

• Remisionadas: Ventas que se hayan inyectado hacia su ERP de manera correcta.
• No remisionadas: Ventas que estén pendientes por inyectar hacia su ERP, puede ser que aún no se encuentren con estatus de "Pagadas" o algún estatus similar.
• Error en remisión: Ventas que se hayan intentado inyectar, pero haya ocurrido algún error al intentar inyectarlas.

Podremos identificar las ventas que ya hayan sido inyectadas porque contarán con un número de remisión debajo del monto de dichas ventas.

En caso de no encontrarse inyectadas, no contarán con este número. Para saber la razón por la cual no han sido inyectadas, debemos de ingresar al detalle de las correspondientes ventas con el botón de "Ver más".

Se deberá de verificar en su correspondiente detalle de la venta, en su log/historial, la razón por la cual no pudo inyectarse.

Se debe corregir la razón del error y reintentar su inyección de manera manual con el botón de "Inyectar ERP".

Una vez inyectada la venta, en su correspondiente log/historial nos generará un enlace, en el cual al ingresar nos redirigirá a la venta inyectada en Odoo.

Cuando las ventas tengan todo lo necesario para inyectarse hacia Odoo, en caso de desear inyectarse de manera masiva, deberán de dirigirse a la sección de ventas, seleccionar las ventas deseadas y presionar el botón de "Inyección masiva ERP".

Configuración de Stock

En esta sección podrán activar la actualización automática del inventario para los canales integrados a Ventiapp, siguiendo estos pasos:

1. Activar el lector de almacenes:

Marcar la casilla "Activar lector". Esto habilitará el resto de los controles necesarios para configurar la sincronización del inventario con sus canales.

2. Definir el tipo de almacén:

Deberán elegir entre las siguientes dos opciones, según la forma en que manejen su inventario:

• Único: Se sincronizará el inventario desde un solo almacén de Odoo hacia todos los canales conectados en Ventiapp.
• Por canal: Podrán asignar un almacén distinto para cada canal conectado, lo que permite mantener un control más específico por Marketplace o tienda.

3. Seleccionar el almacén:

En la casilla correspondiente se desplegarán los almacenes disponibles en su cuenta de Odoo. Elegir el almacén o almacenes que desean usar para sincronizar el stock.

4. Configurar la frecuencia y horario de ejecución:

• Tiempo en ejecución del lector: Seleccionar cada cuánto tiempo se ejecutará el lector para consultar los productos actualizados. Pueden elegir entre 10, 20, 30 o 60 minutos.

Finalmente, dar click en Guardar para aplicar y activar la configuración.

Credenciales

En este apartado podrán visualizar las credenciales con las cuales se realizó la integración de Odoo con Ventiapp, en conjunto con la fecha de cuando se realizó dicha integración.

Eliminar integración

En caso de no desear continuar con la integración de Odoo con Ventiapp, debemos de presionar el botón de "Eliminar integración", con ello ya no se tendrá ninguna conexión con el ERP. En caso de desear volver a integrar Odoo con Ventiapp, únicamente hay que volver a ingresar las credenciales de administrador y volver a configurar la integración.

Editar credenciales

Dentro de Ventiapp no será posible editar las credenciales del usuario de Odoo conectado con Ventiapp, en caso de desear modificarlas, será necesario actualizarlas directamente en Odoo. Posteriormente, en Ventiapp se mostrará un banner en el cual nos indicará que las credenciales de Odoo son incorrectas, debemos presionar en "Ver". Una vez en este apartado, se deben de asignar las mismas credenciales recién actualizadas en Odoo y presionar el botón de "Autenticar". De esta manera, el usuario con el cual se realizó la conexión con la integración contará con sus credenciales actualizadas.

Actualizado el: 25/02/2026