I have created Invoice Adjustments, for some contract, but it didint display in Deel Invoice (bills) screen,
but I still can see it in API Endpoint List of Invoice adjustments, how does it works? And How I can create two or more Adjustments into one invoice?
Hello @IronRat,
To have access to the Adjustments on the UI, kindly refer to the session “Payments, expenses & work submissions” inside the worker profile. You need to submit the Adjustments individually and it will follow the payment cycle of the worker (defined on the contract creation). You can also submit off-cycle payments in case you don’t want to follow the payment cycle.
Hi @Gabriela_Deel,
It seems there was a bit of a misunderstanding, so let me clarify what we need.
We are integrating our ERP system with Deel. In our ERP, we have a Bill object that we create internally. Our goal is to migrate this bill to Deel — in other words, once a bill is generated in our ERP, we want to send it to Deel as an invoice.
For example, we may create a bill in our ERP with two adjustment lines:
- Hours: $300
- Bonus: $400
We need to know:
Which Deel API endpoint should we use to create this invoice in Deel?
Are there specific requirements or formats we should follow when submitting these line items?
Thanks in advance for your guidance!
Hi @IronRat ,
Here’s how it works:
- In Deel, invoices are generated automatically based on all approved work submissions and approved invoice adjustments by the worker’s payment cycle. You don’t create the invoice directly — Deel handles that based on what’s been approved.
- To send billing details from your ERP to Deel, you’ll need to:
- Use the Create Invoice Adjustment endpoint to submit each line item (e.g., Hours: $300, Bonus: $400) as a separate adjustment.
- Then, approve each adjustment using the Update Invoice Adjustment by ID endpoint.
- If the adjustments are approved before the worker’s payment cycle cut-off, Deel will automatically include them in that cycle’s invoice. If they’re not approved in time, they’ll roll over into the next one.
If you’re looking to group multiple line items under a single bill, the Deel system will do that for you on the invoice side — as long as those adjustments are approved in the same cycle.
Okay, that’s one of the options, but what if I want to create a bill outside of Deel and transfer it (still in unpaid status) into Deel, and then make the payment directly through Deel, with all payroll calculations handled entirely within Deel? Do you have any built-in functionality to support this workflow?
Basically, I don’t want to wait for Deel to generate the bill on its own — the invoice is already created, we just need to populate it into Deel.
Hello @IronRat
It depends on if you want for the payment to occur via Deel or if you only want to store this information into Deel.
For the 1st scenario, where you will make this payment using Deel:
- I recomment using Off cycle payments, once approved it will automatically generate an invoice.
For the 2nd scenario, where you only want to store this information inside Deel application:
- I recommend using custom fields, you can add a Custom Field either on the worker profile level or on the contract level.
On the UI, please go to Organizations settings → Custom fields (image attached)
After the custom field is created with the needed configuration, you can rely on Deel APIs to update this information: