SAP Knowledge Base Article - Public

2473623 - Employee Central: How to enable End Dated Payments feature?

Symptom

How to enable End Dated Payments feature?

Image/data in this KBA is from SAP internal systems, sample data, or demo systems. Any resemblance to real data is purely coincidental.

Environment

SuccessFactors Employee Central: Compensation Information

Resolution

Index

 

Handbook: Implementing and Configuring Employee Payments in Employee Central > Recurring Pay Components > End-Dated Payments

 

What is it?

Previously it was not possible to set an End Date for Recurring Payments in one step. This is now possible in the Hire and MSS UI's. The operator can set an End Date and also to make changes to the End Date

 

Why is it important?

There were 2 problems with the previous behavior:

  • The 2 step entry is rather cumbersome.
  • Entry in 2 steps increases the risk that the entry of the 2nd record to end the recurring payment might be forgotten.

 

How to enable this feature

Enabling this feature does not require Professional Services/Consultant engagement, and does not require Product Support to enable any features.

1) People Profile (PP3) must be enabled (can be enabled via the Upgrade Center).

2) Navigate to Admin Center > Manage Data > search under object "Hire/Rehire Configuration" for the record "MATCHINGUSERCONFIG" (if there is no "MATCHINGUSERCONFIG" you will need to create one). Please refer to KBA "2346919 - Add New Employee Wizard : How to configure "Use this Match" feature" for more information regarding configuring this object.

NOTE: Please make sure you only select an Event Reason where -:

  • The Employee Status is set to "No Selection". Ideally you can create a new Event Reason that can be used in this configuration, but again, make sure that the Employee Status is "No Selection".
  • The "Event" is not a "Hire, Termination, Rehire, Paid Leave, Unpaid Leave, etc (Do not use Events which normally result in an Employee Status change)

MATCHINGUSERCONFIG.jpg

Please Note:
If new time slices 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 or alternatively is no record exists on that date it will use the Event Reason from the pervious record before the new End Dated Pay Component was added.  When this record has a Hire or Rehire event reason, the new event reason is taken from the Hire/Rehire Configuration. Please see the following section of the guide for further information:

Implementing and Configuring Employee Compensation Data in Employee Central: End-Dated Payments - Event Reason Derivation

3) Navigate to Admin Center > Manage Organization, Pay and Job Structures > Update the Pay Components that you want to use with the End-Dated Payment feature by setting the new field "End-Dated Payments" to "Yes".

SetEndDatedPaymentYesjpg.jpg

 

 

 

How does it work?

When you are performing a change to Compensation Information via the following UI's, when you select a Pay Component that has "End-Dated Payments" set to "Yes" (or even if you already have a Pay Component already selected where that Pay Component has "End-Dated Payments" set to "Yes"), you will see a new link next to the "Compensation" text in the UI called "Define End Dates". Clicking this link will open a pop-up in which you can define an End Date for each of the Pay Components which have this filter option set to Yes. You will see this option only if you have at least 1 Pay Component selected which has the filter "End-Dated Payments" set to "Yes", and the link will only be available via the following UI's (but not the History UI)

  • "Pencil" icon in the Compensation Information block in People Profile
  • Take Action > Change Job and Compensation Information > click the pencil to include Compensation Information
  • Hire/Rehire wizards

NOTE: The "Define End Dates" link will only display in the above mentioned UI's only and when you have selected a Pay Component where "End-Dated Payments" is "Yes". For a new entry, 'Pay Component' and 'Amount' field needs to fill so that 'Define end date' link will appear.

DefineEndDate.jpg

 

NOTE: Only the Pay Components which are configured with "End-Dated Payments" is "Yes" will be displayed.

DefineEndDate2.jpg

 

FAQ:

Q)  Is it possible to import end dates to pay components?
A) Imports of end dates for pay components are currently not supported. You can create a similar effect via a series of imports detailed in the following KBA:
     2818933 - How to Import End Dated Payments

 

Q) If I do not click "Define End Dates" and enter an End Date, will the UI generate an error message?
A) No. The expectation is that the user will manually fill out the End Dates by clicking "Define End Dates". However, if the link is not used and an End Date is not defined, the process will work as normal.

 

Q) What happens when I fill in an End Date?
A) A new Compensation Info record is created in which the Pay Component is removed. The record is created with a date 1 day later than what is selected in the "Define End Dates" UI.

