Vai al contenuto principale
Deel

Deel contractor payments in Odoo: dal pagamento a Deel al pagamento di ogni fattura fornitore

Un'azienda che paga i suoi collaboratori tramite Deel fa un solo bonifico a Deel che copre più fatture. Il connettore Deel di FlexigoTech legge quel pagamento, lo ripartisce con il dettaglio che fornisce l'API di Deel e registra in Odoo un pagamento per ogni fattura fornitore, nel registro pagamenti dell'entità legale e con la data in cui è stato pagato Deel. Ecco le condizioni perché lo faccia, cosa succede se una fattura arriva in ritardo e cosa non fa.

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
6 min

Cos'è un pagamento in Deel

Questa guida guarda il pagamento dei collaboratori dal lato dell'azienda che paga. Nella scheda Pay di Finance, Deel seleziona per impostazione predefinita tutte le fatture in sospeso per pagarle in una volta, e l'azienda può togliere quelle che non vuole ancora pagare, tranne quelle che, secondo Deel, in alcuni casi possono essere obbligatorie, come quelle scadute. Se paga con bonifico, deve includere il riferimento Deel del pagamento. Finché il denaro non arriva, il pagamento risulta in elaborazione, e quando Deel conferma di averlo ricevuto passa a Paid. Così un pagamento a Deel salda in una volta le fatture di più collaboratori.

L'API di Deel separa le due cose. GET /payments elenca i pagamenti a Deel con il loro stato, che è paid o processing, i totali, la valuta e il metodo di pagamento, ma non contiene più le fatture che coprono. Per questo c'è GET /payments/{payment_id}/breakdown, che secondo Deel restituisce ogni fattura e la commissione di Deel come righe separate. Ogni riga porta, tra gli altri campi, l'identificativo della fattura (invoice_id), il contratto e il suo tipo, il nome della persona, l'importo con la sua valuta, l'importo nella valuta del pagamento e il conto di contabilità generale configurato in Deel (general_ledger_account).

Come lo ripartisce il connettore

Cosa manda DeelCosa fa il connettore in Odoo
Pagamenti da GET /paymentsLi legge dal passaggio precedente meno 7 giorni; la prima volta, da Importa fatture emesse da
Stato processingIl pagamento aspetta in In attesa di Deel e il connettore non chiede il suo dettaglio
Stato paidIl pagamento passa a Da registrare e il connettore legge il suo dettaglio, se Deel lo dà per pagato entro 7 giorni dalla sua creazione
invoice_id di ogni rigaLa fattura fornitore di quella fattura Deel, che riceve il suo pagamento
paid_atData del pagamento in Odoo
deel_referenceCausale del pagamento; se manca, l'etichetta del pagamento
general_ledger_accountSalvato in Conto contabile generale Deel, ma non decide dove va il pagamento

Ogni fattura viene pagata con la procedura guidata di registrazione dei pagamenti di Odoo, nel Registro Pagamenti della sua entità legale, così un pagamento a Deel che copre più fatture dà in Odoo un pagamento per fattura. Ogni pagamento è pari a quanto resta da pagare della sua fattura fornitore, non all'importo della riga del dettaglio: se qualcuno ha ritoccato la fattura in Odoo, si paga quello che dice la fattura. Se una fattura risulta già pagata in Odoo, il connettore non crea un altro pagamento, e una riga già pagata non viene pagata di nuovo nei passaggi successivi. Quando nessuna fattura deve aspettare, il pagamento Deel finisce in Registrato.

Le condizioni, tutte

Perché una fattura riceva il suo pagamento devono valere insieme tutte queste condizioni:

  • Nella connessione è spuntata la casella Pagamenti a Deel, come da impostazione predefinita.
  • Deel dà il pagamento per pagato (paid) entro 7 giorni dalla sua creazione.
  • La fattura Deel ha già la sua fattura fornitore in Odoo.
  • Quella fattura fornitore è registrata. Con Fatture Fornitore su Bozza, da revisionare, il valore predefinito, qualcuno deve registrarla; con Registrato quando tutto corrisponde, si registra da sola quando tutto corrisponde.
  • La sua entità legale ha un Registro Pagamenti, un registro di banca o di cassa. Quel campo parte vuoto in ogni nuova entità, e senza di esso le fatture restano non pagate in Odoo.

