Skip to Content

Compensation Planning is an objective way of rewarding employees based on the performance and retaining valuable employees. Compensation Planning focuses on how a company allocates salary, bonus, stocks and one time lump sum disbursements. Employee Central captures information about a company’s organization, pay, job structure and employees.

Compensation can be implemented as a standalone module in SuccessFactors. If Employee central is also implemented, then Compensation plan template can be configured to fetch employee data from Employee central.

1. Enabling integration

Preparing the Compensation Plan Template for Integration

The compensation plan template is EC-enabled when it includes the attribute ‘effectiveDate’ in the comp-config section. The data as on the ‘effectiveDatewould be fetched from EC into the Compensation form.


<comp-config showFormRatingAs=“number-text” functionalCurrencyCode=“EUR”

baseCurrencyView=“localCurrencyCentric” autoSyncP4PData=“true”

effectiveDate=“2015-04-01” >


With 1505 release, this option is available in compensation form template ‘Settings’.

/wp-content/uploads/2015/07/image003_744542.png

The effective date would be displayed on the compensation form as shown in the sample screenshot below.

/wp-content/uploads/2015/07/image005_746413.png

    i. Hybrid mode

A compensation plan template can be hybrid or non-hybrid. A hybrid template is used when a company has some users that are not in Employee Central. It is NOT possible to select some data from Employee Central and the remaining data from the user directory (UDF) for the same user. In this mode, both importkey and mapping with EC field has to be maintained. System automatically fetches the data for EC employees from EC and that for non-EC employees from the user directory (UDF)  This mode is not recommended.

<comp-config showFormRatingAs=“number-text” functionalCurrencyCode=“EUR”

baseCurrencyView=“localCurrencyCentric” autoSyncP4PData=“true”

effectiveDate=“2015-01-01” isHybridMode=“true”>

    ii. Non-hybrid mode

If the tag ‘isHybridMode’ is not set to ‘TRUE’, it is non-hybrid mode. All employee data must come from EC. It is not possible to have a combination of data sources. The data source is always EC. importkey’ tag is not supported in custom fields and hence they should be removed from the template. This includes importkeys defined in the Budgets and Rating Source sections also. Data cannot be imported for any employee.

2. Mapping the fields to fetch information from Employee Central to Compensation

Compensation can currently retrieve data from the following Employee Central components

      • jobInfo
      • compInfo
      • payComponentRecurring
      • payComponentNonRecurring
      • personalInfo
      • employmentInfo

Compensation fields can be mapped to individual pay components, a pay component group or to any of the other EC components mentioned above. Related salary fields (e.g. curSalary, salaryRateType, salaryRateUnits, localCurrencyCode etc.) must be mapped from the same recurring pay component.

The xml code to map a field is <comp-field-definition……………………/>

Complete code is given below.

<comp-field-definition id=“salaryType” isCustomField=“false” isVisible=“true”

useFor=“salary” importKey=“SALARYTYPE” readOnly=“true” hidePercentage=“false”

hideAmount=“false” percentageReadOnly=“false” reloadable=“true”>

<comp-field-label><![CDATA[Salary Type]]></comp-field-label>

<comp-ect-input-field-map componentType=“payComponentRecurring” componentCode=“Base Salary” fieldName=“frequency”/>

</comp-field-definition>

In this mapping,

    • componentType specifies the type of EC component from which the data will be retrieved.
    • componentCode is only valid for the component types payComponentRecurring, payComponentNonRecurring and payComponentGroup. It will be ignored for all other component types.
    • fieldName is the EC hris-field from which data will be retrieved.

Mapping for paygrade is given below.

<comp-field-definition id=“payGrade” isCustomField=“false” isVisible=“true”

useFor=“salary” importKey=“PAYGRADE” readOnly=“false” hidePercentage=“false”

hideAmount=“false” percentageReadOnly=“false” reloadable=“false” >

        <comp-field-label><![CDATA[Pay Grade]]></comp-field-label>

        <comp-ect-input-field-map componentType=“jobInfo” fieldName=“pay-grade”/>

</comp-field-definition>

Referring to a Foundation object

It is possible to define mapping to a foundation object or a property of the foundation object. Mapping for Location is given below.

/wp-content/uploads/2015/07/image011_743738.png

The mapping below, gives the location code

<comp-field-definition id=“CLOCATION” isCustomField=“true” isVisible=“true”

type=“string” useFor=“salary” readOnly=“true” hidePercentage=“false”

hideAmount=“false” percentageReadOnly=“false” reloadable=“false”>

<comp-field-label><![CDATA[Location]]></comp-field-label>

<comp-ect-input-field-map componentType=“jobInfo” fieldName=“location”/>

</comp-field-definition>

/wp-content/uploads/2015/07/image014_743758.png

If the name of the location is required, then the code has to refer to the respective property of the foundation object.

<comp-ect-input-field-map componentType=“jobInfo” fieldName=“location.name”/>

/wp-content/uploads/2015/07/image016_743757.png

Mapping PM rating (Performance management module is not implemented in SF)

In such case, PM rating has to be stored in a custom field in EC e.g. in ‘Employment Details’ portlet. Same is mapped in the rating source section in the form template.

/wp-content/uploads/2015/07/image017_743762.png

<comp-rating-source useFor=“salary” form-id=“0” is-default=“true”

completed-only=“false” use-calculated-rating=“false”

import-from-assignment=“false” scaleId=“Rating_scale”>

<comp-ect-input-field-map componentType=“employmentInfo” fieldName=“custom-double3”/>


Mapping PM rating from Performance management module in SF

In such case, PM form has to be linked to the Compensation template. The configuration in the instance as well as the xml code is given below.

Rating scale-PM.png

<comp-rating-source useFor=“salary” form-id=“1000” is-default=“true”

completed-only=“false” use-calculated-rating=“false” import-from-assignment=“false”

scaleId=“IntScale” ratingType=“overallPerformance”>


Proration Configuration

For configuring proration based on hire date, hire date from EC has to be mapped to the standard ‘Salary Proration Start Date’ field in the template. No mapping required for ‘Salary Proration End Date’ or ‘Prorating’ fields. Details are given below.

Proration-dates.png

<comp-field-definition id=“salaryProratingStartDate” isCustomField=“false” isVisible=“false” useFor=“salary” readOnly=“true” hidePercentage=“false”

hideAmount=“false” percentageReadOnly=“false” reloadable=“false” displayOrder=“23” exportable=“false”>

        <comp-field-label><![CDATA[Proration Start Date]]></comp-field-label>

        <comp-ect-input-field-map componentType=“employmentInfo” fieldName=“start-date”/>

      </comp-field-definition>

 

For proration based on percentage, the percentage has to be stored in Employee central and mapped to the standard ‘Prorating’ field in the template.            

3. Eligibility rules

For the EC integrated compensation template, the eligibility rules are created as business rules in EC. For creating eligibility rules go to Admin Tools > Company Settings > Configure Business Rules

Rules can be defined at –

    • Compensation Plan Level – At the Plan level, compensation rules define who should not be part of the plan. By default, Compensation assumes all users are eligible to be part of the plan.
    • Component Level – At the Component level, rules can be defined to apply to the Salary, Bonus, and Stock tab.
    • Field Level – At the field level, rules can be applied to: promo, merit, extra, extra2, lumpSum, lumpSum2, stock, options, stockUnits, stockOther1, stockOther2, and stockOther3.

A rule that excludes employees based on hire date and employee class is given below. The field that determines the eligibility should be a part of the base object. The rule type should be ‘compensationEligibility

This rule will be available in compensation plan template./wp-content/uploads/2015/07/image019_743780.png

This rule will be available in compensation plan template.

/wp-content/uploads/2015/07/image021_743781.png

4. Pay range (Pay matrix)

Pay range from Compensation as well as the pay range foundation object from EC can be used. Below setting has to be done for using the foundation object.

/wp-content/uploads/2015/07/image023_744541.png