Note: Once the End Date is saved, it is not displayed as a value for the End Date field. Only Compensation records will be updated based on its Effective Start and Effective End Date. The focus was more on administrator that is doing a correction with the end date and he/she would be allowed to see the history (where end date record is available).

 

Q) What Event Reason gets used by the system when it creates the "End" record in which the Pay Components are removed?
A) If new time slices 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 as defined in step 2 of the "How to enable this feature" section at the top of this article.

 

Q) Can we use different Event Reasons depending on the Pay Component being ended?
A) No. It is 1 Event Reason for all.

 

Q) We are not using Payment End Date but it is still showing in Workflow Request. Is there a way to hide it?
A) Currently, the Payment End Date field is not configurable from the data model. The behaviour is hard-coded, and it will work as such -:

  1. If there is atleast one Pay Component with an end-date defined, then the "Payment End Date" column appears on the Workflow page.
  2. If there are end-dated Pay Components added in compInfo but no end-date is selected for those Pay Components, then the "Payment End Date" column is not displayed on Workflow page.

 

Q) I have configured Event Reason "Data Change (DATACHG)" for the "Event reason for end-dated payments" in the "MATCHINGUSERCONFIG" object configuration, but the system is setting a different Event Reason in the "End" record
A) This is most likely caused by Business Rule Event Reason Derivation configuration issues. When you create your Event Reason derivation Business Rule, every "IF" condition should check that Event Reason is "NULL". And MATCHINGUSERCONFIG event reason is considered when we have only hire/rehire record before adding and ending a new pay component. Refer here.

For example -:

"IF Job Information.Event Reason is equal to NULL"

If this check is not performed, the Event Reason Derivation rules will overwrite the Event Reason you have defined in the "MATCHINGUSERCONFIG" object configuration. Please refer to the Employee Central Master implementation guide for the Recommendations/Guidelines for Event-Reason Derivation Rules.

 

Q) Which UI's allow you to set the Payment End Date?
A) The behaviour was delivered in 1705 and enhanced in 1708.

  1. As of the 1705 release - Add New Employee and Take Action (MSS UI).
  2. As of the 1708 release - Rehire, Internal Hire, Manage Pending Hires, Global Assignments & Concurrent Employments.

Q) Can you reach this field in the rule engine or via the import framework?

A) This field is a UI field only, and is part of the feature end dated payments only. There is no way to add data via import, or API to this field or access it in the business rules engine.

 

Q) When viewing the MATCHINGUSERCONFIG record, some of the options are missing / the "Event reason for end-dated payments" field is missing?
A) Go to Admin Center > Configure Object Definitions > search for the object "Hire/Rehire Configuration (MatchingUserConfiguration)". Then edit the object, click "Details" for the field "endDatedPaymentsEventReason" and then set the Visibility to "Editable" > then click Done and then click Save.

Q) If a Pay component is added to multiple records, and it is then updated to have an end date prior to the effective date of the last record. Will it also be removed from that last record, as well as the effective date of the end date?
A) No, if the pay component already exists in a record after the end-date of the pay component, it will not be removed from this record. It will only be removed from the end-date record and will remain in the later record.

See Also

  • 2785143 - How to Display An End Date Of Each Pay Component
  • 2270326 - How to configure which Pay Components should be displayed in payComponentNonRecurring and payComponentRecurring portlets
  • 2473623 - Employee Central: How to enable End Dated Payments feature?
  • 2716060 - Recurring Deduction - End Date Forward Propagation Behavior
  • Guide: Implementing and Configuring Employee Compensation Data in Employee Central Chapter: Adding an End Date to Recurring Pay Components

Keywords

ECT-59054, end-dated payment, end dated payment, payComponentRecurring, ECT-74068, Payment End Date, ECT- 72868, endDatedPaymentsEventReason, Event reason for end-dated payments, missing, ECT-69238,A Compensation Information record matching the values start-date: , end-date: could not be found. You must first create a Compensation Information record before creating a Compensation record , KBA , LOD-SF-EC-CMP , Compensation Information & One-Time Bonus , LOD-SF-EC-HIR , Hire & Rehire Wizards , How To

Product

SAP SuccessFactors Employee Central all versions ; SAP SuccessFactors HCM Core all versions