Skip to main content
Deel

Deel invoice in Odoo: from the Deel invoice to the vendor bill

Every invoice Deel issues to your company, whether it is for a contractor, an EOR employee or Deel's own fees, can reach Odoo as a vendor bill exactly once, with its PDF, its VAT and the contract's cost centers. Here is what FlexigoTech's Deel connector does with it and what to set up first.

FlexigoTech · Editor in charge: Víctor Gómez · Updated 18 November 2026

Key facts

Module
Deel
Versions
Odoo 17, 18, 19 and 20
Checked
in the connector's source code, version 20.0 · against the sources linked at the end
Reading time
5 min

The Deel invoice the paying company sees

Search for "deel invoice" and most results explain how a contractor creates an invoice in Deel. This guide covers the other side: the company that receives those invoices and has to get them into its books. In Deel, the company handles payments and invoices on the Billing tab, under Finance, where it can download them one at a time or in a zip of up to 50 documents. Without a connector, someone retypes each PDF into Odoo.

The Deel API returns more than the PDF shows. Its invoice list only includes paid and refunded invoices by default, so the connector asks for status=all and gets the pending ones as well. Invoices for Deel's own fees come from a separate call, GET /invoices/deel, and the connector imports those too.

The connector was tested end to end through FlexigoTech Cloud against a Deel demo organization (demo.deel.com): the connection, legal entities, a contract with its person and vendor, webhooks and a second sync without duplicates. That organization had no invoices, payments or payroll cycles yet, so that part was tested with answers modelled on Deel's API reference. Whether Deel's invoice list also includes EOR invoices still has to be confirmed with a real organization.

What Deel sendsWhere it ends up in Odoo
The invoice's line items (line_items)One vendor bill line per item, with its description
amount and deel_feeWhen the invoice has no line items, one line for the amount and one for the Deel fee
vat_percentageThe Odoo tax you mapped to that rate under VAT rates
Issue date and due dateBill date and, when there are no payment terms, the due date
Deel invoice numberBill reference and payment reference
PDFAttachment on the vendor bill, up to 20 MB

How it becomes a vendor bill

Each Deel invoice is stored in Odoo with its Deel ID, and the connector never lets the same invoice produce two vendor bills, even when two runs overlap or two connections read the same Deel organization. The Deel legal entity decides the Odoo company, the purchase journal and the vendor, and a contractor who has their own vendor in Odoo goes to that vendor. A negative total produces a vendor refund.

Draft vendor bill in Odoo created from a Deel invoice, with the vendor, the Deel invoice reference and two lines with VAT
Draft vendor bill created from a Deel invoice (made-up company and contractor, demo data).

The lines come from the invoice's line items in Deel and carry the contract's analytic distribution, so the cost centers arrive already filled in. Only the Deel fee line of an invoice without line items goes without it. The import stops with a warning, without creating the bill, when a Deel VAT rate has no Odoo tax mapped in the connection, when the currency is not active in Odoo or when the Deel legal entity has no purchase journal, among other cases.

Before it calls the bill done, the connector compares the Odoo total with the Deel total. If they differ by more than 0.01, it sets the invoice to To review with a message that gives both totals and asks you to check the taxes before posting. The connection's Vendor bills field decides the rest: with Draft, to review, the default, every bill stays in draft; with Posted when everything matches, bills post themselves when the total matches.

The states of a Deel invoice in Odoo

StateWhat it means
To importRead from Deel, no vendor bill yet
Bill createdIts vendor bill exists in Odoo
To reviewThe total does not match, or Deel changed it later, and a person decides

Invoices with a zero total do not produce a vendor bill, and neither do invoices for contractors or EOR employees that Deel marks as cancelled, failed or unpayable. If something needed to create the bill is missing, such as a tax or a currency, the invoice goes to error with a warning that says what is missing.

Deel invoice record in Odoo with its kind, contract, legal entity, amounts, VAT and the link to the vendor bill
The Deel invoice inside Odoo, in the Bill created state and linked to its draft vendor bill.

When Deel changes or cancels the invoice later

If Deel changes an invoice's total, or cancels an invoice for a contractor or an EOR employee, after the vendor bill exists in Odoo, the connector leaves that vendor bill alone, because it may already be posted or paid. It moves the Deel invoice to To review and opens a warning with what changed, so someone can cancel the bill or add a credit note. To catch those changes, the sync runs every 30 minutes and reads again whatever was issued in the 7 days before the previous run. Older invoices that already have a vendor bill and are still unpaid get checked one by one, up to 100 per run.

Before you switch it on

  • Odoo 17, 18, 19 or 20 on your own server or on Odoo.sh. The module does not work on Odoo Online.
  • A Deel organization token with read permissions, created by a Deel admin in the Developer Center. You paste it into the connection and FlexigoTech Cloud keeps it encrypted; it never stays in your Odoo. The Authorize with Deel option will work once Deel approves the FlexigoTech app; until then the connector asks you to use the token.
  • An Odoo tax for every VAT rate your invoices carry, under VAT rates.
  • The Payments journal of each Deel legal entity, which starts empty. Without it, the connector does not register payments to Deel in Odoo; with it, it registers them on vendor bills that are already posted.
  • The date to import from. If you leave it as it is, invoices issued in the 60 days before you created the connection come in.

When one Deel organization pays from several entities, each legal entity goes to its own Odoo company, with its own journals and vendor. If you also run Global Payroll, payroll arrives as one journal entry per cycle, and we compare that with what Deel offers in its accounting integrations. The connector is explained in full on its page and published on Odoo Apps.

Keep reading

Deel accounting integrations: what GL Sync and Bill Sync do and how to get them in OdooDeel connects its accounting data to NetSuite, Xero, QuickBooks, Sage, SAP and Dynamics. Odoo is not on that list: what a connector covers and what it does not.
Checked in the connector's source code (version 20.0) and the linked sources

Sources