O que a Tickelia diz da sua API
Na sua página inicial em português, a Tickelia diz que «Automatiza integralmente todo o processo de gestão de despesas da empresa, desde o pagamento até à contabilização automática com o ERP, incluindo relatório e gestão de adiantamentos, viagens e liquidação.» Na sua página de integração, descreve a segunda via como uma API com ligações bidirecionais otimizadas entre a solução e o software de gestão. A terceira via são os ficheiros: CSV, TXT, Excel e outros, com os dados que os utilizadores processaram na Tickelia.
O conector traz os dois canais. A API funciona hoje; o SFTP ainda não, e explicamos porquê mais abaixo.
O que precisa para ligar
Peça à Tickelia um utilizador da API (Colaborador), a sua base de dados (BDD) e a respetiva palavra-passe, juntamente com o endereço do seu serviço. Depois, em Tickelia › Configuration › Settings, preencha Service URL, API User, a base de dados e API Password, e carregue em Test Connection. Esse teste abre uma sessão real na Tickelia e lê as suas empresas da Tickelia: só corre bem quando a Tickelia responde com dados.

Tickelia › Configuration › Settings: o URL do serviço, o utilizador da API, a base de dados e a palavra-passe, que fica na FlexigoTech Cloud, com o botão para testar a ligação.Onde fica a palavra-passe
Não no seu Odoo. A palavra-passe é só de escrita: viaja cifrada para a FlexigoTech Cloud, que a guarda no seu cofre e abre com ela a sessão da Tickelia em cada chamada, e nunca fica na sua base de dados. Para a mudar, escreve-a de novo. O URL do serviço, o utilizador e a base de dados ficam, esses sim, no Odoo, em campos que só um administrador vê.
Por isso a única saída do Odoo para a Tickelia é a FlexigoTech Cloud, com a entrada de cada empresa. Sem o serviço da nuvem ativo, o conector para antes de sair o que quer que seja. A ligação passa pelos nossos servidores na Alemanha, e as suas liquidações ficam no seu Odoo.
Como é tratada cada chamada
- Espera
- 45 segundos por chamada.
- Novas tentativas
- Só com um 429, 500, 502, 503 ou 504, até 3 tentativas, com a espera que pedir o Retry-After ou com 2, 4 e 6 segundos.
- Ritmo
- No máximo uma chamada a cada 0,6 segundos por serviço da Tickelia e processo do Odoo.
- Pausa da nuvem
- Nunca se repete: o conector para e vê-se.
Além disso, o conector não dá uma chamada por boa só porque voltou sem erro. Antes de cada passagem verifica a sessão lendo as suas empresas da Tickelia, e volta a verificá-la depois de cada confirmação.
Cada chamada deixa uma linha em Tickelia › Configuration › Sync Log, com o método e o estado, e nunca com uma credencial.

Tickelia › Configuration › Sync Log: uma contabilização da recuperação de IVA, concluída, com um registo, o seu modelo do Odoo e zero erros.Ler sem marcar, confirmar e reler
A importação não marca nada na Tickelia: o conector lê o que está pendente e deixa-o como estava. Só quando o Odoo contabilizou uma liquidação, ou pagou um adiantamento, pede à Tickelia que a marque como contabilizada. Depois volta a ler as pendentes e só regista a marca se o documento já lá não estiver.
Testámo-lo a 19/11/2026 numa conta real da Tickelia: o número do lançamento ficou escrito na despesa e a liquidação saiu das pendentes. A única coisa que a Tickelia não confirmou foi o e-mail ao funcionário.
A API também trabalha no outro sentido. Em Tickelia › Actions › Push Master Data envia à Tickelia centros de custo, projetos e os dados dos funcionários que já têm utilizador na Tickelia.
O que não faz
Não é em tempo real: a importação agendada corre a cada 4 horas nas empresas que a ligam, ou quando a lança em Tickelia › Actions › Import from Tickelia. A Tickelia não envia avisos; o webhook do Odoo importa uma liquidação pelo seu número quando a sua própria automatização o chama.
Também não cria utilizadores na Tickelia nem carrega taxas de IVA ou formas de pagamento. Só se liga a um serviço em tickelia.com, por HTTPS e na porta padrão.
Perguntas sobre a API da Tickelia e o Odoo
O SFTP funciona?
Ainda não. A FlexigoTech Cloud só se liga aos servidores SFTP da Tickelia da sua lista, e essa lista fica vazia até a Tickelia nos confirmar os seus endereços e as impressões digitais das chaves. A API, essa, funciona.
Quanto custa?
O módulo custa 9 € por versão do Odoo na Odoo Apps. Funciona com a FlexigoTech Cloud, a partir de 49 €/mês: plano Conector Standard a 49 €/mês ou 490 €/ano, ou Pro a 98 €/mês ou 980 €/ano, sem IVA. O período de teste é de 14 dias, grátis e sem cartão. Inclui 2 meses de suporte para o pôr a funcionar e, enquanto mantiver a subscrição, as atualizações e o suporte, segundo as condições de venda 2.2. Está tudo na página do conector Tickelia.
Em que versões do Odoo funciona?
No Odoo 17, 18, 19 e 20 com Despesas e Contabilidade, no Odoo.sh ou no seu próprio servidor. Não funciona no Odoo Online. A sua conta Tickelia com acesso à API e as respetivas tarifas são à parte.
Continue a ler
Verificado no código do conector (versão 20.0) e nas fontes indicadas
Fontes
- Código do módulo: flexigo_tickelia_connector 20.0 (840deb1b): models/tickelia_api_client.py:185
- Código do módulo: flexigo_tickelia_connector 20.0 (840deb1b): models/res_company.py:99
- Código do módulo: flexigo_tickelia_connector 20.0 (840deb1b): models/tickelia_api_client.py:62
- Código do módulo: flexigo_tickelia_connector 20.0 (840deb1b): models/tickelia_api_client.py:68
- Código do módulo: flexigo_tickelia_connector 20.0 (840deb1b): models/tickelia_api_client.py:238
- Código do módulo: flexigo_tickelia_connector 20.0 (840deb1b): models/tickelia_api_client.py:15
- Código do módulo: flexigo_tickelia_connector 20.0 (840deb1b): models/tickelia_api_client.py:20
- Código do módulo: flexigo_tickelia_connector 20.0 (840deb1b): models/tickelia_api_client.py:151
- Código do módulo: flexigo_tickelia_connector 20.0 (840deb1b): views/res_config_settings_views.xml:86
- Código do módulo: flexigo_tickelia_connector 20.0 (840deb1b): models/res_company.py:202
- Código do módulo: flexigo_tickelia_connector 20.0 (840deb1b): static/description/index.html
- Código do módulo: flexigo_tickelia_connector 20.0 (840deb1b): views/menu.xml
- Código do módulo: flexigo_tickelia_connector 20.0 (840deb1b): data/tickelia_cron_data.xml
- tickelia.com/integracion/
- flexigotech.com/pt/conector-tickelia-odoo.html
- Teste real da FlexigoTech numa conta Tickelia (19-11-2026)
- tickelia.com/
- tickelia.com/en/
- tickelia.com/ca/
- tickelia.com/de/
- tickelia.com/fr/
- tickelia.com/pt/
- tickelia.com/pl/
