Integración con Odoo

¿Qué es Odoo?

Odoo es un conjunto de aplicaciones de gestión — CRM, ventas, facturación, inventario y más — disponible como Odoo Online, en Odoo.sh o en un servidor propio. En Odoo, las empresas y sus contactos son ambos partners (res.partner), y la app CRM gestiona leads y oportunidades.

Qué datos se intercambian entre Odoo y Transportial

• ⇄ En ambos sentidos

  Empresas ↔ relaciones comerciales

  Las empresas de Odoo y las relaciones comerciales de Transportial se sincronizan en ambos sentidos. Antes de crear nada, Transportial busca una coincidencia por NIF-IVA, luego por número de registro mercantil, luego por dominio web o de correo y por último por nombre, para que no haya duplicados en ningún lado.

• ⇄ En ambos sentidos

  Contactos ↔ personas de contacto

  Los contactos de una empresa de Odoo se mantienen al día con las personas de contacto de la relación correspondiente.

• ⇄ En ambos sentidos

  Oportunidades ↔ presupuestos

  Cada presupuesto es una oportunidad del CRM en la empresa, y su etapa sigue el estado del presupuesto mediante una correspondencia de etapas que puedes cambiar. Ganada y perdida usan las acciones propias de Odoo. Opcionalmente, marcar una oportunidad como ganada o perdida en Odoo acepta o rechaza el presupuesto; viene desactivado por defecto.

• → Hacia Odoo

  Órdenes de transporte y facturas → notas en el chatter

  Las órdenes de transporte y las facturas enviadas se publican como notas en el chatter de la empresa de Odoo.

Cómo conectar Odoo

1. Comprueba tu plan de Odoo: Odoo solo permite el acceso por su API externa en el plan Custom.

2. En Odoo, crea una clave de API en Preferencias → Seguridad de la cuenta. Las claves de Odoo valen como máximo tres meses, así que apunta cuándo hay que renovarla.

3. Añade la integración de Odoo en Transportial con la URL de tu Odoo y la clave de API. Para versiones de Odoo anteriores a la 19, o un servidor con varias bases de datos, introduce también el nombre de la base de datos y tu usuario.

4. Revisa los valores por defecto: sentido de sincronización por objeto, regla de conflicto (gana el cambio más reciente), correspondencia de etapas de oportunidad, mapeo de campos, si las empresas desconocidas de Odoo se crean como relaciones (activado) y qué tipos de relación se sincronizan.

Frecuencia de sincronización y límites

• Odoo 19 y posteriores se consultan por la API JSON-2; las versiones anteriores, por JSON-RPC.
• Transportial envía sus propios cambios a Odoo y consulta los cambios de Odoo cada 15 minutos.
• El sentido de sincronización se define por objeto; si un registro cambió en ambos lados, por defecto gana el cambio más reciente.
• Lo que Transportial escribió en Odoo nunca se vuelve a importar, así que los cambios no rebotan de un lado a otro.
• Los importes de las oportunidades están en la moneda de la empresa de tu Odoo.

Caso de uso típico

Una empresa de transporte lleva sus ventas en Odoo y su planificación en Transportial. Las empresas y los contactos que se añaden en un sistema aparecen en el otro, emparejados por NIF-IVA para no introducir nada dos veces. Los presupuestos de Transportial aparecen como oportunidades en el embudo de Odoo, y cada orden y factura enviada se publica en el chatter de la empresa, donde todo el equipo comercial la ve.

Preguntas frecuentes