Skip to main content

Placement Object

The Placement object has numerous custom fields which are used to capture relevant data and support associated processes. For ease, these have been broken down into logical sections below.

Placement Details Fields​

Field LabelAPI NameTypeRequiredDescription
Accountseven20__Account__cLookup(Account)YesThe account with which the placement is associated
Applicationseven20__Application__cLookup(Application)NoThe application with which the placement is associated
Candidateseven20__Candidate__cLookup(Contact)NoThe candidate with which the placement is associated
Charge Rateseven20__Charge_Rate__cCurrency(16, 2)NoThe rate at which the client is charged
Compliance Statusseven20__Compliance_Status__cPicklistNoUsed to track the overall status of any required Compliance
Contract Duration (Months)seven20__Contract_Duration_Months__cNumber(3, 1)NoThe length of the contract in months (if applicable)
Current User Is Candidateseven20__Current_User_Is_Candidate__cFormula (Checkbox)NoSet to true when the current user is the candidate on the placement accessing via Experience Cloud
Duration (Weeks)seven20__Duration_Weeks__cNumber(6, 1)NoThe calculated or manual duration of the assignment in weeks
End Dateseven20__End_Date__cDateNoThe end date of the placement (if applicable)
Jobseven20__Job__cLookup(Job)NoThe job with which the placement is associated
Members Countseven20__Members_Count__cNumber(18, 0)NoThe number of Members for the placement
Pay Rateseven20__Pay_Rate__cCurrency(16, 2)NoThe rate at which the successful applicant(s) will be paid
Placement Statusseven20__Placement_Status__cPicklistNoThe overall status of the placement
Salaryseven20__Salary__cCurrency(16, 2)NoThe salary for the placement
Start Dateseven20__Start_Date__cDateNoThe start date for the placement
Timesheet Periodseven20__Timesheet_Period__cPicklistNoThe period to be used for Timesheets when logging time, i.e. daily, weekly or monthly
Timesheet Start Dayseven20__Timesheet_Start_Day__cPicklistNoUsed to override the first day of the week for weekly timesheets, if required

Financial Fields​

Field LabelAPI NameTypeRequiredDescription
Margin %seven20__Margin_Percent_2__cFormula (Percent)NoPercentage representing the profit margin, calculated as Charge Rate - Pay Rate / Charge Rate expressed as a percentage
Markupseven20__Markup__cFormula (Currency)NoThe markup for the placement, calculated as Charge Rate - Pay Rate
Markup %seven20__Markup_Percent__cFormula (Percent)NoThe Markup as a proportion of the Pay Rate expressed as a percentage
Placement Feeseven20__Placement_Fee__cCurrency(16, 2)NoA generic fee field for the placement
Placement Fee %seven20__Placement_Fee_Percent__cPercent(5, 2)NoThe agreed-upon commission percentage charged to the client based on the candidate's first-year salary
Placement Flat Feeseven20__Placement_Flat_Fee__cCurrency(16, 2)NoA flat fee for the placement (if applicable); conditionally used to populate Permanent Placement Fee
Placement Valueseven20__Placement_Value__cCurrency(16, 2)NoCalculation for placement revenue or net value
Total Membership Split %seven20__Total_Membership_Split__cNumber(18, 0)NoThe sum of Member split percentage values against the placement
Total Revenueseven20__Total_Revenue__cCurrency(16, 2)NoThe sum of Billing Item Amounts against the placement
Total Timesheet Marginseven20__Total_Timesheet_Margin__cRoll-Up Summary (SUM Timesheet)NoThe aggregate gross profit generated from all approved and processed timesheets linked to this placement
Total Valueseven20__Total_Value__cCurrency(16, 2)NoThe sum of Billing Item Margins against the placement
info

The Margin field still exists for this object but has been superseded by the Markup field due to naming inaccuracies.