Saltar para o conteúdo principal
Tickelia

Tickelia API: o que o conector do Odoo faz com ela, da palavra-passe ao registo de chamadas

A Tickelia explica na sua página de integração, em espanhol, que se liga aos ERP de três formas: com conectores dos principais fabricantes, por API e por ficheiros. O Odoo não aparece nessa lista. O conector da FlexigoTech usa a API, e aqui contamos o que pede, onde guarda as credenciais e como trata cada chamada.

FlexigoTech · Responsável: Víctor Gómez · Atualizado em 20 de novembro de 2026

O essencial

Módulo
Tickelia
Versões
Odoo 17, 18, 19 e 20
Verificado
no código do conector, versão 20.0 · nas fontes indicadas no fim
Leitura
5 min

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.

Definições da API da Tickelia no Odoo
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.

Uma entrada do registo de sincronização da Tickelia
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

Notas de despesas da Tickelia no Odoo, passo a passo: da liquidação ao lançamento de diárioComo as notas de despesas da Tickelia chegam à contabilidade do Odoo: importar, associar tipos e IVA, validar, contabilizar e avisar a Tickelia.Tickelia, quilometragem e ajudas de custo no Odoo: o que acontece a uma linha que chega sem valorO que o conector do Odoo faz com uma linha de quilometragem ou ajudas de custo da Tickelia sem valor, e como a contabilizar se tiver de a pagar.Tickelia e o cartão da empresa no Odoo: um caso de três despesas e quem pagou cada umaUma liquidação da Tickelia com uma despesa paga com o cartão da empresa e duas pagas pelo funcionário: quanto o Odoo reembolsa e o que o decide.O que é Tickelia, e o que é cada termo da Tickelia no Odoo: um glossário para contabilistasO que é a Tickelia e o que significa no Odoo cada um dos seus termos: liquidação, relatório, adiantamento, fatura de troca, Colaborador e BDD.
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/