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 Deel | Cosa fa il connettore in Odoo |
|---|---|
Pagamenti da GET /payments | Li legge dal passaggio precedente meno 7 giorni; la prima volta, da Importa fatture emesse da |
Stato processing | Il pagamento aspetta in In attesa di Deel e il connettore non chiede il suo dettaglio |
Stato paid | Il 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 riga | La fattura fornitore di quella fattura Deel, che riceve il suo pagamento |
paid_at | Data del pagamento in Odoo |
deel_reference | Causale del pagamento; se manca, l'etichetta del pagamento |
general_ledger_account | Salvato 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 FornitoresuBozza, da revisionare, il valore predefinito, qualcuno deve registrarla; conRegistrato 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.

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.

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
Verificato nel codice del connettore (versione 20.0) e nelle fonti collegate
Fonti
- help.letsdeel.com/hc/en-gb/articles/4407737772689-Making-Invoice-Payments-With-Deel
- developer.deel.com/api/reference/endpoints/accounting/retrieve-payment-receipts-v-2027-01-
- developer.deel.com/api/reference/endpoints/accounting/retrieve-a-payment-breakdown-v-2026-
- Codice del modulo: flexigo_deel_connector 20.0 (18442307): models/deel_payment.py
- Codice del modulo: flexigo_deel_connector 20.0 (18442307): models/deel_account.py
- Codice del modulo: flexigo_deel_connector 20.0 (18442307): models/deel_legal_entity.py
- Codice del modulo: flexigo_deel_connector 20.0 (18442307): data/deel_cron.xml
- Codice del modulo: flexigo_deel_connector 20.0 (18442307): models/deel_invoice.py
- Codice del modulo: 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
