Czego wymaga Channable API do połączenia
Identyfikator firmy Channable: numeryczny identyfikator widoczny w aplikacji Channable. Musi być liczbą dodatnią.Token API (FlexigoTech Cloud): generujesz go w aplikacji Channable (Company Settings > Channable API) i jest ważny rok. Wysyłany jest raz, zaszyfrowany, do FlexigoTech Cloud i nigdy nie jest zapisywany w Odoo.Token wygasa: przypomnienie, kiedy token skończy rok.- Identyfikator projektu, również dodatni, dla endpointów wymagających zakresu projektu.
Zanim token zostanie zapisany, administrator musi zaznaczyć Akceptuję, że mój token API Channable i moje wywołania do Channable przechodzą przez FlexigoTech Cloud. Przekaźnik FlexigoTech Cloud przechowuje token w postaci zaszyfrowanej i dodaje go do każdego wywołania.
Jakie wywołania Channable API wykonuje konektor i jak często
Konektor działa w obu kierunkach na API połączenia zamówień Channable (api.channable.com). Te zaplanowane akcje są aktywne od instalacji:
| Zaplanowana akcja | Częstotliwość |
|---|---|
Channable: import zamówień | Co 15 minut |
Channable: wysyłka oczekujących przesyłek | Co 15 minut |
Channable: import zwrotów | Co 30 minut |
Channable: wysyłka aktualizacji stanów | Co 30 minut |
Channable: publikuj feedy w FlexigoTech Cloud | Co godzinę |
Channable: pobieranie statystyk kanałów | Codziennie |
Channable: kontrola wygaśnięcia tokenu API | Codziennie |
Zamówienia wpływają przez przyrostowe odpytywanie API v2 z kursorem last_modified_after. Każde z nich tworzy zamówienie sprzedaży z podatkami wliczonymi w cenę wyliczonymi z kanału, pozycjami wysyłki i rabatów, prowizją, opłatami transakcyjnymi i flagą zamówienia testowego. Zamówienia z Amazona mają własny przewodnik po Channable i Amazonie.

Rzeczywiste ruchy magazynowe oznaczają pozycje jako oczekujące, a konektor wysyła bezwzględne wartości stanów. Akcja uzgadniania porównuje stany w Odoo z aktualnymi ofertami w Channable.
FlexigoTech Cloud hostuje feed produktów każdego projektu: Odoo generuje go (XML, CSV lub JSON), kompresuje gzipem i wysyła co godzinę, jeśli się zmienił, albo po kliknięciu Opublikuj feed teraz. Channable importuje go z hostowanego adresu URL widocznego w projekcie.

Limity Channable API i jak konektor je respektuje
API przyjmuje najwyżej 50 pozycji na jedną aktualizację stanów. Konektor wysyła partie po 50 przez klienta świadomego limitów: leaky bucket o szybkości 4 żądań na sekundę. Gdyby żądanie zawierało więcej, moduł zatrzymałby je komunikatem Aktualizacje stanów Channable przyjmują maksymalnie … pozycji na żądanie.
Co do tokenu, kontrola wygaśnięcia działa codziennie. Jeśli Channable odpowie kodem 401 lub 403, konto przechodzi w stan Błąd uwierzytelniania.
Błędy połączenia z Channable API i co robić
| Komunikat | Kiedy się pojawia | Co zrobić |
|---|---|---|
Channable odrzucił token API konta '…' zapisany w FlexigoTech Cloud (…): jest nieprawidłowy, wygasł (tokeny są ważne 1 rok) albo został unieważniony. Wygeneruj nowy w aplikacji Channable (Company Settings > Channable API) i wpisz go na koncie. Nic nie zostało oznaczone jako nieudane. | Channable odpowiada kodem 401 lub 403. | Wygeneruj nowy token i wpisz go na koncie. |
Channable account '…' no longer has the consent to go through FlexigoTech Cloud, so nothing was sent. Nothing was marked as failed: an administrator accepts it again on the account to resume. | Konto nie ma już zgody na przechodzenie przez FlexigoTech Cloud. | Administrator akceptuje ją ponownie na koncie. |
Identyfikator firmy Channable musi być liczbą dodatnią. | Identyfikator firmy to zero lub liczba ujemna. | Skopiuj identyfikator widoczny w aplikacji Channable. |
Identyfikator projektu Channable musi być liczbą dodatnią. | Identyfikator projektu to zero lub liczba ujemna. | Popraw identyfikator projektu. |
Ten endpoint Channable wymaga zakresu projektu. | Wywołanie wymagające projektu idzie bez niego. | Sprawdź projekt. |
Przed zapisaniem tokenu API administrator musi zaakceptować, że token i wywołania do Channable przechodzą przez FlexigoTech Cloud. Nic nie zostało wysłane. | Token jest zapisywany bez tej zgody. | Administrator akceptuje i zapisujesz ponownie. |
Token API … nie jest zapisany w FlexigoTech Cloud: wpisz go ponownie. | FlexigoTech Cloud nie przechowuje tokenu tego konta. | Wpisz token ponownie. |
Pytania o Channable API w Odoo
Jak często zamówienia z Channable trafiają do Odoo?
Co 15 minut, przez akcję Channable: import zamówień, która odpytuje API v2 kursorem last_modified_after.
Czy Odoo przechowuje kopię tokenu API?
Nie. Przekaźnik FlexigoTech Cloud przechowuje go w postaci zaszyfrowanej. Tylko administrator może usunąć token z FlexigoTech Cloud.
Czego potrzebuję i z którymi wersjami Odoo to działa?
Działa z Odoo 17, 18, 19 i 20 i wymaga subskrypcji FlexigoTech Cloud, plan Konektor. Konektor Channable dla Odoo znajdziesz w Odoo Apps, a szczegóły na jego stronie na flexigotech.com.
Czytaj dalej
Sprawdzone w kodzie źródłowym konektora (wersja 20.0)
Źródła
- Kod modułu: flexigobe_channable_connector 20.0 (6156c3b8): __manifest__.py
- Kod modułu: flexigobe_channable_connector 20.0 (6156c3b8): README.md
- Kod modułu: flexigobe_channable_connector 20.0 (6156c3b8): models/channable_api_client.py
- Kod modułu: flexigobe_channable_connector 20.0 (6156c3b8): models/channable_account.py
- Kod modułu: flexigobe_channable_connector 20.0 (6156c3b8): models/fgt_cloud.py
- Kod modułu: flexigobe_channable_connector 20.0 (6156c3b8): models/channable_project.py
- Kod modułu: flexigobe_channable_connector 20.0 (6156c3b8): data/channable_cron_data.xml
