Klucz i hasło API Plytix
W Plytix klucz tworzy się w Account, potem API i potem API Keys. Mogą to zrobić tylko użytkownicy z rolą Owner lub Admin. Przy każdym kluczu Plytix pokazuje hasło. API potrzebuje obu.
W Odoo wklejasz je w Plytix › Konfiguracja › Konta Plytix, w polach Klucz API i Hasło API. Idą razem albo wcale: jeśli brakuje jednego, konektor nic nie wysyła. Przed zapisem administrator musi zgodzić się, by FlexigoTech Cloud je przechowywało.

Token ważny 900 sekund
API Plytix uwierzytelnia w dwóch krokach. Najpierw para klucza i hasła jest wymieniana na token w usłudze uwierzytelniania Plytix. Ten token jest ważny dokładnie 900 sekund. Potem każde wywołanie zawiera token.
Jeśli integrujesz Plytix samodzielnie, musisz przechowywać parę, pobierać token i odnawiać go przed wygaśnięciem. Z konektorem robi to FlexigoTech Cloud. Przechowuje parę zaszyfrowaną, pobiera token, odnawia go i dodaje do każdego wywołania. Odoo nie przechowuje ani pary, ani tokenu.
Dwa limity wywołań naraz
Plytix ogranicza wywołania dwoma licznikami naraz: jednym na 10 sekund i drugim na godzinę. Oba zależą od twojego planu. Konektor zwalnia przed wysłaniem, żeby ich nie przekroczyć. Jeśli mimo to je przekroczy, Plytix odpowiada kodem 429, który mówi, ile czekać (nagłówek Retry-After) i jaki jest limit (RateLimit-Limit i RateLimit-Window).
Strona cennika Plytix (www.plytix.com/pricing, odczytana 12 listopada 2026) podaje dla planu Standard 2 000 wywołań na godzinę, dla Pro 15 000, a dla Enterprise 25 000. Standard jest darmowy tylko do 100 SKU; przy większej liczbie SKU jest płatny. Dokumentacja API Plytix dodaje, że limity zależą od planu, a limity twojego konta potwierdza twój opiekun konta.
W koncie Odoo wybierasz plan w polu Plan, a konektor wypełnia oba limity:
- Standard: 20 wywołań na 10 sekund i 2 000 na godzinę.
- Pro: 50 wywołań na 10 sekund i 15 000 na godzinę.
- Enterprise: 50 wywołań na 10 sekund i 25 000 na godzinę.
- Własne limity: zaczynają od 20 i 2 000, a wpisujesz je sam.
To wartości wersji 1.3.0 konektora; wartości godzinowe pochodzą ze strony cennika Plytix. Przy aktualizacji konto, które wciąż ma wcześniejsze wartości (Standard 5 000 na godzinę, Enterprise 15 000), samo przechodzi na nowe, a konto, w którym ktoś zmienił limity, zostaje bez zmian. Oba pola limitów można zmieniać ręcznie i nie przyjmują mniej niż 1 wywołania. Jeśli przyjdzie 429, konektor zapisuje na koncie limit podany przez Plytix i czeka tyle, ile każe Plytix: do 15 sekund w ramach tego samego wywołania; jeśli czekanie ma trwać dłużej, wstrzymuje synchronizację, niczego nie oznaczając jako nieudane, a reszta wychodzi później.
Wyszukiwanie: 20 atrybutów i 100 wyników na stronę
Wyszukiwania API Plytix zwracają domyślnie mało pól. Każdy atrybut trzeba wskazać z nazwy, a Plytix przyjmuje najwyżej 20 na jedno wyszukiwanie. Jeśli potrzeba więcej, konektor robi kilka przebiegów i łączy je po identyfikatorze produktu. Każda strona zwraca najwyżej 100 wyników. Powyżej API odpowiada błędem 422.
Co konektor robi z API
Konektor dopasowuje produkty, warianty i podwarianty po SKU. Jeśli SKU nie identyfikuje rekordu, nie tworzy dopasowania. Znajdziesz to w Plytix › Produkty › Dopasuj według SKU, a import w Plytix › Produkty › Importuj z Plytix.
Są dwa zadania zaplanowane dla zmian: import zmienionych produktów co 6 godzin i eksport co 12 godzin. Oba są domyślnie wyłączone. Włączasz je po sprawdzeniu mapowania pól i kierunku każdej synchronizacji.

Czego potrzebujesz
Potrzebujesz aktywnego konta Plytix z kluczem API. Konektor jest w Odoo Apps dla Odoo 17, 18, 19 i 20 i wymaga subskrypcji FlexigoTech Cloud. Wszystkie szczegóły są na stronie konektora.
Gdzie jest dokumentacja API Plytix?
Na apidocs.plytix.com. Konektor pracuje z REST API Plytix przez HTTPS.
Co się dzieje, gdy Plytix odpowie kodem 429?
Konektor zwalnia przed wysłaniem, zgodnie z limitami konta. Jeśli mimo to przyjdzie 429, zapisuje limit podany przez Plytix i czeka tyle, ile każe Plytix, do 15 sekund w ramach tego samego wywołania. Jeśli czekanie ma trwać dłużej, synchronizacja zostaje wstrzymana, a nic nie jest oznaczane jako nieudane; reszta wychodzi, gdy Plytix na to pozwoli.
Czy mogę korzystać z darmowego planu Plytix?
Tak, jeśli masz do 100 SKU: tyle Plytix daje za darmo w planie Standard, według swojego cennika. W koncie wybierasz Standard, a konektor zaczyna od 20 wywołań na 10 sekund i 2 000 na godzinę. Konektor nadal wymaga subskrypcji FlexigoTech Cloud.
Czy Odoo przechowuje mój klucz Plytix?
Nie. Klucz i hasło przechowuje FlexigoTech Cloud, zaszyfrowane, po zgodzie administratora.
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_plytix_connector 20.0 (6d411531): __manifest__.py
- Kod modułu: flexigobe_plytix_connector 20.0 (6d411531): static/description/index.html
- Kod modułu: flexigobe_plytix_connector 20.0 (6d411531): models/plytix_account.py
- Kod modułu: flexigobe_plytix_connector 20.0 (6d411531): data/plytix_cron_data.xml
- Kod modułu: flexigobe_plytix_connector 20.0 (6d411531): views/plytix_menus.xml
- Kod modułu: flexigobe_plytix_connector 20.0 (6d411531): models/plytix_api_client.py
- www.plytix.com/pricing/
- docs.plytix.com/reference/v1-v2/rate-limits/
- Kod modułu: flexigobe_plytix_connector 20.0 (40f61773): models/plytix_account.py
- Kod modułu: flexigobe_plytix_connector 20.0 (40f61773): migrations/1.3.0/post-migrate.py
- Kod modułu: flexigobe_plytix_connector 20.0 (40f61773): models/plytix_api_client.py
