Raport gross to net w Deel
Według centrum pomocy Deel, Deel Global Payroll tworzy raport brutto-netto w każdym okresie, w tym samym formacie we wszystkich krajach, a każdy raport dotyczy jednego okresu. Otwiera się go w Analytics, wśród raportów płacowych, i eksportuje do CSV, XLSX lub PDF. Deel ostrzega też, że G2N zawiera wyniki płacowe, a nie reguły księgowe, więc nie ma w nim zapisów po stronie Winien i Ma, logiki przypisywania kont ani walidacji. Bez integracji ktoś z księgowości przygotowuje ręcznie zapis każdego okresu na podstawie tego pliku.
API Deel podaje ten sam raport dla okresu przez GET /reports/payroll/cycles/{cycle_id}/gross-to-net. Dla każdej umowy zwraca walutę (currency), kurs wymiany między walutą płac a walutą płatności (conversion_rate) i listę pozycji, każdą z nazwą (label), kwotą (value), kategorią i jedną z tych grup (category_group):
| Grupa w Deel | Co obejmuje |
|---|---|
ADDITIONS | To, co dochodzi do wynagrodzenia brutto, na przykład pensja zasadnicza |
DEDUCTIONS | To, co potrąca się osobie, na przykład jej zaliczkę na podatek i jej składkę |
BENEFITS | Świadczenia |
CONTRIBUTIONS | Składki pracodawcy |
INFOS | Informacje |
TOTALS | Sumy, na przykład kwota netto do wypłaty |
Konektor czyta wszystkie strony raportu i zapisuje każdą pozycję jako wiersz okresu w Odoo. Deel podaje 20 umów na stronę, jeśli nie poprosi się o inny rozmiar; konektor prosi o 50, czego nie sprawdzono na prawdziwym raporcie.
Kiedy okres jest gotowy
Konektor pobiera okresy każdego podmiotu prawnego przez GET /legal-entities/{legal_entity_id}/payroll-events, ale tylko dla podmiotów, które mają Dziennik płacowy. Każdy nowy podmiot dostaje jako dziennik płacowy pierwszy dziennik ogólny swojej firmy; jeśli go usuniesz, ten podmiot przestanie dawać zapisy płacowe. Każdy odczyt zaczyna się od daty w Importuj cykle płacowe z, domyślnie 90 dni przed dniem, w którym tworzysz połączenie: konektor nie zapamiętuje, dokąd doczytał, więc każdy przebieg pobiera okresy od tej daty od nowa.
Deel oznacza każdy okres polem has_g2n_report, a według jego dokumentacji ma ono wartość prawda tylko wtedy, gdy okres jest opublikowany, a jego raport nie ma blokujących błędów. W Odoo to pole wyboru Gotowy do brutto-do-netto i to ono przenosi okres z Oczekuje na Deel do Do zatwierdzenia. Stamtąd okres dostaje swój zapis (Wpis utworzony), zatrzymuje się na Mapuj koncepcje, jeśli którejś pozycji brakuje kont, albo trafia do Błąd z ostrzeżeniem. Synchronizacja działa co 30 minut; jeśli połączenie odbiera webhooki, zdarzenie gp.payslips.available z Deel uruchamia wcześniej część płacową, a dane zawsze są czytane ponownie przez API.
Każda pozycja na swoje konta
Mapowanie jest w zakładce Konta płacowe połączenia, a każdy wiersz mówi, co zrobić z pozycją: Zapisz, ustawienie domyślne, albo Ignoruj. Wiersz, który zapisuje, ma Konto debetowe i Konto kredytowe, a kwota pozycji trafia w całości na oba, więc każdy zapis bilansuje się z samej konstrukcji. Wiersz bez pozycji obowiązuje dla całej grupy, a wiersz bez podmiotu prawnego dla wszystkich podmiotów połączenia. Jeśli do wiersza raportu pasuje kilka wierszy, wygrywa najdokładniejszy: ten dla tego podmiotu i tej pozycji, potem ten dla tego podmiotu i jej grupy, potem ten dla dowolnego podmiotu z tą pozycją i na końcu ten dla dowolnego podmiotu z tą grupą.
Gdy przychodzi pozycja bez gotowego wiersza, okres zostaje na Mapuj koncepcje: konektor tworzy brakujący wiersz i otwiera zgłoszenie z prośbą o konto po stronie Winien i konto po stronie Ma albo o zignorowanie pozycji. Tak samo jest z grupą, której konektor nie zna: zapisuje ją jako INFOS i ona też potrzebuje swojego wiersza, więc żadna kwota nie zostaje pominięta bez tego, żeby ktoś ją zobaczył. Pole wyboru Centra kosztowe w każdym wierszu jest zaznaczone i dzięki niemu wiersz po stronie Winien dostaje centra kosztów z umowy Deel tej osoby.

Waluta, data i szczegóły na osobę
Każda pozycja wchodzi w walucie, którą raport podaje dla jej umowy, albo w walucie firmy, jeśli raport jej nie podaje. Jeśli ta waluta nie jest aktywna w Odoo, okres zatrzymuje się z ostrzeżeniem, żeby ją aktywować i spróbować ponownie. Kwota w walucie Twojej firmy wynika z kursów wymiany Odoo z dnia zapisu: conversion_rate z Deel zostaje zapisany w wierszu okresu, ale zapis go nie używa.
Zapis trafia do dziennika płacowego podmiotu prawnego, z datą końca okresu i odnośnikiem z nazwą okresu. W nim kwoty tej samej pozycji, które mają te same konta, centra kosztów i walutę, sumują się, więc powstaje para wierszy na pozycję, a nie na osobę. Szczegóły każdej osoby zostają w wierszach okresu, które widzą tylko administratorzy księgowości w Odoo. Ale jeśli podmiot ma tylko jedną osobę albo każda osoba ma własne centrum kosztów, zapis pokazuje jej wynagrodzenie każdemu, kto może oglądać zapisy księgowe. Każdy okres daje jeden zapis, nawet gdy dwa przebiegi się nałożą, a pole Wpisy płacowe decyduje, czy zostaje on jako Wstępne, do sprawdzenia, czyli ustawienie domyślne, czy wychodzi jako Zapisane.
Przykładowy okres, zbilansowany ręcznie

