Przejdź do głównej treści
Tickelia

Tickelia API: co robi z nim konektor Odoo, od hasła po dziennik wywołań

Tickelia wyjaśnia na swojej stronie o integracji, po hiszpańsku, że łączy się z systemami ERP na trzy sposoby: przez konektory głównych producentów, przez swoje API i przez pliki. Odoo nie ma na tej liście. Konektor FlexigoTech korzysta z API, a tutaj opisujemy, czego wymaga, gdzie trzyma dane logowania i jak obsługuje każde wywołanie.

FlexigoTech · Odpowiada: Víctor Gómez · Aktualizacja: 20 listopada 2026

Najważniejsze

Moduł
Tickelia
Wersje
Odoo 17, 18, 19 i 20
Sprawdzone
w kodzie źródłowym konektora, wersja 20.0 · w źródłach podanych na końcu
Czas czytania
4 min

Co Tickelia mówi o swoim API

Na swojej polskiej stronie głównej Tickelia obiecuje całą drogę: «od płatności po automatyczną księgowość w ERP». Na stronie o integracji opisuje drugą drogę jako API ze zoptymalizowanymi połączeniami w obie strony między swoim rozwiązaniem a oprogramowaniem do zarządzania. Trzecia droga to pliki: CSV, TXT, Excel i podobne, z danymi, które użytkownicy przetworzyli w Tickelia.

Konektor ma oba kanały. API działa już dziś; SFTP jeszcze nie, co wyjaśniamy niżej.

Czego potrzebujesz do połączenia

Poproś Tickelia o użytkownika API (Colaborador), swoją bazę danych (BDD) i jej hasło, a także o adres swojej usługi. Potem w Tickelia › Configuration › Settings wypełnij Service URL, API User, bazę danych i API Password, i kliknij Test Connection. Ten test otwiera prawdziwą sesję w Tickelia i czyta Twoje firmy w Tickelia: udaje się tylko wtedy, gdy Tickelia odpowiada danymi.

Ustawienia API Tickelia w Odoo
Tickelia › Configuration › Settings: adres URL usługi, użytkownik API, baza danych i hasło, które jest przechowywane w FlexigoTech Cloud, z przyciskiem do testu połączenia.

Gdzie jest hasło

Nie w Twoim Odoo. Hasło jest tylko do zapisu: trafia zaszyfrowane do FlexigoTech Cloud, który trzyma je w swoim sejfie i przy każdym wywołaniu otwiera nim sesję w Tickelia, i nigdy nie zostaje w Twojej bazie danych. Żeby je zmienić, wpisujesz je ponownie. Adres URL usługi, użytkownik i baza danych zostają natomiast w Odoo, w polach, które widzi tylko administrator.

Dlatego jedyna droga z Odoo do Tickelia prowadzi przez FlexigoTech Cloud, z wpisem każdej firmy. Bez aktywnej usługi w chmurze konektor zatrzymuje się, zanim cokolwiek wyjdzie. Połączenie idzie przez nasze serwery w Niemczech, a Twoje rozliczenia zostają w Twoim Odoo.

Jak obsługiwane jest każde wywołanie

Oczekiwanie
45 sekund na wywołanie.
Ponowienia
Tylko przy 429, 500, 502, 503 lub 504, do 3 prób, z czasem oczekiwania, którego żąda Retry-After, albo 2, 4 i 6 sekund.
Tempo
Najwyżej jedno wywołanie co 0,6 sekundy na usługę Tickelia i proces Odoo.
Pauza chmury
Nigdy nie jest ponawiana: konektor się zatrzymuje i to widać.

Co więcej, konektor nie uznaje wywołania za udane tylko dlatego, że wróciło bez błędu. Przed każdym przebiegiem sprawdza sesję, czytając Twoje firmy w Tickelia, i sprawdza ją ponownie po każdym potwierdzeniu.

Każde wywołanie zostawia wiersz w Tickelia › Configuration › Sync Log, z metodą i statusem, i nigdy z danymi logowania.

Wpis w dzienniku synchronizacji Tickelia
Tickelia › Configuration › Sync Log: księgowanie z odzyskiwania VAT, zakończone, z jednym rekordem, jego modelem Odoo i zerem błędów.

Czytanie bez oznaczania, potwierdzenie i ponowny odczyt

Import niczego nie oznacza w Tickelia: konektor czyta to, co oczekuje, i zostawia to bez zmian. Dopiero gdy Odoo zaksięguje rozliczenie albo opłaci zaliczkę, prosi Tickelia o oznaczenie go jako zaksięgowanego. Potem ponownie czyta listę oczekujących i zapisuje oznaczenie tylko wtedy, gdy dokumentu już na niej nie ma.

Przetestowaliśmy to 19.11.2026 na prawdziwym koncie Tickelia: numer zapisu dziennika został wpisany w wydatek, a rozliczenie zniknęło z oczekujących. Jedyne, czego Tickelia nie potwierdziła, to e-mail do pracownika.

API działa też w drugą stronę. Z Tickelia › Actions › Push Master Data wysyłasz do Tickelia centra kosztów, projekty i dane pracowników, którzy mają już użytkownika w Tickelia.

