Saltar al contenido principal
Tickelia

Tickelia API: lo que hace con ella el conector de Odoo, de la contraseña al registro de llamadas

Tickelia cuenta en su página de integración que se conecta con los ERP de tres maneras: con conectores de los principales fabricantes, por API y por ficheros. Odoo no aparece en esa lista. El conector de FlexigoTech usa la API, y aquí contamos qué pide, dónde guarda las credenciales y cómo trata cada llamada.

FlexigoTech · Responsable: Víctor Gómez · Actualizado el 20 de noviembre de 2026

Lo esencial

Módulo
Tickelia
Versiones
Odoo 17, 18, 19 y 20
Comprobado
en el código del conector, versión 20.0 · en las fuentes enlazadas al final
Lectura
4 min

Lo que dice Tickelia de su API

En su página de integración, Tickelia describe la segunda vía así: «Mediante API con conexiones bidireccionales optimizadas entre la solución y el software de gestión.» La tercera son los ficheros: «Por ficheros CSV, TXT, Excel, etc. con los datos procesados en Tickelia por los usuarios.»

El conector trae los dos canales. La API funciona hoy; el SFTP todavía no, y lo explicamos más abajo.

Qué necesitas para conectar

Pide a Tickelia un usuario de la API (Colaborador), tu base de datos (BDD) y su contraseña, junto con la dirección de tu servicio. Después, en Tickelia › Configuración › Ajustes, rellena URL del servicio, Usuario de la API, Base de datos y Contraseña de la API, y pulsa Probar conexión. Esa prueba abre una sesión real con Tickelia y lee tus empresas de Tickelia: solo sale bien cuando Tickelia responde con datos.

Ajustes de la API de Tickelia en Odoo
Tickelia › Configuración › Ajustes: la URL del servicio, el usuario de la API, la base de datos y la contraseña, que se guarda en FlexigoTech Cloud, con el botón para probar la conexión.

Dónde se guarda la contraseña

No en tu Odoo. La contraseña es de solo escritura: viaja cifrada a FlexigoTech Cloud, que la guarda en su bóveda y abre con ella la sesión de Tickelia en cada llamada, y nunca se queda en tu base de datos. Para cambiarla, la escribes de nuevo. La URL del servicio, el usuario y la base de datos sí se quedan en Odoo, en campos que solo ve un administrador.

Por eso la única salida de Odoo hacia Tickelia es FlexigoTech Cloud, con la entrada de cada compañía. Sin el servicio de la nube activo, el conector se para antes de que salga nada. La conexión pasa por nuestros servidores de Alemania, y tus liquidaciones se quedan en tu Odoo.

Cómo trata cada llamada

Espera
45 segundos por llamada.
Reintentos
Solo un 429, 500, 502, 503 o 504, hasta 3 intentos, con la espera que pida Retry-After o con 2, 4 y 6 segundos.
Ritmo
Como mucho una llamada cada 0,6 segundos por servicio de Tickelia y proceso de Odoo.
Pausa de la nube
Nunca se reintenta: se para y se ve.

Además, el conector no da una llamada por buena solo porque vuelva sin error. Antes de cada pasada comprueba la sesión leyendo tus empresas de Tickelia, y vuelve a comprobarla después de cada confirmación.

Cada llamada deja una línea en Tickelia › Configuración › Registro de sincronización, con el método y el estado, y nunca con una credencial.

Una entrada del registro de sincronización de Tickelia
Tickelia › Configuración › Registro de sincronización: una contabilización de la recuperación de IVA, hecha, con un registro, su modelo de Odoo y cero errores.

Leer sin marcar, confirmar y releer

Importar no marca nada en Tickelia: el conector lee lo pendiente y lo deja como estaba. Solo cuando Odoo ha contabilizado una liquidación, o ha pagado un anticipo, pide a Tickelia que la marque como contabilizada. Después relee las pendientes y solo apunta la marca si el documento ya no está.

Lo probamos el 19-11-2026 contra una cuenta real de Tickelia: el número del asiento quedó escrito en el gasto y la liquidación salió de las pendientes. Lo único que Tickelia no confirmó fue el correo al empleado.

La API trabaja también en el otro sentido. Desde Tickelia › Acciones › Enviar datos maestros mandas a Tickelia centros de coste, proyectos y los datos de los empleados que ya tienen usuario en Tickelia.

Lo que no hace

No es en tiempo real: la importación programada corre cada 4 horas en las compañías que la encienden, o cuando la lanzas tú desde Tickelia › Acciones › Importar desde Tickelia. Tickelia no envía avisos; el webhook de Odoo importa una liquidación por su número cuando lo llama tu propia automatización.

