Czego wymaga Billbee
Według centrum pomocy Billbee, po niemiecku, Billbee API potrzebuje klucza API aplikacji, a do tego twojej nazwy użytkownika Billbee i specjalnego hasła API, które identyfikuje cię jako sprzedawcę. To hasło musi mieć co najmniej 12 znaków i nie może zawierać dwukropka. Billbee dodaje, że dostęp do API nie ma żadnych ograniczeń dostępu.
Od 1 listopada 2025, według strony o cenach API, pierwsze 100 000 wywołań miesięcznie pozostaje bezpłatne dla każdego połączenia lub narzędzia. Każde narzędzie dostaje dokładnie jeden klucz API, a faktura zawsze trafia do właściciela połączenia.
Klucz należy do FlexigoTech, a twoje dane logowania trafiają do FlexigoTech Cloud
Ponieważ Billbee wydaje jeden klucz na narzędzie, klucz konektora należy do FlexigoTech. Każde wywołanie z twojego Odoo do Billbee przechodzi przez FlexigoTech Cloud, na naszych serwerach w Niemczech. Tam do wywołania dochodzą twoja nazwa użytkownika i hasło API, przechowywane w postaci zaszyfrowanej, razem z tym kluczem. Wywołanie wychodzi tylko wtedy, gdy masz aktywny okres próbny lub aktywną subskrypcję FlexigoTech Cloud.
Pole Hasło API można tylko zapisać i nie jest ono przechowywane w Odoo. Gdy zapisujesz je na koncie w Billbee › Konfiguracja › Konta, twoja nazwa użytkownika, która zostaje w rekordzie, i hasło trafiają razem do FlexigoTech Cloud. Wcześniej zaznaczasz, że akceptujesz, iż FlexigoTech Cloud przechowuje twoje dane logowania do Billbee i że wywołania przez nie przechodzą. Pomoc pola przypomina, że chodzi o hasło API, oddzielne od hasła logowania, mające co najmniej 12 znaków i bez dwukropka.

Billbee › Konfiguracja › Konta: połączone konto, z danymi logowania zapisanymi w FlexigoTech Cloud i datą ostatniego testu.Testowanie połączenia
Przetestuj połączenie odczytuje z Billbee jedną stronę z jednym zamówieniem. Jeśli Billbee odpowie, konto przechodzi na Połączono, zapisuje datę testu, a rekord sam się przeładowuje. Jeśli odpowie 401 lub 403, konto przechodzi na Błąd uwierzytelniania i prosi o sprawdzenie nazwy użytkownika i hasła API.
Tylko administrator Odoo może wywoływać Billbee tymi danymi logowania. Zaplanowane zadania, powiadomienie o zamówieniach i przesyłka wysyłana przy zatwierdzaniu dostawy wywołują jako system. Jeśli zarchiwizujesz konto, Odoo przestaje nim wywoływać Billbee: to przełącznik, który zatrzymuje wszystko.
Limit wywołań: pytać tylko o to, co się zmieniło
Żeby zużywać mało wywołań, każdy przebieg zamówień pyta tylko o zamówienia zmienione od poprzedniego, a zadanie stanów wysyła tylko produkty, których liczba się zmieniła, do 100 na wywołanie. Konektor nie liczy wywołań: wywołanie zużycia Billbee jest w jego kodzie, ale nie używa go żaden ekran ani żadne zadanie. Wywołania i tak trafiają do Billbee › Dziennik synchronizacji, z metodą, ścieżką, kodem odpowiedzi i milisekundami.
Gdy coś się nie uda
Jeśli Billbee odpowie 429, za dużo wywołań, Odoo ponawia do 5 razy, czekając tyle, ile prosi Billbee, albo czas, który podwaja się przy każdej próbie, za każdym razem najwyżej 300 sekund. Błąd 5xx Billbee jest ponawiany do 3 razy. Pauza FlexigoTech Cloud nie jest ponawiana.
Odoo nie podąża za przekierowaniami: gdyby Billbee odpowiedział przekierowaniem, wywołanie jest odrzucane z błędem, żeby dane logowania nie trafiły gdzie indziej.
Każdy błąd w dzienniku tworzy aktywność dla osoby odpowiedzialnej za konto (jeśli jej nie ma, dla tego, kto akurat pracował). Codzienne czyszczenie usuwa wiersze dziennika starsze niż 90 dni.

Powiadomienie o zamówieniach
Przyciskiem Zarejestruj webhook w Billbee (w miarę możliwości) na koncie Odoo rejestruje w Billbee powiadomienie o nowych zamówieniach. Zanim Billbee je przyjmie, sprawdza adres, a Odoo odpowiada tym samym tekstem tylko wtedy, gdy adres zawiera sekret konta. Od tej chwili każde powiadomienie sprawia, że Odoo odczytuje to zamówienie albo, jeśli go nie znajdzie, od razu uruchamia przebieg zamówień. Także gdy powiadomienie nie jest zarejestrowane, zamówienia przychodzą z zadaniem co 15 minut.
Co każdy przebieg robi z zamówieniami, opisuje zamówienia Billbee w Odoo, a pojęcia Billbee co to jest Billbee.
Przetestowaliśmy to na koncie Billbee
17-11-2026, na testowym koncie sprzedawcy w Billbee i z usługą testową FlexigoTech Cloud, przetestowaliśmy od początku do końca połączenie, stan magazynowy, zamówienia i wysyłkę w Odoo 20, bez błędów. 18-11-2026, z wersją 1.2.11 w Odoo 17, 18, 19 i 20, zarejestrowaliśmy powiadomienie o zamówieniach, a Billbee najpierw sprawdził adres. W Odoo 17, 18 i 20 zamówienie utworzone potem w Billbee trafiło do Odoo.
Pytania o Billbee API i Odoo
Czy potrzebuję własnego klucza API Billbee?
Nie. Klucz należy do integracji i jest własnością FlexigoTech. Wpisujesz swoją nazwę użytkownika Billbee i hasło API, które tworzysz w Billbee osobno od hasła logowania.
Gdzie jest przechowywane moje hasło API?
W FlexigoTech Cloud, zaszyfrowane. W twoim Odoo pole można tylko zapisać: możesz je zmienić, ale nie odczytać.
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 Billbee.
Z którymi wersjami Odoo działa?
Z Odoo 17, 18, 19 i 20, na Odoo.sh lub na własnym serwerze. Nie działa w Odoo Online. Konto Billbee z nazwą użytkownika i hasłem API oraz jego plan są osobno.
Czytaj dalej
Sprawdzone w kodzie źródłowym konektora (wersja 20.0) i w podlinkowanych źródłach
Źródła
- Kod modułu: flexigobe_billbee_connector 20.0 (a5ae481e): models/billbee_api_client.py:172
- Kod modułu: flexigobe_billbee_connector 20.0 (a5ae481e): models/billbee_account.py:103
- Kod modułu: flexigobe_billbee_connector 20.0 (a5ae481e): models/billbee_account.py:110
- Kod modułu: flexigobe_billbee_connector 20.0 (a5ae481e): models/billbee_account.py:541
- Kod modułu: flexigobe_billbee_connector 20.0 (a5ae481e): models/billbee_api_client.py:230
- Kod modułu: flexigobe_billbee_connector 20.0 (a5ae481e): models/billbee_api_client.py:215
- Kod modułu: flexigobe_billbee_connector 20.0 (a5ae481e): models/billbee_api_client.py:196
- Kod modułu: flexigobe_billbee_connector 20.0 (a5ae481e): models/billbee_api_client.py:153
- Kod modułu: flexigobe_billbee_connector 20.0 (a5ae481e): models/billbee_api_client.py:148
- Kod modułu: flexigobe_billbee_connector 20.0 (a5ae481e): models/billbee_api_client.py:265
- Kod modułu: flexigobe_billbee_connector 20.0 (a5ae481e): models/billbee_sync_log.py:76
- Kod modułu: flexigobe_billbee_connector 20.0 (a5ae481e): models/billbee_sync_log.py:117
- Kod modułu: flexigobe_billbee_connector 20.0 (a5ae481e): controllers/main.py:144
- Kod modułu: flexigobe_billbee_connector 20.0 (a5ae481e): controllers/main.py:96
- Kod modułu: flexigobe_billbee_connector 20.0 (a5ae481e): models/billbee_order.py:582
- Kod modułu: flexigobe_billbee_connector 20.0 (a5ae481e): models/billbee_product.py:237
- Kod modułu: flexigobe_billbee_connector 20.0 (a5ae481e): models/billbee_product.py:124
- Kod modułu: flexigobe_billbee_connector 20.0 (a5ae481e): models/billbee_api_client.py:342
- hilfe.billbee.io/article/1505-nutzung-der-billbee-api
- hilfe.billbee.io/article/1506-preisgestaltung-der-billbee-api
- Test FlexigoTech na prawdziwym koncie testowym Billbee (17 i 18-11-2026)
- flexigotech.com/pl/integracja-billbee-odoo.html
- www.billbee.io/
- www.billbee.io/en
