Alcance

La integración de Handy con Odoo es creada y mantenida por nosotros mismos. Tanto su instalación, como soporte y mantenimiento son por parte de Handy.

A continuación se explican los alcances de la integración desde la perspectiva de negocios.

Preventa

• Sync
• Reserva de inventario hasta crear ruta

Rutas

• Venta al aceptar ruta

Entregas

• Factura

Cobros

• Complemento de pago ante cobro

Prerrequisitos

• Tener una instancia de Odoo operando. Nuestra integración no considera la puesta en marcha de la instancia de Odoo, pero sí te ayudamos a instalar la integración.
• El tipo de instancia de Odoo puede ser tanto en la nube (Odoo.com) como en un servidor propio (on-premise).
• Actualmente se soporta la versión de Odoo 19.
• Community y Enterprise, ambas ediciones están soportadas.
• Proporcionar usuario admin de Odoo para nosotros conectarlo y echarlo a andar.

igualmente existen diferentes prerrequisitos dependiendo de si la instalación corre en la nube o en un servidor propio.

Para servidor propio, necesitas proporcionarnos acceso al servidor de Odoo, ya sea por SSH si es Linux, o escritorio remoto si fuera Windows.

Cuando es por Odoo en la nube, se requiere que contrates Odoo.sh para poder instalar la integración. En este caso, necesitas darnos acceso al repositorio de GitHub asociado a la instancia de Odoo.

Sobre qué tamaño de servidor o worker utilizar, hay que seguir estos lineamientos para cada caso:

• On-premise
• Odoo.sh

Recomendaciones de hardware

Cuando se opera con Odoo en la nube, conectado con Odoo.sh, la cantidad de workers a contratar dependerá del tamaño de tu operación.

Sincronización de datos

El módulo puede sincronizar de forma bi direccional los catálogos generales que se necesitan para la correcta sincronización de clientes y productos, como son la Zona, Familia de Producto. La columna "Syncs IN" es toda la información que viaja de Handy => Odoo, mientras que la columna "Sync OUT" es toda la información que viaja de Odoo => Handy.

1.- ⏰ Automatizaciones

Existen una serie de cron jobs que se encargan de cada X tiempo de acuerdo a cómo se configuren, identificados con prefijos, traer la información de Handy(HANDY SYNC FROM) o actualizar la información de Odoo a Handy(HANDY SYNC TO)

Los que están marcados como(HANDY TOOLS) son específicos para todo el tema de la sincronización de pedidos, existe una en particular, que está verificando si quedó algún pedido sin sincronizar, para reintentarlos y que se persistan los datos correctamente.

2.- Catálogos y datos base

En el menú configuración, vamos a encontrar los catálogos generales y la información de los clientes

3.- 🛒 Pedidos

Los pedidos son sincronizados por defecto cada (15 min), aunque este tiempo se puede ajustar dependiendo de la operación de cada compañía

En cada vista que tenga una referencia a un objeto en Handy, se encuentra una pestaña "Handy Integration" que cuenta con todos los datos como se manejan en Handy, así como el ID de referencia del mismo dentro de Handy, con un link para abrirlo en una nueva pestaña, al igual que en Handy almacenamos la referencia del pedido en Odoo.

4.- 🚚 Rutas (movimientos de inventario en almacén)

Cuando se crea una ruta en Handy y el repartidor acepta la carga en su dispositivo móvil, se dispara un webhook que notifica a Odoo, para que pueda hacer todos los movimientos de inventario, particularmente son salidas de almacén. También se encuentra a la escucha de las acciones "Terminar ruta en el dispositivo" y "Cerrar la ruta".

4.1.- ➡ Salidas de almacén WH/OUT

Las salidas de almacén se realizan de forma individual por cada pedido de preventa que esté involucrado en la ruta, y una salida global para cuando se maneja "venta en ruta".

En el detalle de cada pedido de preventa, se visualizará el icono "Delivery” que representa los movimientos de almacén asociados a ese pedido:

4.2.- ⬅ Entradas de almacén (Devoluciones) WH/IN

Cuando se cierra la ruta en Handy, se envía una notificación al webhook, para que Odoo pueda procesar todas las devoluciones que ocurrieron en la ruta para los escenarios cuando una entrega se realiza de forma parcial, además de las devoluciones puras y todo el producto que se cargó previamente para venta en ruta y que no pudo ser vendido.

Para el caso de las entregas realizadas en Handy de forma parcial, en Odoo se reflejan dentro de la orden de venta y tienen la referencia al movimiento de salida de almacén, para establecer que esa entrada pertenece a lo que previamente se había sacado del almacén.

Además, dentro del módulo de inventario de Odoo hay varias formas de visualizar todos los movimientos de almacén y varios reportes. Esto es nativo del ERP.

5.- 🔄 Sincronizar inventario a Handy

Como el mandante del inventario de la compañía es el ERP(Odoo), luego de la operación diaria, o un ajuste manual en las cantidades de uno o varios productos, o porque se realizó una orden de compra dentro del flujo del ERP y se confirma, esto conlleva que dichas cantidades aumenten dentro del stock del almacén.

Por lo que desde la vista "Lista" de productos, seleccionando el o los productos que se necesiten actualizar su inventario en Handy, aparece un botón "Sync Stock to Handy", para actualizar las cantidades de cada producto, si todo se actualiza correctamente, se muestran notificaciones "Success" producto por producto.

Cualquier duda, estamos disponibles en el chat de soporte 🙂.

Actualizado el: 18/11/2025