Czego nie robi

Nie działa w czasie rzeczywistym: zaplanowany import idzie co 4 godziny w firmach, które go włączą, albo wtedy, gdy uruchomisz go z Tickelia › Actions › Import from Tickelia. Tickelia nie wysyła powiadomień; webhook w Odoo importuje rozliczenie po jego numerze, kiedy wywoła go Twoja własna automatyzacja.

Nie zakłada też użytkowników w Tickelia ani nie wgrywa stawek VAT czy metod płatności. Łączy się tylko z usługą pod tickelia.com, przez HTTPS i na standardowym porcie.

Pytania o API Tickelia i Odoo

Czy SFTP działa?

Jeszcze nie. FlexigoTech Cloud łączy się tylko z serwerami SFTP Tickelia ze swojej listy, a ta lista jest pusta, dopóki Tickelia nie potwierdzi nam ich adresów i odcisków kluczy. API działa.

Ile to kosztuje?

Moduł kosztuje 9 € za wersję Odoo w Odoo Apps. Działa z FlexigoTech Cloud, od 49 €/mies.: plan Konektor Standard za 49 €/mies. lub 490 €/rok albo Pro za 98 €/mies. lub 980 €/rok, bez VAT. Okres próbny trwa 14 dni, za darmo i bez karty. Obejmuje 2 miesiące wsparcia przy uruchomieniu oraz, dopóki masz subskrypcję, aktualizacje i wsparcie, zgodnie z warunkami sprzedaży 2.2. Wszystko jest na stronie konektora Tickelia.

Z którymi wersjami Odoo działa?

Z Odoo 17, 18, 19 i 20 z aplikacjami Wydatki i Księgowość, na Odoo.sh lub na własnym serwerze. Nie działa w Odoo Online. Konto Tickelia z dostępem do API i opłaty za Tickelia są osobno.

Czytaj dalej

Rozliczenia wydatków Tickelia w Odoo krok po kroku: od rozliczenia do zapisu dziennikaJak rozliczenia wydatków z Tickelia trafiają do księgowości Odoo: import, przypisanie rodzajów i VAT, walidacja, księgowanie i potwierdzenie w Tickelia.Tickelia, kilometrówka i diety w Odoo: co się dzieje z pozycją, która przychodzi bez kwotyCo konektor Odoo robi z pozycją kilometrówki lub diety z Tickelia, która przychodzi bez kwoty, i jak ją zaksięgować, jeśli trzeba ją zapłacić.Tickelia i karta firmowa w Odoo: przypadek trzech wydatków i kto za który zapłaciłRozliczenie Tickelia z jednym wydatkiem opłaconym kartą firmową i dwoma opłaconymi przez pracownika: ile zwraca Odoo i co o tym decyduje.Co to jest Tickelia i czym jest w Odoo każde pojęcie z Tickelia: słowniczek dla księgowychCo to jest Tickelia i co znaczy każde z jej pojęć (rozliczenie, raport, zaliczka, faktura w zamian za paragon, Colaborador i BDD) po połączeniu z Odoo.
Sprawdzone w kodzie źródłowym konektora (wersja 20.0) i w podlinkowanych źródłach

Źródła

  • Kod modułu: flexigo_tickelia_connector 20.0 (840deb1b): models/tickelia_api_client.py:185
  • Kod modułu: flexigo_tickelia_connector 20.0 (840deb1b): models/res_company.py:99
  • Kod modułu: flexigo_tickelia_connector 20.0 (840deb1b): models/tickelia_api_client.py:62
  • Kod modułu: flexigo_tickelia_connector 20.0 (840deb1b): models/tickelia_api_client.py:68
  • Kod modułu: flexigo_tickelia_connector 20.0 (840deb1b): models/tickelia_api_client.py:238
  • Kod modułu: flexigo_tickelia_connector 20.0 (840deb1b): models/tickelia_api_client.py:15
  • Kod modułu: flexigo_tickelia_connector 20.0 (840deb1b): models/tickelia_api_client.py:20
  • Kod modułu: flexigo_tickelia_connector 20.0 (840deb1b): models/tickelia_api_client.py:151
  • Kod modułu: flexigo_tickelia_connector 20.0 (840deb1b): views/res_config_settings_views.xml:86
  • Kod modułu: flexigo_tickelia_connector 20.0 (840deb1b): models/res_company.py:202
  • Kod modułu: flexigo_tickelia_connector 20.0 (840deb1b): static/description/index.html
  • Kod modułu: flexigo_tickelia_connector 20.0 (840deb1b): views/menu.xml
  • Kod modułu: flexigo_tickelia_connector 20.0 (840deb1b): data/tickelia_cron_data.xml
  • tickelia.com/integracion/
  • flexigotech.com/pl/integracja-tickelia-odoo.html
  • Test FlexigoTech na prawdziwym koncie Tickelia (19-11-2026)
  • tickelia.com/
  • tickelia.com/en/
  • tickelia.com/ca/
  • tickelia.com/de/
  • tickelia.com/fr/
  • tickelia.com/pt/
  • tickelia.com/pl/