Token Deel, którego potrzebuje Odoo
Deel rozróżnia trzy tokeny: token organizacji, który reprezentuje całą organizację; token osobisty, który reprezentuje jednego użytkownika; i token pracownika, który reprezentuje jednego pracownika w modelu EOR. Konektor działa z tokenem organizacji, zaznaczonym domyślnie w Metoda Autoryzacji: Token organizacji. Według centrum pomocy Deel token osobisty wygasa, gdy osoba, która go utworzyła, odchodzi z firmy, a token organizacji nie jest przypisany do nikogo i nie wygasa, choć nie może podpisywać umów. Aby go utworzyć, trzeba być w Deel Org Admin albo IT Developer Admin.
Krok po kroku w Developer Center Deel
- Otwórz Developer Center. Przewodnik Deel po uwierzytelnianiu prowadzi tam przez More, a potem Developer; przewodnik po webhookach przez ikonę profilu, Settings i Developer Center; a centrum pomocy przez Apps & Integrations.
- Otwórz zakładkę Access Tokens i kliknij Generate new token.
- Wybierz typ Organization token.
- Zaznacz uprawnienia z tabeli poniżej i zdecyduj, do jakich danych wrażliwych token będzie miał dostęp.
- Kliknij Generate i od razu skopiuj token: Deel ostrzega, że później nie da się go już zobaczyć.
Deel wydaje osobne klucze dla swojego sandboxa i dla produkcji i prosi, żeby ich nie mieszać. W Odoo pole Środowisko połączenia ma Produkcja i Sandbox (testy), czyli demonstracyjną organizację Deel (demo.deel.com) bez prawdziwych pieniędzy. Token musi pochodzić ze środowiska, które wybierzesz.
Jakie uprawnienia zaznaczyć
Deel nazywa swoje uprawnienia zasób:read i zasób:write, a jego dokumentacja referencyjna podaje, czego wymaga każde wywołanie. Oto, między innymi, wywołania konektora i uprawnienie każdego z nich według dokumentacji Deel z 18-11-2026:
| Do czego | Wywołanie | Uprawnienie |
|---|---|---|
Sprawdź połączenie | GET /organizations | organizations:read |
| Podmioty prawne | GET /legal-entities | organizations:read, accounting:read |
| Umowy i osoby | GET /contracts, GET /people | contracts:read, people:read |
| Faktury, opłaty Deel i ich pliki PDF | GET /invoices, GET /invoices/deel, GET /invoices/{id}/download | accounting:read |
| Płatności i ich rozbicie | GET /payments, GET /payments/{payment_id}/breakdown | accounting:read |
| Okresy płacowe i centra kosztów | GET /legal-entities/{legal_entity_id}/payroll-events, GET /legal-entities/{legal_entity_id}/cost-centers | legal-entity:read |
| Raport brutto-netto każdego okresu | GET /reports/payroll/cycles/{cycle_id}/gross-to-net | payslips:read |
| Rejestracja i usunięcie webhooka | POST /webhooks, DELETE /webhooks/{id} | webhooks:write |
| Wysyłanie centrów kosztów do Deel | POST /legal-entities/{legal_entity_id}/cost-centers/synchronize | legal-entity:write |
Dwa ostatnie wiersze zapisują dane w Deel. Webhook powstaje tylko wtedy, gdy administrator kliknie Zarejestruj webhook, a centra kosztów trafiają do Deel tylko wtedy, gdy wybierzesz, że prowadzi je Odoo; domyślnie idą z Deel do Odoo. Pomoc pola tokenu wymaga uprawnień do odczytu. Z samymi nimi, według swojej dokumentacji, Deel odrzuci rejestrację webhooka, a jeśli centra kosztów prowadzi Odoo, także ich wysyłkę. Przewodnik Deel po uwierzytelnianiu podaje dwie możliwe odpowiedzi dla tokenu, któremu brakuje uprawnienia: 403 albo 401. Przy kodzie 403 synchronizacja co 30 minut dalej odczytuje całą resztę. Przy kodzie 401 konektor traktuje to jako odrzucony token i, jeśli centra kosztów prowadzi Odoo, każde przejście zatrzymuje się na nich, zanim dojdzie do umów, faktur, płatności i okresów płacowych; wtedy token potrzebuje też legal-entity:write. Jeśli Deel zmieni uprawnienie któregoś wywołania, rozstrzyga jego dokumentacja.
Gdzie wkleić go w Odoo
W połączeniu z Deel administrator:
- zaznacza
Akceptuję, że FlexigoTech Cloud przechowuje poświadczenia Deel, bo do tego czasu pola tokenu nie da się wypełnić i nic nie jest wysyłane; - zostawia
Token organizacjiwMetoda Autoryzacjii wybieraŚrodowisko; - wkleja token w
Token organizacji Deeli zapisuje.
Przy zapisie konektor wysyła token do FlexigoTech Cloud, który musi być w okresie próbnym albo w subskrypcji, i wpisuje datę w Zapisane poświadczenia na. Pole znowu jest puste i tak ma być: można do niego tylko zapisywać, a Odoo nie zatrzymuje tokenu. Tylko administrator może go zapisać. Potem Sprawdź połączenie pyta Deel o organizację i jej podmioty prawne i odpowiada nazwą oraz ich liczbą.

