Salta al contingut principal
Tickelia

Tickelia API: què en fa el connector d'Odoo, de la contrasenya al registre de crides

Tickelia explica a la seva pàgina d'integració, en castellà, que es connecta amb els ERP de tres maneres: amb connectors dels principals fabricants, per API i per fitxers. Odoo no surt en aquesta llista. El connector de FlexigoTech fa servir l'API, i aquí expliquem què demana, on guarda les credencials i com tracta cada crida.

FlexigoTech · Responsable: Víctor Gómez · Actualitzat el 20 de novembre de 2026

L'essencial

Mòdul
Tickelia
Versions
Odoo 17, 18, 19 i 20
Comprovat
al codi del connector, versió 20.0 · a les fonts enllaçades al final
Lectura
4 min

El que diu Tickelia de la seva API

A la seva portada en català, Tickelia diu que «Automatitza íntegrament tot el procés de gestió de despeses d’empresa, des del pagament fins a la comptabilització automàtica amb l’ERP, passant per l’informe, la gestió de bestretes, els viatges i la liquidació.» A la seva pàgina d'integració, descriu la segona via com una API amb connexions bidireccionals optimitzades entre la solució i el programari de gestió. La tercera són els fitxers: CSV, TXT, Excel i semblants, amb les dades que els usuaris han processat a Tickelia.

El connector porta els dos canals. L'API funciona avui; l'SFTP encara no, i ho expliquem més avall.

Què necessites per connectar

Demana a Tickelia un usuari de l'API (Colaborador), la teva base de dades (BDD) i la seva contrasenya, juntament amb l'adreça del teu servei. Després, a Tickelia › Configuration › Settings, omple Service URL, API User, la base de dades i API Password, i prem Test Connection. Aquesta prova obre una sessió real amb Tickelia i llegeix les teves empreses de Tickelia: només surt bé quan Tickelia respon amb dades.

Ajustos de l'API de Tickelia a Odoo
Tickelia › Configuration › Settings: la URL del servei, l'usuari de l'API, la base de dades i la contrasenya, que es guarda a FlexigoTech Cloud, amb el botó per provar la connexió.

On es guarda la contrasenya

No al teu Odoo. La contrasenya és només d'escriptura: viatja xifrada a FlexigoTech Cloud, que la guarda a la seva caixa forta i hi obre la sessió de Tickelia a cada crida, i mai no es queda a la teva base de dades. Per canviar-la, l'escrius de nou. La URL del servei, l'usuari i la base de dades sí que es queden a Odoo, en camps que només veu un administrador.

Per això l'única sortida d'Odoo cap a Tickelia és FlexigoTech Cloud, amb l'entrada de cada empresa. Sense el servei del núvol actiu, el connector s'atura abans que surti res. La connexió passa pels nostres servidors d'Alemanya, i les teves liquidacions es queden al teu Odoo.

Com tracta cada crida

Espera
45 segons per crida.
Reintents
Només un 429, 500, 502, 503 o 504, fins a 3 intents, amb l'espera que demani Retry-After o amb 2, 4 i 6 segons.
Ritme
Com a molt una crida cada 0,6 segons per servei de Tickelia i procés d'Odoo.
Pausa del núvol
No es reintenta mai: s'atura i es veu.

A més, el connector no dona una crida per bona només perquè torni sense error. Abans de cada passada comprova la sessió llegint les teves empreses de Tickelia, i la torna a comprovar després de cada confirmació.

Cada crida deixa una línia a Tickelia › Configuration › Sync Log, amb el mètode i l'estat, i mai amb una credencial.

Una entrada del registre de sincronització de Tickelia
Tickelia › Configuration › Sync Log: una comptabilització de la recuperació d'IVA, feta, amb un registre, el seu model d'Odoo i zero errors.

Llegir sense marcar, confirmar i rellegir

Importar no marca res a Tickelia: el connector llegeix el que està pendent i ho deixa com estava. Només quan Odoo ha comptabilitzat una liquidació, o ha pagat una bestreta, demana a Tickelia que la marqui com a comptabilitzada. Després rellegeix les pendents i només apunta la marca si el document ja no hi és.

Ho vam provar el 19/11/2026 amb un compte real de Tickelia: el número de l'assentament va quedar escrit a la despesa i la liquidació va sortir de les pendents. L'única cosa que Tickelia no va confirmar va ser el correu a l'empleat.

L'API també treballa en l'altre sentit. Des de Tickelia › Actions › Push Master Data envies a Tickelia centres de cost, projectes i les dades dels empleats que ja tenen usuari a Tickelia.

El que no fa

