We have a client that wants to send Imputed income from their recognition and rewards platform into their Deel platform through an automation leveraging API connections.
We have the data for the imputed income and any necessary accompanying user data, but are unsure if Deel’s Global Payroll API or Off-Cycle Payments API would be the right destination for the imputed income inputs.
Is there an endpoint on the current API that would work?
If not, what is the recommendation to the client on how we could most easily get this data to them in a method with the least amount of human/manual intervention.
Thank you!!
Hello @cameron.fry,
This extra income can indeed be added via API, but on what endpoint to use it depends on what type of worker your client is referring to.
For Contractors: Create off cycle payment
For other types (EOR or GP): Create adjustment and Get categories to find the right category for the extra income
Kindly let us know in case you have further doubts 
Thank you so much! I’ll be sure to reach out when we have more details from the client, but this is a really great start!
Ok, I’m back!
The client is concerned about the tax management for this imputed income automation.
They want some clarification on making sure the employees are not getting paid the amount we send to Deel, that they aren’t paying the taxes on that amount, and that Deel is automatically covering the taxes for those employees.
They want guidance and clarification on what steps need to be taken when setting up the codes and categories on their Deel platform to make sure this happens.
This is for non-contractors, so we’re using the Create Adjustment endpoint.
For more context, the client is using Awardco to award points to employees, and those employees are spending the points on he Awardco platform. This is considered taxable “imputed income”, and should not added to their paychecks when sent to Deel.
E.g. Employee receives 100 points in Awardco, and spends it on a $100 gift card, the client needs to track that $100 as imputed income and tax the employee based on that extra $100 ‘earned’, but in this particular case the client is covering the taxes for that employee.
If there are support docs anywhere that walk through this, I’d be happy to read through them.
Hello @cameron.fry,
If you don’t want for the worker to receive that amount and only store this information in Deel, I recommend using custom fields for that. The Adjustment will indeed give this amount to the worker and add this value to the client billing.
Hi Gabriela, Could you give some additional context, examples, or even screenshots that would help demonstrate or indicate how this could be accomplished?
For sure!
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:
- Use this API, if the custom field is stored on the worker profile
- Use this API, if the custom field is stored on the contract
Thanks for pointing this out, Gabriela!
I can’t say I’m very familiar with the platform yet, so I have no clue how some of these features would work, but I’m also not seeing that custom fields option anywhere in our developer sandbox…
Ideally, I would love to work with someone, maybe get a series of screenshots or get on a call, to discuss how to create a custom field for employees for this imputed income process and how to ensure that the inputs we make with the “Update Custom Field” endpoint would result in the desired outcome of taxing on, but not awarding, the gross amounts earned/spent in Awardco.
Thank you!
Hello @cameron.fry
Not to worry, I am sure you will get familiar with the platform eventually. For getting access to this screen, please log in to https://app.demo.deel.com/ with your API Sandbox credentials.
With this, you should have access to the UI of the Demo account linked to your sandbox environment.
Let me know in case you have any trouble.
All the best,
Gabriela
Ok, I was able to create a custom field, named it imputed income, and chose all of the options during setup that I thought were relevant to what we’ll be doing, but I’m still lost on how updating this field for an employee will allow clients to attribute the taxes to the employees from the off-platform earnings/spendings they had on the Awardco platform without giving them that gross amount.
Thank you,
Cameron
Hello Cameron,
Given the current structure, either the client submit this as an Adjustment/Expense/Off-cycle payment, that will generate a billing for the Reward amount and will be tax compliant. Or you can submit this value in a custom field only for control, but Deel will not collect taxes on this amount.
We don’t offer a programmatical way to add Rewards delivered outside of the platform into the tax calculations inside of the platform.
Ok, if there’s no way to programatically add that data via API, how would a client go about doing that manually?
I would have to imagine that the Deel Payroll has some way for clients to track things like cash or gift cards being given to employees, and ensuring that taxes are attributed with those off-payroll earnings.
Or is the alternative to tell Deel Payroll clients to avoid giving cash, gift cards, and other non-paycheck gifts, or to only provide those gifts in the form of off-cycle payments and adjustments?
thank you