Attribute 1 and 2 are additional fields used for determining the pay range.

Pay range foundation object in EC

The pay ranges in EC are foundation objects. The pay range associations are used as pay range attributes in compensation. In the example given below, Geo Zone and Legal entity are the associations (attributes).

/wp-content/uploads/2015/07/image024_744543.png

Corporate data model has the definition of the pay range. The associations can be modified in corporate data model. Paygrade should be the first association defined, followed by the other associations.

    <hris-associations>

      <association id=“id” multiplicity=“ONE_TO_ONE” destination-entity=“payGrade” required=“false”/>

      <association id=“id” multiplicity=“ONE_TO_ONE” destination-entity=“geozone” required=“false”/>

      <association id=“id” multiplicity=“ONE_TO_ONE” destination-entity=“company” required=“false”/>

    </hris-associations>


5. Publishing Compensation data to Employee Central

Once the compensation process is complete, data can be published to EC. The compInfo record that is effective as of the publish date is the basis from which a new compInfo record is created. The new compInfo record copies information from the base record, modifying it according to the publishing configurations in the compensation template and user data in the compensation form. Final salary, merit, promotion, adjustment are stored in compensation form and updated in the compensation cycle. They are published to the recurring pay components. Lump sum is stored and edited in the form, and since it is a onetime payout, it is published as a non-recurring pay component.

Field mapping for publishing to EC

The section <comp-ect-output-component…………../> defines the mapping for publishing fields to EC. This code supports recurring and non-recurring pay components. A combination of the component type, component code, and effective date is used as a unique identifier for each recurring pay component. For non-recurring pay components, the pay-date is used.

Publishing recurring pay components

Sample code to publish new salary is given below.

<comp-ect-output-component componentType=“payComponentRecurring”

componentCode=“Base Salary” eventReason=“PAYMER” effectiveDate=“2015-07-01”>

<comp-hris-field-map>

<comp-field-id><![CDATA[finSalary]]></comp-field-id>

<hris-field-id><![CDATA[paycompvalue]]></hris-field-id>

</comp-hris-field-map>

</comp-ect-output-component>


Here

componentType specifies the pay component type (payComponentRecurring or payComponentNonRecurring)

componentCode specifies the pay component code. This code is not mandatory for recurring pay components. When not specified, the pay component which has the UsedforCompPlanning attribute set to COMP or BOTH is used.

eventReason specifies the reason for the change in compinfo record. This is not required for non-recurring pay components.

effectiveDate specifies the default start date of the new compinfo record (recurring pay components) and the pay date for the non-recurring pay components.

comp-hris-field-map specifies the mapping between compensation fields (comp-field-id) and employee central fields (hris-field-id).


The record created in EC is given below.

/wp-content/uploads/2015/07/image027_745966.png

Publishing non-recurring pay components

Sample mapping for non recurring pay component is given below.

<comp-ect-output-component componentType=“payComponentNonRecurring”

componentCode=“SPOTBONUS” effectiveDate=“2015-08-15”>

<comp-hris-field-map>

<comp-field-id><![CDATA[lumpSum]]></comp-field-id>

<hris-field-id><![CDATA[value]]></hris-field-id>

</comp-hris-field-map>

</comp-ect-output-component>


The record created in EC is given below.

/wp-content/uploads/2015/07/image029_746011.png

Steps to publish compensation data to EC

Once the compensation process is complete, the data can be published to EC. Click on ‘Complete Compensation Cycle’, then on          ‘Publish Data’ and then on ‘Publish in Employee Central’. Click on the button ‘Check Form Status’. Screen similar to the one given below          would be displayed. Click on ‘Submit’ button to publish the data from the completed forms to EC.

              /wp-content/uploads/2015/07/image031_746091.png

6. Field mapping tool for EC-Enabled Plans

With 1505 release, field mapping is possible from admin tools. Validation also happens and in case of an error, a message is displayed.

Mapping option is available in ‘Design Worksheet’ section, for all standard and custom fields.


