La Deel invoice vista dall'azienda che paga
Chi cerca «deel invoice» trova di solito come un collaboratore crea la sua fattura in Deel. Questa guida parla dell'altro lato: l'azienda che riceve quelle fatture e deve portarle in contabilità. In Deel l'azienda gestisce pagamenti e fatture nella scheda Billing, sotto Finance, e da lì le scarica una alla volta o in uno zip di massimo 50 documenti. Senza connettore, qualcuno ricopia ogni PDF in Odoo.
L'API di Deel dice più del PDF. Il suo elenco di fatture restituisce per impostazione predefinita solo quelle pagate e rimborsate, quindi il connettore lo chiede con status=all e riceve anche quelle in sospeso. Le fatture delle commissioni di Deel arrivano da un'altra chiamata, GET /invoices/deel, e il connettore importa anche quelle.
Il connettore è stato provato da cima a fondo, tramite FlexigoTech Cloud, contro un'organizzazione dimostrativa di Deel (demo.deel.com): la connessione, le entità legali, un contratto con la sua persona e il suo fornitore, i webhook e un secondo passaggio senza duplicati. Quell'organizzazione non aveva ancora fatture, pagamenti né cicli di paga, quindi questa parte è stata provata con risposte costruite sul riferimento dell'API di Deel. Che l'elenco delle fatture di Deel includa anche quelle dei dipendenti in EOR resta da verificare con un'organizzazione reale.
| Cosa manda Deel | Dove finisce in Odoo |
|---|---|
Le voci della fattura (line_items) | Una riga della fattura fornitore per voce, con la sua descrizione |
amount e deel_fee | Se la fattura non ha voci, una riga con l'importo e una con la commissione Deel |
vat_percentage | L'imposta di Odoo che hai associato a quell'aliquota in Aliquote IVA |
| Data di emissione e di scadenza | Data della fattura e, se non ci sono termini di pagamento, la scadenza |
| Numero della fattura in Deel | Riferimento della fattura e del pagamento |
| Allegato della fattura fornitore, fino a 20 MB |
Come diventa una fattura fornitore
Ogni fattura Deel viene salvata in Odoo con il suo identificativo Deel, e il connettore non permette mai due fatture fornitore per la stessa fattura, anche se due passaggi si sovrappongono o due connessioni leggono la stessa organizzazione Deel. L'entità legale di Deel decide l'azienda di Odoo, il registro acquisti e il fornitore, e un collaboratore che ha un proprio fornitore in Odoo va su quel fornitore. Con un totale negativo nasce una nota di credito fornitore.

Le righe vengono dalle voci che la fattura ha in Deel e portano la distribuzione analitica del contratto, così i centri di costo arrivano già compilati. Solo la riga della commissione di una fattura senza voci ne resta priva. L'importazione si ferma con un avviso, senza creare la fattura, tra l'altro quando un'aliquota IVA di Deel non ha un'imposta di Odoo associata nella connessione, quando la valuta non è attiva in Odoo o quando l'entità legale di Deel non ha un registro acquisti.
Prima di considerarla pronta, il connettore confronta il totale della fattura in Odoo con quello di Deel. Se differiscono di più di 0,01, la mette in Da revisionare con un messaggio che riporta i due totali e chiede di controllare le imposte prima di registrare. Il campo Fatture Fornitore della connessione decide il resto: con Bozza, da revisionare, il valore predefinito, restano tutte in bozza; con Registrato quando tutto corrisponde, si registrano da sole quando il totale torna.
Gli stati di una fattura Deel in Odoo
| Stato | Cosa significa |
|---|---|
Da importare | Letta da Deel, ancora senza fattura fornitore |
Fattura creata | La sua fattura fornitore esiste in Odoo |
Da revisionare | Il totale non torna o Deel l'ha cambiata dopo, e decide una persona |
Le fatture con totale zero non creano una fattura fornitore, e nemmeno quelle di collaboratori o di dipendenti in EOR che Deel segna come annullate, fallite o non pagabili. Se manca qualcosa per crearla, come un'imposta o una valuta, la fattura va in errore con un avviso che dice cosa manca.

Fattura creata e collegata alla sua fattura fornitore in bozza.Se Deel cambia o annulla la fattura dopo
Se Deel cambia il totale di una fattura, o annulla quella di un collaboratore o di un dipendente in EOR, quando in Odoo esiste già la fattura fornitore, il connettore non tocca quella fattura fornitore, perché può essere già registrata o pagata: mette la fattura Deel in Da revisionare e apre un avviso con la modifica, così qualcuno annulla la fattura o emette una nota di credito. Per accorgersene, la sincronizzazione gira ogni 30 minuti e rilegge quanto emesso nei 7 giorni prima dell'ultimo passaggio. Le fatture più vecchie che hanno già la fattura fornitore e non sono ancora pagate vengono ricontrollate una per una, fino a 100 per passaggio.
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. Lo incolli nella connessione e FlexigoTech Cloud lo conserva cifrato, mai il tuo Odoo. L'opzione
Autorizza con Deelfunzionerà quando Deel approverà l'app di FlexigoTech; fino ad allora il connettore chiede di usare il token. - Un'imposta di Odoo per ogni aliquota IVA delle tue fatture, in
Aliquote IVA. - Il
Registro Pagamentidi ogni entità legale di Deel, che parte vuoto. Senza di esso il connettore non registra in Odoo i pagamenti a Deel; con esso li applica alle fatture fornitore già registrate. - La data da cui importare. Se non la cambi, entrano le fatture emesse nei 60 giorni prima della creazione della connessione.
Quando un'organizzazione Deel paga da più entità, ogni entità legale va nella sua azienda di Odoo, con i suoi registri e il suo fornitore. Se usi anche Global Payroll, le paghe arrivano come una registrazione per ciclo, e lo confrontiamo con quello che offre 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/20301708484753-How-to-Download-Invoices-and-Manage-Pay
- developer.deel.com/api/reference/endpoints/accounting/retrieve-invoices-v-2026-01-01
- Codice del modulo: flexigo_deel_connector 20.0 (18442307): models/deel_invoice.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_account.py
- apps.odoo.com/apps/modules/20.0/flexigo_deel_connector
- Codice del modulo: flexigo_deel_connector 20.0 (18442307): models/deel_payment.py
- Codice del modulo: flexigo_deel_connector 20.0 (18442307): models/deel_legal_entity.py
