The import guidelines outline the necessary parameters and requirements for successfully importing data into the payroll system. It provides clear instructions on the format, structure, and content needed for each data type, along with sample files to guide users in preparing their data for import.
When preparing data for import, please ensure that Reference Values, Column Names, and Sheet Names are case-sensitive. Additionally, it’s important to avoid adding any extra spaces before or after these elements, as this may result in import errors or failed uploads.
Careful formatting helps ensure a smooth and successful data import process.
For further information, please select one of the following options:-
The file should contain two sheets with the title: Placements and PlacementRates as per the screenshot below:
Image 5: -Placement Import
The placements Sheet should include the headers in the following order:
Title
Title
Title
Column Name
Required/Can be Left Blank
Accepts the format
Reference
Required
PL00001A
Worker
Required
W00001A
Customer
Required
CU00001A, 1234 etc
StartDate
Required
YYYY-MM-DD
EndDate
Required
YYYY-MM-DD
AutoGenReference
Required
FALSE, TRUE - by default set the rows as FALSE and supply the references
BusinessUnit
Can be left blank
Business Unit reference (Always in CAPS)
Image 6: - Placement Import
PlacementRates Sheet should include the headers in the following order:
Title
Title
Title
Column Name
Required/Can be Left Blank
Accepts the format
Reference
Required
Should match the reference from the placement sheet
PayRate
Required
0.00
Bill Rate
Required
0.00
RateReference
Required
1000, 10001, etc
Image 7: -Placement Rates Import
If the AutoGenReference column is set to FALSE then the Reference field will need to be specified to import the records with the references provided.
If the AutoGenReference column is set to TRUE then the Reference field can be specified as per the screenshots below. This will auto-generate the placement references after the import. Ensure the reference numbers are consistent in both sheets to link the records
Image 8: - Placement References
Image 9: - Placement Rates References
We recommend you specify the placement references as PLXXXXXA to know which references will be assigned to the worker so it is easy to map the placement to the timesheet file import (as shown on the next page).
When importing the Placement file you should select ‘Placements’ as the type of upload
The file should contain two sheets with the title: Timesheets, TimesheetRates, BackingData and ConsultantSplit as per the screenshot below:
Image 10: - Timesheet Import
The timesheet Sheet should include the headers in the following order:
Title
Title
Title
Column Name
Required/Can be Left Blank
Accepts the format
Reference
Required
TS00001A
Placement
Required
PL00001A
TotalTaxes
Required
by Default 0
WorkedDate
Required
YYYY-MM-DD
WorkPeriodId
Required
20220800010
AutoGenReference
Required
FALSE, TRUE - by default set the rows as FALSE and supply the references. If you don’t know the last reference used then set it to TRUE and supply reference as 1,2,3 etc
BusinessUnit
Required
Business Unit reference (Always in CAPS)[1]
TimesheetRates Sheet should include the headers in the following order:
Title
Title
Title
Column Name
Required/Can be Left Blank
Accepts the format
Reference
Required
should match the reference from the timesheets sheet
PayRate
Required
0.00
BillRate
Required
0.00
RateReference
Required
10000, 10001 etc
Units
Required
0.00
Image 11:- Timesheet Rates Import
If the AutoGenReference column is set to FALSE then the Reference field will need to be specified to import the records with the references provided.
If the AutoGenReference column is set to TRUE then the Reference field can be specified as per the screenshots below. This will auto-generate the timesheet references after the import. Ensure the reference numbers are consistent in both sheets to link the records.
Image 12: - Timesheets Import
Image 13:- Timesheet References
BackingData Sheet should include the headers in the following order:
Title
Title
Title
Column Name
Required/Can be Left Blank
Accepts the format
Reference
Required
should match the reference from the timesheets sheet
HasConsultantSplits
Required
True or False
BackingData
Optional
BackingData value
CustomBackingData
Optional
10000, 10001 etc
Image 14: - Timesheet Backing Data Import
ConsultantSplits Sheet should include the headers in the following order:
Title
Title
Title
Column Name
Required/Can be Left Blank
Accepts the format
Reference
Required
should match the reference from the timesheets sheet
Consultant
Required if BackingData has ConsultantSplits = True
Consultant Reference
Percentage
Required if BackingData has ConsultantSplits = True
Consultant Split Percentage
Please refer to the screenshot below to understand what values are accepted for importing backing data
Image 15: - Backing Data Guidelines
When importing the Timesheet file, you must select ‘Timesheets’ as the import type
The file should contain two sheets with the title: Timesheets, TimesheetRates, BackingData and ConsultantSplit as per the screenshot below:
Image 17: -Timesheets with Auto placement
In order to import timesheets using Auto-create placements, users will first need to enable this in the configuration {Account -> Configuration -> Payroll Setup -> Auto Create Placements = “Enable”}
The file should contain two sheets with the title: PermPlacements and PermPlacementRates as per the screenshot below:
Image 18: - Pem Placements Import
The PermPlacements Sheet should include the headers in the following order:
Title
Title
Title
Column Name
Required/Can be Left Blank
Accepts the format
Customer
Required
Customer Reference – Alphanumeric
Reference
Required
Alphanumeric
CandidateName
Required
Alphabets
JobTitle
Required
Alphabets
HiringManager
Required
Alphabets
StartDate
Required
Date in Format – DD/MM/YYYY
AutoGenReference
Can be left blank
TRUE/FALSE
Image 19:- Perm Placements Rates Import
The PermPlacementRates Sheet should include the headers in the following order:
Title
Title
Title
Column Name
Required/Can be Left Blank
Accepts the format
PermPlacementReference
Required
Alphanumeric
RateReference
Required
Number
VATCode
Required
V0/V1/V2
Description
Required
Alphabets
Salary
Required
Decimal
CommisionRate
Required
Number
BillRate
Can be left blank
Decimal
If the AutoGenReference column is set to FALSE then the Reference field will need to be specified to import the records with the references provided.
If the AutoGenReference column is set to TRUE then the Reference field can be specified as per the screenshots below. This will auto-generate the PermPlacement references after the import. Ensure the reference numbers are consistent in both sheets to link the records
Image 20: -Perm Placement Auto Refrence
When importing the PermPlacement file you should select ‘PermPlacements’ as the type of upload
Image 21: - Perm Placement Import Type
Please Note: The PurePro application does not support importing Backing Data for “Perm Placements”. Users can manually add backing data by editing required Perm Placement(s) in the system
The file should contain two sheets with the title: WorkerRates and Transactions as per the screenshot below:
Image 22: - Worker Rates Import
WorkerRates Sheet should include the headers in the following order:
Title
Title
Title
Column Name
Required/Can be Left Blank
Accepts the format
Reference
Required
if AutoGenReference is TRUE then Reference can be set as 1,2,3 etc else set as WR00001A etc
Description
Required
text
Rate
Required
1001 etc
Worker
Required
Worker Reference
WorkerRateType
Required
Payment, Deduction
AutoGenReference
Required
FALSE, TRUE
Image 23:- Worker Rates Import Headers
Transactions should include the headers in the following order:
Title
Title
Title
Column Name
Required/Can be Left Blank
Accepts the format
WorkerRate
Required
Should match the reference from the worker rate sheet
EffectiveDate
Required
YYYY-MM-DD
ExpiryDate
Required
YYYY-MM-DD
NumberOfUnits
Required
0.00
RateValue
Required
0.00
Replace
Can be Left Blank
1 or Blank
Recurring
Can be Left Blank
1 or Blank
CalculationBasis
Can be Left Blank
1 or Blank
Image 24: -Worker Rates Import Headers
If the AutoGenReference column is set to FALSE then the Reference field will need to be specified to import the records with the references provided.
If the AutoGenReference column is set to TRUE then the Reference field can be empty or specified as per the screenshots below. This will auto-generate the transaction references after the import. Ensure the reference numbers are consistent in both sheets to link the records.
WorkerRate import file can be used for the following type of rates:
Salary Payments
Other Payments
Mileage Expenses Payments
Holiday Payments
Other Deductions
When importing the WorkerRate file you must select ‘Worker Rates’ as the import type
The file should contain sheets with the title: StudentLoans as per the screenshot below:
Image 26: - Student Loan Import
StudentLoans sheet should include the headers in the following order:
Title
Title
Title
Column Name
Required/Can be Left Blank
Accepts the format
Reference
Required
if AutoGenReference is TRUE then Reference can be set as 1,2,3 etc else set as WR00001A etc
Rate
Required
2003, 2004 etc
Description
Required
text
Worker
Required
Worker Reference
Plan1
Required
1 or 0
Plan2
Required, can be left blank
1 or 0
PostGraduateLoan
Required, can be left blank
1 or 0
StartDateStudentLoan
Required
YYYY-MM-DD
EndDateStudentLoan
Required, can be left blank
YYYY-MM-DD
StartDatePostgraduateLoan
Required
YYYY-MM-DD
EndDatePostgraduateLoan
Required, Can be left blank
YYYY-MM-DD
AutoGenReference
Required
FALSE, TRUE
Image 27: - Student Loan Import Headers
If the AutoGenReference column is set to FALSE then the Reference field will need to be specified to import the records with the references provided.
If the AutoGenReference column is set to TRUE then the Reference field can be empty or specified as per the screenshots below. This will auto-generate the references after the import. Ensure the reference numbers are consistent in both sheets to link the records.
When importing the StudenLoan file you must select ‘Statutory’ as the import type
ParentalForms sheet should include the following headers in this order:
Title
Title
Title
Column Name
Required/Can be Left Blank
Accepts the format
Reference
Required
if AutoGenReference is TRUE then Reference can be set as 1,2,3 etc else set as WR00001A etc
Description
Required
text
Rate
Required
2104
Worker
Required
Worker Reference
StartDate
Required
YYYY-MM-DD
EndDate
Required
YYYY-MM-DD
EventDate
Required
YYYY-MM-DD
FormReference
Required
text
HasSeenForm
Required
1 or 0
PartnerForename
Required
text
PartnerSurname
Required
text
PartnerNiNumber
Required
text
AutoGenReference
Required
FALSE, TRUE
Statutory Payments of type: - Statutory Maternity Pay (SMP), Statutory Adoption Pay (SAP), Statutory Paternal Pay (SPP), Shared Statutory Parental Pay (SSPP) & Statutory Paternal Bereavement Pay (SPBP) use the same format at “parental Forms” for importing data into the PurePro application.
When importing Parental Form or Sick Pays you must select ‘Statutory’ as the import type
The file should contain sheet with the title: Sheet 1, as per the screenshot below:
Image 39: - Static Data Imports
Static Data Imports can be used to import the following types of static data
Tax Code Change
Tax Basis
NI Letter
Previous Pay
Previous Tax
Student Loan Plan Type
Student Loan Start & End Date
Pension Scheme
Pension Effective Date
Sheet 1 in the StaticDataImport.xlsx should include the following columns: -
Title
Title
Title
Column Name
Required/Can be Left Blank
Accepts the format
BusinessUnitReference
Required
Business Unit Reference
WorkerReference
Required
Worker Reference
ExternalReference
Can be left Blank
External Reference
Forenames
Can be left Blank
Worker Forename – Text
Surname
Can be left Blank
Worker Surname – Text
Property
Required
What needs to be changed – Text e.g. TaxCode
Change
Can be left Blank
Description – Text
NewTaxCode
Can be left Blank
Valid Tax Code
NewTaxBasis
Can be left Blank
Valid Tax Basis
NewNILetter
Can be left Blank
Valid NI Letter
NewPreviousPay
Can be left Blank
Decimal
NewPreviousTax
Can be left Blank
Decimal
SLPlanType
Can be left Blank
Valid Student Loan Type
SlStart
Can be left Blank
Date YYYY-MM-DD
SLStop
Can be left Blank
Date YYYY-MM-DD
PensionChange
Can be left Blank
Valid Pension Scheme
PensionEffectiveDate
Can be left Blank
Date YYYY-MM-DD
Static Data Imports can be used to update employee's pension status; These changes can be made using the following columns in the import file:-
Property
PensionChange
Pension
OptIn
Pension
OptOut
Pension
CeaseMembership
Please note, the corresponding dates in the PensionEffectiveDate cannot be backdated, i.e. the provided dates should reflect the current tax period in the account.
Please note if no Business Unit has been specified against the Data in the import file, data will be imported against the Business Unit selected on the Data Import page prior to importing.
The contents of this document, along with any associated documents, are the property of PurePro Solutions Ltd. and are shared in strict confidence with the intended recipient. These materials may not be reproduced, shared, or used in any manner without prior written consent from PurePro Solutions Ltd. Unauthorized use or distribution is prohibited.