Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Please note that you must also include information about the consultant, contractor, manager and client.  The fields for these entities are defined in their own sections


NameFieldEquivalent InTIME Webservice FieldDescriptionTypeFormatConstraintsMandatory
ReferencePLA_ITRIS_IDPlacement.externalIdA reference for the placementString(20)

Yes
Job TitlePLA_JOB_TITLEPlacement.jobTitleThe job titleString(100)

Yes
Job DescriptionPLA_JOB_DESCRIPTIONPlacement.jobDescriptionThe job descriptionString(1000)

No
Purchase Order NumberPLA_PURCHASE_ORDER_NUMPlacement.purchaseOrderNumA purchase order numberString(50)

No
Default RatePLA_DEFAULT_RATEN/A - First rate in list sentThe name of the rate that is the default, i.e. the one that appears at the top of the list when a timesheet is createdString(80)
Must be a valid rate name and match one of the rate names on the R lineYes
Created Date TimePLA_CREATEDPlacement.created (Read Only)The date and time that the placement was createdDateTimeyyyy-MM-ddTHH:mm:ss
No
Modified Date TimePLA_MODIFIEDPlacement.modified (Read Only)The date and time that the placement was modifiedDateTimeyyyy-MM-ddTHH:mm:ss
No
Placed DatePLA_PLACEDPlacement.placedThe date the worker was placed on the placementDateTimeyyyy-MM-ddTHH:mm:ss
No
Start DatePLA_STARTPlacement.startThe first date of the placementDateyyyy-MM-dd
Yes
End DatePLA_ENDPlacement.endThe last date of the placement (or null for open ended)Dateyyyy-MM-dd
No
Expense TemplatePLA_EXPENSE_TEMPLATEPlacement.expenseTemplateThe name of the expense template to use for this placementString
Must be the name of an existing expense templateNo
Timesheet PeriodPLA_TS_PERIODPlacement.timesheetDateCalculatorNameThe name of the timesheet period to useString


Must be a configured period for the agency. Allowed Values....

weekly
weekly_tue-mon
weekly_wed-tue
weekly_thurs-wed
weekly_fri-thurs
weekly_sat-fri
weekly_sun-sat
monthly
monthly2nd
monthly3rd
monthly4th
monthly5th
monthly6th
monthly7th
monthly8th
monthly9th
monthly10th
monthly11th
monthly12th
monthly13th
monthly14th
monthly15th
monthly16th
monthly17th
monthly18th
monthly19th
monthly20th
monthly21st
monthly22th
monthly23th
monthly24th
monthly25th
monthly26th
monthly27th
monthly28th

No
Bulk EntryPLA_BULK_ENTRYPlacement.bulkEntryThe placement is enabled for bulk entry of timesheetsBooleanY/true/1 OR N/false/0
No
Charge CurrencyPLA_CURRENCY_CHARGEPlacement.currencyForChargeThe currency that items for this placement are charged in. Can be omitted in which case the currency of the client will be usedStringISO 3 digit currency
No
Pay CurrencyPLA_CURRENCY_PAYPlacement.currencyForPayThe currency in which timesheets and expenses will be paid. Can be omitted to use the default for the contractorStringISO 3 digit currency
No
Pay Currency TimesheetsPLA_CURRENCY_PAY_TSPlacement.currencyForPayTimesheetsIf you wish to pay timesheets and expenses in different currencies then use this optionStringISO 3 digit currency
No
Pay Currency ExpensesPLA_CURRENCY_PAY_EXPPlacement.currencyForPayExpensesIf you wish to pay timesheets and expenses in different currencies then use this optionString
ISO 3 digit currencyNo
Split CommissionsPLA_CONSULTANT_SPLITPlacement.splitCommissionsIf you are using split commissions then you can send through a string value that describes the split. The format of this string is <Consultant Ref 1>:<Weight>|<Consultant Ref 2>:<Weight 2>. For example, if you wanted to add a split commission of 30% to a consultant with reference R1 and 70% to a consultant with reference R2, the string would be R1:0.3|R2:0.7



Client SitePLA_CLIENT_SITEPlacement.clientSiteThe site at which the work is being undertakenString(80)