Okres ze zrzutu to okres REGULAR wymyślonej firmy Lumbre Analytics, S.L., od 30 września do 30 października 2026, z jedną umową Global Payroll w euro. Jego mapowanie używa kont z PGC, planu kont tej S.L.: 640 na wynagrodzenia, 642 na składki pracodawcy, 4751 na zaliczki na podatek, 476 na ubezpieczenia społeczne i 465 na wynagrodzenie netto do wypłaty. Przy tych danych demonstracyjnych kod konektora dałby taki zapis, przeliczony ręcznie:
| Pozycja | Grupa w Deel | Winien (konto) | Ma (konto) |
|---|---|---|---|
Salario base | ADDITIONS | 3900 (640) | 3900 (465) |
IRPF | DEDUCTIONS | 702 (465) | 702 (4751) |
Seguridad Social trabajador | DEDUCTIONS | 253,5 (465) | 253,5 (476) |
Seguridad Social empresa | CONTRIBUTIONS | 1236,3 (642) | 1236,3 (476) |
Neto a pagar | TOTALS | Na Ignoruj, nie wchodzi | |
| Suma | 6091,8 | 6091,8 |
Każda pozycja jest księgowana dwa razy, raz po stronie Winien i raz po stronie Ma, dlatego obie kolumny dają tę samą sumę. Konto 465 dostaje 3900 po stronie Ma oraz 702 i 253,5 po stronie Winien i zostaje z saldem 2944,5 po stronie Ma, czyli Neto a pagar z raportu. Dlatego w tym przykładzie wiersz TOTALS jest ustawiony na Ignoruj: kwota netto wynika już z pozostałych wierszy. Konto 476 zbiera 1489,8 ubezpieczeń społecznych, 4751 te 702 zaliczek, a koszt okresu dla firmy zostaje na 640 i 642, razem 5136,3.
Czego nie obejmuje
Płace w modelu PEO nie mają osobnej obsługi: konektor traktuje umowy PEO jak EOR, a GL Sync, integracja księgowa Deel, przenosi PEO do księgi głównej. Poza tym nic z tego nie zostało przetestowane na prawdziwym API Deel. Demonstracyjna organizacja Deel, na której przetestowano konektor za pośrednictwem FlexigoTech Cloud, nie miała jeszcze okresów płacowych, więc okresy przetestowano na odpowiedziach przygotowanych na podstawie dokumentacji API Deel. Na tej organizacji przetestowano połączenie, podmioty prawne, umowę z jej osobą i dostawcą, webhooki oraz powtórne przejście bez duplikatów.
Zanim go włączysz
- Odoo 17, 18, 19 lub 20 na własnym serwerze albo w Odoo.sh. Moduł nie działa w Odoo Online.
- Token organizacji Deel z uprawnieniami do odczytu, który tworzy administrator Deel w Developer Center. Według dokumentacji Deel raport brutto-netto wymaga
payslips:read, a lista okresówlegal-entity:read. Według samego modułu FlexigoTech Cloud przechowuje token zaszyfrowany, nigdy Twoje Odoo. Dziennik płacowykażdego podmiotu prawnego, który korzysta z Global Payroll.- Wiersze w
Konta płacowe. Za pierwszym razem każda nowa pozycja wstrzymuje swój okres, dopóki nie dasz jej kont albo jej nie zignorujesz. - Datę w
Importuj cykle płacowe z, jeśli chcesz pobrać okresy sprzed ponad 90 dni.
Faktury, które wystawia Deel, idą inną drogą i trafiają jako faktury od dostawcy, jak opisuje Deel invoice w Odoo, a ich płatności rejestruje się tak, jak pokazuje poradnik o płatnościach na rzecz Deel. To, co GL Sync robi z innymi programami księgowymi, porównujemy w integracjach księgowych Deel. 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
- help.letsdeel.com/hc/en-gb/articles/12602682257809-Customizing-And-Downloading-Gross-To-Ne
- help.letsdeel.com/hc/en-gb/articles/45125127111825-Accounting-Integrations-Pricing-and-Set
- developer.deel.com/api/reference/endpoints/reports/gets-g-2-n-report-data-for-a-given-payr
- Kod modułu: flexigo_deel_connector 20.0 (18442307): models/deel_payroll.py
- Kod modułu: flexigo_deel_connector 20.0 (18442307): models/deel_account.py
- Kod modułu: flexigo_deel_connector 20.0 (18442307): models/deel_maps.py
- developer.deel.com/api/reference/endpoints/list-cycles/list-payroll-cycles-v-2026-01-01
- Kod modułu: flexigo_deel_connector 20.0 (18442307): models/deel_legal_entity.py
- Kod modułu: flexigo_deel_connector 20.0 (18442307): data/deel_cron.xml
- Kod modułu: flexigo_deel_connector 20.0 (18442307): models/account_move.py
- Obliczenie FlexigoTech na podstawie przytoczonych liczb
- Kod modułu: flexigo_deel_connector 20.0 (18442307): models/deel_contract.py
- help.letsdeel.com/hc/en-gb/articles/46057955155217-Accounting-Integrations-Overview
- apps.odoo.com/apps/modules/20.0/flexigo_deel_connector
