Het gross-to-net-rapport van Deel
Volgens het helpcentrum van Deel maakt Deel Global Payroll elke periode een bruto-netto-rapport, in alle landen in hetzelfde formaat, en elk rapport gaat over één periode. Je opent het in Analytics, bij de loonrapporten, en exporteert het als CSV, XLSX of pdf. Deel waarschuwt ook dat de G2N looncijfers bevat en geen boekhoudregels, dus er zitten geen debet- en creditboekingen in, geen logica om rekeningen toe te wijzen en geen controle. Zonder integratie maakt iemand van de boekhouding de boeking van elke periode met de hand op basis van die download.
De API van Deel geeft hetzelfde rapport per periode met GET /reports/payroll/cycles/{cycle_id}/gross-to-net. Voor elk contract geeft hij de valuta (currency), de wisselkoers tussen de valuta van het loon en die van de betaling (conversion_rate) en de lijst met concepten, elk met zijn naam (label), zijn bedrag (value), zijn categorie en een van deze groepen (category_group):
| Groep bij Deel | Wat erin zit |
|---|---|
ADDITIONS | Wat bij het brutoloon komt, zoals het basissalaris |
DEDUCTIONS | Wat de persoon wordt ingehouden, zoals de loonheffing en de eigen premie |
BENEFITS | Voordelen |
CONTRIBUTIONS | Werkgeversbijdragen |
INFOS | Informatie |
TOTALS | Totalen, zoals het netto te betalen bedrag |
De connector leest alle pagina's van het rapport en bewaart elk concept als een regel van de periode in Odoo. Deel geeft 20 contracten per pagina als er geen andere grootte wordt gevraagd; de connector vraagt er 50, en dat is nog niet met een echt rapport getest.
Wanneer een periode klaar is
De connector vraagt de perioden van elke rechtspersoon op met GET /legal-entities/{legal_entity_id}/payroll-events, maar alleen voor rechtspersonen met een Lonenboek. Elke nieuwe rechtspersoon krijgt als loonboek het eerste algemene dagboek van zijn bedrijf; haal je dat weg, dan geeft die rechtspersoon geen loonboekingen meer. Elke keer leest hij vanaf de datum bij Looncycli geïmporteerd vanaf, standaard 90 dagen voor de dag waarop je de koppeling maakt: de connector onthoudt niet tot waar hij heeft gelezen, dus elke run vraagt de perioden vanaf die datum opnieuw op.
Deel markeert elke periode met has_g2n_report, en volgens de documentatie is dat alleen waar als de periode is gepubliceerd en het rapport geen blokkerende fouten heeft. In Odoo is dat het vakje Bruto-na-netto klaar, en dat zet de periode van Wacht op Deel op Te posten. Daarna krijgt de periode haar boeking (Post gemaakt), stopt ze bij Concepten koppelen als een concept nog rekeningen mist, of komt ze met een melding op Fout. De synchronisatie draait elke 30 minuten; ontvangt de koppeling webhooks, dan start het event gp.payslips.available van Deel het loondeel eerder, en de gegevens worden altijd opnieuw via de API gelezen.
Elk concept naar zijn rekeningen
De toewijzing staat op het tabblad Lonenrekeningen van de koppeling, en elke regel zegt wat er met een concept gebeurt: Verwerken, de standaardwaarde, of Negeer. Een regel die verwerkt, heeft een Debitrekening en een Creditrekening, en het bedrag van het concept gaat volledig naar allebei, zodat elke boeking door haar opbouw altijd sluit. Een regel zonder concept geldt voor de hele groep, en een zonder rechtspersoon voor alle rechtspersonen van de koppeling. Passen meerdere regels op een regel van het rapport, dan wint de meest specifieke: die van die rechtspersoon en dat concept, dan die van die rechtspersoon en de groep, dan die van elke rechtspersoon met dat concept en tot slot die van elke rechtspersoon met die groep.
Komt er een concept binnen zonder klare regel, dan blijft de periode op Concepten koppelen: de connector maakt de ontbrekende regel aan en opent een melding die om een debet- en een creditrekening vraagt, of om het concept te negeren. Hetzelfde gebeurt met een groep die de connector niet kent: hij bewaart die als INFOS, en ook die heeft een eigen regel nodig, zodat geen bedrag buiten beeld blijft zonder dat iemand het heeft gezien. Het vakje Kostenplaatsen van elke regel staat aan, en daardoor krijgt de debetregel de kostenplaatsen van het Deel-contract van die persoon.