No
DeletePLA_DELETEN/AUse this flag to delete a placement. Specify the value "delete" to delete a placement.String
Placement cannot have any timesheets or expenses
Charge TermsPLA_CHARGE_TERMSPlacement.chargeTermsOverrideIf you wish to override the charge terms on this placement then you can use this field.String
Must be the name of a charge term.No
Paper RequiredPLA_PAPER_REQUIREDN/AWhether a paper electronic upload is requiredBooleanY/true/1 OR N/false/0
No
Tempaid Company IDPLA_TEMPAID_COMPANY_IDN/AThis field is only relevant to clients with a Tempaid back-end system. It provides an associate between the placement and a particular tempaid companyString

No
Holiday Accrual RatePLA_HOL_ACCRUAL_RATEPlacement.holidayAccrualRateThe holiday accrual rate as a decimal figure, e.g. 12% should be 0.12Decimal

No
Post AWR Holiday Accrual RatePLA_HOL_ACCRUAL_AWR_RATEPlacement.holidayAccrualRatePostAWRThe post AWR holiday accrual rate as a decimal figure, e.g. 15% should be 0.15. Note that this is not applicable for all installationsDecimal

No
Placement CommsPLA_NO_COMMSPlacement.noCommunicationsDisables placement related communications for each user type. Expects a string containing a combination of the letters WCML which relates to Worker, Consultant, Manager and LtdCoUser respectively. E.g.

"WCML" disables placement comms for all user types,
"WM" disables comms for worker and manager,
empty enables placement comms for all user types.

Please note: this is Placement comms specific - setting to "WM" wills disable placement comms for the worker and manager but will NOT disable all InTime comms for these users. To do this you would need to use additional import columns WKR_NO_COMMS, MAN_NO_COMMS.

String

No
PAYE Deductions ApplicablePLA_PAYE_DEDUCTIONS_LTDPlacement.pAYEDeductionsOnLtdIf this placement is scope of IR35 so that PAYE deductions are applicable this needs to be ticked. NOTE: InPAY Deemed / IR35 module required!BooleanY/true/1 OR N/false/0
No
Placement Agency Entry

PLA_AGENCY_ENTRY

Placement.agencyOnlyTicks the "Agency" tickbox on the "Main" tab on placement. If ticked the worker cannot enter timesheets or expenses on this placement, these needing to be entered by the Agency.BooleanY/true/1 OR N/false/0
No
Placement Invoice required PO

PLA_INVOICE_REQUIRES_PO

Placement.invoiceRequiresPO

Ticks the "Invoice Requires PO" tickbox on the "Financial" tab on the placement.

BooleanY/true/1 OR N/false/0
No
Placement Overtime RulesPLA_OVERTIME_RULESplacement.overtimeRulesIdThe overtime rules to use for the timesheetsString

No
Email Approval (Only applicable for clients with email approval)
For TimesheetsPLA_EMAIL_APPROVAL_ENABLEDPlacement.timesheetEmailApprovalEnable email approval for timesheets on this placementBooleanY/true/1 OR N/false/0
No
For ExpensesPLA_EXPENSE_EMAIL_APPROVAL_ENABLEDPlacement.expenseEmailApprovalEnable email approval for expense items on this placementBooleanY/true/1 OR N/false/0
No
Approval Routes
TimesheetPLA_TS_APPROVAL_ROUTEPlacement.timesheetApprovalRouteThe approval route to use for timesheetsString
Must be the name of a configured approval routeNo
Chargeable ExpensesPLA_CE_APPROVAL_ROUTEPlacement.chargeableExpenseApprovalRouteThe approval route to use for chargeable expensesString
Must be the name of a configured approval routeNo
Non-Chargeable ExpensesPLA_NCE_APPROVAL_ROUTEPlacement.nonChargeableExpenseApprovalRouteThe approval route to use for non-chargeable expensesString
Must be the name of a configured approval routeNo
Tax Code Override (if you wish to override the tax code on a placement then use this fields)
Self Bill Tax CodePLA_SLFBILL_TAXCODEPlacement.selfBillTaxCodeOverrideThe tax code for self bill invoicesString
Must be the code of an existing tax codeNo
Client Tax CodePLA_CLIENT_TAXCODEPlacement.chargeTaxCodeOverrideThe tax code for client invoicesString
Must be the code of an existing tax codeNo
Financial Categories




Sales DepartmentPLA_SALES_DEPTPlacement.salesDepartmentThe sales departmentString(80)

No
Purchase DepartmentPLA_PURCHASE_DEPTPlacement.purchaseDepartmentThe purchase departmentString(50)

No
Sales SectorPLA_SALES_SECTORPlacement.salesSectorThe sales sectorString(50)

