Vai al contenuto principale
Deel

Deel gross to net: dal report lordo-netto di ogni ciclo a una registrazione delle paghe in Odoo

Deel Global Payroll genera a ogni ciclo un report lordo-netto (gross to net, G2N) con i concetti di ogni contratto suddivisi in gruppi come le aggiunte al lordo, le trattenute, i contributi del datore di lavoro e i totali. Il connettore Deel di FlexigoTech legge questo report tramite l'API e ne ricava una registrazione per ciclo in Odoo, in cui ogni concetto va sui conti che gli assegni. Ecco come lo fa, cosa non copre e un ciclo di esempio calcolato a mano.

FlexigoTech · Responsabile: Víctor Gómez · Aggiornato il 18 novembre 2026

In breve

Modulo
Deel
Versioni
Odoo 17, 18, 19 e 20
Verificato
nel codice del connettore, versione 20.0 · nelle fonti collegate in fondo
Lettura
8 min

Il report gross to net di Deel

Secondo il suo centro assistenza, Deel Global Payroll genera un report lordo-netto a ogni ciclo, con lo stesso formato in tutti i paesi, e ogni report riguarda un solo ciclo. Si apre in Analytics, tra i report delle paghe, e si esporta in CSV, XLSX o PDF. Deel avverte anche che il G2N riporta risultati delle paghe e non regole contabili, quindi non porta movimenti in dare e avere, né una logica per assegnare i conti, né una validazione. Senza un'integrazione, qualcuno della contabilità prepara a mano la registrazione di ogni ciclo partendo da quel download.

L'API di Deel fornisce lo stesso report per ciclo con GET /reports/payroll/cycles/{cycle_id}/gross-to-net. Per ogni contratto restituisce la valuta (currency), il tasso di cambio tra la valuta delle paghe e quella del pagamento (conversion_rate) e l'elenco dei concetti, ciascuno con il suo nome (label), il suo importo (value), la sua categoria e uno di questi gruppi (category_group):

Gruppo di DeelCosa raccoglie
ADDITIONSCiò che si aggiunge allo stipendio lordo, come lo stipendio base
DEDUCTIONSCiò che viene trattenuto alla persona, come la sua ritenuta e il suo contributo
BENEFITSBenefit
CONTRIBUTIONSContributi del datore di lavoro
INFOSInformazioni
TOTALSTotali, come il netto da pagare

Il connettore legge tutte le pagine del report e salva ogni concetto come una riga del ciclo in Odoo. Deel restituisce 20 contratti per pagina se non gli si chiede un'altra dimensione; il connettore ne chiede 50, e questo non è stato provato con un report reale.

Quando un ciclo è pronto

Il connettore chiede i cicli di ogni entità legale con GET /legal-entities/{legal_entity_id}/payroll-events, ma solo per le entità che hanno un Registro di Paghe. Ogni nuova entità prende come registro delle paghe il primo registro generale della sua azienda; se lo togli, quell'entità non produce più registrazioni delle paghe. Ogni lettura parte dalla data di Importa cicli di busta paga da, che per impostazione predefinita è 90 giorni prima del giorno in cui crei la connessione: il connettore non tiene traccia di fin dove ha letto, quindi ogni passaggio richiede di nuovo i cicli da quella data.

Deel contrassegna ogni ciclo con has_g2n_report, e la sua documentazione dice che è vero solo quando il ciclo è pubblicato e il suo report non ha errori bloccanti. In Odoo è la casella Pronto per lordo-netto, ed è ciò che porta il ciclo da In attesa di Deel a Da registrare. Da lì il ciclo riceve la sua registrazione (Registrazione creata), si ferma su Mappa concetti se a qualche concetto mancano i conti, oppure finisce in Errore con un avviso. La sincronizzazione gira ogni 30 minuti; se la connessione riceve webhook, l'evento gp.payslips.available di Deel avvia prima la parte delle paghe, e i dati vengono sempre riletti tramite l'API.

Ogni concetto sui suoi conti

La mappatura sta nella scheda Conti di Paghe della connessione, e ogni riga dice cosa fare di un concetto: Registra, il valore predefinito, oppure Ignora. Una riga che registra ha un Conto debito e un Conto credito, e l'importo del concetto va per intero su entrambi, così ogni registrazione quadra per costruzione. Una riga senza concetto vale per tutto il suo gruppo, e una senza entità legale per tutte le entità della connessione. Se più righe corrispondono a una riga del report, vince la più precisa: quella di quell'entità e di quel concetto, poi quella di quell'entità e del suo gruppo, poi quella di qualsiasi entità con quel concetto e infine quella di qualsiasi entità con quel gruppo.

Quando arriva un concetto senza una riga pronta, il ciclo resta su Mappa concetti: il connettore crea la riga che manca e apre una segnalazione che chiede un conto in dare e uno in avere, oppure di ignorarlo. Lo stesso accade con un gruppo che il connettore non conosce, che salva come INFOS e che ha bisogno anch'esso della sua riga, così nessun importo resta fuori senza che qualcuno l'abbia visto. La casella Centri di costo di ogni riga è spuntata, e con essa la riga in dare porta i centri di costo del contratto Deel di quella persona.

Elenco dei contratti Deel in Odoo con un dipendente Global Payroll e la sua scheda dipendente, una dipendente in EOR e due collaboratori con il loro fornitore
I contratti Deel in Odoo, con quello di Global Payroll e il suo dipendente (persone inventate, dati dimostrativi).

Valuta, data e dettaglio per persona