No és en temps real: la importació programada corre cada 4 hores a les empreses que l'activen, o quan la llances tu des de Tickelia › Actions › Import from Tickelia. Tickelia no envia avisos; el webhook d'Odoo importa una liquidació pel seu número quan el crida la teva pròpia automatització.

Tampoc no crea usuaris a Tickelia ni hi carrega tipus d'IVA o formes de pagament. Només es connecta a un servei sota tickelia.com, per HTTPS i al port estàndard.

Preguntes sobre l'API de Tickelia i Odoo

Funciona l'SFTP?

Encara no. FlexigoTech Cloud només es connecta als servidors SFTP de Tickelia de la seva llista, i aquesta llista és buida fins que Tickelia ens confirmi les seves adreces i les seves empremtes. L'API sí que funciona.

Quant costa?

El mòdul costa 9 € per versió d'Odoo a Odoo Apps. Funciona amb FlexigoTech Cloud, des de 49 €/mes: pla Connector Estàndard a 49 €/mes o 490 €/any, o Pro a 98 €/mes o 980 €/any, sense IVA. La prova és de 14 dies, gratis i sense targeta. Inclou 2 mesos de suport per deixar-lo en marxa i, mentre continuïs subscrit, les actualitzacions i el suport, segons les condicions de contractació 2.2. Tot és a la pàgina del connector de Tickelia.

En quines versions d'Odoo funciona?

A Odoo 17, 18, 19 i 20 amb Despeses i Comptabilitat, a Odoo.sh o al teu propi servidor. No funciona a Odoo Online. El teu compte de Tickelia amb accés a la seva API i les tarifes de Tickelia van a part.

Continua llegint

Notes de despeses de Tickelia a Odoo, pas a pas: de la liquidació a l'assentament comptableCom arriben les notes de despeses de Tickelia a la comptabilitat d'Odoo: importar, associar tipus i IVA, validar, comptabilitzar i avisar Tickelia.Tickelia, quilometratge i dietes a Odoo: què passa amb una línia que arriba sense importQuè fa el connector d'Odoo amb una línia de quilometratge o de dieta de Tickelia que arriba sense import, i com comptabilitzar-la si s'ha de pagar.Tickelia i la targeta d'empresa a Odoo: un cas de tres despeses i qui va pagar cadascunaUna liquidació de Tickelia amb una despesa pagada amb la targeta d'empresa i dues de l'empleat: quant reemborsa Odoo i què ho decideix.Què és Tickelia, i què és cada terme de Tickelia a Odoo: un glossari per a comptablesQuè és Tickelia i què vol dir cadascun dels seus termes (liquidació, informe, bestreta, factura de bescanvi, Colaborador i BDD) quan es connecta amb Odoo.
Comprovat al codi del connector (versió 20.0) i a les fonts enllaçades

Fonts

  • Codi del mòdul: flexigo_tickelia_connector 20.0 (840deb1b): models/tickelia_api_client.py:185
  • Codi del mòdul: flexigo_tickelia_connector 20.0 (840deb1b): models/res_company.py:99
  • Codi del mòdul: flexigo_tickelia_connector 20.0 (840deb1b): models/tickelia_api_client.py:62
  • Codi del mòdul: flexigo_tickelia_connector 20.0 (840deb1b): models/tickelia_api_client.py:68
  • Codi del mòdul: flexigo_tickelia_connector 20.0 (840deb1b): models/tickelia_api_client.py:238
  • Codi del mòdul: flexigo_tickelia_connector 20.0 (840deb1b): models/tickelia_api_client.py:15
  • Codi del mòdul: flexigo_tickelia_connector 20.0 (840deb1b): models/tickelia_api_client.py:20
  • Codi del mòdul: flexigo_tickelia_connector 20.0 (840deb1b): models/tickelia_api_client.py:151
  • Codi del mòdul: flexigo_tickelia_connector 20.0 (840deb1b): views/res_config_settings_views.xml:86
  • Codi del mòdul: flexigo_tickelia_connector 20.0 (840deb1b): models/res_company.py:202
  • Codi del mòdul: flexigo_tickelia_connector 20.0 (840deb1b): static/description/index.html
  • Codi del mòdul: flexigo_tickelia_connector 20.0 (840deb1b): views/menu.xml
  • Codi del mòdul: flexigo_tickelia_connector 20.0 (840deb1b): data/tickelia_cron_data.xml
  • tickelia.com/integracion/
  • flexigotech.com/ca/connector-tickelia-odoo.html
  • Prova real de FlexigoTech contra un compte de Tickelia (19-11-2026)
  • tickelia.com/
  • tickelia.com/en/
  • tickelia.com/ca/
  • tickelia.com/de/
  • tickelia.com/fr/
  • tickelia.com/pt/
  • tickelia.com/pl/