{"article":{"id":900001189006,"url":"https://roubler.zendesk.com/api/v2/help_center/en-us/articles/900001189006.json","html_url":"https://support.roubler.com/hc/en-us/articles/900001189006-Employee-Import-via-Excel-CSV-Roubler-UK","author_id":376419685773,"comments_disabled":false,"draft":false,"promoted":false,"position":0,"vote_sum":0,"vote_count":0,"upvote_count":0,"downvote_count":0,"section_id":29603793703321,"created_at":"2020-06-05T02:00:07Z","updated_at":"2024-03-07T07:42:55Z","name":"Employee Import via Excel / CSV - Roubler UK","title":"Employee Import via Excel / CSV - Roubler UK","source_locale":"en-us","locale":"en-us","outdated":false,"outdated_locales":[],"edited_at":"2024-03-07T07:42:55Z","user_segment_id":null,"permission_group_id":1035374,"content_tag_ids":[],"label_names":[],"body":"<div>\n<h1>File Specification</h1>\n<p> Importing Employees from an XLSX or CSV file is a great way to get set up and running quickly.</p>\n<p>Your implementation team is here to help but if you are having some trouble with the template this article will assist with any questions you may have.</p>\n<p>There are quite a few fields in the file however they are broken into sections as shown below and not all sections need to be present.</p>\n<table class=\"table table-striped table-bordered\" width=\"648\">\n<thead>\n<tr>\n<td colspan=\"3\">\n<table width=\"803\">\n<tbody>\n<tr>\n<td width=\"297\">Field Name</td>\n<td width=\"99\">Data Type</td>\n<td width=\"215\">Notes</td>\n<td width=\"87\"> </td>\n<td width=\"105\"> </td>\n</tr>\n<tr>\n<td>PERSONAL DETAILS</td>\n<td> </td>\n<td> </td>\n<td> </td>\n<td> </td>\n</tr>\n<tr>\n<td> </td>\n<td> </td>\n<td> </td>\n<td> </td>\n<td> </td>\n</tr>\n<tr>\n<td>EmployeeId</td>\n<td>Number</td>\n<td> </td>\n<td> </td>\n<td> </td>\n</tr>\n<tr>\n<td>Title</td>\n<td>Text</td>\n<td>Valid values: Mr, Mrs, Miss, Ms, Dr</td>\n<td> </td>\n<td> </td>\n</tr>\n<tr>\n<td>PreferredName</td>\n<td>Text</td>\n<td> </td>\n<td> </td>\n<td> </td>\n</tr>\n<tr>\n<td>FirstName</td>\n<td>Text</td>\n<td> </td>\n<td> </td>\n<td> </td>\n</tr>\n<tr>\n<td>MiddleName</td>\n<td>Text</td>\n<td> </td>\n<td> </td>\n<td> </td>\n</tr>\n<tr>\n<td>Surname</td>\n<td>Text</td>\n<td> </td>\n<td> </td>\n<td> </td>\n</tr>\n<tr>\n<td>PreviousSurname</td>\n<td>Text</td>\n<td> </td>\n<td> </td>\n<td> </td>\n</tr>\n<tr>\n<td>DateOfBirth</td>\n<td>Number</td>\n<td> </td>\n<td> </td>\n<td> </td>\n</tr>\n<tr>\n<td>Gender</td>\n<td>Text</td>\n<td>Valid values: Male, Female</td>\n<td> </td>\n<td> </td>\n</tr>\n<tr>\n<td>ExternalId</td>\n<td>Number</td>\n<td> </td>\n<td> </td>\n<td> </td>\n</tr>\n<tr>\n<td>ResidentialStreetAddress</td>\n<td>Text</td>\n<td> </td>\n<td> </td>\n<td> </td>\n</tr>\n<tr>\n<td>ResidentialAddressLine2</td>\n<td>Text</td>\n<td> </td>\n<td> </td>\n<td> </td>\n</tr>\n<tr>\n<td>ResidentialCity</td>\n<td>Text</td>\n<td> </td>\n<td> </td>\n<td> </td>\n</tr>\n<tr>\n<td>ResidentialCounty</td>\n<td>Text</td>\n<td> </td>\n<td> </td>\n<td> </td>\n</tr>\n<tr>\n<td>ResidentialPostCode</td>\n<td>Text</td>\n<td> </td>\n<td> </td>\n<td> </td>\n</tr>\n<tr>\n<td>ResidentialCountry</td>\n<td>Text</td>\n<td>This field only needs to be completed if ResidentialAddressIsManuallyEntered = True</td>\n<td> </td>\n<td> </td>\n</tr>\n<tr>\n<td>ResidentialAddressIsManuallyEntered</td>\n<td>Text</td>\n<td>Valid values: True, False</td>\n<td> </td>\n<td> </td>\n</tr>\n<tr>\n<td>PostalStreetAddress</td>\n<td>Text</td>\n<td> </td>\n<td> </td>\n<td> </td>\n</tr>\n<tr>\n<td>PostalAddressLine2</td>\n<td>Text</td>\n<td> </td>\n<td> </td>\n<td> </td>\n</tr>\n<tr>\n<td>PostalCity</td>\n<td>Text</td>\n<td> </td>\n<td> </td>\n<td> </td>\n</tr>\n<tr>\n<td>PostalCounty</td>\n<td>Text</td>\n<td> </td>\n<td> </td>\n<td> </td>\n</tr>\n<tr>\n<td>PostalPostCode</td>\n<td>Text</td>\n<td> </td>\n<td> </td>\n<td> </td>\n</tr>\n<tr>\n<td>PostalCountry</td>\n<td>Text</td>\n<td>This field only needs to be completed if PostalAddressIsManuallyEntered = True</td>\n<td> </td>\n<td> </td>\n</tr>\n<tr>\n<td>PostalAddressIsManuallyEntered</td>\n<td>Text</td>\n<td>Valid values: True, False</td>\n<td> </td>\n<td> </td>\n</tr>\n<tr>\n<td>EmailAddress</td>\n<td>Text</td>\n<td> </td>\n<td> </td>\n<td> </td>\n</tr>\n<tr>\n<td>HomePhone</td>\n<td>Number</td>\n<td> </td>\n<td> </td>\n<td> </td>\n</tr>\n<tr>\n<td>WorkPhone</td>\n<td>Number</td>\n<td> </td>\n<td> </td>\n<td> </td>\n</tr>\n<tr>\n<td>MobilePhone</td>\n<td>Number</td>\n<td> </td>\n<td> </td>\n<td> </td>\n</tr>\n<tr>\n<td>StartDate</td>\n<td>Number</td>\n<td> </td>\n<td> </td>\n<td> </td>\n</tr>\n<tr>\n<td>EndDate</td>\n<td>Number</td>\n<td colspan=\"3\">date that employment was terminated (If employee has finalised their employment)</td>\n</tr>\n<tr>\n<td>ContinuousEmploymentDate</td>\n<td>Number</td>\n<td> </td>\n<td> </td>\n<td> </td>\n</tr>\n<tr>\n<td>Tags</td>\n<td>Text</td>\n<td colspan=\"3\">Pipe (‘|’) separated list of tags to associate with this employee</td>\n</tr>\n<tr>\n<td> </td>\n<td> </td>\n<td> </td>\n<td> </td>\n<td> </td>\n</tr>\n<tr>\n<td>PAY RUN SETUP</td>\n<td> </td>\n<td> </td>\n<td> </td>\n<td> </td>\n</tr>\n<tr>\n<td> </td>\n<td> </td>\n<td> </td>\n<td> </td>\n<td> </td>\n</tr>\n<tr>\n<td>JobTitle</td>\n<td>Text</td>\n<td> </td>\n<td> </td>\n<td> </td>\n</tr>\n<tr>\n<td>PaySchedule</td>\n<td>Text</td>\n<td colspan=\"3\">Corresponds to the name of a Pay Schedule that you have already created. For example ‘Weekly’</td>\n</tr>\n<tr>\n<td>PrimaryPayCategory</td>\n<td>Text</td>\n<td colspan=\"3\">Corresponds to the name of a Pay Category that you have already created. For example ‘Full Time – Standard’</td>\n</tr>\n<tr>\n<td>PrimaryLocation</td>\n<td>Text</td>\n<td colspan=\"3\">Corresponds to the fully qualified name of a Location that you have already created.</td>\n</tr>\n<tr>\n<td>PaySlipNotificationType</td>\n<td>Text</td>\n<td colspan=\"2\">Valid values: Email, SMS, Manual, None</td>\n<td> </td>\n</tr>\n<tr>\n<td>RosteringNotificationChoices</td>\n<td>Text</td>\n<td> </td>\n<td> </td>\n<td> </td>\n</tr>\n<tr>\n<td>Rate</td>\n<td>Number</td>\n<td colspan=\"3\">How much is the employee paid (may be specified as a ‘per hour’ or ‘per annum’ value)</td>\n</tr>\n<tr>\n<td>RateUnit</td>\n<td>Text</td>\n<td colspan=\"2\">Valid values: Hourly, Annually, Daily</td>\n<td> </td>\n</tr>\n<tr>\n<td>HoursPerWeek</td>\n<td>Number</td>\n<td colspan=\"3\">Standard number of hours per week for this employee</td>\n</tr>\n<tr>\n<td>AutomaticallyPayEmployee</td>\n<td>True/False</td>\n<td colspan=\"3\">Determines whether the employee's “standard weekly hours” are automatically added as earnings lines to a new pay run</td>\n</tr>\n<tr>\n<td>LeaveTemplate</td>\n<td>Text</td>\n<td colspan=\"3\">Name of the Leave Allowance Template to apply to this employee</td>\n</tr>\n<tr>\n<td>PayRateTemplate</td>\n<td>Text</td>\n<td colspan=\"3\">Name of the Pay Rate Template to apply to this employee</td>\n</tr>\n<tr>\n<td>PayConditionRuleSet</td>\n<td>Text</td>\n<td colspan=\"3\">Name of the pay condition rule set to assign to this employee</td>\n</tr>\n<tr>\n<td>IsEnabledForTimesheets</td>\n<td>Text</td>\n<td colspan=\"3\">Valid values: Enabled, Disabled, EnabledForExceptions</td>\n</tr>\n<tr>\n<td>Locations</td>\n<td>Text</td>\n<td colspan=\"3\">Pipe (‘|’) separated list of fully qualified locations that this employee works at</td>\n</tr>\n<tr>\n<td>WorkTypes</td>\n<td>Text</td>\n<td colspan=\"3\">Pipe (‘|’) separated list of work types to enable this employee to submit timesheets for</td>\n</tr>\n<tr>\n<td> </td>\n<td> </td>\n<td> </td>\n<td> </td>\n<td> </td>\n</tr>\n<tr>\n<td>EMERGENCY CONTACTS</td>\n<td> </td>\n<td> </td>\n<td> </td>\n<td> </td>\n</tr>\n<tr>\n<td> </td>\n<td> </td>\n<td> </td>\n<td> </td>\n<td> </td>\n</tr>\n<tr>\n<td>EmergencyContact1_Name</td>\n<td>Text</td>\n<td> </td>\n<td> </td>\n<td> </td>\n</tr>\n<tr>\n<td>EmergencyContact1_Relationship</td>\n<td>Text</td>\n<td> </td>\n<td> </td>\n<td> </td>\n</tr>\n<tr>\n<td>EmergencyContact1_Address</td>\n<td>Text</td>\n<td> </td>\n<td> </td>\n<td> </td>\n</tr>\n<tr>\n<td>EmergencyContact1_ContactNumber</td>\n<td>Text</td>\n<td> </td>\n<td> </td>\n<td> </td>\n</tr>\n<tr>\n<td>EmergencyContact1_AlternateContactNumber</td>\n<td>Text</td>\n<td> </td>\n<td> </td>\n<td> </td>\n</tr>\n<tr>\n<td>EmergencyContact2_Name</td>\n<td>Text</td>\n<td> </td>\n<td> </td>\n<td> </td>\n</tr>\n<tr>\n<td>EmergencyContact2_Relationship</td>\n<td>Text</td>\n<td> </td>\n<td> </td>\n<td> </td>\n</tr>\n<tr>\n<td>EmergencyContact2_Address</td>\n<td>Text</td>\n<td> </td>\n<td> </td>\n<td> </td>\n</tr>\n<tr>\n<td>EmergencyContact2_ContactNumber</td>\n<td>Number</td>\n<td> </td>\n<td> </td>\n<td> </td>\n</tr>\n<tr>\n<td>EmergencyContact2_AlternateContactNumber</td>\n<td>Number</td>\n<td> </td>\n<td> </td>\n<td> </td>\n</tr>\n<tr>\n<td> </td>\n<td> </td>\n<td> </td>\n<td> </td>\n<td> </td>\n</tr>\n<tr>\n<td>BANK ACCOUNTS</td>\n<td> </td>\n<td> </td>\n<td> </td>\n<td> </td>\n</tr>\n<tr>\n<td> </td>\n<td> </td>\n<td> </td>\n<td> </td>\n<td> </td>\n</tr>\n<tr>\n<td>BankAccount1_AccountNumber</td>\n<td>Text</td>\n<td> </td>\n<td> </td>\n<td> </td>\n</tr>\n<tr>\n<td>BankAccount1_AccountName</td>\n<td>Text</td>\n<td> </td>\n<td> </td>\n<td> </td>\n</tr>\n<tr>\n<td>BankAccount1_AllocatedPercentage</td>\n<td>Text</td>\n<td colspan=\"2\">Use 100 to nominate remaining balance</td>\n<td> </td>\n</tr>\n<tr>\n<td>BankAccount1_FixedAmount</td>\n<td>Text</td>\n<td colspan=\"2\">Percentage or Fixed amount may be specified.</td>\n<td> </td>\n</tr>\n<tr>\n<td>BankAccount2_SortCode</td>\n<td>Text</td>\n<td> </td>\n<td> </td>\n<td> </td>\n</tr>\n<tr>\n<td>BankAccount2_AccountNumber</td>\n<td>Text</td>\n<td> </td>\n<td> </td>\n<td> </td>\n</tr>\n<tr>\n<td>BankAccount2_AccountName</td>\n<td>Text</td>\n<td> </td>\n<td> </td>\n<td> </td>\n</tr>\n<tr>\n<td>BankAccount2_AllocatedPercentage</td>\n<td>Text</td>\n<td colspan=\"2\">Use 100 to nominate remaining balance</td>\n<td> </td>\n</tr>\n<tr>\n<td>BankAccount2_FixedAmount</td>\n<td>Text</td>\n<td colspan=\"2\">Percentage or Fixed amount may be specified.</td>\n<td> </td>\n</tr>\n<tr>\n<td>BankAccount3_SortCode</td>\n<td>Text</td>\n<td> </td>\n<td> </td>\n<td> </td>\n</tr>\n<tr>\n<td>BankAccount3_AccountNumber</td>\n<td>Text</td>\n<td> </td>\n<td> </td>\n<td> </td>\n</tr>\n<tr>\n<td>BankAccount3_AccountName</td>\n<td>Text</td>\n<td colspan=\"2\">Use 100 to nominate remaining balance</td>\n<td> </td>\n</tr>\n<tr>\n<td>BankAccount3_FixedAmount</td>\n<td>Text</td>\n<td colspan=\"2\">Percentage or Fixed amount may be specified.</td>\n<td> </td>\n</tr>\n<tr>\n<td> </td>\n<td> </td>\n<td> </td>\n<td> </td>\n<td> </td>\n</tr>\n<tr>\n<td>HMRC/NI AND PENSION SETTINGS</td>\n<td> </td>\n<td> </td>\n<td> </td>\n<td> </td>\n</tr>\n<tr>\n<td> </td>\n<td> </td>\n<td> </td>\n<td> </td>\n<td> </td>\n</tr>\n<tr>\n<td>NationalInsuranceNumber</td>\n<td>Text</td>\n<td> </td>\n<td> </td>\n<td> </td>\n</tr>\n<tr>\n<td>NationalInsuranceCalculationMethod</td>\n<td>Text</td>\n<td> </td>\n<td> </td>\n<td> </td>\n</tr>\n<tr>\n<td>NationalInsuranceCategory</td>\n<td>Number</td>\n<td> </td>\n<td> </td>\n<td> </td>\n</tr>\n<tr>\n<td>PayrollId</td>\n<td>Number</td>\n<td> </td>\n<td> </td>\n<td> </td>\n</tr>\n<tr>\n<td>TaxCalculationMethod</td>\n<td>Text</td>\n<td> </td>\n<td> </td>\n<td> </td>\n</tr>\n<tr>\n<td>TaxCode</td>\n<td>Text</td>\n<td> </td>\n<td> </td>\n<td> </td>\n</tr>\n<tr>\n<td>EmployeeStatement</td>\n<td>Text</td>\n<td> </td>\n<td> </td>\n<td> </td>\n</tr>\n<tr>\n<td>IsCompanyDirector</td>\n<td>Text</td>\n<td> </td>\n<td> </td>\n<td> </td>\n</tr>\n<tr>\n<td>EmployeePaidIrregularly</td>\n<td>Text</td>\n<td> </td>\n<td> </td>\n<td> </td>\n</tr>\n<tr>\n<td>StudentLoanType</td>\n<td>Text</td>\n<td> </td>\n<td> </td>\n<td> </td>\n</tr>\n<tr>\n<td>PensionAssessmentOption</td>\n<td>Text</td>\n<td> </td>\n<td> </td>\n<td> </td>\n</tr>\n<tr>\n<td>PensionContributionGroup</td>\n<td>Text</td>\n<td> </td>\n<td> </td>\n<td> </td>\n</tr>\n<tr>\n<td>AssessmentDate</td>\n<td>Number</td>\n<td> </td>\n<td> </td>\n<td> </td>\n</tr>\n<tr>\n<td>AssessmentStatus</td>\n<td>Text</td>\n<td> </td>\n<td> </td>\n<td> </td>\n</tr>\n<tr>\n<td>OptInDate</td>\n<td>Number</td>\n<td> </td>\n<td> </td>\n<td> </td>\n</tr>\n<tr>\n<td>EmployeeStarterType</td>\n<td>Text</td>\n<td> </td>\n<td> </td>\n<td> </td>\n</tr>\n<tr>\n<td>IsExemptFromMinimumWage</td>\n<td>Text</td>\n<td> </td>\n<td> </td>\n<td> </td>\n</tr>\n<tr>\n<td>IsApprentice</td>\n<td>Text</td>\n<td> </td>\n<td> </td>\n<td> </td>\n</tr>\n<tr>\n<td>PreviousEmployerOfficeNumber</td>\n<td>Text</td>\n<td> </td>\n<td> </td>\n<td> </td>\n</tr>\n<tr>\n<td>PreviousEmployerOfficeNumber</td>\n<td>Text</td>\n<td> </td>\n<td> </td>\n<td> </td>\n</tr>\n<tr>\n<td>PreviousEmployerReferenceNumber</td>\n<td>Text</td>\n<td> </td>\n<td> </td>\n<td> </td>\n</tr>\n<tr>\n<td>PreviousEmployerLeavingDate</td>\n<td>Text</td>\n<td> </td>\n<td> </td>\n<td> </td>\n</tr>\n<tr>\n<td>PreviousEmployerTaxablePay</td>\n<td>Text</td>\n<td> </td>\n<td> </td>\n<td> </td>\n</tr>\n<tr>\n<td>PreviousEmployerTaxWithheld</td>\n<td>Text</td>\n<td> </td>\n<td> </td>\n<td> </td>\n</tr>\n<tr>\n<td>PreviousEmployerStudentLoanDeductions</td>\n<td>Text</td>\n<td> </td>\n<td> </td>\n<td> </td>\n</tr>\n<tr>\n<td>PreviousEmployerW1M1</td>\n<td>Text</td>\n<td> </td>\n<td> </td>\n<td> </td>\n</tr>\n<tr>\n<td>PreviousEmployerTaxCode</td>\n<td>Text</td>\n<td> </td>\n<td> </td>\n<td> </td>\n</tr>\n<tr>\n<td>PreviousEmployerTaxPeriodFrequency</td>\n<td>Text</td>\n<td> </td>\n<td> </td>\n<td> </td>\n</tr>\n<tr>\n<td>PreviousEmployerTaxPeriodNumber</td>\n<td>Text</td>\n<td> </td>\n<td> </td>\n<td> </td>\n</tr>\n<tr>\n<td> </td>\n<td> </td>\n<td> </td>\n<td> </td>\n<td> </td>\n</tr>\n</tbody>\n</table>\n</td>\n</tr>\n</thead>\n</table>\n<p><strong><br>Minimum Required Fields</strong></p>\n<p>To setup an employee to be processed in a pay run the following fields are required as a minimum:</p>\n<ul>\n<li>FirstName</li>\n<li>Surname</li>\n<li>DateOfBirth</li>\n<li>ResidentialStreetAddress</li>\n<li>ResidentialCity</li>\n<li>ResidentialDistrict</li>\n<li>ResidentialPostCode</li>\n<li>PostalStreetAddress</li>\n<li>PostalCity</li>\n<li>PostalDistrict</li>\n<li>PostalPostCode</li>\n<li>StartDate</li>\n<li>EmploymentType</li>\n<li>PaySchedule</li>\n<li>PrimaryPayCategory</li>\n<li>PrimaryLocation</li>\n<li>PaySlipNotificationType</li>\n<li>Rate</li>\n<li>RateUnit</li>\n<li>HoursPerWeek</li>\n<li>BankAccount1_SortCode</li>\n<li>BankAccount1_AccountNumber</li>\n<li>BankAccount1_AccountName</li>\n<li>BankAccount1_AllocatedPercentage</li>\n</ul>\n<p>Once an employee is set up in the system, import files may contain a smaller subset of fields but the following must always be included in order to be able to identify the employee to update:</p>\n<p> </p>\n<ul>\n<li>First Name</li>\n<li>Surname</li>\n<li>Date of Birth</li>\n</ul>\n<h2>Fully Qualified Locations</h2>\n<p>Since locations may be nested, When importing from the CSV file, it is important to specify the Fully Qualified Location. For the following set of locations:</p>\n<ul>\n<li>All Offices\n<ul>\n<li>London Offices\n<ul>\n<li>Strathfield</li>\n</ul>\n</li>\n<li>Devon Offices\n<ul>\n<li>Logan</li>\n</ul>\n</li>\n</ul>\n</li>\n</ul>\n<p>The fully qualified location for ‘Strathfield’ would be <code>All Offices / London Offices / Strathfield</code></p>\n</div>\n<p> </p>\n<h2>Deleting Data</h2>\n<p>If you want to use an import file to remove data from the employee records, in bulk, you'll need to use the value \"(clear)\" without the quotes in the appropriate field on your import file to remove it from the matching field on the employee record.</p>\n<p>If you have any questions or feedback, please let us know via <a href=\"mailto:support@roubler.com\">support@roubler.com</a></p>","user_segment_ids":[]}}