Planned Working Time Information and Employee Central Payroll
Planned Working Time Information and Employee Central Payroll
1 What's New in Planned Working Time Information and Employee Central Payroll. . . . . . . . . . . . . . . 3
2 Glossary. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4
4 Setting up Permissions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6
4.1 Granting Permissions to API Users. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6
4.2 Granting Permissions for Planned Working Time. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7
1H 2020
Here are the prerequisites to set up the replication of planned working time from Employee Central to Employee
Central Payroll using point-to-point integration:
● Employee Central Payroll is based on HR Renewal 2.0 EHP8. The systems are initially provided to you with the
latest HRSP level. In order to use the full range of features as described in this guide, you need to install the
latest Synchronization Support Package EA-HR SP80. In addition, we recommend that you update regularly
your system to ensure legal compliance.
● You’ve activated the business function:
1. Go to Switch Framework in the Employee Central Payroll system by using transaction SFW5.
2. Check the box for business function HCM_SFEC_TDEC2HR to activate it. Activating the business function
makes the Customizing for Personnel Management Integration Settings for SuccessFactors Employee
Central Payroll visible.
Remember
Business function HCM_SFEC_TDEC2HR is the same business function you need for the integration
between Employee Central Time Off and Employee Central Payroll in general.
Set up the permissions needed by API users in Employee Central, as well as permissions for data replication users
and users who process the replicated time data in Employee Central Payroll.
Set the permissions required by a user of the SAP SuccessFactors Application Programming Interface (API) and
the Data Replication Proxy and grant your replication (API) users the permission they require for running employee
time data replication in Employee Central.
Context
The permissions listed here give a user access to use the SAP SuccessFactors OData API and OData API for time
data replication. Please note that they don’t grant any user interface logon.
Your API users need permission to access the Data Replication Proxy object, to be able to run the replication of
employee time data to Employee Central Payroll.
For more information about role-based permissions – what they are, how they work, how you set them up – see
Implementing Role-Based Permissions
Procedure
Next Steps
You can test that the API works by using any commonly available tools, such as the SOAP UI tool.
Context
Your admin users need the following permissions to be able to make settings for replication of planned working
time to Employee Central Payroll.
For more information about role-based permissions – what they are, how they work, how you set them up – see
Implementing Role-Based Permissions
Procedure
The following chapter describes step-by-step how to configure Employee Central and Time Off so that they can
communicate time data to Employee Central Payroll.
In Employee Central Payroll you have to set the connection Set Connection Data [page 8]
data to Employee Central and create the Replication Target
Creating the Replication Target System Object [page 9]
System Object.
Ping the Employee Central APIs to ensure that communication Pinging Employee Central APIs [page 10]
is up and running.
Using the Configuration report for Employee Central Payroll, you set the connections for replicating master data
and time data.
Context
Before creating the replication target system object and verifying the connection with a ping test, start the report
Configuration report for Employee Central Payroll (RP_HRSFEC_PTP_CONFIGURATION) using the
HRSFEC_PTP_CONFIG transaction to set up the connection to Employee Central for the replication of employee
master data and time data.
Procedure
Ensure that your password doesn’t contain the special character &.
Remember
The user needs permission to access the Employee Central APIs and OData Service Communication must
be enabled. For more information, see Granting Permissions to API User and Getting users up and running:
Permission settings.
4. To create the Replication Target System Name for Employee Central, go under Set Connection Data and set the
Create Repl. Target System flag.
You can also create the replication target system manually in the Admin Center. For more information, see
section Creating the Replication Target System Object Manually.
5. Press Execute
The last three characters of the RFC destination name should be the same as the SAP client you used.
If you chose to create the replication target system with the report and the creation is successful, you should
see the following success message on the Configuration Status view:
○ Replication Target System XXXCLNTNNN is created successfully in Employee Central.
Context
There are two ways to create the Replication Target System Object, you can create it automatically using the
Configuration Report for Employee Central Payroll (RP_HRSFEC_PTP_CONFIGURATION) as described in the
previous section or you can create it manually in Admin Center, as described in this section.
If you want to create the Replication Target System object manually, go to transaction SCC4.
a. Choose your client and click on the magnifying glass.
b. Note down the logical system name. You will need it again later.
c. Go to Admin Center. In the Tools search field, enter Manage Data.
Related Information
Verify that OData API queries are being received, understood, and accepted for master data and time data by using
Ping Employee Central APIs.
Context
You ping an Employee Central API to ensure that the request has succeeded and use the configuration report
(RP_HRSFEC_PTP_CONFIGURATION) to verify the connection.
Procedure
Results
When the test is successful, the following success messages display in the log:
With this scenario, you can replicate planned working time from Employee Central to the Substitutions (2003)
infotype in Employee Central Payroll for each day of a year. Doing so, the business case for employee's working
time that deviates from the planned working time and/or to be paid based on a different position/work center is
covered.
Caution
You use this scenario to replicate planned working time only for active employees. Inactive employees like
terminated employees and pensioners are out of scope.
Note
We recommend that you create work schedules in the Employee Central system.
● Job Information
● Temporary Time Information. You can create this information manually or upload it. For more information, see
Upload of Temporary Time Information.
Planned working times are replicated to infotype 2003: Infotype 2003 is filled based on the mapping.
The Data Replication Monitor is updated with the status of the replication:
● Successful: The replication results are successful and the corresponding data replication proxy objects are
deleted.
● Failed: The replication results are unsuccessful.
Any replication with the status Failed is repeated until the status Successful is achieved in the Data Replication
Monitor. When the replication is successful, the corresponding data replication proxy objects are deleted.
Creating Data Replication Configuration for Planned Working Time [page 16]
The steps you need to take to create Data Replication Configuration for Planned Working Time replication
from Employee Central to Employee Central Payroll.
All the settings you need to make for the planned working time replication period object. This object is a
prerequisite for the data replication configuration of planned working time.
Context
To replicate planned working time, create a planned working time replication period. You specify a start date and
the period length. The end date is automatically determined based on your entries. 32 days is the default for the
period length.
Restriction
The maximum number of days is set to 60. This period length ensures that at least the end of the month of the
current payroll period is included in the replication process.
Procedure
The end date is automatically determined based on the start date and the number of days you've specified.
Note
The system runs checks on the period object and errors are raised in the following cases:
○ The period length is empty.
○ You want to delete a period object already used in a Data Replication Configuration.
A warning message is raised if a time gap occurs, for example when the period object is moved too far into
the past or into the future.
7. [Optional] Choose Yes for Update Automatically. We recommend that you enable this feature so that the period
object is automatically shifted one day further in a nightly job.
Next Steps
In Data Replication Configuration , select the Planned Working Time Replication Period object from the dropdown.
Note
You can define multiple planned working time replication periods according to your specific needs. Each data
replication configuration object is assigned to a single period object. However, you can assign one single period
object to several data replication configurations.
The steps you need to take to create Data Replication Configuration for Planned Working Time replication from
Employee Central to Employee Central Payroll.
Prerequisites
Procedure
Note
This date is important because only planned working times on or after the Earliest Selection Date you
specify here are considered for replication.
Tip
Tip
Note that the format of the date depends on your logon language. Let's take the date from our example
January 3, 2018 to illustrate it:
○ English UK: 03/01/2018
○ English US: 01/03/2018
7. Set Correction Phase Indicator. The payroll cycle foresees a correction phase where a limited number of
changes are performed before the actual payroll run is executed. If you set the Always Allow Replication In
Payroll Correction Phase field to Yes, your entire planned working times are replicated and saved in the payroll
system, including those entries generated in any correction phase.
8. If you want to replicate planned working time that wasn’t replicated before you set up the integration itself,
choose Yes for Execute Proxy Creation Job. A job is started that creates proxies for all employees corresponding
to the current data replication configuration. Start date and end date of the planned working time are defined
by the planned working time replication period.
Note
Note
This feature is only available when changing the Data Replication Configuration using Manage Data, but not
when using Import Data.
You’ve successfully completed the configuration of planned working time replication from the Employee Central
system to the Employee Central Payroll system. A proxy is generated whenever a change occurs in the following
information:
● Holiday Calendar
● Assignment of a work schedule
● Temporary time information
● Assignment of dynamic break configuration
● Planned working time replication period
You use this feature to create a list of work schedules for planned working times you want to exclude from the
replication to infotype 2003.
Prerequisites
This feature applies only to work schedules assigned to Job Information.. You can’t use this feature to create list for
work schedules assigned to Temporary Time Info.
Context
The following is the list of work schedules in the Employee Central system that are defined in an equivalent way in
the Employee Central Payroll system. Another possible reason is that customers already defined work schedules in
Employee Central Payroll before planned working time replication was available. These customers possibly want to
continue using partially their Employee Central Payroll work schedules.
You manually keep them in sync. When an employee is assigned to a work schedule from this list in the Job
Information block, the corresponding work schedule in the Employee Central Payroll system is assigned to that
employee in infotype 0007. For that reason, the planned working times of the work schedule in the Job Information
block shouldn’t be replicated to infotype 2003 in the Employee Central system. The replication of the planned
working times gets prevented by registering a work schedule in this unique list.
Procedure
A warning message is raised before you can proceed with the deletion.
See how you customize the replication of planned working times in the Employee Central Payroll system.
Prerequisites
Make sure that you have added payroll function Processing request for substitution (P2003) to your payroll schema
so that the replication of infotype 2003 is included in the payroll run of your employees. Otherwise, infotype 2003
isn’t included in payroll.
Procedure
1. In the Employee Central Payroll system, go to transaction SPRO and choose SAP Reference IMG.
2. Check the standard delivery in Display Code Value Mapping as Delivered by SAP in Customizing for Personnel
Management Integration Settings for SuccessFactors Employee Central Payroll Assignment of Code Values
For Point-to-Point Replication .
Here you can see the code value mapping of Employee Cenral Data types as it is delivered by default.
3. Choose Maintain Properties for Code Value Mapping in Customizing for Personnel Management Integration
Settings for SuccessFactors Employee Central Payroll Assignment of Code Values For Point-to-Point
Replication to map the Employee Central code values to the Employee Central Payroll code values.
Context
The point-to-point replication of planned working time can be used to replicate the planned working times of an
employee from the Employee Central system to the Employee Central Payroll system. This means you don't need
to create an actual work schedule in the Employee Central Payroll system, which would also require keeping this
work schedule in sync with the corresponding work schedule in the Employee Central system.
In Employee Central, the holiday calendar is independent of the work schedule. However, in Employee Central
Payroll, the holiday calendar is part of the work schedule because the holiday calendar ID is included in the key
structure of the work schedule rule.
For that reason, you may link the dummy work schedule rule available in the Employee Central Payroll system to a
dummy holiday calendar containing no actual public holidays. However, in some cases, you might need to define
actual holiday calendars in the Employee Central Payroll system and keep them in sync with the holiday calendars
defined in the Employee Central system.
For more information on how to define a work schedule in combination with a dummy holiday calendar, see KBA
2906872 .
For more information on how to define a work schedule in combination with an actual holiday calendar, see KBA
2914265 . By default, the replication of planned working time also replicates the holiday class into infotype 2003.
KBA 2914265 describes how to avoid the replication of the holiday class.
Country/Region A - No replication of planned working time for Define actual work schedules in the Employee Central Payroll
all employees
system and manually keep them in sync with the correspond
ing ones in the Employee Central system.
Country/Region B - Replication of planned working time in Set up a dummy work schedule with a dummy holiday calen
cluding the replication of holiday class for all employees dar in the Employee Central Payroll system. For more informa
tion, see KBA 2906872 .
Country/Region C - Replication of planned working time ex Set up a dummy work schedule with an actual holiday calendar
cluding the replication of holiday class for all employees in the Employee Central Payroll system. For more information,
see KBA 2914265 .
Country/Region D - Replication of planned working time in In the Employee Central system, proceed as follows:
cluding the replication of holiday class for most employees
1. Set up a dummy work schedule with an actual holiday cal
endar.
2. Define actual work schedules as far as necessary, and
manually keep them in sync with the corresponding ones
in the Employee Central system.
Remember
In the Employee Central system, you’ve included
these Employee Central work schedules in the Work
Schedule Replication Exclusion List.
Country/Region E - Replication of planned working time ex In the Employee Central system, proceed as follows:
cluding the replication of holiday class for most employees
1. Set up a dummy work schedule with an actual holiday cal
endar.
2. Define actual work schedules as far as necessary, and
manually keep them in sync with the corresponding ones
in the Employee Central system.
Remember
In the Employee Central system, you’ve included
these Employee Central work schedules in the Work
Schedule Replication Exclusion List.
Procedure
1. In the Employee Central Payroll system, go to transaction SPRO and choose SAP Reference IMG.
2. Choose Maintain Code Value Mapping in the Customizing for Personnel Management Integration Settings
for SuccessFactors Employee Central Payroll Assignment of Code Values For Point-to-Point Replication .
The employee isn’t assigned to a work The Employee Central Code Value field Infotype 0007 is filled with the work
schedule. is empty. schedule rule specified in the ERP Code
Value field.
The employee is assigned to a work The work schedule of the employee is Infotype 0007 is filled with the work
schedule. mapped to a given work schedule rule. schedule rule ERP Code Value
The employee is assigned to a work The Employee Central work schedule With this mapping logic, any work
schedule. doesn’t have an explicit mapping: You schedules without explicit mapping are
entered * in the ERP Code Value field. mapped to the rule code of the dummy
work schedule, and infotype 0007 is fil
led with this dummy work schedule
rule.
Context
Your employee has a day off that is a planned working time of 0 hours in Employee Central. To replicate it to IT2003,
you need to create a dummy daily work schedule FREE in Employee Central Payroll.
Remember
Don't enter 0 manually because the system runs standard checks on infotype 2003.
Procedure
1. In the Employee Central Payroll system, go to transaction SPRO and choose SAP Reference IMG.
2. Choose Maintain Code Value Mapping in the Customizing for Personnel Management Integration Settings
for SuccessFactors Employee Central Payroll Assignment of Code Values For Point-to-Point Replication .
3. Map TIME_FREE_DAILY_WORK_SCHEDULE entered in field EC data type with the ERP Code Value.
4. Save your changes.
Context
Make sure that public holiday class from the Employee Central system is replicated to field Public holiday class
(FTKLA) of infotype 2003.
Note
To cover some country/regionspecific requirements, you can maintain a holiday calendar in the Employee
Central Payroll system and synchronize it with the holiday calendar in Employee Central. In this case, you can
decide not to replicate the holiday class into infotype 2003. For more information on how to avoid the
replication of the holiday class, see KBA 2914265 .
Procedure
1. In the Employee Central Payroll system, go to transaction SPRO and choose SAP Reference IMG.
2. Choose Maintain Code Value Mapping in the Customizing for Personnel Management Integration Settings
for SuccessFactors Employee Central Payroll Assignment of Code Values For Point-to-Point Replication .
3. Check the standard delivery in Display Code Value Mapping as Delivered by SAP in Customizing for Personnel
Management Integration Settings for SuccessFactors Employee Central Payroll Assignment of Code Values
For Point-to-Point Replication .
NONE 0
FULL 1
HALF 2
Note
By default, field Holiday Class of infotype 2003 is filled with the value 0 for days that aren’t public holidays
in the Employee Central field Holiday Class.
The Day Type field defines the payment relevancy of a certain calendar day, and also the planned attendance
regardless of the daily work schedule.
0 0 (Work/Paid)
1 1 (Off/paid)
2 2 (Off/unpaid)
4. [Optional] Choose Maintain Properties for Code Value Mapping in Customizing for Personnel Management
Integration Settings for SuccessFactors Employee Central Payroll Assignment of Code Values For Point-to-
Point Replication to configure public holiday class according to your country/regionspecific requirements.
Context
When replicating planned working times to infotype 2003, field Subsitution Type (VTART) is required because it’s
used to determine the substitution type according to which an employee should work or be paid.
Procedure
1. In the Employee Central Payroll system, go to transaction SPRO and choose SAP Reference IMG.
2. Choose Maintain Code Value Mapping in the Customizing for Personnel Management Integration Settings
for SuccessFactors Employee Central Payroll Assignment of Code Values For Point-to-Point Replication .
3. Map TIME_PLANNED_WORKING_TIME_TYPE entered in field EC data type with the ERP Code Value.
Only substitution types configured in table T556 are allowed as ERP code values. Go to this table by specifying
SM30 to make sure that fields Personnel subarea grouping for substitution/availability types (MOVER) and
Substitution Type (VTART) are customized for your employees.
Example
13 02
TIME_PLANNED_WORKING_TIME_TYP AU 02
E
Collision checks are run in Employee Central. Find out how to disable the checks in Employee Central Payroll.
Context
To avoid unnecessary error messages, you need to turn off several checks in the Employee Central Payroll system.
Procedure
1. In the Employee Central Payroll system, go to transaction SPRO and choose SAP Reference IMG.
2. Choose Reaction to Overlapping Time Infotypes in the Customizing for Time Management Time Data
Recording and Administration Specify System .
3. Disable the checks for the corresponding infotype by selecting N from the dropdown.
4. Save your changes.
The user needs to be of type B (System User) with specific authorizations and restrictions. For your convenience,
we’ve created a template role you can assign to this user: SAP_HR_TIM_EC_PTP_REPL. We strongly recommend
that you create the user with this template role. You have also to mark this user as a customer user by assigning it
to the user group customer in transaction SU01, otherwise the user is deleted automatically by the system.
You have to copy this role from client 000 into your customizing client.
For more information, see Creating a Technical User in the SAP NetWeaver Library.
Context
The Replication Report picks up the data from the OData API. The report runs as a batch job that you need to
schedule.
Procedure
You get the status message Job PLANNED WORKING TIME REPLICATION saved with status: Released
Note
To avoid unnecessary replication of planned working times, especially in test systems because
configuration errors aren’t corrected, the following logic has been improved:
○ If the replication per employment and replication content type fails 100 times, the next replication is
automatically rescheduled one hour later. Later on, the replication is restarted 24 times per day to
With the Admin Alerts 2.0, you track errors and warnings that can occur during the replication process of planned
working time.
You can display the alerts that have come up during the replication process. For more information, see Admin
Alerts 2.0.
Restriction
Using the Employee Central Data Replication Monitor When Replicating Employee Time Data [page 31]
The Data Replication Monitor shows the replication status of individual employees.
Monitoring Tools in the Employee Central Payroll System: Web Service Utilities and Application Log [page 32]
On the Employee Central Payroll side, there are two monitoring tools that help you identify errors that occur
during the replication of employee master and time data.
The Data Replication Monitor shows the replication status of individual employees.
The Data Replication Monitor shows the replication status of individual employments of an employee for the
Replication Content Types Employee Absence Data and Planned Working Time. The monitor displays two statuses:
Successful or Failed. Clicking the Employee Name leads you to the respective Employee File. Clicking the respective
Failed replication status brings up further information about the error.
Example
The picture shows a number of employee entries in the Data Replication Monitor and examples of the replication of
employee time entries with the Replication Content Type: Employee Absence Data.
You can trigger a replication run for one or more employees in the Data Replication Monitor. This might be
necessary for you after correcting errors like incorrect Time Type mapping.
Select the employees and choose Send. The Scheduled Replication Time field is then set to the current time and the
flag Allow Replication in Correction Phase is set for the respective employees. This means that the employee data is
replicated during the next schedule cycle to the payroll system, even if it is in correction phase. In this case, the
error message Payroll area in correction phase isn’t generated.
On the Employee Central Payroll side, there are two monitoring tools that help you identify errors that occur during
the replication of employee master and time data.
Replication messages are first received by the Web Service Framework. Here the system performs a technical
check on the compliance of the received message with the XML schema required by the inbound service interface.
The error log in the transaction SRTUTIL (Web Service Utilities) shows errors that come up in this check.
Application Log
Correct messages are passed on to the application logic that maps the data to the structures of the Employee
Central Payroll employee infotypes and performs the updates on the HCM time data records. Numerous checks are
performed here. Examples of errors are unknown code values, missing mandatory field data, or editing locks if
records are currently being edited by another user. These errors can be monitored in transaction SLG1
(Application Log).
To search for a specific employment per employee enter the External ID and User ID in that order separated by a
slash (/).
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 a 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.
Gender-Related Language
We try not to use genderspecific word forms and formulations. As appropriate for context and readability, SAP may use masculine word forms to refer to all genders.
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.