Se a una fattura manca una delle ultime tre condizioni, il pagamento resta in Alcune fatture non pronte, con un avviso che lo spiega, e le fatture in regola vengono pagate comunque. La sincronizzazione ci ripassa ogni 30 minuti, e appena la fattura è registrata e l'entità ha il registro, il suo pagamento viene registrato. Se la connessione riceve webhook, gli eventi payment.statement.initiated e payment.statement.mark-paid di Deel avviano prima la parte dei pagamenti, e i dati vengono riletti tramite l'API.

Fattura fornitore in bozza in Odoo, creata da una fattura Deel, con il fornitore, il riferimento della fattura Deel e due righe con IVA
Fattura fornitore in bozza di un collaboratore, creata da una fattura Deel (azienda e collaboratore inventati, dati dimostrativi).

Se il pagamento arriva prima della sua fattura

Il dettaglio può nominare una fattura Deel che Odoo non ha ancora: una emessa prima della data da cui importi, oppure quella di un lavoratore COR, che il connettore non chiede quando elenca le fatture. In quel caso la legge da Deel tramite il suo identificativo, con GET /invoices/{id}, e crea subito la sua fattura fornitore, con le stesse regole delle altre. Se quella fattura resta in bozza, come da impostazione predefinita, il pagamento aspetta in Alcune fatture non pronte finché qualcuno non la registra, e viene registrato al passaggio successivo.

Collaboratori con un proprio fornitore

In Deel i soldi vanno a Deel, ma in Odoo ogni fattura è intestata a un fornitore, e l'entità legale di Deel decide l'azienda, il registro acquisti e quel fornitore. Un collaboratore è il proprio fornitore: il connettore lo cerca tramite la sua email, ma solo tra i contatti di Odoo che sono già fornitori e non hanno un utente; se non lo trova, ne crea uno nuovo. Finché Deel non ha quella persona, per esempio perché non ha accettato l'invito, le sue fatture vanno al fornitore di Deel. Quelle di EOR e COR vanno sempre a Deel, al Fornitore Deel dell'entità legale o, se è vuoto, a quello della connessione. Poiché il pagamento viene registrato sulla fattura, salda il debito con lo stesso fornitore della fattura.

Elenco dei contratti Deel in Odoo con due collaboratori che hanno il loro fornitore, una dipendente in EOR e un dipendente Global Payroll con la sua scheda dipendente
I contratti Deel in Odoo: i due collaboratori compaiono con il loro fornitore (persone inventate, dati dimostrativi).

Cosa non fa

Il connettore non usa il conto di contabilità generale del dettaglio: lo salva in Conto contabile generale Deel, e il pagamento va nel registro pagamenti dell'entità. Non legge nemmeno le note di credito, che l'API di Deel fornisce con un'altra chiamata (GET /billing/invoices), né torna a leggere un pagamento ancora in elaborazione più di 7 giorni dopo la sua creazione, perché Deel, secondo il riferimento della sua API, filtra l'elenco dei pagamenti per data di creazione. Se Deel lo dà per pagato più tardi, il pagamento resta in In attesa di Deel senza alcun avviso e le sue fatture restano non pagate in Odoo. I webhook avviano questa stessa lettura, quindi nemmeno loro lo recuperano, e oggi non c'è nessun pulsante che lo faccia. Inoltre nessun pagamento è stato provato contro l'API reale di Deel. L'organizzazione dimostrativa di Deel contro cui è stato provato il connettore, tramite FlexigoTech Cloud, non aveva pagamenti, quindi questa parte è stata provata con risposte costruite sul riferimento dell'API di Deel, e nessuno ha ancora visto come arriva in un dettaglio reale la riga della commissione di Deel. 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.

Il connettore funziona su Odoo 17, 18, 19 e 20 sul tuo server o su Odoo.sh, non su Odoo Online. Come entra ogni fattura è in Deel invoice in Odoo, le paghe di Global Payroll in Deel gross to net e il confronto con Bill Sync, la sincronizzazione delle fatture di Deel, nelle sue integrazioni contabili. Il connettore è spiegato per intero nella sua pagina ed è pubblicato su Odoo Apps.

Continua a leggere

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 gross to net: dal report lordo-netto di ogni ciclo a una registrazione delle paghe in OdooCome il report gross to net (G2N) di ogni ciclo di Deel Global Payroll diventa in Odoo una registrazione che quadra, concetto per concetto, con un esempio.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.
Verificato nel codice del connettore (versione 20.0) e nelle fonti collegate

Fonti