SF EC Payments
SF EC Payments
7 Pay Range. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 89
7.1 Determining Pay Ranges in Calculations. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 89
Examples for Pay Range Calculations. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 90
Troubleshooting Pay Ranges in Calculations. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 91
7.2 Showing the Pay Range in Job Information. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 92
7.3 Exporting Pay Ranges. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 94
8 Pay Scale. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 96
8.1 Pay Scale Structure. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 96
Migrating Pay Scale Type and Pay Scale Area Fields. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 97
Creating Pay Scale Area. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 98
Creating Pay Scale Type. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 99
Creating Pay Scale Groups . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .99
Creating Pay Scale Levels. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 100
Changing the Pay Scale (Mass Changes). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 100
Business Rules for Indirect Valuation. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 101
8.2 Tariff Change Effects on Employee Compensation (Pay Scale Increase) . . . . . . . . . . . . . . . . . . . . . . . . 112
Exporting the Pay Scale Structure . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 114
Importing the New Pay Scale Structure. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .115
Adjusting Employee Compensation Data Based on Tariff Changes . . . . . . . . . . . . . . . . . . . . . . . . . .117
8.3 Adjust Pay Scale Level. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 121
8.4 Grade Step Progression. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 121
Prerequisites for Grade Step Progression. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 122
Employee Central Compensation helps you to set up and manage a pay structure for your company. You can
create annualized salaries as well as compensation packages for your employees. The system helps you visualize
where an employee is in their pay range or where they are in comparison others in a team. It is possible to set up
location-based payments as well as country/region-specific pay components. Spot bonuses or deductions can be
created for users as well if required.
This guides covers topics related to compensation information. There are other guides that may interest you as well
though.
Topic Link
Some of the foundation objects (FO) can be used to handle payroll-related issues.
Pay Range Foundation/Legacy Pay range is primarily used for the cal-
culation of compa ratio and range pen-
etration. The system stores minimum,
median, and maximum points of a pay
range.
Foundation objects can be changed using the Manage Organization, Pay, and Job Structures UI.
You can set up pay component groups to calculate and display annualized sums of recurring pay components in
the Compensation Information block.
Note
In pay component groups, the default decimal rounding is 3 digits in UI, APIs, business rules, and reporting.
However, this is configurable and can be changed in the Manage Organization, Pay and Job Structures page.
General
Pay component groups are linked only to pay components. It is also possible to link from legal entity to pay
component groups (which limits the pay components you can see in the profile to the ones relevant for your legal
entity) but is only possible using an association.
You can define the currency in which the pay component group should be displayed and in what order, and whether
the group is used for the calculation of compa ratio and/or range penetration. In addition, you specify which pay
components belong to which group.
The currency is not a required field. If no currency is entered in the pay component group definition, the system
determines which currency to use for the display. If the currency used is decided by the system, it is based on the
following criteria:
When viewing the Compensation Information block, the pay component groups are calculated on-the-fly, that is,
they are not stored to the database. As for the calculation, it is relatively simple. For pay components of type:
• Amount: convert currency if needed and annualize (meaning, multiply monthly salary by 12)
• Number: calculate amount = number * rate, then convert currency if needed and annualize
• Percentage: calculate annualized (and converted) value of base pay component, then multiply by given
percentage
Note
For percentages, frequency is not relevant for this calculation. Frequency only affects the calculated
amount for the employee pay components.
Here is an example of the pay component groups in the Compensation Information block.
If you select the question-mark icon, the system displays the annualized values of all the pay components that are
in the pay component group (those for which the employee has data) for the total earning opportunity (TEO).
If a pay component group has the Use for Range Penetration setting (you can check in Manage Organization, Pay
and Job Structures to be sure), then that will be used in Total Compensation History. If no such pay component
group exists for the employee, then the first pay component group from the list will be used (this can be influenced
by the Sort Order flag in the pay component group definition).
A pay component group sum can be the sum of the annualized values of the pay components assigned to it. These
annualized values are calculated by taking the annualization factor of the "Frequency" object set against the pay
component to calculate the annualized value. The frequency of the pay component determines how this value is
calculated.
Tip
The system considers all frequencies where the annualization factor is 0 to be hourly frequencies independent
of the text name, and that non-zero annualization factor means not hourly, independent of the text name of the
frequency.
Note
The pay component group is in a certain currency, so whatever currency the pay components have, they must
be converted to the pay component group currency in the annualization and sum building process.
For more information, refer to Optional: Pay Component Groups and Pay Component Group Calculation.
Here is an example of the steps needed to calculate the annualized value for pay components with frequencies that
are not hourly based.
1. Associate the Base Salary pay component to the Annualized Salary pay component group.
2. Assign the Base Salary pay component to an employee with the amount of "$1,000" and set the frequency to
Monthly (MON).
The Monthly (MON) frequency has an annualization factor of 12.
3. Check the Compensation Information block to ensure that the Annualized Salary field displays "$12,000".
The annualized salary is the pay component value multiplied by the annualization factor of the frequency
(annualized salary = pay component value * annualization factor). So, in the example, "12,000" is the result of
1,000 multiplied by 12.
Here is an example of the steps needed to calculate the annualized value for pay components with frequencies that
are hourly based and where the annualization factor is zero.
1. Associate the Base Salary pay component to the Annualized Salary pay component group.
2. Assign the Base Salary pay component to an employee with the amount of "$250" and set the frequency to
Hourly (HOURLY).
The Hourly (HOURLY) frequency has an annualization factor of 0, which means that working hours are taken in
account.
3. Check the Standard Hours of the employee in Job Information - in our example, we use 25 hours a week.
4. Check the Compensation Information block to ensure that the Annualized Salary field displays "$325,000".
The annualized salary is the pay component value multiplied by the standard hours multiplied by 52 weeks in a
year. So, in the example, the "325,000" is the result of 250 * 25 * 52.
Here is an example of the steps needed to calculate the annualized value for pay components with frequencies that
are hourly based and have an annualization factor greater than zero.
Note
If there is an annualization factor greater than zero, then it's calculated the same as non-hourly frequencies.
If the value is nonzero, the amount of the pay component is multiplied with the annualization factor, for example
12. This means that $100 a month (amount of pay component) x 12 months in a year (annualization factor) =
$1200 for the year.
• Basic salary
• Target bonus
• Company car allowance
• Whether the component is recurring or one-time. If recurring, how often it is paid? (this is called the Frequency
- see below).
• Whether the component is paid as an absolute amount, as a percentage, or as a number
• If the component is paid out as a percentage of other pay components, specify which pay component forms
the basis for the percent calculation.
There are validation checks in place that the system performs when changing the configuration of a pay
component. In most cases the configuration of a pay component should never be changed once it is used in
employee data. This is because it could have a negative or unexpected impact, causing incorrect calculations in
payouts. Do not set pay components to the status Inactive. It is always best to create a new pay component if major
changes are needed.
Integration
Pay components are used in several areas of the system other than just compensation information. They are also
used in the following areas of Employee Central:
• Time Off
• Global Benefits
• Advances and Deductions
• Compensation
Rounding of Values
For the pay component value and calculated amount fields in recurring pay components, the system rounds the
values as follows:
• If the Maximum Fraction Digits are not specified anywhere, the default number of decimal places is 3.
• The Maximum Fraction Digits can be specified for the fields in Manage Business Configuration if the default
value doesn't meet customer requirements.
In this case, both the pay component value and calculated amount fields are rounded using the value specified
for the respective pay component value or calculated amount field. Please ensure that the number of digits
specified for the calculated amount is identical to that of the value field, as some UIs shorten the calculated
amount according to the field definition, which may confuse users.
• If the Maximum Fraction Digits are specified for the pay component in Manage Organisation, Pay, and Job
Structures, then that value is used to round all the fields listed above for the pay component.
The rounding is half-even; that is, if you enter 51.645 and you have two decimal places defined, you get 51.64.
Related Information
A pay scale is a salary (tariff) structure that shows the rates of pay for employees working at each level of an
organization.
It may be based on one or more factors such as the employee's level, rank or status, length of time with the
company, or difficulty of the work. The pay scale is made up of pay scale levels, which define the pay components
that are assigned to each employee in that level.
The pay scale structure enables pay component values for employees to be defined based on a fixed pay structure.
This is often used for unionized employees, for whom collective bargaining and contractual agreements exist to
control employees’ pay on a scaling basis.
The pay scale objects have no relationship with the pay ranges and pay grades.
Related Information
Pay grades form a matrix for employees to move through. They can move through a vertical range where each level
corresponds to the responsibility of, and requirements needed for a certain position; as well as a horizontal range
that allows monetary incentives to reward the employee's quality of performance or length of service.
Pay grades and pay ranges are required for compa ratio and range penetration calculations.
Pay Range is primarily used for the calculation of Compa Ratio and Range Penetration. The system stores
minimum, median, and maximum points of a pay range.
Salary ranges within each pay grade are based on qualifications, skills, experience, equity in comparison to similar
positions, and external market values. Salary ranges allow for differences among positions within the same grade
as well increasing levels of responsibility and performance within the same job.
Your company can define as many pay ranges as required. The range generally includes Pay Grade, Geozone, and
Legal Entity and are updated every year.
In order to determine the pay range of an employee, the system will proceed as follows:
1. For each associated field type, it looks for a field in the employee Job Information with the same type.
Ideally there is only one field with a specific type (example pay grade) in Job Information. If a standard field and
a custom field exist with the same type, the system will use the standard field. If several custom fields exist with
the same type, the system will simply pick one. Even if a Job Information field is inactive – the system takes
both active and inactive fields into account.
For example, if there are 2 fields with a specific type configured in the Corporate Data Model, where one is
active but the other inactive. When the system tries to determine the pay range, it will find both fields and it is
possible that the system picks the inactive field. This can lead to an unexpected pay range being determined.
Therefore, we recommend that there should be only one such Job Information field – no matter if active or not.
2. The system looks for a pay range that matches all the associated field values from employee job info.
3. If one (or more) matching pay ranges are found, the system uses the first one.
Defining several pay ranges that match one combination of associations is a (common) configuration error.
4. If no matching pay range is found, the system will remove the last associated field from the list (based on the
order of the associations in the Corporate Data Model) and repeats steps 2—4 until either a match is found or
no associations are left (= no pay range for this employee).
Related Information
Compa ratio is a key metric for an employee's compensation. It measures the relationship between the salary of an
employee or a position, and the mid-point of the pay range for that employee or position.
If an employee is earning the exact amount of the mid-point of their salary range, their compa ratio will be 1.0 (or
100%). Anything less than 1.0 means they are earning less than mid-point and if the compa ratio is more than 1.0
they are earning more than the mid-point.
If you have a lot of employees, sorting your compa ratios in ascending or descending order can be a useful way to
quickly see which of your employees is earning significantly less or more than the mid-point of their range.
Compa ratio is updated when the amount of a pay component is changed. For manual changes in Job Information,
ensure that the Enable Compensation Refresh setting is set to Yes to trigger the recaluclation of fields in
Compensation Information. This is for manual changes only and not for fields changed by rules or for the Position
field.
There are two settings you can choose for compa ratio calculation:
• Admin Center Company System and Logo Settings Ignore FTE During Compa Ratio and Range
Penetration Calculation
When you choose to ignore the FTE, the calculation of compa ratio and range penetration does not show FTE at
all. When FTE is considered, then the calculation reflects the value of the FTE as listed in Job Information.
• Admin Center Company System and Logo Settings Calculate Range Penetration or Compa Ratio even if
FTE and Standard Weekly Hours are null
Usually the Compa Ratio and Range Penetration fields display an error if the standard weekly hours for an
employee are null. If this setting is activated, then these fields are calculated using FTE = 1, meaning, as if the
employee were full-time.
Related Information
Range penetration is a key metric for an employee's compensation. It shows the level of an individual's pay
compared to the total pay range.
It is calculated as follows:
Range penetration and compa ratios show how an employee’s pay progresses with increasing skill and
performance. Range penetration describes how far into a range an individual’s pay has progressed. Rather than just
While range penetration can be useful on an individual basis, looking at where all of your employees fall within
each of your ranges can also be a useful indicator that maybe your ranges are too wide or too narrow. In addition,
range penetration can be useful if you use portions of the range as target levels for certain categories of employees,
meaning that you want new hires to be in the first 25% of the range, and experts or consistent high performers to
be in the top 25% of the range.
There are two settings you can choose for range penetration calculation:
• Admin Center Company System and Logo Settings Ignore FTE During Compa Ratio and Range
Penetration Calculation
When you choose to ignore the FTE, the calculation of compa ratio and range penetration does not show FTE at
all.
When FTE is considered, then the calculation reflects the value of the FTE as listed in Job Information.
• Admin Center Company System and Logo Settings Calculate Range Penetration or Compa Ratio even if
FTE and Standard Weekly Hours are null
Usually the Compa Ratio and Range Penetration fields display an error if the standard weekly hours for an
employee are null. If this setting is activated, then these fields are calculated using FTE = 1, meaning, as if the
employee were full-time.
The forward propagation of this field change stops as soon as one of the future records has a field value that is
different than the original field value.
For recurring pay components, propagation stops for all fields as soon as a future record is found in which one field
does not match the original value.
Changes to Compensation Information (hris element: compInfo) are propagated individually, whereas recurring
pay components (hris element: payComponentRecurring) are propagated as a group. This is due to the fact that
pay components consist primarily of a group of fields whose values make sense only as a group (amount +
currency + frequency or number + currency + frequency + unit + custom fields) so that it is reasonable to stop
propagation entirely when one field changes.
Note
Some fields are not propagated, for either technical or business reasons.
Note
Business rules are applied only once and the changes resulting from these rules are propagated.
When forward propagation makes changes to future records, then the timestamp and user are also changed in the
future.
• Imports
• Compensation Planning
Note
These changes are propagated as if they were made using the compensation UI; that is, the rules are
applied once and the changes are propagated independently of the end date of the original changes to Job
Information.
Example
A company may have 2 pay components, one for full-time employee and one for part-time employees. The
employees have both pay components in their compensation information data. The amount for the part-time pay is
calculated using a business rule based on the full-time pay amount and the employee’s FTE.
In this example, an employee has a future change from full-time to part-time (80%) on April 1st at a 20% salary
reduction.
The employee receives a pay increase on March 01. The full-time pay component is changed manually from 5000
to 5050 and the part-time pay component is adjusted using a business rule from 5000 to 5050 (as the employee is
still working full time in March).
After the change and propagation, the employee has the following pay components:
Related Information
Here is some additonal information about the fields that are not forward propagated for Compensation
Information.
allowDelete
change-source
created-on
created-by
effectiveLatestChange
endDate
event
eventReason
item-id
last-modified-on
last-modified-by
notes
seqNumber
startDate
wfConfig
Here is some additonal information about the fields that are not forward propagated for Pay Component Recurring.
allowDelete
calculated-amount
Compensation-id
createdOn
createdBy
effective-latest-change
end-date
formId
Item-id
lastModifiedOn
lastModifiedBy
notes
noChangesUntilDate
pay-component
pay-component-type
paymentEndDate
start-date
seq-number
templateId
wfConfig
Here are a few examples of how you can use business rules for compensation topics in your system.
Note
Only use the Compensation Information Model base object to set visibility of fields or when you need to
compare/read previous and current values for fields.
When you change pay component fields (pay component, pay component type, amount, currency, frequency,
number) using business rules, this does not trigger the recalculation of Compensation Information fields (compa
ratio, range penetration, and pay component groups). During rule execution, the calculation of these fields happens
when one of these fields is checked by a rule. If some changes are done by other rules on pay components, when
another rule checks these fields, then the recalculation does not take place.
When executing rules for pay components of type percentage, the calculated amount is not always available at the
time of the execution of the rule. Therefore a pay component group should be used as a proxy.
For transient fields, there is no data stored in the database. This means that some values are not updated when the
business rule is executed. For example, if you use a custom field for Country/Region in Job Information, then that
field will not be updated. The solution is that the information should come from the legal entity information stored
in the system. This means that the country/region information for business rules should come from the legal entity
rather than from another source.
The decimal points of sums and calculations are based on the <maximumFractionDigits> HRIS attribute
defined in the Corporate Data Model. Depending on the number of decimal digits defined, the numbers displayed in
the system get rounded up or down. This property is only for HRIS fields with the data type DOUBLE, and can have
up to 5 decimal places. If you define a value higher than 5, the system uses the maximum value, which is 5. If you
define a negative value, for example, -1, the default value of 3 decimal places is used. The pay component value field
of the Pay Component foundation object is reused in Compensation Information. If you then choose to override this
field and the value of the maximumFractionDigits attribute is different for the fields, it leads to an error.
Note
Do not mix global fields and fields from multiple country/region versions in one rule!
If you have a rule for a field in Country/Region-Specific Data Model, and the rule is attached to the global Job
Information data model, there may be problems. The possible solutions for this are:
When using pay components for comparisons in business rules, ensure that the condition is the same for all fields
being compared.
In this example, if the previous value of the base salary for an employee is different from the current value, then the
event should be set to Pay Rate Change.
Note
If you want to use a pay component group in business rules, then the external code can contain ONLY
alphanumerics, underscore, minus, @, %, and space. Other characters such as slash (/) are not allowed.
You can use pay component group sums in rules, for example, to perform calculations. To use pay component
group sums in business rules, you have to make sure the corresponding pay component groups are displayed on
the Configure Business Rules page.
For more information on how to set this up, refer to Setting Up the Application in the Implementing Business Rules
in SAP SuccessFactors guide.
You can set up the system to send a warning message when an employee's compensation is outside of the pay
range for their pay grade. This is an onSave rule for compensation information.
If the range-penetration value is more than 100, then the annual salary is more than the pay range or if the
range-penetration value is less than 0, then the salary is less than the pay range. Therefore the system is set up to
display the warning message when the employee compensation information for annual salary is saved.
Prerequisites
You can set the default pay component in compensation information during hiring based on the pay scale level
selection in the Job Information.
It must be clear what pay component is associated with the pay scale level as well as which pay component
assignment needs to be configured at pay scale level.
This is a rule with the base object Employee Information. It should be added to the onInit event of
payComponentRecurring in Manage Business Configuration.
Note
You can use rule functions, for example, Amount from Pay Scale Structure or Currency from Pay Scale Structure,
to get the value that was assigned at pay scale level & then based on the retrieved value, the values in the recurring
pay component are set.
Caution
This example rule is correct for defaulting pay components during the hire process. In general, rules that
change pay components should obey the following two principles:
1. If a recurring pay component should be created, use the command Create and not the command Set to do
so
You can create a cross-entity rule to make sure that changes made in the Compensation block to a pay component
also appear in MSS and History pages.
This is a rule with the base object Compensation Information. It should be added as an onSave rule to
compensation information in Manage Business Configuration.
You can create a cross-entity rule to create or update recurring pay components when Job Information is changed.
This is a rule with the base object Job Information. It should be added as an onSave rule to Job Information in
Manage Business Configuration.
You can create a rule to update the effective date of event reasons or pay groups.
This is a rule with the base object Compensation Information Model. It should be added as an onSave rule to
Compensation Information in Manage Business Configuration.
You can create an onView rule that calls the Pay Range Name function.
Prerequisites
Sample Code
<hris-associations>
<association id="id" required="false" multiplicity="ONE_TO_ONE"
destination-entity="payGrade" />
<association id="id" required="false" multiplicity="ONE_TO_ONE"
destination-entity="geozone" />
<association id="id" required="false" multiplicity="ONE_TO_ONE"
destination-entity="company" />
</hris-associations>
In some cases, you may want to have fields set to read-only for users. You can create an onView rule for this.
This is a rule with the base object Compensation Model. For the If condition, you can create your own or select the
Always True checkbox.
You can create an onChange rule for HR admins to create a workflow for changes to benefits and/or compensation.
Note
Although it is technically possible to configure workflow rules on Recurring Pay Components as the base object,
this is not recommended because if you configure a rule that returns different workflow configurations for the
separate pay components, the system will select one of those values for you.
You can create an onSave rule to check not only whether the value has been reduced, but should also include the
cases where the value and the previous value are null, which may occur when an employee has no recurring pay
components.
You can use the Compensation Model object to compare the value to ensure that changes of 10% or more are
limited. On the rule, you can use a Math Expression function and get the previous value to compare with the newly
entered value.
You can use a cross-entity business rule to create and/or adjust pay components whenever there is a change in pay
scale for a user.
You can use a cross-entity business rule to create or update additional pay components when the end user adds a
pay component.
If your rule does the same thing repeatedly, for example, calculating a value or reading the same field, then the rule
will be faster if you create a variable and re-use it.
For rules that use the Create function to create a new recurring pay component, the result is that the recurring pay
component is created.
For rules that use the Create function to update an existing recurring pay component, the result is that the
recurring pay component is updated with the rule result. The values of any fields that are not filled explicitly by the
rule are taken from the existing record.
You can use a business rule to calculate the ratio between the previous value of a field and the current value of it, for
example, for the previous value of a salary “Salary Amount” and the current value of it.
Context
Automation in the system means less manual effort and fewer errors. Compensation data for each employees can
be captured along with an employee's past record.
Reporting on a standard compensation structure also helps to understand the total cost in salary of a company.
Procedure
a. Go to Admin Center Manage Organization,Pay and Job Structures Create New Pay Component .
b. Enter the required data.
c. Save your changes.
2. Assign View/Edit permissions for all the components.
a. Go to Admin Center Manage Permission Roles User Permissions Employee Data Pay
Components .
b. Select the View and/or Edit permissions for each pay component you created for the structure.
c. Save your changes.
3. Optional: Define a custom field for Compensation Information.
a. Go to Admin Center Manage Permission Roles User Permissions Employee Central Effective Dated
Entities Compensation Information .
b. Select the permissions for the new field you created.
c. Save your changes.
5. Create a rule to automatically propagate pay components.
a. Go to Admin Center Configure Business Rules Create Basic . The base object must be
Compensation Information.
b. Define the If condition. For example, when the current salary is greater than 20,000 or if the employee
belongs to certain pay grades, company, department, and so on.
c. Define the Then condition to create a Compensation Information block with data populated from all the
pay components defined in your structure.
Results
Changes to your custom field result in updates shown in the Compensation Information block.
You can default pay components to better automate the Hire/Rehire process.
Context
• Automatically create Compensation Information and recurring pay component while hiring based on Job
Information fields, for example, Company, Job Classification, and Pay Grade using an onSave rule
• Provide default recurring pay component values while hiring to add to the Compensation Information and
recurring pay component records in the UI using an onInit rule
Procedure
a. Go to Admin Center Manage Organization,Pay and Job Structures Create New Pay Component .
b. Enter the required data.
c. Save your changes.
2. Create a pay component group.
a. Go to Admin Center Manage Organization,Pay and Job Structures Create New Pay Component
Group .
b. Add all the pay components required.
c. Save your changes.
a. Go to Admin Center Configure Business Rules Create Basic . Select Compensation Information
as the base object although you can also use Job Information Model where required .
b. Define the If condition. For example, for the Hire or Rehire event.
c. Define the Then condition to create recurring pay components with data populated from all the pay
components defined.
d. Save your changes.
5. Assign the rule to the standard or custom field.
Results
Set up the data models and permissions for compensation objects in Employee Central.
For payments to work correctly, then all payments and deductions have to be entered in Employee Central.
Employee Central must be the core HR platform, where payroll is managed in SAP and other local platforms. Data
management must be standard and identical across all countries. That data in Employee Central needs to be easily
accessible for both employees and managers.
Pay components and wage types that are governed by HR policies and/or that impact global compensation
processes should be managed in Employee Central. This allows the Employee Central to drive the eligibility
elements for other processes, for example, benefits or overtime.
Context
Remember
As a customer, you don't have access to Provisioning. To complete tasks in Provisioning, contact your
implementation partner or Account Executive. For any non-implementation tasks, contact Product Support.
Procedure
Once the settings have been enabled in Provisioning, you can enable new features using the Employee Central
Settings in the Admin Center rather than having to create a support ticket to update Provisioning. To grant this
permission, go to Manage Permission Roles Manage System Properties to enable the Employee Central
Feature Settings.
Here is some important information for fields needed for compensation information.
You can update the data models yourself in your system in the Business Configuration UI.
For more information about the Business Configuration UI, refer to the Setting Up and Using Business
Configuration UI (BCUI) found on the SAP Help Portal.
Note
Do not add a picklist for the pay group field in the data model.
Employment Objects
• Compensation Information
Here is some important information about fields that must be in the data models for pay components.
To update the data models, create a support ticket by contacting SAP Product Support.
Remember
As a customer, you don't have access to Provisioning. To complete tasks in Provisioning, contact your
implementation partner or Account Executive. For any non-implementation tasks, contact Product Support.
You can add the field <maxFractionDigits> if needed but it isn't required.
To use the pay component type Number, the fields <unit-of-measure>, <rate>, and <number> must first be
defined and set to visible in the Corporate Data Model.
Sample Code
<hris-element id="payComponent">
<hris-field id="unit-of-measure" visibility="both" pii="false">
<label>Unit of Measure</label>
</hris-field>
<hris-field id="rate" visibility="both" pii="false">
<label>Rate</label>
</hris-field>
<hris-field id="number" visibility="both" pii="false">
<label>Number</label>
</hris-field>
</hris-element>
To use the pay component type Percentage, the field <basePayComponentGroup> must be enabled and editable.
The base pay component specifies which pay component group is used as the basis for the percentage calculation
and is a required field for pay components of type Percentage. In order to avoid data inconsistencies, the
<basePayComponentGroup> field is only visible for pay components of type percentage when defining pay
components.
Sample Code
Sample Code
<hris-element id="payComponent">
<hris-field id="basePayComponentGroup" visibility="both">
<label>Base Pay Component Group</label>
</hris-field>
</hris-element>
Employment Objects
• PayComponentRecurring
• PayComponentNonRecurring
You can update the Succession Data model using the Business Configuration UI. For more information about the
Business Configuration UI, refer to the Setting Up and Using Business Configuration UI (BCUI) found on the SAP
Help Portal.
Sample Code
Tip
The base-paycomponent field specifies which pay component group is used as the basis for the percentage
calculation. It is filled automatically by the system when the corresponding <basePayComponentGroup> field
is filled in the pay component definition.
It is not recommended to make this field editable and it is not recommended to use it for other purposes. If you
wish to associate recurring pay components to pay component groups for some other purpose, a custom field
should be used.
Calculated amounts
In order to ensure that the field <calculated-amount> is filled, it should also be added to the Succession Data
Model for both payComponentRecurring and payComponentNonRecurring.
The system determines the decimal places used in order of the following:
• If the decimal places are defined for the pay component, the system uses the definition.
• If the decimal places are defined in the data model, but not in the pay component, then the system uses the
definition from the data model.
• If nothing is specified at all, then the system uses 3 decimal places for the calculation.
Sample Code
Foundation Objects
Foundation Objects are managed in the Manage Organization, Pay, and Job Structures UI.
• Frequency
• Pay Component
Here is some important information about the fields needed for pay scale.
You can update the data models yourself in your system in the Business Configuration UI.
For more information about the Business Configuration UI, refer to the Setting Up and Using Business
Configuration UI (BCUI) found on the SAP Help Portal.
Pay Scale
To ensure that the fields are automatically available in all countries/regions, SAP SuccessFactors recommends that
you add the following pay scale structure fields to the data model for Job Information:
These fields must be in the non-country/region-specific data model, although the visibility can be set to none, and
set to visible for specific countries. If you don't do this, the value help for pay scale group and level will not work.
You can hide pay scale structure fields for countries where you do not require pay scale structures.
Note
Customers who are setting up these fields for the first time should always use the Metadata Framework (MDF)
objects. This means that the picklist should not be in the data model. For existing customers, we recommend
that you migrate to the MDF. MDF objects are updated using the Manage Data UI.
Here is some important information about the field required for pay range.
You can update the data models in the Business Configuration UI.
The following fields are required in order to calculate compa ratio or range penetration based on the pay range and
should always be enabled.
• currency
• minimumPay
• maximumPay
• midPoint
• frequencyCode
Sample Code
The pay range for an employee is not entered into the system as a field in job or compensation information.
It is determined automatically depending on associated fields in the job information of the employee. These
associations must be defined in the Corporate Data Model for the pay range.
Example
If the employee pay range is determined by the Legal Entity and Pay Grade of the employee, the associations might
be created for legal entity, geo zone, and pay grade as one-to-one associations.
Sample Code
<hris-associations>
<association id="id" multiplicity="ONE_TO_ONE" destination-entity="LegalEntity"
required="false" />
<association id="id" multiplicity="ONE_TO_ONE" destination-entity="geozone"
required="false" />
<association id="id" multiplicity="ONE_TO_ONE" destination-entity="payGrade"
required="false" />
</hris-associations>
ONE_TO_MANY associations are also possible, meaning that one pay range could be valid for a single legal entity
and geozone and several pay grades.
Associations to geozone follow a special logic. The value of the associated field is not taken from a field with
type geozone in job info, but rather from the geozone assigned to the location of the employee.
You can use role-based permissions (RBP) to control access to compensation areas. This may be important for
customers to separate duties to limit who has access to monetary information.
Permission Description
Compensation Information Actions Allows user to see Compensation Information in the Profile as
well as controls the visibility of buttons and links in the block:
User Permissions Employee Central Effective-Dated
• View Current: Visibility of Compensation Information in
Entities Compensation Information
Profile
Access to Compensation Information in Take Action does
not depend on this!
• View History: Visibility of History button in Profile Com-
pensation Information
• Edit/Insert: Clickability of Insert New Record button in
Compensation Information History
• Correct: Visibility of Edit button in Compensation Informa-
tion History
• Delete: Visibility of Delete button in Compensation Infor-
mation History
Field-Level Permissions Allows user to see and/or edit fields in Compensation Informa-
tion UIs:
User Permissions Employee Central Effective-Dated
• View Current: Field visibility in Compensation Information
Entities Compensation Information
block
• View History: Field visibility in Compensation Information
History
• Edit/Insert: Field editability when creating a new record
• Correct: Field editability when Compensation Information
is edited from the History
• Delete: Not used for fields
Recurring Pay Components There are no specific permissions for the recurring pay compo-
nent object. Access to the UI is handled by the Compensation
Information permissions as well as permissions for the individ-
ual pay components. A user with permission for an action and
the corresponding pay component has permission for all fields
in the recurring pay component.
• On view of UIs
• On save in spot bonus UIs
Non-Recurring Pay Components There are no field-level permissions for the non-recurring pay
component object. Access to the Us is handled by the Spot
Bonus permissions as well as permissions for the individual
pay components. A user with permission for an action and the
corresponding pay component has permission for all fields in
the non-recurring pay component.
Pay Components Allow users to view pay components on the user interface as
read-only.
User Permissions Employee Data Pay Components
Allow users to edit and delete a pay component on the Update
• On view of UIs
• On delete
Only when a pay component is deleted, not when an entire
Compensation Information record is deleted in the History
UI.
• On Save (correct/insert)
• Specific business scenarios for Time, Benefits, Leave
Loading, and Compensation.
Pay Components When selected, the system is able to create pay components
from business rules.
User Employee Data HR Information Create or Delete
Pay Components Using Business Rules Without Additional When not selected, the additional permission check prevents
Permission Check the system from being able to create pay components using
business rules.
Pay Component Groups Allow users to view the pay component group in the system,
for example, on the Employment Information page.
User Permissions Employee Data Pay Component
Groups Note
The pay component groups are only visible if the field
Display on Comp UI is set to Yes in the pay component
group definition.
• On view of UIs
Pay Scale - Adjust Employees’ Compensation to Tariff Changes Allows users with this permission to both view and create pay
scale increase jobs.
Admin Permissions Manage Pay Scale
The corresponding MDF object for the job is not secured by
default. You can manually change this in the Configure Object
Defintion page.
Pay Scale - Manage Pay Scale Objects This permission controls access to Admin Center Manage
Admin Permissions Manage Pay Scale Pay Scale Objects for these objects:
User Permissions Employee Data HR Information Pay • View: Visibility of the entire pay targets section (including
the header)
Targets
• Edit: Editability of the entire pay targets section
• On view of UIs
This is not validated again on save, as the relevant permis-
sion for changing the employee data is the permission for
the recurring pay components.
User Permissions Employee Data Transactions Pending • View: Visibility of pending request line in the block
Approval
• Edit: Selectable link as pending request line in the block
• On view of UIs
User Permissions Employee Data View Workflow • View: Visibility of workflow history from History
Approval History
• Edit: Not used
• On view of UIs
Allow Retroactive Employee Data Changes This permission is used to prevent users from making retro-
active changes to employee data, for example, because such
Administrator Permissions Manage User Allow changes will cause issues in payroll.
Retroactive Employee Data Changes
All changes to employee data are validated against the earli-
est retroactive change date in the pay group assigned to the
employee in compensation information. If the data change is
before that date, the system raises an error message UNLESS
the user has this permission, in which case a warning message
is raised and the user is allowed to make the change.
Foundation Object Types These permissions control the visibility (and editability) of ob-
jects in Manage Organization, Pay, and Job Structures.
Administrator Permissions Manage Foundation Object
• View: The admin can only view the corresponding founda-
Types
tion object type.
• Create: The admin can create a foundation object of the
selected type.
• Insert: The admin can create a new data record for a foun-
dation object type, by selecting Insert New Record.
• Correct: The admin can correct foundation objects by se-
4.7 Currency
Setting up currency in your system means that you need to decide whether you use your pay components locally or
globally.
For both local or global, you can have multiple currencies for one pay component. In that case, define the criteria
required for the currency, for example, geo zone, legal entity, and so on.
You can associate the currency with this object or to automate the currency with a business rule. In case you only
have one currency for a pay component, you can enter this directly into the object and default it using business
rule. If you have one or multiple leading currencies in your organization, you can show your salary in multiple
currencies. However, for that you need custom fields and exchange rates.
Note
The following currency codes do not conform to the ISO 4217 norm and cannot be used in the system:
• RMB
RMB is sometimes used to denote Renminbi instead of the ISO code CNY. However, the system requires
that you use CNY.
• UYP
UYP was replaced in 1993 by the code UYU. Therefore, please use UYU.
Set up the currency exchange rate to show pay component group values as well as to be able to calculate Compa
Ratio/Range Penetration.
Context
Procedure
Metadata Framework Import Permission on Metadata Allows users to import the MDF object into the system.
Framework
MDF Foundation Objects Currency Exchange Rate Allows users to see and use the Currency Exchange Rate
MDF object.
If you are a new customer, check whether there is already an existing picklist with ID =
"CurrencyExchangeRateType" and a picklist value = "DEFAULT". If it is not available, create the picklist and
the default value.
Caution
Only exchange rates with the default exchange rate type, DEFAULT, are used in Employee Central
currency conversion.
For mass updates of currency exchange rates, you can use the standard import and export UI. For more
information, refer to Importing MDF Data topic in the Implementing the Metadata Framework (MDF) guide.
d. Save any changes.
For customers operating in multiple countries that have several legal entities in one country or customers that have
a high number of country/region-specific pay components, country/region-specific picklists for pay components
filter the relevant values for admins and managers on all screens with a pay component field.
Prerequisites
• You use the generic object Country. For the prerequisites of using generic objects, refer to Generic Objects
Overview.
• You have downloaded the Country list.
Note
All configuration files for Employee Central, for example, master data models, master picklists, as well as
country/region-specific files, have moved from the SAP Help Portal to the Software Download Center .
Context
Customers that operate in multiple countries tend to have pay components that are very specific for a country. For
example, the customer pays their German employees based on the pay agreements with the German Trade Unions.
This pay component would never be used for an employee based in the USA. However, the admin has to scroll
through the picklist containing all the pay components existing in the system for all countries when adding a new
employee, for example.
As the employee is always clearly assigned to one legal entity, and thus to one specific country, you can set
up country/region-specific picklists for pay components filtering the values to those that are relevant for that
employee.
Once the country/region-specific picklists for pay components are set up, administrators and managers can use
them on all screens that have a pay component field [Employment/Personal Information page; Update Employee
Records page; History pages (for example, Job History); Add New Employee page, and so on].
• Large customers operating in multiple countries that have several legal entities in one country
• Customers that have a high number of country/region-specific event reasons or pay components
1. You create an association from the Country generic object to the foundation object pay component.
a. Create a wrapper generic object for a pay component:
1. From the Configure Object Definitions page, choose Object Definition Country .
2. Select Take Action Make Correction .
3. Under Associations, in the Destination Object field, select the wrapper generic object that you have
created in step 1.
Results
• Check Tool System Health Tab Employee Central Core Compensation Area
• Check Tool System Health Tab Employee Central Core Invalid Effective End Date for FO/GOArea
• Check Tool System Health Tab Employee Central Core Object Relationship Area
• Check Tool System Health Tab Employee Central Core Picklist Area
• Check Tool System Health Tab Employee Central Core Associations Area
Next Steps
Prerequisites
For the Salary vs. Team Widget, there are a few more requirements:
• All exchange rates for every currency used by all employees must be available for the display date, otherwise
the currency for the employee is not converted.
• All employees in the team must use the same pay component group.
• The pay component group must have the Use for Range Penetration Yes setting. Without this setting, the
employee is not shown in the widget.
Context
Once the permissions are granted, the widgets are displayed automatically in the Compensation Information block.
These graphs can be viewed from the Employment Information page, the MSS page when changing Compensation
Information, and the History page.
Total Compensation History This widget shows the wage progression for an employee.
Salary Positioning This widget shows the employee's salary in relation to the pay
range.
If the pay range is changed, the new pay range is only shown
once the record is saved.
Salary vs. Team The 'Salary vs. Team' widget displays a comparison of the em-
ployee's salary with those of their immediate colleagues, for
example, annualized salaries. It is intended as information for
the manager, who usually has permission to view the salaries
of the team, and not for the individual employees, who usually
only have permission to view their own salary. This means that
individual employees can never access this widget to see how
they compare to their peers. Managers can only see the com-
parison of their direct reports and not see how they themselves
compare to their peers.
The Salary vs. Team widget is not shown at all if the the man-
ager has more than 30 direct reports.
With the People Profile, you can set up the system to automatically refresh Compensation Information when there
are changes to Job Information fields from a Manager Self-Service or Employee Self-Service. However, if the Job
Information field is changed using the History, there is no refresh of compensation data.
Context
The compa ratio and range penetration will also reflect the latest values. The field refresh ensures that annualized
salaries are recalculated when standard hours are updated.
Procedure
Note
Results
When a field that has the refresh option is updated and only Job Information is selected in the Take Action
Change Job and Compensation Info menu, then Compensation Information is automatically selected. This results
in the creation of a new Compensation Information record.
Next Steps
To make changes to Job Information based on Compensation Information event changes, you can create onChange
business rules to propagate the event reason to Job Information. Ensure that you use Compensation Information
as the base object.
Once you have added <unit-of-measure> to the data model, create objects in Manage Data for your required
units of measure.
Once the fields <unit-of-measure>, <rate> and <number> have been defined in the Corporate Data Model,
the Pay Component Type field will display Number as an option. Selecting Number displays additional fields for
Number, Unit of Measure, and Rate on the UI.
Add picklist values for the units of measure field that you added in the data model.
Procedure
For pay components of type Number, when you select the units of measure field, the values you create here are
visible in the dropdown list.
Related Information
Unit of Measure
The system default is set to 3 decimal places for pay component groups. However, this can be changed as needed.
Prerequisites
You have the User Permissions Employee Data Pay Component Groups permission.
You have the User Permissions Employee Central Effective-Dated Entities Compensation Information
permission.
You have the Administrator Permissons Manage Foundation Object Types Foundation Object Types - Pay
Component Group permission.
Context
Depending on the number of decimal places defined, the numbers displayed in the system get rounded up or down.
This property is only for HRIS fields with the data type DOUBLE, and can have up to 5 decimal places.
The system determines the decimal places used in order of the following:
• If the decimal places are defined for the pay component group, the system uses the definition.
• If noting is specified, then the system uses the default of 3 decimal places for the calculation.
Procedure
1. Navigate to the Manage Organization, Pay and Job Structures page. Select the required pay component group,
for example, Annualized Salary.
Results
Once configured, the decimal places are updated throughout the UI:
The system default is set to 3 decimal places for pay components. However, this can be changed as needed.
Context
The decimal places of sums and calculations are based on the <maximumFractionDigits> the field attribute
<maximumFractionDigits> in the Succession Data Model and the pay component FO definition as explained below.
Depending on the number of decimal places defined, the numbers displayed in the system get rounded up or down.
This property is only for HRIS fields with the data type DOUBLE, and can have up to 5 decimal places.
If you define a value higher than 5, the system uses the maximum value, which is 5. If you define a negative value,
for example, -1, the default value of 3 decimal places is used.
The system determines the decimal places used in order of the following:
• If the decimal places are defined for the pay component, the system uses the definition.
• If the decimal places are defined in the data model, but not in the pay component, then the system uses the
definition from the data model.
• If nothing is specified at all, then the system uses the default of 3 decimal places for the calculation.
Procedure
1. In the Succession Data Model, set the <maximumFractionDigits> attribute of the pay component value field
to visible and editable. Then set the number of decimal places between 0 and 5.
Results
Once configured, the decimal places are updated throughout the UI:
This section describes how you can set up Number or Percentage as a Pay Component Type.
If the employee is assigned to a pay scale level that contains this pay component, the rate and currency are
read from the pay scale level. If not, the rate and currency are read from the pay component definition. The rate
obtained is converted from the currency from pay scale level/pay component to the currency of the employee pay
component.
The annual amount of the corresponding base pay component is calculated. The percentage (field amount) of
the percentage pay component is used to find the annual amount of the percentage-based pay component. The
calculated amount is reduced from the annual amount using the frequency of the employee pay component.
If a pay component is with type Percentage and is a non-recurring pay component, the base pay component must
only be a recurring pay component or a pay component group. Calculation for the field calculated amount in a
percentage-type pay component will not take place if base pay component is created with a non-recurring pay
component.
Note
When executing rules for pay components of type percentage, the calculated amount is not always available at
the time of the execution of the rule. Therefore a pay component group should be used as a proxy.
Example
Base pay component = ( 40105 EUR /Month ) * ( 12 Months /Year) = 481260 EUR /Year
Percent pay component = 12.5% * 481260 EUR /Year = 60157.50 EUR / Year
Tip
In cases where the calculated amount field for the percentage pay component is not calculated, check the
following configuration:
• Is the affected pay component (for example, PERC) of pay component type = percentage?
• Is the affected pay component linked against the relevant base pay component group (for example,
AnnualizedSalary)?
• Is the affected base pay component (for example, Base Salary) associated to the relevant pay component
group (for example, AnnualizedSalary)?
• Make sure that the relevant pay component, pay component groups, and relationship have one and only
one record with an end date of 31-Dec-9999 using the two check tool checks found in Admin Center
Check Tool System Health Tab Employee Central Core Invalid Effective End Date check for FO/GO
Area . If one of the relevant objects does not have a record with an end date of 31-Dec-9999 or if it has
multiple such records, please create a support ticket and provide the object type & external codes (or
provide the export of the results of the checks).
• Make sure that all exchange rates for every currency used by employees are available for the pay
component, otherwise the calculated amount is set to 0.
If the configuration set up is correct, then you have to check that the relationship between the base pay
component and the pay component group exists. Ensure that you have the relevant permission by checking the
Manage System Properties Data Inspector setting. Go to Admin Center Data Inspector and check
the following:
The calculated amount is converted from the employee pay component frequency to annual for the pay
component group.
The annual amount of the corresponding base pay component is calculated. The percentage (field amount) of the
percentage pay component is used to find the annual amount of the percentage-based pay component.
Example
Base pay component = ( 40105 EUR /Month ) * ( 12 Months /Year) = 481260 EUR /Year
Percent pay component = 12.5% * 481260 EUR /Year = 60157.50 EUR / Year
Context
When configuring pay components, you must specify the following 2 values in order for the system to determine
which pay component is available in which section or block:
• Recurring
• Target
These options can be set in different combinations, which allows the system to determine which block the pay
component is available in, for example, Compensation, Pay Targets, or Spot Bonus.
Optionally, you can create pay components in the system by importing the data. For more information, refer to
Related Information section.
Field Description
Frequency Select how often the pay component should be paid, for
example, biweekly or annually.
Self Service Description You can optionally add a description for the pay component
to show on the profile, if you select Yes for the Display on Self
Service field.
If you select Yes and assign the permissions, the pay com-
ponent is then visible in the Manager Self-Service and Em-
ployee Self-Service UIs.
Used for Comp Planning If you have integrated Employee Central with the SAP Suc-
cessFactors Compensation module, you can select one of
the options.
Maximum Decimal Places The system default is set to 3 decimal places, but you can
choose between 0 and 5 decimal places.
If you select yes, you can add a specific expiration date for
the pay component.
Results
The pay component appears in the list and are ordered based on creation date.
You can use the Check Tool to find any inconsistencies in your pay components. Any fix would result in the update
to your pay component data in Employee Central. We recommend selecting checks available under the following
sections:
• Check Tool System Health Tab Employee Central Core Compensation Area
• Check Tool System Health Tab Employee Central Core Invalid Effective End Date for FO/GO Area
• Check Tool System Health Tab Employee Central Core Object Relationship Area
Next Steps
Once the pay component is created, assign permissions for who can see and edit it.
Assign it to an employee. Some common ways to assign pay components to the employees:
• UI (hire/rehire wizard, Take Action menu in the employee profile, Compensation Information History)
• Imports
• Integration (Benefits, Compensation Planning, APIs)
Related Information
Control who can see pay components in self-service pages (Manager Self-Service pages and Employee Self-Service
pages).
Context
Showing pay components on the UI is a two-step process. You start by defining the pay component and then
granting permissions to access the pay component. Note that the recurring and non-recurring settings applied
here are only honored by the Manager Self-Service pages and not in the change history.
1. Define the Pay Component using the Manage Organization, Pay and Job Structures page. Make sure that you set
the Display on Self Service to Yes.
Manager Self-Service
Employee Self-Service
This example shows the page seen by an admin for non-recurring pay components. The Type drop-down shows
both recurring and non-recurring pay components.
If your company operates in multiple countries, you may need to set up and manage country/region-specific pay
components. These pay components can then be assigned only to the employees of the specific country/region.
The assignment of pay components to countries/regions assists end users by removing irrelevant pay components
from the value lists. It does not prevent assigning these pay components to employees when no screen is used.
Prerequisites
• You use the object Country and have imported content for the Country/Region object.
• You have created the Pay Component foundation object in your system.
• The pay component wrapper (Pay Component Wrapper - (FOWPayComponent)) exists in your system.
For example, the customer pays their German employees based on the pay agreements with the German Trade
Unions. These pay components would never be used for an employee based in the USA.
As the employee is always clearly assigned to one legal entity, and thus to one specific country/region, you can
set up country/region-specific pay components filtering the values to those that are relevant for that employee.
Only those pay components that are assigned to the country/region corresponding to the employee’s legal entity
assignment are available in the value list.
Once the country/region-specific pay components are set up, administrators and managers can use them on
all screens with a pay component field [Update JobInfo/Compensation Employee Records; History pages (for
example, Job History); Add New Employee page, and so on].
• Large customers operating in multiple countries that have several legal entities in one country/region
• Customers that have a high number of country/region-specific pay components
Procedure
1. Create an association from the Country/Region object to the foundation object pay component.
a. Associate the Country/Region object with the wrapper generic object:
1. From the Configure Object Definitions page, choose Object Definition Country/Region .
2. Select Take Action Make Correction .
3. Under Associations, in the Destination Object field, select the wrapper pay component generic object.
Note that the prefix cust_ is automatically added to the association name, which is used to assign
wrapper to the Country object (for example, cust_CountryToPayComponentWrapper).
Make sure that the Type field is set Composite and Multiplicity is set to One To Many.
4. Save your changes.
2. For each country/region, assign the pay component relevant for that country/region.
Pay components that should be visible for all countries must be added to every country that is used in a legal
entity.
Existing employee pay components are not affected (these are displayed in all screens and can still be edited or
deleted).
No validation of the country assignment is performed when employee pay components are imported or
changed using an API.
You can set the decimal places needed for each country according your object definitions. Go to Manage Data
Currency and set the values required for each country.
Create a pay component group. A group is used to calculate and display annualized sums of recurring pay
components.
Context
A pay component group sum is the total amount (sum) of the recurring pay components that are part of a specific
pay component group. Pay component group sums are listed with other fields from Compensation Information.
You can use pay component group sums in rules, for example, to perform calculations. To use pay component
group sums in business rules, you have to make sure the corresponding pay component groups are displayed on
the Configure Business Rules page.
Note
The external code of the pay component group can contain alphanumerics, underscore, minus, @, %, and
space. However, other characters such as back and forward slashes (/ and \) are not allowed.
Procedure
Field Description
Pay Component Group ID You must give the group a unique ID.
Name You can name the group, so that's easier to search for.The
pay component group sum shows up on the Compensation
Information block and can also be used in rules.
Note
You need to do this when using any rule scenario ex-
cept the Event Reason Derivation scenario. Event Rea-
son Derivation rule scenarios allow all pay component
groups.
Use for Comparatio Calculation Select Yes to use the group to calculate compa ratio and
range penetration.
Use for Range Penetration Select Yes to use the group to calculate compa ratio and
range penetration.
Sort Order The sort order influences the order in which the groups are
shown in the UIs.
5. Add the pay components that you want to be included in the group.
6. Save your changes.
Business Rules
The pay component group sum shows up on the Compensation Information block and can also be used in rules.
In the Compensation Information block, you can select the blue question mark icon next to the Compa Ratio and
Range Penetration fields to show the following information:
• The values from Job Information being used to identify the pay range used in the calculation
• The pay range derived by the UI based on the values from Job Information
• The calculation that is used to calculate the value
• The result of the calculation
• Check Tool System Health Tab Employee Central Core Compensation Area
• Check Tool System Health Tab Employee Central Core Invalid Effective End Date for FO/GO Area
• Check Tool System Health Tab Employee Central Core Object Relationship Area
Related Information
Optional: Pay Component Groups and Pay Component Group Calculation [page 10]
Setting Up the Currency Exchange Rate [page 52]
Calculation of Annualized Values [page 12]
Event Reasons
Rule Scenarios for Employee Central Core
The system doesn't allow changes to assigned pay components to prevent the data inconsistencies.
From the Admin Center, you can navigate to Check Tool System Health Tab Employee Central Core
Compensation Area to get a list of where pay components are used as well as all possible dependencies for
the pay component. Note that the where-used list may list more dependencies than you need to delete. This check
is only applied when you attempt to make a change in the UI. These checks are not applied during import.
Once the pay components are in use, you are not allowed to change the following attributes:
The system validates these fields and displays an error message if attempts are made to them.
You can change the Can Override flag from No to Yes, but not the other way around. If the Can Override flag is set to
No, you are also not allowed to change any of the following attributes: Currency or Frequency.
For pay components of type Amount and Percentage, you cannot change the Pay Component Value attribute.
For pay components of type Number, you cannot change the Number attribute.
Once used, none of the pay components can be deleted or set to inactive. If a pay component is no longer used
after a specific date, it is possible to create a new record in which the pay component is inactive after that date.
Base Pay Compo- Change Allowed Change Prevented Change Prevented Change Prevented Change Prevented
Pay Component Change Allowed Change Prevented Change Prevented Change Prevented Change Prevented
Type
Recurring Change Allowed Change Prevented Change Prevented Change Prevented Change Prevented
Is Target Change Allowed Change Prevented Change Prevented Change Prevented Change Prevented
Is Earning Change Allowed Change Prevented Change Prevented Change Prevented Change Prevented
Tax Treatment Change Allowed Change Prevented Change Prevented Change Allowed Change Allowed
Can Override Change Allowed Change Prevented Change Allowed Change Allowed Change Allowed
Currency Change Allowed Change Allowed Change Prevented Change Allowed Change Allowed
Frequency Change Allowed Change Allowed Change Prevented Change Allowed Change Allowed
Pay Component Change Allowed Change Allowed Change Prevented Change Allowed Change Allowed
Value
Name Change Allowed Change Allowed Change Allowed Change Allowed Change Allowed
Display on Self- Change Allowed Change Allowed Change Allowed Change Allowed Change Allowed
Service
Permanently Delete Deletion Allowed Deletion Prevented Deletion Prevented Deletion Prevented Deletion Prevented
Record
Note
If the change of the field is allowed only for the whole validity period of the pay component, for example, for the
Recurring field, you have to delete all assignments of pay component to execute the change. Don't select the
time period in the selection pop-up of the check tool to get the list of all assignments.
Related Information
Control which pay components appear in the Compensation and Deduction blocks on the Employee Profile.
Context
These settings affect only the drop-down lists in the Employee Profile. Once a pay component exists in the system,
it is displayed in the Manage Organization, Pay and Job Structures screen independent of the settings.
Procedure
Recurring determines whether a pay component is visible in the recurring pay components (comp info) or the
nonrecurring section (Spot Bonus). If a pay component has the setting where Recurring is No, it is not visible in
the drop-down for the Compensation Information block.
Target determines whether a pay component is visible under the Compensation section of the Compensation
Information block or under the Pay Targets section. When Target is set to Yes, the pay component appears in
the drop-down in the Pay Targets section. When Target is set to No, the pay component appears in drop-down
list in the Compensation section.
All pay components are visible for Employment Information Spot Bonus Edit
You may want to use recurring pay components that are limited in time, meaning you know the expiration date of
those payments. This end date can now be entered in the system when the recurring payment is created - in one
step.
This can be enabled using a new field in the Pay Component foundation object and is valid for recurring payments
and pay targets. Once enabled, a button appears in the Compensation Information in MSS and in the New Hire
screen to allow you to set an end date. You can also select additional pay components and set multiple end dates.
You can enter any end dates that are after the start date of this record.
Note
If you set an end date for recurring payments or pay targets that don't have the same time periods as
the Compensation Information, then the existing Compensation Information record is split into two records.
The forward propagation of changes made to Compensation Information fields or to other recurring pay
components is not affected by the end date.
You cannot change the end date once it is saved in the system.
The end date option is updated only when the amount is given.
Prerequisites
People Profile and Compensation Information must be enabled in your Employee Central system.
If new records are created in Compensation Information when an end-dated payment is saved, the new records
generally use the same event reason as the existing record on the same date. When this record has a Hire or Rehire
event reason, the new event reason is taken from the Hire/Rehire Configuration.
Note
The system uses the last event reason stored rather than actual event reason derived by the end-dated recurring
pay component.
• Hire record
• One or more Compensation Information records starting in the past (with the Data Change event reason)
• One or more Compensation Information records starting in the future (with the Future Data Change event
reason)
An end-dated payment is added with the start date 01 Jan 2020, and end date 31 Dec 2020 (with the event reason
Add End-Dated Payment).
The system must create a Compensation Information record starting on 01 Jan 2021. However, this record is
created for technical reasons, rather than anyone actively changing the data for this date. Therefore the event
reason derivation is not used. The event reason that was valid on 01 Jan 2021, before the end-dated payment was
inserted, is used for the new record. The result is listed with the Data Change event reason.
• Hire record
• One or more compensation information records starting in the future (with the Future Data Change event
reason)
If an end-dated payment starting on 01 Jan 2020 and ending on 31 Dec. 2020 is inserted, the standard system
logic would mean that the record starting 01 Jan 2021 would get the event New Hire, is not correct, since the Hire
event did not happen on 01 Jan 2021. In this case, the system inserts the record starting on 01 Jan 2021 with the
event reason defined in the Hire/Rehire Configuration object in Manage Data (with the End-Dated Payment event
reason).
Workflows
If you have a workflow in place for changes in Compensation Information, then it is triggered. The end date is visible
in the workflow approval popup. It will show in a separate column in line with the pay components. If you try to edit
a workflow, you will jump to the normal MSS page.
Add an end date when you create a recurring payment to delimit a pay component in your system.
Context
• Which event reason should be used if a new Compensation Informtion record must be created and the existing
event reason is assigned to the hire or rehire event
• Which pay components can be used for end-dated payments
Procedure
This configuration tells the system which event reason to be used in case the system can't use the event
reason of the manual changes record, for example, in a Hire or Rehire scenario.
d. Save your changes.
2. Check the Enable End-Dated Payments field.
The field should be editable. If not, you will need to add this field to the payComponent element in the
Corporate Data Model.
Sample Code
3. Specify the pay components that can be used for end-dated payments
In the Compensation Information block, in the Recurring Payment section, when you now select a pay component
that is enabled for end date, you will see a blue link on top of this sub section. You can select it and provide the end
date. When you save your changes, you will have the changes based on the provided end date in your system.
You can use the Check Tool to find any inconsistencies in your pay components. Any fix would result in the update
to your pay component data in Employee Central. We recommend selecting checks available under the following
sections:
• Check Tool System Health Tab Employee Central Core Compensation Area
• Check Tool System Health Tab Employee Central Core Invalid Effective End Date for FO/GO Area
• Check Tool System Health Tab Employee Central Core Object Relationship Area
Related Information
Working with Corporate Data Model and Country/Region-Specific Corporate Data Model in Admin Center
Here is a little more information about some of the features and functions in Employee Central blocks.
General
The data shown in the Compensation Information block is aggregated from several objects, such as Pay Group, Pay
Range, Pay Component, and Pay Component Group.
Only pay components with the field <Recurring> that are set to Yes for are available in the block, and those with
the field <Target> set to Yes will show in the Pay Targets section of the block.
If you do not want users to have access to Pay Targets information, you can update the permissions in User
Permissions Employee Data HR Information .
To correctly trigger workflows, create an onSave rule with Compensation Information as the base object. Do not
use Pay Component Recurring as the base object.
In the Compensation Information block, you can see an icon for the compa ratio and range penetration fields.
If you select the icon, a pop-up opens that contains an explanation of how the values are calculated including which
pay range is used and why this pay range is selected as well as the calculation of the percentage of both compa
ratio and range penetration.
This is currently only available in the Employment Information page and the Compensation Information
Manager Self-Service page.
You can add how long a pay component will be valid for, which allows admins to see whether the pay components
have an end date.
The system compares a pay component record with all future records for the same pay component. The pay
component is valid until there is either a gap in the pay component records or ANY field is changed in the pay
component data (including custom fields).
Note
If you enable this opt-in feature, it takes longer for the blocks where this field is displayed to load. This is
because the <valid until this date> field is calculated by the system when the block is loaded and is not
stored on the database.
You can add the field in the data model in Manage Business Configuration. Ensure that the visibility setting for
the <no-changes-until-date> field is set to Yes.
• Recurring Pay Component block of the employee profile for View and Edit
• History on the View and Edit page of each affected record as well as the Change History (in the left overview)
The effective date determines which Job Information record is selected to derive the pay range.
Imports
Please refer to the Compensation Information Imports topic in the Employee Central Imports guide.
The notes fields is always cleared when a new Compensation Information record is created. Unlike most other
fields, this value is never copied over into new records, since it generally refers to one particular record.
Managers can generate insights into an employee's compensation using generative AI capabilities as well as talking
points to guide discussions.
Prerequisites
You've purchased the SAP AI Units license. For more information about SAP AI Units license, please contact your
Account Executive.
Once enabled, the Generate Compensation Insights icon appears in the Compensation Information block.
Context
To prepare for compensation talks with their direct reports, a manager needs relevant data, for example, from past
compensation data, organizational pay bands / defined ranges, and market data.
These insights can identify any general discrepancies or anomalies or patterns in an employee's compensation
and employment history as well as identify any specific discrepancies such as pay equity or equality gaps
based on gender or age or other criteria. Managers get insights into expiring long-term incentives, hiring trends,
and company policies, which may not be obvious as decision-making factors. The insights can help managers
understand how their employees' work aligns to the expectations of the pay bands or corporate goals, which can
then help them to make better decisions for their promotion/progression. Managers spend less time on manual
data compilation and more time making informed decisions.
Procedure
1. Navigate to the Compensation Information for the employee for whom you want generate insights.
2. Select Generate Insights.
The system generates insights based on, for example, past compensation data, organizational pay bands /
defined ranges, and job progression.
Related Information
All data validations are consistent in Imports, History UI, and MSS.
• When editing the history, audit fields are set for the recurring pay component only when a change is made to
that specific pay component (including rules and calculations).
• To ensure that the new effective start date cannot be after the end date.
• To ensure that moving the start date as well as adding or deleting records can't be done together in one step.
The start date must be moved first and then the grid records can be changed afterwards.
Workflow Handling
With Centralized services, workflows are not supported on the History UI.
Related Information
On the History UI and Editing UI of Compensation Information and recurring pay components, if you update or
delete a record, it doesn't affect the "last modified date" and "last modified by" information of other records in the
block.
Compensation Information and recurring pay components have a parent-child relationship. Scenarios related to
the suppression are as follows:
• When you edit the parent entity, only the data of the parent entity is updated.
There is no change to the "last modified date" and "last modified by" information for the records of its child
entity.
• When you edit a record of child entity, the "last modified date" and "last modified by" information of this
record and its parent entity is updated.
There is no change to the "last modified date" and "last modified by" information for any other records of child
entity.
• When you delete a record of child entity, only the "last modified date" and "last modified by" information
of its parent entity is updated.
There is no change to the "last modified date" and "last modified by" information for any other records of child
entity.
Related Information
Non-recurring pay components are basically like the recurring ones, except that they don’t recur.
This means, that there is no frequency, no end dates, just one-time payments. They can be of type amount,
percentage, or number, assuming the data models are set up to include the fields needed (unit-of-measure and
number-of-units).
It is possible to give an employee several non-recurring pay components of the same pay component on a single
day (for example, three spot bonus or whatever on one payment day). However, if you want to change these
records using import or an OData API, then the field sequence-number must be available for import (meaning, it
must be in the data model).
Rounding of Values
For the value and calculated amount fields in non-recurring pay components, the system rounds the values as
follows:
• If the Maximum Fraction Digits are not specified anywhere, the default number of decimal places is 3.
• The Maximum Fraction Digits can be specified for the fields in Manage Business Configuration if the default
value doesn't meet customer requirements.
In this case, both the value and calculated amount fields are rounded using the value specified for the
respective value or calculated amount field. Please ensure that the number of digits specified for the calculated
amount is identical to that of the value field, as some UIs shorten the calculated amount according to the field
definition, which may confuse users.
• If the Maximum Fraction Digits are specified for the pay component in Manage Organisation, Pay, and Job
Structures, then that value is used to round all the fields listed above for the pay component.
The rounding is half-even; that is, if you enter 51.645 and you have two decimal places defined, you get 51.64.
Here is a little more information about some of the features and functions in Employee Central blocks.
General
All pay components are available for selection in Employment Information Spot Bonus Edit regardless of
target or recurring settings. This facilitates recording an actual payment for a target bonus pay component, which
may be different from the achievable target. The pay components can be added by selecting the Pencil icon and
selecting the desired pay component. You can then add, update, or delete spot bonuses.
When you edit the pay components, only the spot bonus payments viewed on the profile are shown. This means
that if the profile shows 2017, only the non-recurring pay components for 2017 can be edited on the popup.
Note
For customers using the Compensation module, the Take Action menu now includes Spot Bonus as well as
Reward and Recognition.
Determine which pay range an employee is associated with and how the system calculates Compa Ratio and Range
Penetration values.
Prerequisites
• Configure the Pay Range foundation object in the Corporate Data Model
• Create associations between Legal Entity and Pay Grade from the Pay Range
Note
If the pay range should depend on the country/region of the legal entity, it is not sufficient to add the
association to the Corporate Data Model.
Sample Code
The reason for this is that there is no standard field of type Country/Region in the Job Information object,
since the field country-of-company is a picklist of type ISOCountryList, and picklists cannot be used in the
pay range determination.
In order to use the country/region as an association for the pay range, it is necessary to:
1. Add a custom field of type country/region (this means that it needs the tag type Country/Region) to
the jobInfo object in the data model.
2. Fill this field using a business rule based on the country/region defined in the legal entity.
Note
This is so that when the system calculates the Compa Ratio and Range Penetration values, it will look up what,
for example, Legal Entity and Pay Grade values the employee has set in their current Job Information record.
Context
The system looks for a pay range that matches all of the configured objects associated with it. If one exact match
is found, that is used. If several matches are found, the first one found is used. If nothing is found, the last selection
criteria (the last association for payRange) is removed from the search, and the search repeated, and so on.
Procedure
Results
• Check Tool System Health Tab Employee Central Core Invalid Effective End Date for FO/GO Area
• Check Tool System Health Tab Employee Central Core Object Relationship Area
• Check Tool Validation Tab Compensation Template Configuration Area
Example
Using the Annual Salary Pay Component Group, we can look at the calculations used for Compa Ratio and Range
Penetration for a regular full-time employee (FTE = 1)
Range Penetration: (AnnualizedSalary – (Pay Range Minimum Pay * FTE))/((Pay Range Maximum Pay - Pay Range
Minimum Pay) * FTE) * 100 = X%
Using the Annual Salary Pay Component Group, we can look at the calculations used for Compa Ratio and Range
Penetration for a regular part-time employee (FTE = 0.5). If the employee has FTE < 1 set in Job Information (for
example FTE = 0.5), the Compa Ratio and Range Penetration calculations take this information into account.
For example, an employee in the same Pay Range with an FTE of 0.5 and an annualized salary of 215,000 has
the same Compa Ratio and Range Penetration as the full-time employee (FTE = 1) with an Annualized salary of
430,000.
Range Penetration: AnnualizedSalary – (Pay Range Minimum Pay * FTE))/((Pay Range Maximum Pay - Pay Range
Minimum Pay) * FTE) * 100 = X%
Usually the reason why the Compa Ratio and Range Penetration values are not correct is due to the Pay Range
not being correctly identified due to missing criteria in the employee’s Job Information data or because a Pay
Range does not exist with the associated combination of Foundation Objects to match against the employees Job
Information data.
• Check that the employee has data in their current Job Information record to satisfy the Pay Range associations
defined in the Corporate Data Model
• Check that the Pay Range exists and has matching values to satisfy the Pay Range associated data defined in
the employees Job Information data
Note
• If you have geoZone configured as one of the associations, only the geozone of the selected "Location" is used
(any custom-string fields configured as type="geoZone" will be ignored).
Note
This configuration requires you to set up an association on Location (ONE_TO_ONE) with the geoZone
Foundation Object. When checking the Locations Geo Zone, the system will look only for the association
and again, not a custom-string field with type="geoZone"
• Job Family association = You need to have configured a custom-string in the jobInfo element, with
type="jobFunction" for this to be considered.
Set up Job Information to display the current pay range that the system is using for the calculations.
Context
In the Compensation Information block, you are now able to see an icon for the compa ratio and range penetration
fields. If you select the icon, a pop-up opens that contains an explanation of how the values are calculated including
which pay range is used and why this pay range is selected as well as the calculation of the percentage of both
compa ratio and range penetration.
Note
Calculated fields in the People Profile and in the history differ in the date used for calculating the fields.
When you view Compensation Information History, the calculated fields (for example, compa ratio) are based
on:
To be able to display the pay range that the system is currently using for the Compa Ratio and Range Penetration
calculations for an employee, you will need to create a new custom field as well as a business rule.
Procedure
Note
• Visibility: View
This means that users will only be able to view the field without being able to add data to it.
g. Once completed, select Finished and save your changes.
2. Now you have to create the business rule.
If condition: Since you want to see the field every time the block loads, hover over the If line and select the
Always True checkbox.
Then condition: choose Edit, then select Set as the Output Type and then select the custom-string field
you created from the list of available Job Info fields (in this case, it is labeled Pay Range). Leave the "to be
equal to" part as it is. For the last field, select the Pay Range from Job Information() rule function. In the
Job Information field, select Job Information.
Note
Since this field is set using an onView rule, we recommend that you add an onSave rule that sets the value
to null in order to clear the value. The field should behave as a transient field so that it isn't saved to the
database. If you do not create the onSave rule, the value would be saved to the database and the saved
value would not be automatically updated if the pay ranges are changed.
Next Steps
You can check an employee's Job Information data, and see the Pay Range that the system is using to calculate
Compa Ratio and Range Penetration. If the Pay Range displayed is incorrect, it likely means that a Pay Range
matching the employees data set does not exist in the system, and the closest match was selected.
Export all of the pay ranges from the system to check whether a pay range with a specific combination of
associated values actually exists in the system.
Context
When trying to determine whether a pay range exists for a particular combination of values, it is difficult to
determine this quickly on the UI. This is because you have to search by the pay range value rather than the
associated data that is used by the system to determine which pay range is used in Compensation Information
calculations.
The approach here is to run a Foundation Objects Ad Hoc Report on pay range, and export all pay ranges from the
system. You can then filter specific value combinations to see whether they exist, and if not, create them.
1. Go to Analytics.
2. Select Reporting Ad Hoc Reports and then select Create New Report.
3. From the drop-down menu, select Foundation Objects.
4. Click Create.
5. In the General Info section, enter a name and a description for the report.
In the pop-up, in the far left panel, select Pay Range. In the middle panel, select Select All.
You can define your pay scale structure centrally and assign employees to it.
Non-exempt employees can then be assigned to the defined pay scale structure by entering pay scale area, pay
scale type, pay scale group, and pay scale level in the Job Information block.
For each pay scale level you can assign one or more pay components. Once an employee is assigned to the
pay scale structure, pay components assigned to the pay scale level can be transferred to the compensation
information of the employee using rules. This is called indirect/automatic valuation.
Note
It is not required for you to use pay scale group and pay scale level. If you already run Employee Central Payroll
based on pay scale area and type, you can stick to this configuration. You will only need pay scale group and
level if you want to be able to assign an employee to the whole pay scale structure for indirect valuation. Pay
scale group and pay scale level are not part of standard employee master data replication. You can include
these fields in standard replication by using custom fields.
Once the pay scale structure is set up in your system, you can see everything in the Job Information block in the
profile.
Note
The Pay Scale Type and Pay Scale Area fields have been configured using the picklists pay-scale-type and pay-scale-
area; ensure that the code and legacy picklist ID of your picklist is pay-scale-type and pay-scale-area.
make sure
In the example below, the field Pay Scale Area uses the picklist pay-scale-area. Likewise, the field Pay Scale Type
uses the picklist pay-scale-type.
If you remove the picklists from their respective fields in Job Information in the Succession Data Model and the
Country/Region-Specific Succession Data Model, the fields will refer to the respective objects in MDF.
However, if you create a Job Information record as before by using the old picklist configuration and change the
data model to use GO for these fields, the Job Information will display only the option ID since it is no longer a
picklist.
Note
Make sure that the field <country-of-company> is included in the pay scale area picklist and pay scale type
picklist. Make sure that this field comes before the pay scale area and pay scale type fields. You can check the
field order in the Business Configuration UI.
If this field is missing, add the field to the jobInfo HRIS element, change the order of the field, and update the
details for the picklist info.
If MDF objects already exist in the system, the system will now update the internal ID of the existing GOs Pay Scale
Area and Pay Scale Type with the option ID from the picklist. This ensures that the reference in the job Info still
work without any disturbance. If Pay Scale Area and Pay Scale Type are referenced in a Pay Scale Group, the key is
replaced with the internal ID of the reference pay scale area or pay scale type.
If the MDF objects do not exist in the system, the system will create a new one and update all references in the Pay
Scale Group GO. If the internal ID is already in use for the respective object type (Pay Scale Area or Pay Scale Type),
an error is displayed in the log file. This happens only if you run the job more than once.
When migrating picklist values for pay-scale-are and pay-scale-type to the GO, the external code of the GO will
differ from the external code of the picklist value (external code of GO is a combination of <3-digit country code>/
<external code of picklist value>). If you transfer pay scale area and type to other systems using an API, you will
need to adjust the relevant mappings.
Note
• If you want the fields to start behaving like picklist fields again, simply add the picklists again in the data
model.
• When using Pay Scale Area and Pay Scale Type only in the Country/Region-Specific Succession Data
Model, it is important that you configure the same fields in the Succession Data Model.
• The picklist entries are matched using the external_code of the picklist and the externalCode of the MDF
object. Since the MDF externalCode includes the 3-digit country/region code, the picklist external code
is converted to similar format using the ISO country/region association which can be retrieved using the
parent option ID.
Related Information
Procedure
Procedure
Procedure
Code is generated automatically by the system. It is a combination of what you enter for Pay Scale Group,
Country, Pay Scale Area, and Pay Scale Type. Therefore, existing pay scale groups can't be changed.
4. Save your changes.
Create pay scale levels and assign them to a pay scale group.
Context
Pay scale levels are time dependent, so you need to set the effective date. You can also assign pay components
to pay scale levels, for which you have to define frequency, currency, and salary amount. These aren't taken
automatically from the pay component.
Procedure
The <Amount> field is required if you assign a pay component of type "Amount“.
Code is generated automatically by the system. It is a combination of the Pay Scale Group Code and the Pay
Scale Level Code. Therefore, they can't be changed.
4. Save your changes.
Context
There are cases, for example the periodical renegotiation of pay scales, that will lead to the situation where you
have to make pay scale changes for a large number of employees. Since it is not possible to manage this volume
manually, you can schedule runs that will pick out the employees affected by the change and make the relevant
updates to the employees' compensation files for you.
Note
This change run will update recurring and non-recurring payments as well as recurring and non-recurring
deductions. For recurring and non-recurring payments, you need to at least configure the Indirect Valuation for
Pay Scale Level Changes or Mass Change rule. For recurring and non-recurring deductions, there is no need to
create rules.
This change run is an extension to the Pay Scale functionality and not applicable to pay increases in general.
Procedure
Pay Scale The tool will start updating compensation files of this date and onwards. This is not the
Changes from start date of the change run itself.
Employee Group You can define a specific group of employees you want to include in the run. This can come
in handy when testing, or if you want to break the run up into smaller chunks, for example
departments, to keep data traffic low. However, the other criteria applies to this group
nonetheless.
4. Select Submit.
Under Employee Selection, you can now see how many employees are affected by the criteria.
5. Select Simulate or Update to start the respective run.
The simulation run will not create new compensation files. It creates a list of all the changes an update would
trigger.
6. After selecting Simulate or Update, a confirmation pop-up opens and you are asked to enter an Event Reason.
This event reason is the same event reason used in the IF-Statements of the business rules for indirect
valuation. To schedule the job, you can uncheck Start Immediately. To generate a CSV log file for all changes
performed in that job, you can check the relevant box.
Generating a CSV log file has negative effect on the job runtime.
7. Select Simulation or Update.
Results
Go to the Manage Pay Increases page to view the results of the run. Here you can see the status of the runs and
download the CSV file.
Pay components are assigned to pay scale levels. For each pay scale level amount, you can specify currency and
frequency. Once the employee is assigned to a specific pay scale level in the Job Information, the pay component
If you have one pay component for example Basic Pay that is used for indirect valuation you need 2 rules.
1. One rule that transfers the pay components from pay scale level to the Compensation Information block in
case of a New Hire.
2. One rule that runs in case the pay scale assignment changes or a Pay Scale Mass Change is run. This rule
is needed to conduct indirect valuation based on the new pay scale assignment of the employee. This rule
transfers a defined pay component (including amount, currency, and frequency) from the pay scale structure
to the employee’s Compensation Information block.
Note
For these rules, you have two choices in how to set them up. You can have one rule for each pay component
used in pay scale. However, this can lead to a lot effort to keep them up to date and lots of rules may lead to
performance problems. The other option is to have one rule to process all pay scale pay components in the
level. These options are an either/or scenario - do not combine them!
Use the rule needed for indirect valuation for new employees. This onInit rule automatically generates pay
components for new hires in compensation information.
The base object must be Employee Information. The rule must be triggered as an onInit rule for the
payComponentRecurring object.
This rule is triggered in the case of a New Hire. In addition, the employee must be assigned to a pay scale level and
the rule-function Amount from Pay Scale Structure must return value >0. This is the case if the pay component
(CC2 Monthly Salary Tariff in the example below) is assigned to the pay scale level with an amount >0 on the
effective date.
In the following example, the amount for CC2 Monthly Salary is taken from the pay scale structure and is rounded
as well as calculated based on the employee’s FTE. Both settings can be skipped if you don’t need it.
Note
You need a separate rule for each individual pay component that you want to transfer from pay scale level to the
Compensation Information block.
Use the rule needed for indirect valuation for changes in the pay scale assignment. This rule is needed to create
a new pay component in the employee’s Compensation Information block and transfer amount, frequency, and
currency for the pay scale level to which the employee is newly assigned.
If the pay scale assignment changes for an employee or a Pay Scale Mass Change is run, the pay components
and/or its values can be changed using a rule.
The base object for this rule must be Job Information Model, and the rule must be triggered as an onSave rule
for the Job Information object. Create an onSave rule for job information in order to transfer a pay component
The rule only gets triggered in case a Pay Scale Mass Change was initiated with the event reason defined in the rule
or the pay scale level or FTE of an employee has changed but not in the case of a new hire. The amount of the pay
scale pay component must be > 0.
The Then statement transfers the pay component (CC2 Monthly Salary in the example) including amount,
frequency, and currency from the pay scale level to the employee’s Compensation Information block on the
effective date. The amount is rounded as well as calculated based on employee’s FTE. Both settings can be skipped
if it is not required.
In order to transfer amount, frequency, and currency from pay scale level to compensation information you have to
include the following rule functions into the rule:
For example, the Else If and corresponding Then statements could look like this:
Tip
Since pay components are deleted and the Else If statement doesn’t distinguish whether the pay component
was assigned by indirect valuation or by the user, it is highly recommended to use unique pay components for
pay scale and separate rules for salaried employees.
Note
The created rule must be available for each pay component used for indirect valuation.
Note
A similar rule can be created to adjust the non-recurring pay components during a Pay Scale Mass Change
runs. These rules must use Spot Bonus as base object and are called at the onChange event of the Spot Bonus
field pay-component-code.
For large pay scale structures, it may be beneficial to simply have one rule for the pay components rather than one
rule for each pay component. One advantage is that this rule can accommodate for any future additions of Pay
Components to Pay Scale Level or addition of new Pay Scales Levels to the Pay Structure.
You need to add a sequence number to the Pay Component and Pay Scale Level objects.
Once the objects are updated, you have to update the actual pay scale levels in your system.
Caution
Note
Make sure that the numbers stay in the correct order of the sequence. The rule will check the pay
components in the order given in the sequence. If the sequence is out of order, this will lead to errors.
Create a rule that updates the pay components when employee data is changed.
6. Create the Else If condition. There must be one Else If condition for each pay component.
Add a business rule for the Job Information block to adjust the pay components.
Procedure
Assign the previously created rules to the correct objects in Employee Central in order for the system to use the
rules.
Once the rules for indirect valuation are created, they must be assigned to the corresponding Employee Central
objects Compensation and Job Information, and Spot Bonus. These rules create the recurring pay components
when you step from Job Information to Compensation Information in the new hire process.
The following lines must be added to the data model for Compensation Information:
The following lines must be added to the data model for Job Information:
<hris-element id="jobInfo">
<label>Job Information</label>
<trigger-rule event="onSave" rule="CC2_Create_MonthlySalary"/>
</hris-element>
The following lines must be added to the data model for Spot Bonus
Code Syntax
<hris-element id="payComponentNonRecurring">
<label>Spot Bonus</label>
<hris-field id="pay-component-code" visibility="both" required="true">
<label>Type</label>
<trigger-rule event="onChange" rule="CC2_Adjust_SpotBonus"/>
</hris-field>
</hris-element>
For more information on how to assign rules to Employee Central objects, refer to Assigning a Rule to a Non-MDF
EC Object in the Business Rules in SAP SuccessFactors guide on the SAP Help Portal.
After new collective bargaining, you increase values for pay scale levels and structures for employee compensation.
Many companies adhere to a collective bargaining agreement that governs the payment of their employees. For
example, after annual collective bargaining in the chemical industry in Germany, the recently changed rates for
each pay scale group and level need to be adjusted and updated on the People Profile for pay components and one
time payments.
Collective agreement governing payment of your employees is represented in pay scale structures consisting of
pay scale type, pay scale area, pay scale group and level.
Beware that the Employee Central processes for Organizational Change and New Hire do not consider future
dates. In cases where you hire an employee and assign a pay scale structure with values that will increase in the
near future, this will result in incorrect data after pay increase date. To correct the data, initiate a pay scale pay
increase update for this employee. The same applies after performing an organizational change.
Prerequisites
• You have already created pay scale structures and assigned pay scales to your employees.
• Permissions for the pay scale adjustments are in place for the admins.
Process
Result
Once you have completed the process steps as outlined here, your employees compensation reflects the tariff
changes.
Related Information
Export the existing pay scale structure from the system to prepare for changes.
Procedure
Field Description
Note
An Import_Sequence.csv file is also generated, con-
taining information such as the name of the file
and the sequence in which the CSV files are to be
imported.
• No
• Yes
This means that the entity ID and the record ID are
exported.
• No
This means that the entity ID and the record ID are not
exported.
• Yes
This means that the reference objects are not exported
in the .zip file.
• No
This means that the reference objects are exported in
the .zip file.
4. Select Export.
Results
Next Steps
If there were errors, the job monitor generates error reports with error messages indicating why a particular record
was not exported. An e-mail mentioning the status is also sent to the logged-on user.
The Pay Scale Pay Increase job also ensures data consistencies. Usually values from the pay scale table are not be
overwritten in the Compensation block and the job corrects accidentally overwritten values. This is also relevant for
the Deductions block.
Import the CSV file with the new values to the system after you have added the new values for each pay component
and pay scale.
Procedure
File Browse and choose the file that you want to upload.
File Encoding Choose the correct file encoding for your data.
4. To validate the data before importing it, select Validate; otherwise, select Import.
Next Steps
You can verify the imported data by checking one of pay scale level objects.
Update employee data with the new pay scale changes. Admins can start an adjustment of the compensation by
simulating and then updating the data or by directly updating the data. The UI shows a list of pay increases in the
system with their status. Workflows are not supported.
Prerequisites
• Admin Permissions Manage Pay Scale Adjust Employees' Compensation to Tariff Changes
• Admin Permissions Manage Pay Scale Manage Pay Scale Objects
Procedure
Field Description
Pay Scale Changes From Date from which the pay scale change is effective.
Note
If any of the rules used for pay scale are in the Coun-
try/Region-Specific Data Model, then the pay scale in-
crease run must be started for groups of employees who
are all in the same country/region.
Note
The program processes business rules for multiple records for all selected employees, so we recommend
splitting up the process into separate runs for different groups of employees.
Field Description
Note
You can also simulate a pay increase for single employ-
ees or group of employees and check the results in a
CSV file containing both the old values and new values.
This enables you to correct values before updating. No
changes are made to the employee data when this op-
tion is used.
Update This starts the job in the system to update the employee
data.
Tip
Generating a CSV log file has negative effect on the job runtime.
If many employees are processed, this file may be extremely large, and a great deal of additional data
will be read to provide texts.
It is therefore recommended that this option ONLY be used when simulating the pay scale change for
select employees.
Results
The system schedules a job that performs the actual processing of the employees. You can see the job status in the
Manage Pay Increases UI or in the Scheduled Job Monitor. You can check the results of the update as well as find
out when the job started and finished. You can check the status of the runs and download the CSV file, if one was
generated. If errors occurred during processing, then you also get a link to the error log. The error log lists what
errors were found for which employees.
The results show the total number of employees process, the total number of employees for whom data was
updated, as well as the total number of skipped employees. Employees are counted as skipped if processing was
successful for the employee but no changes to the data were required.
The Pay Scale Pay Increase Run background job supports compensation admins with mass changes to employee
compensation data.
The job selects all employees in the specified group who have a pay scale level value selected in the Job Information
record matching the job’s date (value inserted in the field ‘Pay Scale Changes From’). For these employees,
it collects all Job Information records that match the pay scale area, type, and group provided. For each Job
Information record, it finds the time period defined by the start date entered in the pay scale increase definition, the
Job Information validity period, and any changes in the pay scale level.
It is not possible to define end dates for Pay Scale Pay Increase updates. Future reords are added during Pay Scale
Pay Increase.
Rule Processing
• onSave rules on Job Information (with Job Information Model as the base object)
If these rules change any recurring pay components, then the result (meaning, the updated pay component
and Compensation Information) are saved.
• onChange rules on the pay component field of non-recurring pay component
If these rules change the non-recurring pay component, then the result is saved.
No other rules are triggered! If rules have been added to Compensation Information and/or the recurring pay
components, they are not triggered by the pay scale increase.
For each start date of a combined time period, the job calls all onSave rules for Job Information using the event
reason specified when submitting the pay scale increase run.
If any recurring pay components were changed, the results are saved.
The job processes onChange rules attached to the pay component field.
The job collects all recurring deductions overlapping the time perios (the same as for Compensation Information).
The job compares the values of the recurring deductions to the pay scale data.
The job collects all one-time deductions during the time period (the same as for spot bonus)
The job compares the values of the one-time deductions to the pay scale data.
Results
When the adjustments are done, the pay scale increase provides the following information:
Note
Since the Pay Scale Pay Increase Run is an MDF object, it can be deleted using an import or the Manage Data
page. This removes the information about when the job ran and how many employees were processed as well
as the error message attachment.
This rule function can be used to adjust pay scale levels up or down.
It checks the Job Information History and checks every record for a pay scale level to see what needs to be
adjusted. It can be used, for example, in grade step progression processes, as well as for scenarios where
employees return from assignments or receive an adjustment based on seniority.
The calculation checks in the Job Information History and searches for the first record with a Pay Scale Level. As a
second step, the data is given in the rule to compare with that date in the pay scale level time period. Assuming the
employee was hired with a first pay scale level, the rule function checks how often the frequency (given in the rule
function) fits into the time period and writes the correct pay scale level for the new record.
Input Parameters
Seniority Date Enter the date to start the calculation from, for example, entry
date.
(or any other date field)
Frequency How often the pay scale level was adjusted for the employee
Grade step progression is the automatic movement of employees to the next higher pay level. This is common in
industries with a unionized workforce. Based on the requirements, HR departments can define how often the pay
progression program runs, for example, yearly.
As an HR admin, you can automate pay progressions for individuals by configuring filter conditions and associated
rules to capture only those records that meet the desired criteria, such as seniority, time on the job, or age. This
also enables you to define exceptions if certain conditions are met, for example, you can suspend a progression if
an employee is on a global assignment. Actions that can be taken on the identified records include a progression to
the next pay scale level, eligibility for a company car, or other non-monetary elements associated with a pay scale.
The progression is done technically in the system using off cycle event batches. The tasks in the following topics are
focused on what is needed for compensation. However, for more information about off cycle event batches, refer to
Using Batch Rules Processing with the Off Cycle Event Batch in SAP SuccessFactors .
Here is a list of what is needed for grade step progression in Employee Central to work.
• In Provisioning, the Off Cycle Event Batch Processing Job job has been created.
Remember
As a customer, you don't have access to Provisioning. To complete tasks in Provisioning, contact
your implementation partner or Account Executive. For any non-implementation tasks, contact Product
Support.
You can check this here: Managing Job Scheduler Manage Scheduled Jobs , then find it in the list.
• Pay scale structure is set up
For more information, refer to Pay Scale Structure [page 96].
• Business rules are enabled
• Permissions are enabled
Related Information
Before you schedule a job to execute on a periodic basis, you must have an instance of Off Cycle Event Batch
configured in place.
Prerequisites
A business rule applicable to the process is created. For more information about creating a business rule, refer to
the Related Information section.
Context
The primary requirement to schedule a rule processing job in Provisioning is to have an Off Cycle Event Batch
object. This helps the system to identify the batch and execute it according to schedule. It will pick all the records
that match the filter criteria defined in the Off Cycle object.
As a customer, you don't have access to Provisioning. To complete tasks in Provisioning, contact your
implementation partner or Account Executive. For any non-implementation tasks, contact Product Support.
Procedure
Field Action
Code Enter a label to identify your Off Cycle Event Batch job.
Base Object Select a target base object or HRIS element from the drop-
down.
Note
If you create an Off Cycle job for the base object Job
Information, the job considers only the current active
records of employees to prevent creation of duplicate
records.
Note
For executing rules on job information or employ-
ment information, you are required to enable
Administrator Permissions Employee Central
Import Settings Enable Business Rules for
selected entities .
Off Cycle Event Batch User Group (Applicable for Job Select a user group from the dropdown to specify a target
Information and Employment Details base objects.) population.
Remember
Select a user group only if you want to run the off cycle
batch for a particular group of employees. To include all
employees, skip this field.
Include All Matched Records in Every Run (Applicable for Select Yes if you want to update user records with recurring
Job Information, Employment Details, and Work Order base event information. To update non recurring event informa-
objects.) tion, select No.
Example
• Events like changes to an employee's pay scale
are recurring and happen periodically. Select Yes in
such cases.
• Events like employee eligibility for company assets
like a car are non recurring and happen only once.
Select No in such cases.
Include Inactive Records (Applicable for Job Information and Select Yes, if you want to process inactive user records.
Employment Details base objects.)
Note
This schedule will take precedence over the schedule
defined in Provisioning.
Day of Execution (Appears when Frequency is selected as Select the preferred day of the week or month, as applicable,
Weekly or Monthly) for executing the job.
4. OPTIONAL: Set a filter criteria to further streamline the list of user records to process.
If you create multiple filters, the system will filter records matching each filter criteria, and add them to the final
list of matching records.
Field Description
Filter Field Select the field from the dropdown. Example: Start Date.
Note
Applicable for Job Information and Employment Details
base objects.
Offset Enter a number appropriate for the offset unit. This means,
how much time after the begin date should the batch run.
Offset Unit Depending on the selected base object, the offset may differ
or may not be supported at all.
For the Filter field, you can filter all the configured date fields for both standard and custom fields in Business
Configuration for the selected base object in the Off Cycle Event Batch.
The filter lists all the active date fields for jobInfo (Job Information base object) and employmentInfo
(Employment Detail base object). The type of HRIS Field should be Date and enabled Yes in the Business
Configuration. Additionally the filter also lists fields that are preconfigured for jobInfo (Job Information base
object) and employmentInfo (EmploymentDetail base object) that don’t need to be configured in Business
Configuration.
startDate startDate
positionEntryDate serviceDate
jobEntryDate seniorityDate
companyEntryDate benefitsEligibilityStartDate
locationEntryDate
departmentEntryDate
payScaleLevelEntryDate
hireDate
terinationDatem
leaveOfAbsenceStartDate
leaveOfAbsenceReturnDate
Note
If the date field isn’t part of the Business Configuration and the additional filters list, you can’t save
the Off Cycle Object. We’ve included a validation message to notify you to either update the Business
Configuration or delete the filter fields in Off Cycle Event Batch.
The Off Cycle Event Batch also filters records by Last successful run date, which is configured in job details
and is recommended for jobs meant for daily execution. The Off Cycle Event batch will only filter records whose
[last successful run date minus offset]< date field. The last successful run date could be the last successful job
run date or a specified date.
Results
To check the progress of the job, go to Admin Center Monitor Jobs page.
Next Steps
Remember
As a customer, you don't have access to Provisioning. To complete tasks in Provisioning, contact your
implementation partner or Account Executive. For any non-implementation tasks, contact Product Support.
Context
You can create as many rules as needed for the scenarios required, for example, automatic upgrade to the next
level every year on April 1.
Procedure
Field Description
Rule ID The system defaults the Rule Name you enter as the Rule ID,
but you can overwrite it.
Base Object The base object defines which fields and related objects you
can select when creating the rule.
Make sure to set it to the same base object as the off cycle
event batch.
3. The If condition lists the prerequisites that must be fulfilled. The Then condition tells the system to upgrade to
the next pay scale level.
Check the result of the batch job to see the status of each job and any potential errors.
Procedure
This job will pick all active Off Cycle Event Batch records and execute them. You cannot select which off cycle
events batches should be picked up by the job - they are all picked up and run in the order of creation. The
system will trigger the rule for each Off Cycle Event Batch record, and log the last successful run for each rule
triggered.
In SAP SuccessFactors Employee Central, we are working to improve setting up and managing complex pay
structures. This allows companies to specify pay structures for different locations, legal entities, as well as for
different types of workers.
Note
Compensation Information and recurring pay components are validated against the Compensation Structure
settings for all channels. However, it is only available on the UI in the Compensation Information History UI and
Manager Self-Service.
Prerequisites
Note
Since standard MDF objects exist for Pay Scale Type and Pay Scale Area, we recommend that you migrate
from the pay scale picklists of the Job Information fields for Pay Scale Type and Pay Scale Area to MDF to
Context
Using the Compensation Structure object in Compensation Information allows you to:
• Define a sort order of how pay components are displayed in the Profile, Manager Self-Service, and
Compensation Information History UIs
Note
This sort order is not considered in APIs, imports, analytics, or any other channel other than what is listed
above.
• Select only those pay components that are assigned to the compensation structure
Note
You can't assign other pay components to the employee using other channels (such as imports or APIs).
Doing so results in validation errors.
• Prevent mandatory pay components from being removed from an employee's compensation
• Prorate compa ratio and range penetration more flexibly
We have added configuration for proration to allow you to choose between FTE, a proration factor, or no
proration.
Procedure
Field Description
Effective Start Date Select the date for the compensation structure to become
effective in the system.
If this is changed on the UI, the system does not allow the
changes to be saved.
If this is changed on the UI, the system does not allow the
changes to be saved.
Proration Source Select the source to be used for the proration, this means
the location of the factor used for proration of an employee's
salary and pay ranges.
Use Proration in Compa Ratio and Range Penetration Calcu- Select Yes or No to decide whether the system should use
lations proration when calculating compa ratio and range penetra-
tion based on the proration source.
Enable Auto Calculation The system defaults this setting to No. You can't change this
field.
4. Select one or more country/regions for which the compensation structure is valid. If no specific country/region
is defined, then the Compensation Structure is valid for all countries/regions.
5. Select the recurring pay components required for the structure, decide whether they should be mandatory,
and set their sort order.
Field Description
If set to Yes, the system does not let a user delete the
pay component and you can't save the changes to Com-
pensation Information without having that pay component
included.
Source for Recurring Pay Component Data The system defaults this setting to User Input.
You can use the up or down arrows to set the sort order of the pay components. The system displays them in
this order in the History, People Profile, and Manager Self-Service (MSS) UIs.
The system validates that all fields are filled. Otherwise, it prevents the user from saving.
Next Steps
Once the compensation structure is created, administrators can assign a compensation structure to employees
using the MSS UI.
In many countries, certain payments are made to employees based on the location they are working in. To handle
this, Employee Central offers the Location Based Payments function. This guide will take you through the steps
needed to implement this function.
10.1 Prerequisites
Before implementing the function, you first need to make some settings in your system. You need to:
Remember
As a customer, you don't have access to Provisioning. To complete tasks in Provisioning, contact
your implementation partner or Account Executive. For any non-implementation tasks, contact Product
Support.
Procedure
Remember
As a customer, you don't have access to Provisioning. To complete tasks in Provisioning, contact
your implementation partner or Account Executive. For any non-implementation tasks, contact Product
Support.
Procedure
Procedure
Your next step is to configure pre-delivered business rules. There are two scenarios, both of which are outlined in
this section. One is a location change for an existing employee, the other is for new hires.
Procedure
If an employee is hired and their job location is configured in the location configuration object with a coefficient
entered for that particular location, you can update the coefficient in the location configuration object.
Procedure
1. Go to Admin Center.
2. Choose Company Settings, then choose Configure Business Rules.
Procedure
On the next screen, you can see your basic information and predefined parameters.
5. Create your rule. When you have finished, choose Save.
Find out how to configure the relevant rule for your legal entity.
Context
This rule receives data from the lookup object and stores it in the compensation base object. The rule ID you have
already created will be available in the Rule ID drop down menu.
Procedure
Procedure
To ensure the unambiguous identification of the coefficient associated with certain combination of criteria
via a lookup, you must restrict the creation of entries in the lookup object with values in the fields
used as lookup criteria that duplicate an already existing record of this object. Legal Entity and Location
are selected as the business key for the lookup object. If you need a more detailed break-down of the
coefficient values (for example, the age and gender of employee as well as the legal entity and location),
you can enhance the lookup object with the respective custom fields for the additional criteria values and
add these custom fields to the pre-delivered business key.
10.5.1 Troubleshooting
In some cases the system shows an error message for the coefficient value field.
• If you enter a negative number in the Coefficient Value field that the system does not allow, you will see the
following error message:
Negative values are not permitted for the Coefficient Value field
• If you enter 0 in the Coefficient Value field, you will see the following warning message:
The percentage value you have entered in the Coefficient Value field is 0. To continue, select Yes. To make
changes, select No
When you save your entries, you will see the following warning message:
• Employee compensation data could be affected by the change. To continue, select Yes. To make changes,
select No
Find out how to change the employee's location in the location field.
Procedure
Under Compensation, you will see the employee's compensation rate updated for the new location.
11.1 Deductions
Deductions are classified as items deducted from gross income that reduce the amount of income subject to
taxation. These deductions can be done on a one-off basis or as recurring items.
Examples of deductions include contributions to pension accounts, medical insurance, charity donations, and
interest on loans for higher studies.
Caution
Deductions are allowed only after an employee is hired. You can't add or update deductions at the time of a new
hire using either the standard hire template or a custom template.
Both one-time and recurring deductions are MDF objects. They can be updated in the object definition. For
example, if you need the delegate, send back, and approve options in one-time deduction workflows, you can set
the Pending Data field to Yes.
Prerequisites
In Provisioning ensure the following settings are enabled for the company:
Remember
As a customer, you don't have access to Provisioning. To complete tasks in Provisioning, contact your
implementation partner or Account Executive. For any non-implementation tasks, contact Product Support.
Results
You can use role-based permissions (RBP) for both one time and recurring deductions to control who has access.
This means you can restrict the options that certain users have, based on the roles assigned to them.
For recurring deductions, RBP is not enabled by default, which means that the Recurring Deduction block is visible
to all users on their Employment Information page. To restrict access to the Recurring Deduction block to certain
roles, then update the permission settings in RBP.
All permissions settings for MDF objects for deductions must be aligned. If permissions are not set and objects are
not secured, one would have no permissions to the object. Using secured objects is recommended. This means, in
the object definition, in the Security section, the Secured field must be set to Yes and the Permission Category set
to Miscellaneous. Once the object definition is updated, the permissions must be set in Manage Permission Roles
User Permissions Miscellaneous Permissions .
• Recurring Deduction
• Recurring Deduction Item
• One Time Deduction
• One Time Deduction Item
• One Time Deduction User
If you choose not to use secured objects, then you must set the Manage Permission Roles Admin Permissions
Metadata Framework Access to non-secured objects setting.
These are the all recommended settings to create, edit and delete Recurring Deduction Items.
These are the all recommended settings to correct Recurring Deduction Items.
Object\Permis-
sions View View History Create Insert Correct Delete
These are the all recommended settings to view Recurring Deduction Items.
Object\Permis-
sions View View History Create Insert Correct Delete
These are the all recommended settings to create, edit and delete One-Time Deduction Items.
Note
For One Time Deductions, it is we recommended only giving Full or View Permissions. We do recommend giving
only Edit permissions as is possible for Recurring Deductions.
These are the all recommended settings to create, edit and delete One Time Deductions.
11.1.3 UI Configuration
You can configure the UI for both one-time and recurring deductions manually.
Recurring Deduction has only one base object, so only one configuration UI is needed.
Context
Caution
Deductions are allowed only after an employee is hired. You can't add or update deductions at the time of a new
hire using either the standard hire template or a custom template.
Note
You can rearrange the fields as you wish by dragging and dropping them in the Recurring Items section.
You can set the number of visible fields to be shown in the block. Select the properties of Recurring
Deduction Items and set the visible field count.
Note
The end user should not see the Has Permission field on their screen. To ensure this, edit the Has
Permission field properties, and set the Visibility field to No, then select OK. This field should also be
the last field in your configuration UI.
Results
Next Steps
After the Recurring Deduction UI has been configured, it must be assigned to the People Profile.
Context
A one-time deduction has three objects: One Time Deduction, One Time Deduction Items, and One Time Deduction
User. This means, three configuration UIs are required for the three objects.
Note
You can rearrange the order of the fields on the screen by dragging and dropping them as required.
Results
Next Steps
You must create the One Time Deduction User for admins and employees.
Context
The process for configuring one time deductions for administrators and employees is very similar, with one
difference for an employee deduction.
Procedure
7. In the Value Type Resolver menu, select One Time Deduction Item One Time Deduction Deduction
Date .
8. In the Label Override field, enter the label you want to appear on the UI. Select OK.
You can follow the same process from steps 5 -8 in the other input fields for the following attributes:
Note
• Currency
When you set the currency attributes, go to the Value Type Resolver drop-down menu, expand the Currency
option, and select currency.code.
• Unit of Measure
When you set the unit of measure attributes, go to the Value Type Resolver drop-down menu , expand the
Unit Of Measure option and select Common Code.
• Pay Component
When you set the attributes for Pay Component, select the highlighted Pay Component option listed on
the Value Type Resolver drop-down menu. By default, you can see four fields in a row on the block. Any
additional fields are included as part of Details.
If you wish to see more than four fields in a row:
1. Hover over the left-hand side of the One Time Deduction Items section, then select Edit Properties.
Note
You can also add rules by hovering over the One Time Deduction block, then selecting Manage UI Rules.
In the Title section, you can add fields, links, or groups, as well as editing the properties of the title, and
deleting the title, by selecting the relevant option.
You can assign screen IDs to the Configure Deduction Screen IDs object, so that when an Employment Information
or Take Action page is loaded, the system reads the object containing the screen IDs and displays your deductions
on-screen.
You can assign both new and previously existing screen IDs.
Assign screen IDs so that the system reads the object containing the screen IDs and displays your deductions
on-screen.
Context
Typically, when Deductions are enabled, the Configure Deduction Screen ID object is created. It is only possible to
have one object associated with the Deduction Screen ID. If there is no existing Deduction Screen ID, you can create
a new one.
Procedure
Code DeductionScreenID - -
Note
This is a technical field,
meaning that the Deduc-
tionScreenID object is
automatically generated.
onetimeDeductionUser- OneTimeDeductionEmpIn- One Time Deduction User One Time Deduction Items
GoEmployeeId foUserConfigUI
onetimeDeductionUser- OneTimeDeductionEmpIn- One Time Deduction User Edit (pencil) icon on One
GoEmployeeEditId foUserConfigUI Time Deduction User screen.
Note
The fields in pop-up are
read-only. To make any
of the fields editable, up-
date the One Time De-
duction object.
Results
Update existing screen IDs so that the system reads the object containing the screen IDs and displays your
deductions on-screen.
Procedure
Results
Procedure
Results
The rule is created in the system and assigned to the config UI.
Create a rule to make some fields in the pay component read-only for users without permissions.
Context
This rule will set all fields to read-only if the hasPermission field is set to No.
Example
The user does not have edit permission for the Monthly Car pay component. Therefore, all fields are read-only.
Procedure
6. For the If expression, select Recurring Items Has Permission Value , then select is equal to Text, then
type No in the last field.
7. Save your settings.
Results
The rule is created in the system and assigned to the config UI.
Create a rule to make some fields read-only so that existing recurring deduction items cannot be changed in edit
mode.
Procedure
6. For the If expression, select Recurring Items Pay Component Value , then select is not equal to Null.
7. Save your settings.
Results
The rule is created in the system and assigned to the config UI.
Create a rule to set the Equivalent Amount field to visible for pay components of types Number and Percentage.
Context
The calculated amount for the pay components is contained in the Equivalent Amount field. By default, this field is
hidden in the object definition for recurring deduction item and one time deduction.
Procedure
6. Now that the field is visible, you have to update the config UI. Go to Admin Center Manage Configuration
UI .
7. In the Manage Configuration UI screen, search for the Recurring Deduction Config UI.
8. Position the cursor over the Recurring Deduction heading and select the Manage UI Rules link that appears.
9. In the pop-up menu, select the MakeFieldsReadOnlyForNoPerm rule that you previously created.
10. In the Edit Rule pop-up, ensure that the permissions are set correctly.
Note
Please make sure that the hasPermission field is always the last field/column in your configuration UI.
The rule is created in the system and assigned to the config UI.
Next Steps
You can follow the same steps for a One Time Deduction Definition and its respective configuration UIs. The
process for adding new fields in configuration UIs is documented in Adding Custom or New Fields [page 158].
Assign the rules you have just created for recurring deductions.
Context
Note
Rules are not mandatory for deductions. However, if you use them, you need to assign the deduction to the
employee before assigning the rule to the deduction.
Procedure
Note
The Hide User rule only needs to be assigned in the onInitUI Rules section.
5. Select OK.
6. Save your changes.
To avoid errors in the People Profile, configure the Recurring Deduction block as a Live Profile MDF Information
custom block with MDF Screen ID Recurring Deduction Configuration UI. Then configure the One Time Deduction
block as a standard block and not as Live Profile MDF Information block. This is because you can only assign one
screen to the Live Profile MDF information, and since 3 screens are needed for the One Time Deduction, then we
use the One Time Deduction block.
Procedure
In the Custom Blocks section, the Live Profile MDF Information appears.
3. Drag the Live Profile MDF Information block over to the One Time Deduction row and drop it in.
Note
The default section name is One Time Deduction. You can add the MDF Block in every section or create a
custom section for the recurring deduction.
4. Add the MDF Screen ID, which is Recurring Deduction Configuration UI.
5. In the Available Blocks search field, search for One Time Deduction, which is listed under Compensation
Information.
6. Drag the One Time Deduction block over to the One Time Deduction row and drop it in.
7. Save your changes.
Add fields to the existing object definition for the deduction where needed.
Context
If you choose to add custom or new fields to the object definition of a one time or recurring deduction, you also
need to update the configuration UI.
Procedure
Enable the end date field to end a recurring deduction item automatically at a future date.
Procedure
Results
You can now add the field to the configuration UI. For more information about how to do this, refer to Adding
Custom or New Fields [page 158].
Once you have made the field visible and added it to the configuration UI, you can use the end date function to end
recurring deduction items automatically.
Example
On January 1, 2014, you define a recurring deduction associated with a pay component, and with a defined end
date.
Forward propagation means that a change in the value of a field in an object is also made (“propagated”) to future
records for the same object. Forward propagation is only triggered if the amount that was changed is the same for
the future record. That can be the amount or any other field.
The forward propagation of this field change stops as soon as one of the future records for a recurring deduction
has a field value that is different than the original field value. When changes are propagated, the time stamp and
user of the last change to the record is updated.
Forward propagation works for pay components of all type, amount, percentage, and number for recurring
deductions, one-time deductions, and recurring pay components. The field values for frequency, amount, currency,
unit of measure, and rate are all propagated. Attachments and equivalent amounts are not propagated.
Here are some examples for forward propagation for deductions in Employee Central.
A recurring deduction of 100 USD from Jan 1, 2019 is the basis for the examples used here.
For the existing recurring deduction, when you change the amount from 100 to 200, the forward propagation is
triggered. All amount fields with the value 100 will be updated and changed to 200. Forward propagation stops if
the amount is not 100 or at the last entry.
For the existing recurring deduction, when you add a new entry between February and March and change the
reference ID, the forward propagation stops since the reference ID is different than expected.
For the existing recurring deductions, when you add a new entry between February and March and add a value
in the Additional Information field, the forward propagation is not triggered because the old value is null and it is
different than the future value.
For an existing recurring deduction, when you add another recurring deduction and make other changes, the
system propagates the changes to different end points.
Here's what happens when you add a new recurring deduction between Jan/01/2019 and Feb/01/2019 and
change the following:
Procedure
Note
Do not include the end date field in the import as it is intended for the UI only.
Results
Procedure
Results
Once deductions have been configured in your system, you can create them for employees and see the workflows
that follow.
Create a one-time deduction, for example, for an advance, from the employee profile.
Procedure
Note
Ensure that the effective start date is after the hire date to avoid errors in the system.
Results
Now, in your profile page, you can see all current and previous deductions under One Time Deduction.
Procedure
1. On the profile page for the employee, under One Time Deduction, select the icon next to the relevant One Time
Deduction ID.
Results
Procedure
Note
Ensure that the effective start date is after the hire date to avoid errors in the system.
You can also create a recurring deduction in the Employment Information section of an employee profile. Go to
the Recurring Deduction block, select Edit, and then create the deduction.
6. Save your changes.
Now, in the employee profile page, you can see all current and previous deductions under Recurring Deduction.
You can also view the history of the recurring deduction by clicking on the History link in the block.
Procedure
Results
General
Using the Trigger Cross-Entity Rules scenario, you can create a business rule to remove a recurring deduction when
an employment is terminated.
This rule has Job Information Model as the base object and is added to the jobInfo (Manage Business
Configuration) HRIS Element.
Learn about changes to the documentation for Implementing Employee Compensation Data in Employee Central in
recent releases.
1H 2024
Changed We have added information about the new Configuring the Compensation Structure
Compensation Structure feature. Object [page 130]
2H 2023
Changed We have moved the Change History to the Prerequisites for Pay Components [page
end of the guide. 40]
New We have added information about the new Compensation Structure [page 130]
Compensation Structure feature.
Configuring the Compensation Structure
Object [page 130]
Added We have added more information about Data Validation for Compensation Infor-
data validation for Compensation Infor- mation and Recurring Pay Components
mation and Recurring Pay Components in (MSS and History UI) [page 85]
MSS and the History UI.
Added We have added more information about Record Suppression for Compensation
identical record suppression. Information and Recurring Pay Compo-
nents [page 86]
Hyperlinks
Some links are classified by an icon and/or a mouseover text. These links provide additional information.
About the icons:
• Links with the icon : You are entering a Web site that is not hosted by SAP. By using such links, you agree (unless expressly stated otherwise in your agreements
with SAP) to this:
• The content of the linked-to site is not SAP documentation. You may not infer any product claims against SAP based on this information.
• SAP does not agree or disagree with the content on the linked-to site, nor does SAP warrant the availability and correctness. SAP shall not be liable for any
damages caused by the use of such content unless damages have been caused by SAP's gross negligence or willful misconduct.
• Links with the icon : You are leaving the documentation for that particular SAP product or service and are entering an SAP-hosted Web site. By using such links,
you agree that (unless expressly stated otherwise in your agreements with SAP) you may not infer any product claims against SAP based on this information.
Example Code
Any software coding and/or code snippets are examples. They are not for productive use. The example code is only intended to better explain and visualize the syntax and
phrasing rules. SAP does not warrant the correctness and completeness of the example code. SAP shall not be liable for errors or damages caused by the use of example
code unless damages have been caused by SAP's gross negligence or willful misconduct.
Bias-Free Language
SAP supports a culture of diversity and inclusion. Whenever possible, we use unbiased language in our documentation to refer to people of all cultures, ethnicities, genders,
and abilities.
SAP and other SAP products and services mentioned herein as well as
their respective logos are trademarks or registered trademarks of SAP
SE (or an SAP affiliate company) in Germany and other countries. All
other product and service names mentioned are the trademarks of their
respective companies.