{"article":{"id":43677675120273,"url":"https://letsdeel.zendesk.com/api/v2/help_center/en-gb/articles/43677675120273.json","html_url":"https://help.letsdeel.com/hc/en-gb/articles/43677675120273-Deel-Local-Payroll-Integration-Overview","author_id":42218584215185,"comments_disabled":false,"draft":false,"promoted":false,"position":0,"vote_sum":0,"vote_count":0,"upvote_count":0,"downvote_count":0,"section_id":43884437275537,"created_at":"2026-02-09T15:27:45Z","updated_at":"2026-02-16T08:05:29Z","name":"Deel Local Payroll Integration Overview","title":"Deel Local Payroll Integration Overview","source_locale":"en-gb","locale":"en-gb","outdated":false,"outdated_locales":[],"edited_at":"2026-02-11T16:14:24Z","user_segment_id":null,"permission_group_id":4402762096145,"content_tag_ids":[],"label_names":[],"body":"<div dir=\"ltr\" id=\"model-response-message-contentr_1c2d49e85a088fa2\" aria-live=\"polite\" aria-busy=\"false\">\n<p>The Deel Local Payroll Push integration is designed for users who use <strong>Deel HR</strong> as their primary HRIS but continue to run local payroll within <strong>Deel Local Payroll</strong>. </p>\n<p> </p>\n<h2 id=\"h_01KH6PJPZD8DNHFBB7Y5S8MGHY\">Supported capabilities</h2>\n<ul>\n<li data-list-item-id=\"e7a33086864f5c827361285d4fec6d9aa\">Automated Provisioning of new employee records in <span style=\"background-color: #ffffff; color: #605e5c;\">Deel Local Payroll</span> once they are onboarded in Deel.</li>\n<li data-list-item-id=\"e2ba993b3ae658c5d10aa59a7d8c1e274\">Updates to existing employee profiles (e.g., address changes, job titles, or salary adjustments) in Deel are pushed to Deel Local Payroll in real-time.</li>\n<li data-list-item-id=\"e0fce3659f98b1fa6bc30366a6dfe2185\">Once a pay run is finalized in Deel Local Payroll, you can trigger a sync. This allows the digital payslips to be retrieved and attached to the employee's profile in Deel for easy access.</li>\n<li data-list-item-id=\"e72f98e02cd27a9bff4790bcb87075ef9\">A dedicated <strong>Event Log</strong> in Deel allows admins to see exactly why a sync might have failed (e.g., a missing mandatory field required by Deel Local Payroll).</li>\n</ul>\n<h3 id=\"h_01KH6QPKBGP9NQDC96PC01ZA8Y\">\n<br><span style=\"color: #434343;\">Supported worker types</span>\n</h3>\n<ul><li data-list-item-id=\"e75c2caa73f00332f782f3a4115e18558\">Direct Employees</li></ul>\n<p> </p>\n<h3 id=\"h_01KH6PK19Y390ZR1CFF0C25NW8\"><span style=\"color: #434343;\">Supported fields</span></h3>\n<ul>\n<li class=\"ck-list-marker-color\" data-list-item-id=\"ef8dc8b689aef5e4a4fc5687a2b3c4d2c\"><span style=\"color: #444746;\">Employee Number (Worker ID)</span></li>\n<li class=\"ck-list-marker-color\" data-list-item-id=\"e63ae411c172a2cd91f586e3fbf2cfd5f\"><span style=\"color: #444746;\">First Name</span></li>\n<li class=\"ck-list-marker-color\" data-list-item-id=\"ee281294ce8bb53878c31e13939d0a7ed\"><span style=\"color: #444746;\">Last Name</span></li>\n<li class=\"ck-list-marker-color\" data-list-item-id=\"ebfc4f1bfe4fa8a470dcea22c739844e9\"><span style=\"color: #444746;\">Title (Mrs, Mss, Mr - default to Mr)</span></li>\n<li class=\"ck-list-marker-color\" data-list-item-id=\"e459f51dc49ecf6b89defe92280b78c40\"><span style=\"color: #444746;\">Birthday</span></li>\n<li class=\"ck-list-marker-color\" data-list-item-id=\"ef680bde9eea0ae8abefd215b7dcb6944\"><span style=\"color: #444746;\">Initials (Default to first and last name initials)</span></li>\n<li class=\"ck-list-marker-color\" data-list-item-id=\"e1ee4446d107e43db90af7d08e3070f4a\"><span style=\"color: #444746;\">Cell Number</span></li>\n<li class=\"ck-list-marker-color\" data-list-item-id=\"e547560496a4c3ec80277a1a6149e7f72\"><span style=\"color: #444746;\">Gender (default to: Male)</span></li>\n<li class=\"ck-list-marker-color\" data-list-item-id=\"eac65af505581ecdb9e04e488c8f81d1e\"><span style=\"color: #444746;\">Race (default to: Other)</span></li>\n<li class=\"ck-list-marker-color\" data-list-item-id=\"e1628736d1c1c0d7a32aa4c84f57f4900\"><span style=\"color: #444746;\">Nationality (only first nationality)</span></li>\n<li class=\"ck-list-marker-color\" data-list-item-id=\"e6a2aa90a21c63c1050a93ca82525c90a\"><span style=\"color: #444746;\">Effective Date (Contract start date - primary contract only)</span></li>\n<li class=\"ck-list-marker-color\" data-list-item-id=\"e982d9a98b35d3a35dd5099377e827bc2\"><span style=\"color: #444746;\">Pay Currency</span></li>\n<li class=\"ck-list-marker-color\" data-list-item-id=\"e7576f999514ce73daa9cadb1bfe1c7a4\"><span style=\"color: #444746;\">Pay Rate</span></li>\n<li class=\"ck-list-marker-color\" data-list-item-id=\"ecc06e350d85f8db999d3c58df984448a\"><span style=\"color: #444746;\">Pay Frequency</span></li>\n<li class=\"ck-list-marker-color\" data-list-item-id=\"e529f6ad046f96483f7f8603690eb377d\"><span style=\"color: #444746;\">Work Schedule (default to: Monday to Friday)</span></li>\n<li class=\"ck-list-marker-color\" data-list-item-id=\"eba9b64022b96a4b2428a6cdc619f41ba\"><span style=\"color: #444746;\">Work Email</span></li>\n</ul>\n<p> </p>\n<h2 id=\"h_01KH6PK5BC7X4YYCB57066BTNX\">Field Mapping</h2>\n<p><span style=\"background-color: #ffffff; color: #444746;\">Below is a list of fields used in Deel and what fields they are mapped to in Deel Local Payroll. </span></p>\n<div><figure class=\"wysiwyg-table\" style=\"width: 100%;\"><table class=\"wysiwyg-table-resized\">\n<colgroup>\n<col style=\"width: 20%;\">\n<col style=\"width: 26%;\">\n<col style=\"width: 30%;\">\n<col style=\"width: 24%;\">\n</colgroup>\n<tbody>\n<tr>\n<td><span style=\"color: #1f1f1f;\"><strong>Category</strong></span></td>\n<td><span style=\"color: #1f1f1f;\"><strong>Deel Source Field</strong></span></td>\n<td><span style=\"color: #1f1f1f;\"><strong>Deel Local Payroll Target Field</strong></span></td>\n<td><span style=\"color: #1f1f1f;\"><strong>Logic / Notes</strong></span></td>\n</tr>\n<tr>\n<td><span style=\"color: #1f1f1f;\"><strong>Worker Data</strong></span></td>\n<td><span style=\"background-color: #e9eef6; color: #444746;\">Worker ID</span></td>\n<td><span style=\"background-color: #e9eef6; color: #444746;\">EmployeeNumber</span></td>\n<td> </td>\n</tr>\n<tr>\n<td> </td>\n<td><span style=\"background-color: #e9eef6; color: #444746;\">First Name</span></td>\n<td><span style=\"background-color: #e9eef6; color: #444746;\">FirstName</span></td>\n<td> </td>\n</tr>\n<tr>\n<td> </td>\n<td><span style=\"background-color: #e9eef6; color: #444746;\">Last Name</span></td>\n<td><span style=\"background-color: #e9eef6; color: #444746;\">LastName</span></td>\n<td> </td>\n</tr>\n<tr>\n<td> </td>\n<td><span style=\"background-color: #e9eef6; color: #444746;\">Birth Date</span></td>\n<td><span style=\"background-color: #e9eef6; color: #444746;\">Birthday</span></td>\n<td> </td>\n</tr>\n<tr>\n<td> </td>\n<td><span style=\"background-color: #e9eef6; color: #444746;\">Full Name initials</span></td>\n<td><span style=\"background-color: #e9eef6; color: #444746;\">Initials</span></td>\n<td> </td>\n</tr>\n<tr>\n<td> </td>\n<td><span style=\"background-color: #e9eef6; color: #444746;\">Work Email</span></td>\n<td><span style=\"background-color: #e9eef6; color: #444746;\">Email</span></td>\n<td> </td>\n</tr>\n<tr>\n<td> </td>\n<td><span style=\"background-color: #e9eef6; color: #444746;\">Nationalities</span></td>\n<td><span style=\"background-color: #e9eef6; color: #444746;\">Nationality</span></td>\n<td> </td>\n</tr>\n<tr>\n<td> </td>\n<td><span style=\"background-color: #e9eef6; color: #444746;\">Employment Start Date</span></td>\n<td><span style=\"background-color: #e9eef6; color: #444746;\">EffectiveDate</span></td>\n<td> </td>\n</tr>\n<tr>\n<td><span style=\"color: #1f1f1f;\"><strong>Address</strong></span></td>\n<td><span style=\"color: #1f1f1f;\">(N/A)</span></td>\n<td><span style=\"background-color: #e9eef6; color: #444746;\">AddressType</span></td>\n<td><span style=\"color: #1f1f1f;\">Hardcoded to <strong>Physical</strong></span></td>\n</tr>\n<tr>\n<td> </td>\n<td><span style=\"background-color: #e9eef6; color: #444746;\">Street Address</span></td>\n<td><span style=\"background-color: #e9eef6; color: #444746;\">AddressLine1</span></td>\n<td> </td>\n</tr>\n<tr>\n<td> </td>\n<td><span style=\"background-color: #e9eef6; color: #444746;\">City</span></td>\n<td><span style=\"background-color: #e9eef6; color: #444746;\">AddressLine3</span></td>\n<td> </td>\n</tr>\n<tr>\n<td> </td>\n<td><span style=\"background-color: #e9eef6; color: #444746;\">Postal Code</span></td>\n<td><span style=\"background-color: #e9eef6; color: #444746;\">AddressCode</span></td>\n<td> </td>\n</tr>\n<tr>\n<td> </td>\n<td><span style=\"background-color: #e9eef6; color: #444746;\">Region/Province</span></td>\n<td><span style=\"background-color: #e9eef6; color: #444746;\">AddressCountry</span></td>\n<td><span style=\"color: #1f1f1f;\">Validates against Deel Local Payroll; defaults to first valid value</span></td>\n</tr>\n<tr>\n<td><span style=\"color: #1f1f1f;\"><strong>Personal Data</strong></span></td>\n<td><span style=\"background-color: #e9eef6; color: #444746;\">Demographics gender</span></td>\n<td><span style=\"background-color: #e9eef6; color: #444746;\">Gender</span></td>\n<td><span style=\"color: #1f1f1f;\">Defaults to <strong>Male</strong></span></td>\n</tr>\n<tr>\n<td> </td>\n<td><span style=\"color: #1f1f1f;\">(Gender-based)</span></td>\n<td><span style=\"background-color: #e9eef6; color: #444746;\">Title</span></td>\n<td><span style=\"color: #1f1f1f;\">Male → \"Mr\", Female → \"Ms\", Default → \"Mr\"</span></td>\n</tr>\n<tr>\n<td> </td>\n<td><span style=\"background-color: #e9eef6; color: #444746;\">Personal phone</span></td>\n<td><span style=\"background-color: #e9eef6; color: #444746;\">CellNumber</span></td>\n<td> </td>\n</tr>\n<tr>\n<td><span style=\"color: #1f1f1f;\"><strong>Employment</strong></span></td>\n<td><span style=\"background-color: #e9eef6; color: #444746;\">Payment scale/cycle</span></td>\n<td><span style=\"background-color: #e9eef6; color: #444746;\">PayFrequency</span></td>\n<td><span style=\"color: #1f1f1f;\">Mapped to Deel Local Payroll Frequency</span></td>\n</tr>\n<tr>\n<td> </td>\n<td><span style=\"color: #1f1f1f;\">(N/A)</span></td>\n<td><span style=\"background-color: #e9eef6; color: #444746;\">HoursPerDay</span></td>\n<td><span style=\"color: #1f1f1f;\">Hardcoded to <strong>8</strong></span></td>\n</tr>\n<tr>\n<td> </td>\n<td><span style=\"background-color: #e9eef6; color: #444746;\">Pay rate</span></td>\n<td><span style=\"background-color: #e9eef6; color: #444746;\">Package</span></td>\n<td> </td>\n</tr>\n<tr>\n<td> </td>\n<td><span style=\"background-color: #e9eef6; color: #444746;\">Pay Currency</span></td>\n<td><span style=\"background-color: #e9eef6; color: #444746;\">Currency</span></td>\n<td> </td>\n</tr>\n<tr>\n<td> </td>\n<td><span style=\"background-color: #e9eef6; color: #444746;\">Is annual scale</span></td>\n<td><span style=\"background-color: #e9eef6; color: #444746;\">IsAnnual</span></td>\n<td><span style=\"color: #1f1f1f;\">Boolean check</span></td>\n</tr>\n<tr>\n<td> </td>\n<td><span style=\"color: #1f1f1f;\">(N/A)</span></td>\n<td><span style=\"background-color: #e9eef6; color: #444746;\">Working Days</span></td>\n<td><span style=\"color: #1f1f1f;\">Hardcoded: <strong>Monday to Friday</strong> = True</span></td>\n</tr>\n<tr>\n<td><span style=\"color: #1f1f1f;\"><strong>Tax Profile</strong></span></td>\n<td><span style=\"background-color: #e9eef6; color: #444746;\">Start Date</span></td>\n<td><span style=\"background-color: #e9eef6; color: #444746;\">EmploymentDate</span></td>\n<td>\n<span style=\"color: #1f1f1f;\">Also maps to </span><span style=\"background-color: #e9eef6; color: #444746;\">GroupJoinDate</span>\n</td>\n</tr>\n<tr>\n<td> </td>\n<td><span style=\"color: #1f1f1f;\">(N/A)</span></td>\n<td><span style=\"background-color: #e9eef6; color: #444746;\">TempWorker</span></td>\n<td><span style=\"color: #1f1f1f;\">Hardcoded to <strong>False</strong></span></td>\n</tr>\n<tr>\n<td><span style=\"color: #1f1f1f;\"><strong>Integration</strong></span></td>\n<td><span style=\"background-color: #e9eef6; color: #444746;\">Legal Entity</span></td>\n<td><span style=\"background-color: #e9eef6; color: #444746;\">CompanyId</span></td>\n<td><span style=\"color: #1f1f1f;\">Mapping based on settings</span></td>\n</tr>\n<tr>\n<td> </td>\n<td><span style=\"background-color: #e9eef6; color: #444746;\">Monthly Frequency</span></td>\n<td><span style=\"background-color: #e9eef6; color: #444746;\">CompanyFrequency</span></td>\n<td><span style=\"color: #1f1f1f;\">From Deel Local Payroll API (Create only)</span></td>\n</tr>\n</tbody>\n</table></figure></div>\n<p> </p>\n<h3 id=\"h_01KH6PKBG023GWFYZWX3A6CF5H\">Known Limitations </h3>\n<ul>\n<li data-list-item-id=\"ee0e01ba59b62ef5e3504014bb364b772\">Data flows from <strong>Deel &gt; Deel Local Payroll</strong>. Any edits made directly in the Deel Local Payroll interface will <strong>not</strong> update the employee's record in Deel. </li>\n<li data-list-item-id=\"e87acf822f9ec03ee5ee0011f24ba2cb5\">Deel Local Payroll requires certain fields (like Gender and Title) that are optional or do not exist in Deel. To prevent sync failures when optional Deel fields are empty, the system uses fail-safe defaults:<ul>\n<li data-list-item-id=\"eab900857b07d3540b54fd3bb979ed97f\">\n<strong>Gender:</strong> Defaults to <strong>Male</strong>.</li>\n<li data-list-item-id=\"e9672315a42d0312b8fa09cb51b06d018\">\n<strong>Title:</strong> Defaults to <strong>Mr.</strong>\n</li>\n<li data-list-item-id=\"ebb993da72b43c8693c40cadb847c9645\">\n<strong>Initials</strong>: Defaults to first and last name initials</li>\n<li data-list-item-id=\"e2d84712fa84e61dc4760a031ab8fd643\">\n<strong>Work</strong> <strong>Schedule</strong>: defaults to <strong>Monday to Friday</strong>\n</li>\n<li data-list-item-id=\"e0cfc5d865998679066e1682e72cf0ff1\">\n<strong>Race</strong>: defaults to <strong>Other</strong>\n</li>\n</ul>\n</li>\n</ul>\n<p> </p>\n<h3 id=\"h_01KH1FFE3XDB1P30DD8XQRYBHA\" data-path-to-node=\"13\">FAQs</h3>\n</div><section style=\"margin-bottom: 30px;\">\n  <details style=\"border: 1px solid #edebe9; border-radius: 4px; margin-bottom: 10px; padding: 15px; background-color: #ffffff; transition: background-color 0.2s ease;\">\n    <summary style=\"font-weight: 600; outline: none; cursor: pointer; list-style: none; display: flex; justify-content: space-between; align-items: center;\">\n      Why isn't my new hire appearing in PaySpace?\n    </summary>\n    <div style=\"margin-top: 12px; line-height: 1.5; color: #605e5c; border-top: 1px solid #f3f2f1; padding-top: 10px;\">\n      Check the worker's status in Deel. They must be fully <i>Onboarded</i>\n      or <i>Active</i>.\n      You can also check the Event Log in the integration settings; if a mandatory\n      field such as <strong>Work Email</strong> is missing, the sync will pause\n      for that individual.\n    </div>\n  </details>\n  <details style=\"border: 1px solid #edebe9; border-radius: 4px; margin-bottom: 10px; padding: 15px; background-color: #ffffff;\">\n    <summary style=\"font-weight: 600; outline: none; cursor: pointer; list-style: none; display: flex; justify-content: space-between; align-items: center;\">\n      How do employees see their payslips?\n    </summary>\n    <div style=\"margin-top: 12px; line-height: 1.5; color: #605e5c; border-top: 1px solid #f3f2f1; padding-top: 10px;\">\n      Once you close the month in PaySpace, the integration pulls the payslip PDF. Employees can then find them under the <strong>Compliance</strong> or <strong>Payslips</strong> tab in their Deel dashboard.\n    </div>\n  </details>\n  <details style=\"border: 1px solid #edebe9; border-radius: 4px; margin-bottom: 10px; padding: 15px; background-color: #ffffff;\">\n    <summary style=\"font-weight: 600; outline: none; cursor: pointer; list-style: none; display: flex; justify-content: space-between; align-items: center;\">\n      What happens if I change an employee's salary in Deel?\n    </summary>\n    <div style=\"margin-top: 12px; line-height: 1.5; color: #605e5c; border-top: 1px solid #f3f2f1; padding-top: 10px;\">\n      The change will automatically be pushed to PaySpace. We recommend always verifying the update in PaySpace before finalizing your\n      monthly pay run to ensure effective dates were captured correctly.\n    </div>\n  </details>\n</section>","user_segment_ids":[]}}