Valuta, datum en detail per persoon
Elk concept komt binnen in de valuta die het rapport aan zijn contract geeft, of in die van het bedrijf als het rapport er geen geeft. Is die valuta in Odoo niet actief, dan stopt de periode met een melding om haar te activeren en het opnieuw te proberen. Het bedrag in de valuta van je bedrijf komt uit de wisselkoersen van Odoo op de boekingsdatum: de conversion_rate van Deel wordt op de regel van de periode bewaard, maar de boeking gebruikt hem niet.
De boeking gaat naar het loonboek van de rechtspersoon, met de einddatum van de periode en een referentie met de naam van de periode. Daarin worden bedragen van hetzelfde concept met dezelfde rekeningen, kostenplaatsen en valuta opgeteld, zodat er één paar regels per concept ontstaat en niet per persoon. Het detail van elke persoon blijft in de regels van de periode, die alleen de boekhoudbeheerders van Odoo zien. Maar heeft de rechtspersoon maar één persoon, of heeft elke persoon een eigen kostenplaats, dan toont de boeking het loon van die persoon aan iedereen die boekingen kan zien. Elke periode levert één boeking op, ook als twee runs overlappen, en het veld Lonenboekingen bepaalt of die als Concept, te controleren blijft staan, de standaardwaarde, of Verwerkt wordt.
Een voorbeeldperiode, met de hand sluitend gemaakt

De periode in de schermafbeelding is een REGULAR-periode van een verzonnen bedrijf, Lumbre Analytics, S.L., van 30 september tot 30 oktober 2026, met één Global Payroll-contract in euro. De toewijzing gebruikt rekeningen uit het PGC, het rekeningschema van deze S.L.: 640 voor lonen, 642 voor de werkgeverspremies, 4751 voor inhoudingen, 476 voor de sociale zekerheid en 465 voor het nog te betalen nettoloon. Met die demogegevens zou de code van de connector deze boeking geven, met de hand doorgerekend:
| Concept | Groep bij Deel | Debet (rekening) | Credit (rekening) |
|---|---|---|---|
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 | Op Negeer, niet geboekt | |
| Totaal | 6091,8 | 6091,8 |
Elk concept wordt twee keer geboekt, een keer debet en een keer credit, en daarom komen beide kolommen op hetzelfde totaal. Rekening 465 krijgt 3900 credit en 702 en 253,5 debet, en houdt 2944,5 credit over, het Neto a pagar van het rapport. Daarom staat de regel van TOTALS in dit voorbeeld op Negeer: het nettobedrag volgt al uit de andere regels. Rekening 476 verzamelt 1489,8 sociale zekerheid, 4751 de 702 aan inhoudingen, en de kosten van de periode voor het bedrijf staan op 640 en 642, samen 5136,3.
Wat hij niet dekt
De loonverwerking van PEO heeft geen eigen behandeling: de connector behandelt PEO-contracten als EOR, terwijl GL Sync, de boekhoudintegratie van Deel, PEO wel naar het grootboek brengt. Bovendien is niets hiervan getest tegen de echte API van Deel. De demo-organisatie van Deel waartegen de connector via FlexigoTech Cloud is getest, had nog geen loonperiodes, dus de perioden zijn getest met nagebootste antwoorden op basis van de API-referentie van Deel. Tegen die organisatie zijn wel getest: de verbinding, de rechtspersonen, een contract met zijn persoon en zijn leverancier, de webhooks en een tweede run zonder duplicaten.
Voordat je hem aanzet
- Odoo 17, 18, 19 of 20 op je eigen server of op Odoo.sh. De module werkt niet op Odoo Online.
- Een organisatietoken van Deel met leesrechten, dat een Deel-beheerder in het Developer Center maakt. Volgens de documentatie van Deel vraagt het bruto-netto-rapport
payslips:readen de lijst met periodenlegal-entity:read. Volgens de module zelf bewaart FlexigoTech Cloud het token versleuteld, nooit je Odoo. - Het
Lonenboekvan elke rechtspersoon die Global Payroll gebruikt. - De regels onder
Lonenrekeningen. De eerste keer houdt elk nieuw concept zijn periode tegen tot je het rekeningen geeft of het negeert. - De datum bij
Looncycli geïmporteerd vanaf, als je perioden van meer dan 90 dagen terug wilt ophalen.
De facturen die Deel uitreikt, gaan een andere weg en komen binnen als leveranciersfacturen, zoals Facturen van Deel in Odoo uitlegt, en hun betalingen worden geregistreerd zoals de gids over betalingen aan Deel laat zien. Wat GL Sync met andere boekhoudprogramma's doet, vergelijken we in de boekhoudintegraties van Deel. De connector staat volledig uitgelegd op zijn pagina en is gepubliceerd op Odoo Apps.
Lees verder
Gecontroleerd in de broncode van de connector (versie 20.0) en in de gelinkte bronnen
Bronnen
- 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
- Broncode van de module: flexigo_deel_connector 20.0 (18442307): models/deel_payroll.py
- Broncode van de module: flexigo_deel_connector 20.0 (18442307): models/deel_account.py
- Broncode van de module: 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
- Broncode van de module: flexigo_deel_connector 20.0 (18442307): models/deel_legal_entity.py
- Broncode van de module: flexigo_deel_connector 20.0 (18442307): data/deel_cron.xml
- Broncode van de module: flexigo_deel_connector 20.0 (18442307): models/account_move.py
- Berekening van FlexigoTech met de genoemde cijfers
- Broncode van de module: 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