/wp-content/uploads/2015/07/image033_746090.png

EC category refers to the ‘componentType in the xml code.

EC Component Name refers to the ‘componentCode in the xml code.

EC field refers to the ‘fieldName in the xml code.


Summary

This write-up was an effort to consolidate the steps required in enabling integration between Compensation and Employee central in SuccessFactors. Not all functionality in Compensation would be working well in a template with EC integration. E.g. the fields in country specific data model cannot be mapped to Compensation. Similarly some types of budget calculation do not work with EC integration.

To report this post you need to login first.

16 Comments

You must be Logged on to comment or reply to a post.

  1. Amy Dines

    Margaret is correct, not all budget modes are available with EC-enabled plan templates.  Budgets based on user and planner are currently supported.

    (0) 
  2. Rajesh Kumar kanagasundaram

    Hi Vinod,

    This was a very helpful article for EC integration. You have put down base points, easy to understand and implement.

    I have few more points needing clarifications…

    1) Can we implement Job Selector in EC integrated scenario. If so, how would we update the New job family, Job code, Job role and Pay grade back to EC.

    2) I have always seen scenarios where we only update Basic Salary component code. Is there possibility to update 2 or more Component codes under Recurring Pay. For instance, Base Salary, HRA(House Rent Allowance), Special allowance etc.

    Thanks

    Rajesh

    (0) 
    1. Vinod Vasudeva Kamath Post author

      1) Currently publishing to EC is limited to compinfo and that also to pay components. So we will have to import the data to the jobinfo manually.

      2) Yes multiple pay components can be updated together.

      Regards

      Vinod V.

      (1) 
  3. Prashant Priyadarshi

    Hi Vinod ,

    very helpful article . But i am getting an error that after launching the form the message i am getting in monitor job is :

    The creation of compensation plans has completed SUCCESSFULLY.

    There were 0 plan(s) created.

    the form is EC Enabled and the planner for whom i am launching the form has 5 direct sub-ordinates. Can you please help me in this by suggesting the cause of this issue.

    one more doubt is that i am not getting the option of adding the attributes while using EC pay matrix.

    Capture.PNG Hoping i will get a positive reply.

    Thanks in advance.

    Prashant

    (0) 
  4. Ritika Mehta

    Hello,


    I tried to Integrate Existing Compensation module with EC and made all the above prescribed changes in the XML  but when I upload the xml ,its throwing the below error. It would be great help if  anybody let me know why this issue is coming.


    Comp-EC.PNG


    Thanks and Regards,

    Ritika Mehta

    (0) 
  5. KPMG SF

    Hello,

    Can anyone please suggest as how can we post revised pay grade to Employee Central from Compensation. Since Compensation is used for performing promotion as well, is there any way of doing the same ?

    (0) 
  6. Amy Dines

    Planning for promotions in Compensation and publishing in Employee Central is available as a Beta feature in Q3, with enabling required via Provisioning. Customers and partners are invited to enable this feature and provide feedback.  In Q4 the feature will be GA, with the additional enhancement of support for custom promotion-related fields displaying on the worksheet.

    (0) 
  7. Naresh KM

    HiĀ Amy Dines,

    Can you please tell me is it possible to publish the promoted Pay grade (New Pay- Grade) from Compensation to Employee central ??

    Please suggest me on this, if possible please let me know the sample XML code for Pay grade publishing.

    Regards,
    Naresh.KM

    (0) 
  8. Lynsye Peterson

    Can anyone tell me how (using EC business rules for eligibility) you can limit someones eligibility to compensation if they do not have a Performance rating? In the old rules there was a radio button in the rule set up for this function, and given PM is not part of MDF i cannot work out how to create this restriction using the new EC business rules.

    Thank you

     

    (0) 
    1. Vinod Vasudeva Kamath Post author

      Hi Lynsye,

      It is late, but still, for EC integrated templates, as the eligibility rules are created as business rules in EC, PM rating should be available in a field in EC to use them in Eligibility rules.

      Regards

      Vinod

      (0) 

Leave a Reply