The Microsoft Dynamics 365 integration connects your Dynamics 365 environment to Deel, allowing employee and payroll data to sync automatically between the two systems. The integration is organised in plugins, where each plugin is responsible for syncing a specific type of data. Plugins are set up independently and can be enabled based on your organisation's needs.
If you're trying to connect Deel to your General Ledger or sync invoices, see the Microsoft Finance integration instead.
In this article
- What this integration does
- Plugins
- Data mapping
- Supported business processes
- Testing
- Frequently asked questions
What this integration does
Data flows primarily from Microsoft Dynamics 365 to Deel. Microsoft Dynamics 365 is the system of record for employee and HR data. Some plugins send data back from Deel to Microsoft Dynamics 365 (payroll results, payslips, and general ledger entries). The table below summarises the sync direction by plugin.
| Plugin | Sync direction |
|---|---|
| Employee Data Sync | Microsoft Dynamics 365 to Deel |
| One-Time Payment Sync | Microsoft Dynamics 365 to Deel |
| Time Off Sync | Microsoft Dynamics 365 to Deel |
| Payslip and Tax Document Sync | Deel to Microsoft Dynamics 365 |
| General Ledger Sync | Deel to Microsoft Dynamics 365 |
Plugins
The Microsoft Dynamics 365 integration is organised in plugins. Each plugin handles the sync of a specific part of the data between Microsoft Dynamics 365 and Deel. Plugins are accessed from the main integration page in Deel and configured independently.
How plugins relate to each other
Some plugins depend on others being set up first. The diagram below shows the dependency structure.
Plugin reference
Employee Data Sync
The Employee Data Sync plugin is the foundational plugin and must be enabled before any others. It syncs worker demographic data, employment details, positions, and compensation from Microsoft Dynamics 365 to Deel.
Data synced:
- Worker master data (name, email, date of birth, national ID)
- Employment details (start date, legal entity, position, department)
- Compensation (fixed pay plan, pay rate, frequency, currency)
- Country-specific fields (tax ID, social security number, bank account)
Sync direction: Microsoft Dynamics 365 to Deel
Required for: One-Time Payment Sync, Time Off Sync, Payslip and Tax Document Sync, General Ledger Sync
One-Time Payment Sync
The One-Time Payment Sync plugin syncs variable pay, bonuses, and entitlements from Microsoft Dynamics 365 to Deel on a periodic basis. This plugin requires Employee Data Sync to be enabled first.
Data synced: approved one-time payments (bonuses, variable pay, entitlements)
Sync direction: Microsoft Dynamics 365 to Deel
Time Off Sync
The Time Off Sync plugin allows direct employees to log time off in Microsoft Dynamics 365. Deel syncs approved time off entries periodically for payroll processing. If the leave type affects payroll (for example, unpaid leave), Deel adjusts the next payroll cycle automatically.
Data synced: approved time off days and types
Sync direction: Microsoft Dynamics 365 to Deel
General Ledger Sync
After each payroll cycle is completed in Deel, the General Ledger Sync plugin creates journal entries in Microsoft Dynamics 365's General Ledger module. Journals are created in Draft status for review or auto-posted if configured.
Data synced: payroll journal headers and lines (gross salaries, employer contributions, tax withholdings, net pay disbursements)
Sync direction: Deel to Microsoft Dynamics 365
Data mapping
After completing the initial setup, your assigned Deel Onboarding Manager will map data fields in Microsoft Dynamics 365 to the corresponding Deel fields. Mapping covers:
- Generic fields: worker name, personnel number, email, employment dates, position, legal entity
- Country-specific fields: tax IDs, social security numbers, bank details, statutory deductions
- Compensation fields: base pay, pay frequency, currency, pay group
- Leave fields: leave types, accrual policies, balances
| Microsoft Dynamics 365 entity / field | Deel field | Direction |
|---|---|---|
| HcmWorkerV2.PersonnelNumber | Employee ID | Microsoft Dynamics 365 to Deel |
| HcmWorkerV2.FirstName / LastName | Name | Microsoft Dynamics 365 to Deel |
| HcmEmploymentDetailV2.EmploymentStartDate | Start date | Microsoft Dynamics 365 to Deel |
| HcmEmploymentDetailV2.EmploymentEndDate | Termination date | Microsoft Dynamics 365 to Deel |
| HcmLeaveRequestEntity | Time off | Microsoft Dynamics 365 to Deel |
| PayrollPayStatementEntity | Payslip | Deel to Microsoft Dynamics 365 |
| LedgerJournalEntity / LedgerJournalLineEntity | GL entries | Deel to Microsoft Dynamics 365 |
Supported business processes
| Process | Supported | Notes |
|---|---|---|
| Hire new worker | Yes | |
| Terminate worker | Yes | Final payroll calculated in Deel; GL sync posts final journal to Microsoft Dynamics 365 |
| Rehire worker | Yes | Personnel number must remain the same for Deel to recognise the rehire |
| Submit and approve time off | Yes | |
| View payslip in Employee Self-Service | Planned | Plugin not yet available |
| Post-payroll GL sync | Yes | Journals created in Draft status by default |
| Update compensation | Yes | Updated pay reflected in next Deel payroll cycle |
| Rescind hire / termination | No | |
| Profit allocation | No |
Testing
With the help of your Deel Onboarding Manager and Deel's Technical Operations team, agree on and conduct test scenarios to verify the integration works as expected before moving to production.
All testing should be conducted in a sandbox or UAT environment before production deployment.
| Number | Scenario | Validation |
|---|---|---|
| 1 | Hire a new worker in Microsoft Dynamics 365 | Worker appears in Deel with correct details |
| 2 | Terminate a worker in Microsoft Dynamics 365 | Offboarding triggered in Deel; final pay calculated |
| 3 | Rehire a worker in Microsoft Dynamics 365 | New contract created in Deel; history preserved |
| 4 | Submit and approve time off in Microsoft Dynamics 365 | Time off entry synced to Deel |
| 5 | Run payroll in Deel | Payslip appears in Microsoft Dynamics 365 Employee Self-Service (planned) |
| 6 | Post-payroll GL sync | Journal entries created in Microsoft Dynamics 365 General Ledger |
| 7 | Update compensation in Microsoft Dynamics 365 | Updated pay reflected in next Deel payroll cycle |