Jeśli zmienisz Środowisko albo Metoda Autoryzacji w zapisanym połączeniu, zapisane poświadczenia przestają obowiązywać: połączenie wraca do Nie połączone, trzeba wkleić token jeszcze raz, a stary wpis zostaje usunięty z FlexigoTech Cloud.
Dokąd trafia token
Według samego modułu FlexigoTech Cloud przechowuje token zaszyfrowany, jeden wpis na połączenie, i dodaje go do każdego wywołania Deel jako nagłówek Authorization: Bearer, tak jak Deel każe go używać. Wywołania do Deel nie wychodzą bezpośrednio z Twojego Odoo; w przeciwną stronę idą tylko powiadomienia webhooków, które Deel wysyła do Twojego Odoo i które opisuje artykuł o webhookach Deel w Odoo. Rozłącz usuwa token z FlexigoTech Cloud i, jeśli usługa jest aktywna, webhook z Deel, i nie rusza niczego, co już zsynchronizowano.

Deel zaleca trzymać poświadczenia w bezpiecznym sejfie, a nigdy w kodzie, wymieniać tokeny co kwartał albo gdy ktoś odchodzi z zespołu i usuwać nieużywane. Z konektorem wymiana polega na utworzeniu nowego tokenu w Deel, wklejeniu go w to samo pole, zapisaniu i usunięciu starego w Deel.
Autoryzuj z Deel, dziś
Druga opcja w Metoda Autoryzacji, Autoryzuj z Deel, łączy bez kopiowania tokenu: administrator Deel zatwierdza aplikację FlexigoTech. Dopóki FlexigoTech Cloud nie ma tej aplikacji dla wybranego środowiska, konektor odpowiada: «Autoryzacja z Deel nie jest jeszcze dostępna dla tego środowiska Deel. W międzyczasie użyj tokenu organizacji: nic nie zostało wysłane do Deel.»
Limity i błędy
Deel dopuszcza 5 żądań na sekundę na organizację, łącznie dla wszystkich jej tokenów, w ruchomym oknie 1 sekundy, a jego sandbox ma te same limity. Powyżej odpowiada kodem 429 i, według swojej dokumentacji, nie wysyła nagłówków, które ostrzegałyby wcześniej. Jeśli inny program czyta tę samą organizację, dzieli z konektorem te 5. Synchronizacja zostawia co najmniej 0,25 sekundy między jednym wywołaniem a następnym; przy kodzie 429 czeka (sekundę, chyba że odpowiedź poprosi o inny czas, i nigdy dłużej niż 5), powtarza do 3 razy, a jeśli dalej się nie udaje, zostawia wywołanie na następne przejście.
| Odpowiedź Deel | Przyczyna według Deel | Co robi konektor |
|---|---|---|
| 401 | Token nieważny lub wygasły, brak nagłówka Authorization albo brak potrzebnych uprawnień | Ustawia połączenie na Deel odrzucił token i prosi o zapisanie nowego |
| 403 | Tokenowi brakuje uprawnienia do tego wywołania | Nie uznaje tokenu za zły: pokazuje powód podany przez Deel |
| 429 | Ponad 5 żądań na sekundę w organizacji | Czeka i powtarza |
Notatka w kodzie konektora dodaje jeszcze jeden kod 403, «Error 1010»: to Cloudflare Deel blokujący User-Agent Python-urllib, i dlatego konektor zawsze wysyła własny. Żeby sprawdzić, dlaczego Deel odrzucił wywołanie, Request logs w Developer Center przechowują przez 15 dni żądania wykonane tokenami organizacji, także odrzucone, razem z powodem.
Co przetestowano
Konektor działa w Odoo 17, 18, 19 i 20, na własnym serwerze albo w Odoo.sh, a nie w Odoo Online. Przetestowano go od początku do końca, za pośrednictwem FlexigoTech Cloud, na demonstracyjnej organizacji Deel (demo.deel.com): połączenie, podmioty prawne, umowę z jej osobą i dostawcą, webhooki oraz powtórne przejście bez duplikatów. Faktury, płatności i okresy płacowe przetestowano na odpowiedziach przygotowanych na podstawie dokumentacji API Deel, bo ta organizacja jeszcze ich nie miała. To, co potem trafia do Odoo jako faktura od dostawcy, opisuje poradnik o Deel invoice, a porównanie z integracjami Deel Deel integrations. Konektor jest w pełni opisany na jego stronie i opublikowany w Odoo Apps.
Czytaj dalej
Sprawdzone w kodzie źródłowym konektora (wersja 20.0) i w podlinkowanych źródłach
Źródła
- developer.deel.com/api/authentication
- help.letsdeel.com/hc/en-gb/articles/8801712601233-How-To-Use-Deel-API
- developer.deel.com/api/webhooks/no-code
- help.letsdeel.com/hc/en-gb/articles/10660690287761-How-To-Create-And-Manage-Webhooks-Notif
- developer.deel.com/api/sandbox
- Kod modułu: flexigo_deel_connector 20.0 (18442307): models/deel_account.py
- Kod modułu: flexigo_deel_connector 20.0 (18442307): models/deel_cost_center.py
- Kod modułu: flexigo_deel_connector 20.0 (18442307): models/deel_legal_entity.py
- Kod modułu: flexigo_deel_connector 20.0 (18442307): models/deel_contract.py
- Kod modułu: flexigo_deel_connector 20.0 (18442307): models/deel_payment.py
- Kod modułu: flexigo_deel_connector 20.0 (18442307): models/deel_payroll.py
- developer.deel.com/api/rate-limits
- developer.deel.com/api/endpoints/organizations/get-organizations
- developer.deel.com/api/endpoints/legal-entities/get-legal-entities
- developer.deel.com/api/endpoints/contracts/get-contracts
- developer.deel.com/api/hris-endpoints/people/get-people
- developer.deel.com/api/reference/endpoints/accounting/retrieve-deel-invoices-v-2026-01-01
- developer.deel.com/api/reference/endpoints/accounting/get-billing-invoice-download-link-v-
- developer.deel.com/api/reference/endpoints/accounting/retrieve-payment-receipts-v-2027-01-
- developer.deel.com/api/reference/endpoints/accounting/retrieve-a-payment-breakdown-v-2026-
- developer.deel.com/api/reference/endpoints/list-cycles/list-payroll-cycles-v-2026-01-01
- developer.deel.com/api/reference/endpoints/reports/gets-g-2-n-report-data-for-a-given-payr
- developer.deel.com/api/endpoints/cost-centers/get-legal-entity-cost-centers
- developer.deel.com/api/reference/endpoints/cost-centers/sync-cost-centers-for-legal-entity
- developer.deel.com/api/endpoints/webhooks/create-webhook
- developer.deel.com/api/endpoints/webhooks/delete-webhook
- developer.deel.com/api/reference/endpoints/accounting/retrieve-invoices-v-2026-01-01
- Kod modułu: flexigo_deel_connector 20.0 (18442307): models/deel_invoice.py
- Kod modułu: flexigo_deel_connector 20.0 (18442307): data/deel_cron.xml
- apps.odoo.com/apps/modules/20.0/flexigo_deel_connector
- Kod modułu: flexigo_deel_connector 20.0 (18442307): views/deel_account_views.xml
