Przejdź do głównej treści
Deel

Deel API token dla Odoo: utworzyć, nadać uprawnienia i wkleić

Deel ma trzy rodzaje tokenów do swojego API, a konektor Odoo używa jednego z nich: tokenu organizacji, który administrator Deel tworzy w Developer Center Deel. Poniżej są kolejne kroki, uprawnienie, którego dokumentacja referencyjna Deel wymaga dla każdego wywołania konektora, miejsce w Odoo, gdzie wkleja się token, i to, co się z nim dzieje po zapisaniu.

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

Najważniejsze

Moduł
Deel
Wersje
Odoo 17, 18, 19 i 20
Sprawdzone
w kodzie źródłowym konektora, wersja 20.0 · w źródłach podanych na końcu
Czas czytania
6 min

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

  1. 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.
  2. Otwórz zakładkę Access Tokens i kliknij Generate new token.
  3. Wybierz typ Organization token.
  4. Zaznacz uprawnienia z tabeli poniżej i zdecyduj, do jakich danych wrażliwych token będzie miał dostęp.
  5. 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 czegoWywołanieUprawnienie
Sprawdź połączenieGET /organizationsorganizations:read
Podmioty prawneGET /legal-entitiesorganizations:read, accounting:read
Umowy i osobyGET /contracts, GET /peoplecontracts:read, people:read
Faktury, opłaty Deel i ich pliki PDFGET /invoices, GET /invoices/deel, GET /invoices/{id}/downloadaccounting:read
Płatności i ich rozbicieGET /payments, GET /payments/{payment_id}/breakdownaccounting:read
Okresy płacowe i centra kosztówGET /legal-entities/{legal_entity_id}/payroll-events, GET /legal-entities/{legal_entity_id}/cost-centerslegal-entity:read
Raport brutto-netto każdego okresuGET /reports/payroll/cycles/{cycle_id}/gross-to-netpayslips:read
Rejestracja i usunięcie webhookaPOST /webhooks, DELETE /webhooks/{id}webhooks:write
Wysyłanie centrów kosztów do DeelPOST /legal-entities/{legal_entity_id}/cost-centers/synchronizelegal-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 organizacji w Metoda Autoryzacji i wybiera Środowisko;
  • wkleja token w Token organizacji Deel i 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ą.

Połączenie z Deel w Odoo z wybraną metodą tokenu organizacji, zaakceptowaną zgodą dla FlexigoTech Cloud, pustym polem tokenu i datą zapisania poświadczeń
Połączenie z już zapisanym tokenem: pole jest puste, a data mówi, kiedy go wysłano (wymyślona organizacja, dane demonstracyjne).

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.

Ustawienia FlexigoTech Cloud w Odoo z połączoną bazą i kartą konektora Deel w okresie próbnym, z jego ceną i tekstem, że utrzymuje połączenie z platformą przez FlexigoTech Cloud
Konektor Deel w ustawieniach FlexigoTech Cloud, w okresie próbnym (dane demonstracyjne).

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ź DeelPrzyczyna według DeelCo robi konektor
401Token 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
403Tokenowi brakuje uprawnienia do tego wywołaniaNie uznaje tokenu za zły: pokazuje powód podany przez Deel
429Ponad 5 żądań na sekundę w organizacjiCzeka 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

Deel webhooks w Odoo: podpis, zdarzenia, ponowienia i co robi konektorJak Deel podpisuje każdy webhook, jakie zdarzenia ma na liście, kiedy ponawia lub go wyłącza i co robi z nimi konektor Deel dla Odoo od FlexigoTech.Deel invoice w Odoo: od faktury Deel do faktury od dostawcyCo zawiera Deel invoice za kontraktora, EOR lub opłaty Deel i jak trafia do Odoo jako faktura od dostawcy, z VAT, plikiem PDF i centrami kosztów.Deel integrations księgowe: co robią GL Sync i Bill Sync i jak mieć to w OdooDeel łączy swoje dane księgowe z NetSuite, Xero, QuickBooks, Sage, SAP i Dynamics. Odoo nie ma na tej liście: co obejmuje konektor, a czego nie.
Sprawdzone w kodzie źródłowym konektora (wersja 20.0) i w podlinkowanych źródłach

Źródła