Ogni concetto entra nella valuta che il report dà al suo contratto, o in quella dell'azienda se il report non la indica. Se quella valuta non è attiva in Odoo, il ciclo si ferma con un avviso che chiede di attivarla e riprovare. L'importo nella valuta della tua azienda viene dai tassi di cambio di Odoo alla data della registrazione: il conversion_rate di Deel viene salvato sulla riga del ciclo, ma la registrazione non lo usa.

La registrazione va nel registro delle paghe dell'entità legale, con la data di fine del ciclo e un riferimento che porta il nome del ciclo. Al suo interno, gli importi dello stesso concetto che condividono conti, centri di costo e valuta si sommano, quindi esce una coppia di righe per concetto e non per persona. Il dettaglio di ogni persona resta nelle righe del ciclo, che vedono solo gli amministratori della contabilità di Odoo. Ma se l'entità ha una sola persona, o se ogni persona ha il suo centro di costo, la registrazione mostra il suo stipendio a chiunque possa vedere le registrazioni. Ogni ciclo dà una sola registrazione anche se due passaggi si sovrappongono, e il campo Registrazioni di Paghe decide se resta in Bozza, da revisionare, il valore predefinito, o esce Registrato.

Un ciclo di esempio, quadrato a mano

Ciclo paghe di Deel in Odoo nello stato Registrazione creata, con la casella Pronto per lordo-netto spuntata e cinque concetti con gruppo, importo in EUR e riga della mappatura
Un ciclo di Global Payroll in Odoo con la sua registrazione in bozza e i suoi cinque concetti (azienda e contratto inventati, dati dimostrativi).

Il ciclo della schermata è un ciclo REGULAR di un'azienda inventata, Lumbre Analytics, S.L., dal 30 settembre al 30 ottobre 2026, con un contratto di Global Payroll in euro. La sua mappatura usa conti del PGC, il piano dei conti di questa S.L.: 640 per gli stipendi, 642 per i contributi a carico dell'azienda, 4751 per le ritenute, 476 per la previdenza sociale e 465 per il netto ancora da pagare. Con questi dati dimostrativi, il codice del connettore darebbe questa registrazione, calcolata a mano:

ConcettoGruppo di DeelDare (conto)Avere (conto)
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 pagarTOTALSSu Ignora, non entra
Totale6091,86091,8

Ogni concetto viene registrato due volte, una in dare e una in avere, ed è per questo che le due colonne danno lo stesso totale. Il conto 465 riceve 3900 in avere e 702 e 253,5 in dare, e chiude con 2944,5 in avere, cioè il Neto a pagar del report. Per questo, in questo esempio, la riga di TOTALS è su Ignora: il netto esce già dalle altre righe. Il 476 accumula 1489,8 di previdenza sociale, il 4751 i 702 di ritenute, e il costo del ciclo per l'azienda resta su 640 e 642, con 5136,3 in tutto.

Cosa non copre

Le paghe PEO non hanno un trattamento proprio: il connettore tratta i contratti PEO come EOR, mentre GL Sync, l'integrazione contabile di Deel, porta il PEO in contabilità generale. Inoltre niente di tutto questo è stato provato contro l'API reale di Deel. L'organizzazione dimostrativa di Deel contro cui è stato provato il connettore, tramite FlexigoTech Cloud, non aveva ancora cicli di paga, quindi i cicli sono stati provati con risposte costruite sul riferimento della sua API. Contro quell'organizzazione sono stati provati la connessione, le entità legali, un contratto con la sua persona e il suo fornitore, i webhook e un secondo passaggio senza duplicati.

Prima di attivarlo

  • Odoo 17, 18, 19 o 20 sul tuo server o su Odoo.sh. Il modulo non funziona su Odoo Online.
  • Un token di organizzazione Deel con permessi di lettura, creato da un amministratore Deel nel Developer Center. Secondo la documentazione di Deel, il report lordo-netto richiede payslips:read e l'elenco dei cicli legal-entity:read. Secondo il modulo stesso, FlexigoTech Cloud conserva il token cifrato, mai il tuo Odoo.
  • Il Registro di Paghe di ogni entità legale che usa Global Payroll.
  • Le righe di Conti di Paghe. La prima volta, ogni nuovo concetto ferma il suo ciclo finché non gli dai i conti o lo ignori.
  • La data di Importa cicli di busta paga da, se vuoi portare cicli di più di 90 giorni fa.

Le fatture emesse da Deel seguono un'altra strada ed entrano come fatture fornitore, come racconta Deel invoice in Odoo, e i loro pagamenti vengono registrati come spiega la guida ai pagamenti a Deel. Cosa fa GL Sync con altri programmi di contabilità lo confrontiamo nelle integrazioni contabili di Deel. Il connettore è spiegato per intero nella sua pagina ed è pubblicato su Odoo Apps.

Continua a leggere

Deel integrations contabili: cosa fanno GL Sync e Bill Sync e come averle in OdooDeel collega i suoi dati contabili a NetSuite, Xero, QuickBooks, Sage, SAP e Dynamics. Odoo non è nella lista: cosa copre un connettore e cosa no.Deel invoice in Odoo: dalla fattura di Deel alla fattura fornitoreCosa contiene una Deel invoice di collaboratori, EOR o commissioni Deel e come arriva in Odoo come fattura fornitore, con IVA, PDF e centri di costo.Deel contractor payments in Odoo: dal pagamento a Deel al pagamento di ogni fattura fornitoreCome un pagamento a Deel che copre più fatture diventa in Odoo un pagamento per fattura fornitore, e quali condizioni deve rispettare ogni fattura.
Verificato nel codice del connettore (versione 20.0) e nelle fonti collegate

Fonti