Przejdź do głównej treści
Deel

Deel gross to net: od raportu brutto-netto każdego okresu do zapisu płacowego w Odoo

Deel Global Payroll tworzy w każdym okresie raport brutto-netto (gross to net, G2N), w którym pozycje każdej umowy są podzielone na grupy, takie jak dodatki do wynagrodzenia brutto, potrącenia, składki pracodawcy i sumy. Konektor Deel od FlexigoTech czyta ten raport przez API i tworzy z niego w Odoo jeden zapis na okres, w którym każda pozycja trafia na konta, które jej przypiszesz. Oto jak to robi, czego nie obejmuje i przykładowy okres przeliczony ręcznie.

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

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 DeelCo obejmuje
ADDITIONSTo, co dochodzi do wynagrodzenia brutto, na przykład pensja zasadnicza
DEDUCTIONSTo, co potrąca się osobie, na przykład jej zaliczkę na podatek i jej składkę
BENEFITSŚwiadczenia
CONTRIBUTIONSSkładki pracodawcy
INFOSInformacje
TOTALSSumy, 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.

Lista umów Deel w Odoo z pracownikiem Global Payroll i jego kartoteką pracownika, pracownicą w modelu EOR i dwoma kontraktorami z ich dostawcą
Umowy Deel w Odoo, z umową Global Payroll i jej pracownikiem (wymyślone osoby, dane demonstracyjne).

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 płacowy Deel w Odoo w statusie Wpis utworzony, z zaznaczonym polem Gotowy do brutto-do-netto i pięcioma pozycjami z grupą, kwotą w EUR i wierszem mapowania
Okres Global Payroll w Odoo z zapisem w wersji roboczej i pięcioma pozycjami (wymyślona firma i umowa, dane demonstracyjne).

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:

PozycjaGrupa w DeelWinien (konto)Ma (konto)
Salario baseADDITIONS3900 (640)3900 (465)
IRPFDEDUCTIONS702 (465)702 (4751)
Seguridad Social trabajadorDEDUCTIONS253,5 (465)253,5 (476)
Seguridad Social empresaCONTRIBUTIONS1236,3 (642)1236,3 (476)
Neto a pagarTOTALSNa Ignoruj, nie wchodzi
Suma6091,86091,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ów legal-entity:read. Według samego modułu FlexigoTech Cloud przechowuje token zaszyfrowany, nigdy Twoje Odoo.
  • Dziennik płacowy każ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

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.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 contractor payments w Odoo: od płatności na rzecz Deel do płatności każdej faktury od dostawcyJak płatność na rzecz Deel, która obejmuje kilka faktur, staje się w Odoo jedną płatnością na fakturę od dostawcy i jakie warunki musi spełnić każda faktura.
Sprawdzone w kodzie źródłowym konektora (wersja 20.0) i w podlinkowanych źródłach

Źródła