No
Purchase SectorPLA_PURCHASE_SECTORPlacement.purchaseSectorThe purchase sectorString(50)

No
Sales BranchPLA_SALES_BRANCHPlacement.salesBranchThe sales branchString(50)

No
Purchase BranchPLA_PURCHASE_BRANCHPlacement.purchaseBranchThe purchase branchString(50)

No
Sales LocationPLA_SALES_LOCATIONPlacement.salesLocationThe sales locationString(50)

No
Purchase LocationPLA_PURCHASE_LOCATIONPlacement.purchaseLocationThe purchase locationString(50)

No
Sales DivisionPLA_SALES_DIVISIONPlacement.salesDivisionThe sales divisionString(50)

No
Purchase DivisionPLA_PURCHASE_DIVISIONPlacement.purchaseDivisionThe purchase divisionString(50)

No
Sales Cost CentrePLA_SALES_COST_CENTREPlacement.salesCostCentreThe sales cost centreString(50)

No
Purchase Cost CentrePLA_PURCHASE_COST_CENTREPlacement.purchaseCostCentreThe purchase cost centreString(50)

No
Sales Project ReferencePLA_PROJECT_REFPlacement.salesProjectThe sales project referenceString(50)

No
Purchase Project ReferencePLA_PURCHASE_PROJECTPlacement.purchaseProjectThe purchase project referenceString(50)

No
Rotations (Only applicable for clients with the rotations module). If using rotation on a placement then all fields are mandatory
Start DatePLA_ROTATION_STARTN/AThe date at which the rotation patter beginsDate

No
Unit TypePLA_ROTATION_UNIT_TYPEN/AWhether the unit is days (0) or weeks (1)Integer

No
Units OnPLA_ROTATION_UNITS_ONN/AThe number of units on-rotationInteger

No
Units OffPLA_ROTATION_UNITS_OFFN/AThe number of units off-rotationInteger

No
Invoice Contact Override (only use these fields if you wish to override the invoice contact on the client)
Frontend ReferencePLA_SALES_INV_FRONTEND_REFPlacement.invoiceContactOverride.externalIdThe unique reference for the invoice contactString(255)
if the import finds an existing invoice contact at the same client with this reference, it uses and updates the same invoice contact.No
First NamePLA_SALES_INV_FIRSTNAMEPlacement.invoiceContactOverride.firstnameThe first name of the invoice contactString(255)

No
Middle NamePLA_SALES_INV_MIDDLENAMEN/AThe middle name of the invoice contactString(255)

No
Last NamePLA_SALES_INV_LASTNAMEPlacement.invoiceContactOverride.lastnameThe last name of the invoice contactString(255)

No
DepartmentPLA_SALES_INV_DEPARTMENTN/AThe department of the invoice contacy



EmailPLA_SALES_INV_EMAILPlacement.invoiceContactOverride.The email address of the invoice contactString(255)
Valid email addressNo
Telephone NumberPLA_SALES_INV_PHONEPlacement.invoiceContactOverride.The telephone number of the invoice contactString(30)

No
Street 1PLA_SALES_INV_STREET1Placement.invoiceContactOverride.address.line1
String(80)

No
Street 2PLA_SALES_INV_STREET2Placement.invoiceContactOverride.address.line2
String(80)

No
TownPLA_SALES_INV_TOWNPlacement.invoiceContactOverride.address.town
String(80)

No
CountyPLA_SALES_INV_COUNTYPlacement.invoiceContactOverride.address.county
String(80)

No
PostcodePLA_SALES_INV_POSTCODEPlacement.invoiceContactOverride.address.postcode
String(20)

No
CountryPLA_SALES_INV_COUNTRYPlacement.invoiceContactOverride.address.country
String(80)

No
Country CodePLA_SALES_INV_COUNTRY_CODEPlacement.invoiceContactOverride.address.countryCode
String(2)
ISO 2 digit country codeNo
Placement Custom Text Fields
Custom Text1PLA_CUSTOM_TEXT1Placement.customText1
String

No
Custom Text2PLA_CUSTOM_TEXT2Placement.customText2
String

No
Custom Text3PLA_CUSTOM_TEXT3Placement.customText3
String

No
Custom Text4PLA_CUSTOM_TEXT4Placement.customtext4
String

No
Custom Text5PLA_CUSTOM_TEXT5Placement.customText5
String

No


The following images show how the import fields are mapped to the placement screen in RSM InTime