Tampoco crea usuarios en Tickelia ni carga tipos de IVA o formas de pago. Solo se conecta a un servicio bajo tickelia.com, por HTTPS y en el puerto estándar.

Preguntas sobre la API de Tickelia y Odoo

¿Funciona el SFTP?

Todavía no. FlexigoTech Cloud solo se conecta a los servidores SFTP de Tickelia de su lista, y esa lista está vacía hasta que Tickelia nos confirme sus direcciones y sus huellas. La API sí funciona.

¿Cuánto cuesta?

El módulo cuesta 9 € por versión de Odoo en Odoo Apps. Funciona con FlexigoTech Cloud, desde 49 €/mes: plan Conector Estándar a 49 €/mes o 490 €/año, o Pro a 98 €/mes o 980 €/año, sin IVA. La prueba es de 14 días, gratis y sin tarjeta. Incluye 2 meses de soporte para dejarlo en marcha y, mientras sigas suscrito, las actualizaciones y el soporte, según las condiciones de contratación 2.2. Todo está en la página del conector de Tickelia.

¿En qué versiones de Odoo funciona?

En Odoo 17, 18, 19 y 20 con Gastos y Contabilidad, en Odoo.sh o en tu propio servidor. No funciona en Odoo Online. Tu cuenta de Tickelia con acceso a su API y sus tarifas van aparte.

Sigue leyendo

Notas de gastos de Tickelia en Odoo, paso a paso: de la liquidación al asiento contableCómo pasan las notas de gastos de Tickelia a la contabilidad de Odoo: importar, asociar tipos e IVA, validar, contabilizar y avisar a Tickelia.Tickelia, kilometraje y dietas en Odoo: lo que pasa con una línea que llega sin importeQué hace el conector de Odoo con un kilometraje o una dieta de Tickelia que llega sin importe, y cómo se contabiliza si hay que pagarlo.Tickelia y la tarjeta de empresa en Odoo: un caso de tres gastos y quién paga cada unoUna liquidación de Tickelia con un gasto pagado con la tarjeta de empresa y dos del empleado: cuánto se reembolsa en Odoo y qué lo decide.Tickelia, qué es y qué es cada cosa de Tickelia en Odoo: un glosario para contablesQué es Tickelia y qué significa cada término (liquidación, informe, anticipo, factura de canje, Colaborador y BDD) cuando se conecta con Odoo.
Comprobado en el código del conector (versión 20.0) y en las fuentes enlazadas

Fuentes

  • Código del módulo: flexigo_tickelia_connector 20.0 (840deb1b): models/tickelia_api_client.py:185
  • Código del módulo: flexigo_tickelia_connector 20.0 (840deb1b): models/res_company.py:99
  • Código del módulo: flexigo_tickelia_connector 20.0 (840deb1b): models/tickelia_api_client.py:62
  • Código del módulo: flexigo_tickelia_connector 20.0 (840deb1b): models/tickelia_api_client.py:68
  • Código del módulo: flexigo_tickelia_connector 20.0 (840deb1b): models/tickelia_api_client.py:238
  • Código del módulo: flexigo_tickelia_connector 20.0 (840deb1b): models/tickelia_api_client.py:15
  • Código del módulo: flexigo_tickelia_connector 20.0 (840deb1b): models/tickelia_api_client.py:20
  • Código del módulo: flexigo_tickelia_connector 20.0 (840deb1b): models/tickelia_api_client.py:151
  • Código del módulo: flexigo_tickelia_connector 20.0 (840deb1b): views/res_config_settings_views.xml:86
  • Código del módulo: flexigo_tickelia_connector 20.0 (840deb1b): models/res_company.py:202
  • Código del módulo: flexigo_tickelia_connector 20.0 (840deb1b): static/description/index.html
  • Código del módulo: flexigo_tickelia_connector 20.0 (840deb1b): views/menu.xml
  • Código del módulo: flexigo_tickelia_connector 20.0 (840deb1b): data/tickelia_cron_data.xml
  • tickelia.com/integracion/
  • flexigotech.com/conector-tickelia-odoo.html
  • Prueba real de FlexigoTech contra una cuenta de Tickelia (19-11-2026)
  • flexigotech.com/condiciones-contratacion.html
  • tickelia.com/
  • tickelia.com/en/
  • tickelia.com/ca/
  • tickelia.com/de/
  • tickelia.com/fr/
  • tickelia.com/pt/
  • tickelia.com/pl/