Przejdź do głównej treści
Channable

Channable API z Odoo: czego wymaga, co wywołuje konektor i jakie zgłasza błędy

Channable API wymaga numerycznego identyfikatora firmy, tokenu API, który wygasa po roku, a przy części wywołań także identyfikatora projektu. Konektor FlexigoTech dla Odoo sprawdza wygaśnięcie tokenu codziennie. Pobiera zamówienia co 15 minut kursorem API v2 i wysyła stany partiami po 50 pozycji, czyli twardy limit API, z szybkością 4 żądań na sekundę.

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

Najważniejsze

Moduł
Channable
Wersje
Odoo 17, 18, 19 i 20
Sprawdzone
w kodzie źródłowym konektora, wersja 20.0
Czas czytania
3 min

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 akcjaCzęstotliwość
Channable: import zamówieńCo 15 minut
Channable: wysyłka oczekujących przesyłekCo 15 minut
Channable: import zwrotówCo 30 minut
Channable: wysyłka aktualizacji stanówCo 30 minut
Channable: publikuj feedy w FlexigoTech CloudCo godzinę
Channable: pobieranie statystyk kanałówCodziennie
Channable: kontrola wygaśnięcia tokenu APICodziennie

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.

Lista zamówień Channable w Odoo z kanałem, kupującym, sumą, prowizją oraz statusem płatności i wysyłki
Zamówienia Channable, z danymi demo.

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.

Pulpit Channable w Odoo z pozycjami w feedzie, zamówieniami, zwrotami, prowizjami kanałów i aktywnością synchronizacji
Pulpit Channable, z danymi demo.

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ć

KomunikatKiedy się pojawiaCo 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

Channable Amazon w Odoo: zamówienia, faktura sprzedawcy i etykiety EasyShipCo dzieje się w Odoo z zamówieniami Amazon z Channable: przesyłanie faktury INVOICE, etykiety EasyShip, numery przesyłek, anulowania i zwroty.
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