username,email,is_active,title,name,mobile,preferences,works_id,start_date,working_days,fte,end_date,original_start_date,department,existing_employee,notes,postaldetail_line1,postaldetail_line2,postaldetail_line3,postaldetail_line4,postaldetail_postcode,postaldetail_foreign_country,taxdetail_weekly_hours_worked,taxdetail_P45_tax_code,taxdetail_P45_week1_month1,taxdetail_P45_leaving_date,taxdetail_P45_total_pay_to_date,taxdetail_P45_total_tax_to_date,taxdetail_P45_continue_student_loan,taxdetail_P45_continue_postgraduate_loan,taxdetail_NI_category,taxdetail_director,taxdetail_director_from,taxdetail_director_NI_cumulative,taxdetail_paid_irregularly,taxdetail_off_payroll_worker,taxdetail_migrated_rti_payid,taxdetail_cis,taxeedetail_date_of_birth,taxeedetail_gender,taxeedetail_NI_number,taxeedetail_employee_statement,taxeedetail_student_loan,taxeedetail_postgraduate_loan,taxeedetail_cis_trading_name,taxeedetail_cis_utr,taxeedetail_cis_crn,bankdetail_account_name,bankdetail_payment_method,bankdetail_sort_code,bankdetail_account_number sherlock.holmes@paiyroll.com,sherlock.holmes@paiyroll.com,,Mr,Sherlock Holmes,+447770123456,,1234,2019-06-01,"{true,true,true,true,true,false,false}",,,,Workers,,,231,Baker St,London,,W1 1AA,,E,,,,,,,,,,,,,,,,1981-12-31,M,AB123456C,A,,,S HOLMES,,123456,12345678,,, COLUMN SPECIFICATION & NOTES "String (up to 80). Login name, e.g. email. Must be unique. (Required)",Email address. (Required),Boolean (either true or false). Unset to prevent login. (Optional),Title. (Required),"String (up to 80). John adam smith or smith,john adam. (Required)",Phone number. Sms with +country code. (Optional),A json object. User-defined choices. (Optional),String (up to 40). Optional. (Optional),Date (without time). Joining date. (Required),Array of boolean (either true or false). (Optional),Decimal number. (Optional),Date (without time). Leaving date. (Optional),Date (without time). Start of continuous employment. (Optional),Department. (Required),Boolean (either true or false). Set to add existing employee. (Optional),String (up to 512). (Optional),String (up to 80). (Optional),String (up to 80). (Optional),String (up to 80). (Optional),String (up to 80). (Optional),String (up to 8). (Optional),String (up to 35). (Optional),String (up to 1). Other if occupational pension scheme. (Required),String (up to 20). Only enter if p45 received. (Optional),Boolean (either true or false). (Optional),Date (without time). Use latest if more than one. (Optional),Decimal number. Only enter if p45 received. (Optional),Decimal number. Only enter if p45 received. (Optional),Integer. Only enter if p45 received. (Optional),Boolean (either true or false). Only enter if p45 received. (Optional),String (up to 16). (Required),Boolean (either true or false). (Required),Date (without time). If unknown use 6 april current tax year. (Optional),Boolean (either true or false). (Required),Boolean (either true or false). Casual worker. (Optional),Boolean (either true or false). Psc worker. (Optional),String (up to 35). Only for new workers during parallel runs. (Optional),String (up to 20). Construction industry scheme. only set if subcontractor legally engaged. (Optional),Date (without time). (Required),String (up to 1). (Required),"String (up to 9). From a payslip, p60 or hmrc letter. (Optional)","String (up to 1). Select a, b or c using the hmrc starter checklist. (Optional)","Integer. If plan type unknown, use 1. (Required)",Boolean (either true or false). (Required),"String (up to 56). Cis only, also used for partnership name. (Optional)","String (up to 21). Cis only, subcontractor utr and optional partnership utr. 10 digits each, separated by semicolon. (Optional)","String (up to 8). Cis only, company reg'n number, e.g. aa123456 or 12345678. (Optional)",String (up to 40). Name of account holder. (Optional),String (up to 40). Banking report definition(s) for payment. (Optional),String (up to 6). 6 digits. (Optional),"String (up to 8). Bank/building society, 8 digits. (Optional)" Use workers e-mail as username,,Usually blank/not in file,Can be a blank string,,,Usually blank/not in file,,,"Mon, Tue, Wed, Thu, Fri, Sat, Sun",,1.0000,Set when continuous employment date predates start date,,"Only used for the first pay run of employment to: 1.Calculate pro-rata salary and 2.Initialise employment history and send a Starter declaration. The value is only used on the first import, when it should be False for a new employee and True if previously paid/reported with an existing payroll system.",Free text,,,,,,Usually blank/not in file,"A B C D or E: A Up to 15.99 hrs B 16-23.99 hrs C 24 – 29.99 hrs D 30 hrs or more, or E Other",Usually blank/not in file,Usually blank/not in file,Usually blank/not in file,Usually blank/not in file,Usually blank/not in file,Usually blank/not in file,Usually blank/not in file,Usually blank/not in file,Usually blank/not in file,Usually blank/not in file,Usually blank/not in file,,,Usually blank/not in file,Only used for CIS,,M or F,Do not use temporary NI numbers,A or B or C,"Omit or 0 (no SL) 1, 2, 4 (SL Plan number)",Omit or 0 (no PGL) or 1 (PGL),Include if using BACS or Faster Payments File,Usually blank/not in file,Include if using BACS or Faster Payments File,Include if using BACS or Faster Payments File,Usually blank/not in file,Usually blank/not in file,Usually blank/not in file GENERAL SPECIFICATION & NOTES Must use CSV format Date format is ISO e.g. 2019-12-31 "Booleans can use 't', 'True', '1' for True and 'f', 'False', '0' for False" Typical files only use a subset of the columns - constant or default values can be omitted and/or set in data feed report definition e.g. 'Workers' if all workers in the same department Column headings can be any string and specified in the report data-feed definition