Introducción
La integración entre Odoo y AntsRoute le permite transferir sus solicitudes de entrega y optimizar automáticamente sus rutas.
Con este conector, puede:
- Enviar entregas desde Odoo a AntsRoute
- Planificar sus rutas de forma más eficiente
- Hacer seguimiento del estado de las entregas directamente desde Odoo
👉 Esta integración está disponible en el catálogo de aplicaciones de Odoo.
💡 Bueno saber: la funcionalidad pick-up & delivery también es compatible con esta integración.
Antes de empezar
Antes de configurar la integración, asegúrese de:
- utilizar odoo.sh
- disponer de una versión compatible de Odoo: 13.0, 14.0, 15.0, 16.0, 17.0, 18.0 o 19.0
- haber instalado los siguientes módulos: Inventory (Stock), Sales, and Invoicing
Paso 1: Instalar el módulo AntsRoute
- Abra el módulo Apps
- Busque AntsRoute
- Haga clic en Install
👉 El módulo ya está disponible en su entorno de Odoo.
Paso 2: Configurar un almacén
Este paso permite definir el punto de partida de sus entregas.
- Vaya al módulo Inventory
- Haga clic en Configuration > Warehouses
- Haga clic en Create
- Complete la siguiente información:
- Nombre del almacén (warehouse name)
- Nombre corto (máx. 5 caracteres) (short name)
- Dirección (obligatoria) (address)
- Horario de apertura (opening hours)
- Haga clic en Save
💡 Importante: la dirección corresponde al lugar donde se cargan las mercancías.
Paso 3: Crear un método de envío AntsRoute
3.1 Configurar el método
- Vaya a Inventory > Configuration > Shipping Methods
- Haga clic en Create
- Complete la siguiente información:
- Nombre (name)
- Proveedor (provider)
- Marque la opción Use AntsRoute
- Añada un producto de entrega (delivery product)
💡 Nota: puede definir un precio fijo (fixed price) o establecer reglas de tarificación (en función del peso, volumen o cantidad).
3.2 Añadir la clave API de AntsRoute
Obtener la clave API:
- Inicie sesión en AntsRoute
- Haga clic en su perfil (arriba a la derecha)
- Vaya a Integraciones
- Haga clic en Clave API
- Haga clic en “+” (Añadir)
- Introduzca un nombre (opcional)
- Seleccione el sitio asociado
- Haga clic en Crear
- Copie la clave generada
- Haga clic en Continuar para confirmar
Añadir la clave en Odoo:
- Vuelva a Odoo
- Abra la pestaña AntsRoute en su método de envío (shipping method)
- Pegue la clave API en el campo correspondiente
🔑 ¿Para qué sirve la clave API?
Permite conectar de forma segura Odoo con AntsRoute y sincronizar los datos de entrega automáticamente.
3.3 Elegir el modo de planificación
En Shipping method > AntsRoute > Order destination in AntsRoute, seleccione una de las siguientes opciones:
- Organizar (Organize): la entrega se programa en una fecha específica
- Cesta (Basket): la entrega se añade con una fecha límite y se planifica más adelante
💡 Nota: si utiliza la funcionalidad Pick-up & Delivery, seleccione « Pickup delivery enabled » en el campo AntsRoute Mode.
Esta funcionalidad le permite:
- Recoger mercancías en una ubicación A
- Entregarlas en una ubicación B
- Volver al almacén varias veces durante el día si es necesario
3.4 Definir los parámetros de entrega
- Complete la siguiente información:
- Tiempo medio de carga en el almacén (average loading time at the warehouse)
- Tiempo medio de descarga en el cliente (average unloading time at the customer's)
- Días de entrega (delivery days)
- Hora de inicio en el almacén a partir de la cual se puede realizar una carga (warehouse default opening)
- Hora de fin en el almacén hasta la cual se puede realizar una carga (warehouse default closing)
- Hora de inicio de entrega al cliente a partir de la cual se puede realizar una entrega (customer default delivery start)
- Hora de fin de entrega al cliente hasta la cual se puede realizar una entrega (customer default delivery end)
- Luego haga clic en Save.
Paso 4: Crear un presupuesto (quotation) con entrega
4.1 Añadir un cliente (opcional)
- Vaya a Sales > Orders > Quotations
- Haga clic en Create
- Seleccione un cliente existente o cree uno nuevo:
- Introduzca un nombre
- Haga clic en Create and edit
- Complete la dirección de entrega (delivery address) y el número de teléfono móvil (mobile number)
- Haga clic en Save
4.2 Añadir productos
- Haga clic en Order Lines
- Añada los productos a entregar (product to deliver)
4.3 Añadir la entrega
- Haga clic en Add Shipping
- Seleccione el AntsRoute shipping method
- Haga clic en Add y luego en Confirm
Paso 5: Enviar la entrega a AntsRoute
5.1 Configurar las capacidades en AntsRoute
Las capacidades se utilizan para optimizar la carga de los vehículos.
Cree las siguientes capacidades:
- Number (número de artículos)
- Weight (peso en kg)
- Volume (volumen en m³)
Para configurarlas:
- Vaya al módulo Configuración
- Abra la pestaña Capacidades
- Haga clic en « + » (Añadir)
Añadir la capacidad Number
Complete la siguiente información:
- Nombre: Number
- Unidad: Unit
- Modo de validación: opcional
Luego haga clic en Guardar.
Añadir la capacidad Weight
Repita el proceso con la siguiente información:
- Nombre: Weight
- Unidad: Kg
- Modo de validación: opcional
Añadir la capacidad Volume
Repita una última vez con:
- Nombre: Volume
- Unidad: m3
- Modo de validación: opcional
💡 Bueno saber: estas capacidades son utilizadas por AntsRoute para distribuir las entregas según las limitaciones de sus vehículos (peso, volumen, número de artículos).
5.2 Definir las capacidades de los vehículos
- Vaya a Recursos
- Haga clic en Vehículos
- Para cada vehículo, haga clic en … > Editar
- Introduzca las capacidades máximas del vehículo para los siguientes elementos:
- Number
- Weight
- Volume
- Haga clic en Guardar
5.3 Crear campos personalizados
Para recuperar cierta información desde Odoo en AntsRoute, debe crear campos personalizados.
Los campos a añadir son:
- Price
- Description
- Reference
👉 Estos campos permiten transferir automáticamente la información relacionada con los pedidos de Odoo.
Paso 1: Crear una categoría
Antes de añadir los campos, debe crear una categoría:
- Vaya al módulo Configuración
- Haga clic en la pestaña Campos personalizados
- Seleccione la pestaña Entrega
-
Haga clic en Crear una categoría
- Introduzca un nombre (por ejemplo, Campos Odoo)
- Haga clic en Guardar
Ahora puede crear sus campos.
Paso 2: Crear campos personalizados
- Haga clic en Crear un campo
- Introduzca la siguiente información:
Añadir el campo Price
Complete la siguiente información:
- Nombre: Price
- Categoría: seleccione la categoría creada anteriormente
- Tipo: Campo de texto
Añadir el campo Description
Repita los mismos pasos con:
- Nombre: Description
- Tipo: Campo de texto
Añadir el campo Reference
Repita una última vez con:
- Nombre: Reference
- Tipo: Campo de texto
💡 Bueno saber: una vez configurados estos campos, la información correspondiente aparecerá automáticamente en sus entregas de AntsRoute.
5.4 Definir las cantidades a entregar
- Abra la entrega en Odoo
- Haga clic en Edit
- Vaya a la pestaña Operations
- Introduzca las cantidades en el campo Done
- Haga clic en Save
5.5 Enviar la entrega
Haga clic en Request carrier pickup
👉 La entrega se envía automáticamente a AntsRoute.
Información disponible en AntsRoute
Una vez que la entrega se envía desde Odoo a AntsRoute, varias informaciones se transmiten automáticamente y quedan disponibles:
- Reference: corresponde a la referencia de Odoo, incluyendo el quotation number (número de presupuesto) y el stock picking (albarán)
- Description: corresponde a la referencia del producto en Odoo (o al nombre del producto si no se ha definido una referencia)
- Price: corresponde al precio del pedido (order price)
- Weight: indica el peso total de los productos a entregar (número entero positivo)
- Number: indica el número de productos a entregar
👉 Esta información facilita el seguimiento de las entregas y permite a los equipos de campo disponer de todos los datos necesarios.
Paso 6: Seguir el estado de la entrega
Desde Odoo:
- Vaya a Orders > Orders
- Abra un pedido (order)
- Haga clic en Delivery
- Abra la pestaña AntsRoute Information
- Haga clic en Get delivery information
Puede consultar la siguiente información:
- Delivery date = Fecha de entrega
- Status = Estado
- Assigned driver = Conductor asignado
- Customer signature = Firma del cliente
- Photos = Fotos
- Comments = Comentarios
💡 Nota: las fotos están disponibles a través de los archivos adjuntos.
Sincronización de datos
Para cambiar la frecuencia de sincronización:
- Vaya a Settings > General Settings
- Haga clic en Activate the developer mode
- Haga clic en Settings
- Vaya a Technical > Scheduled Actions
- Abra AntsRoute – check delivery information
- Modifique la frecuencia haciendo clic en Edit (arriba a la izquierda) y configure « Execute every … days »
- Haga clic en Save
Conclusión
La integración entre Odoo y AntsRoute le permite gestionar sus entregas de forma fluida, desde la creación del presupuesto hasta el seguimiento final.
Una vez configurada, le ayudará a:
- Ahorrar tiempo en la planificación
- Reducir errores manuales
- Mejorar el seguimiento de las entregas
👉 Si encuentra problemas, verifique primero:
- La clave API
- Las capacidades configuradas
- La información de dirección
🙋 ¿Necesita ayuda?
Si tiene dificultades para configurar la integración, puede ponerse en contacto con el soporte de AntsRoute:
- Por correo electrónico
- O a través del chat disponible directamente en su interfaz web