Technical Articles
Setting up Payroll Processing with SAP SuccessFactors Employee Central Payroll (Point-to-point integration) (Part 1)
Introduction:
This blog will describe the technical setup that must be carried out to enable the integration of SAP SuccessFactors Employee Central Payroll with SAP S/4HANA. In the first part, the steps that should be carried out in S/4HANA will be described, and the second part will describe the steps in ECP.
The document used during this setup is:
S/4HANA:
Step (1):
This step is usually carried out by the functional consultant.
Tcode: sale> Idoc Interface / Application Link Enabling (ALE) > Modelling and Implementing Business Process > Global Organizational Units > Cross-System Company Codes
Double click on (Cross-System Company Codes)
Choose (New Entities) and write the global CoCde for your company in this example it will be GLCC01
Save and go back, then double-click on (Assign Cross-System Company Code to Chart of Accounts)
Add the Target ChtAccts next to the Global CoCde
Save and go back, then double-click on (Assign Company Code to Cross-System Company Code)
In this step make sure that you write the Global CoCde that you identified earlier in the raw that contains your Company Name
Save.
Step (2)
This step is usually carried out by the functional consultant
Tcode: sale> Idoc Interface / Application Link Enabling (ALE) > Modelling and Implementing Business Process > Global Organizational Units > Cross-System Business Areas
Double-click on (Cross-system business area)
Through (New Entries), add the X-syst. business area and the Description, they can be added in bulk by pasting the values directly in the table
Save and go back, then double-click on (Assign Business Area to Cross-System Business Area)
Add X-SysBusAr for the Business area that you added before
Save.
Step (3)
Tcode: sale > Idoc Interface / Application Link Enabling (ALE) > Basic Settings > Logical Systems > Define Logical System
OR Directly
Tcod: BD54
Then, choose (New Entity)
In the New Entries screen make sure that the Log. System is exactly like the one in ECP, in this case, it will be X01CLNT100
Save.
***
You can get the Log. System entry by logging in to your ECP system and going to Tcode: sale > Idoc Interface / Application Link Enabling (ALE) > Basic Settings > Logical Systems > Assign Logical System to Client
Double-click on the client
Find the logical system
***
Step (4)
Tcode: BD64
Switch to edit view using (the pain and glasses) symbol, then choose (Create Model View)
- The short text can be any value in this example: S4OP to EC Payroll
- The technical name can be any name in this example: S4OPECPY
Then choose to continue
Choose the model that you created and then press (Add Message Type)
- The Sender will be the S/4HANA logical system in this example: QI1CLNT600
- The Receiver will be the ECP logical system in this example: X01CLNT100
- The Message type will be COSMAS
Choose to continue
Save.
***
You can get the logical system for the S/4HANA by going to Tcode: sale > Idoc Interface / Application Link Enabling (ALE) > Basic Settings > Logical Systems > Assign Logical System to Client
Double-click on the client
Find the logical system
***
Step (5)
Tcode: sale > Idoc Interface / Application Link Enabling (ALE) > Modelling and Implementing Business Process > Master Data Distribution > Replication of Modified Data > Activate Change Pointers for Message Types
Make sure that activation is set for message type COSMAS.
Step (6)
Tcode: SM59
Choose ABAP Connections and then Create
Then in the Technical Setting tab, fill:
- Target Host: of the ECP system
- Instance: of the ECP system
The target host string depends on the data center, and it should be like the following:
Datacenter | RFC from Customer to SAP Payroll System |
DC55 | /H/<Customer SAProuter>/S/3299/H/payroll55-osk.sapsf.eu/S/3299/H/<payroll-host>/S/3300 |
DC56 | /H/<Customer SAProuter>/S/3299/H/payroll56.sapsf.eu/S/3299/H/<payroll-host>/S/3300 |
DC64 | /H/<Customer SAProuter>/S/3299/H/payroll64-osk.sapsf.com/S/3299/H/<payroll-host>/S/3300 |
DC66 | /H/<Customer SAProuter>/S/3299/H/payroll66-osk.sapsf.com/S/3299/H/<payroll-host>/S/3300 |
DC22 | /H/<Customer SAProuter>/S/3299/H/payroll22-osk.sapsf.com/S/3299/H/<payroll-host>/S/3300 |
DC23 | /H/<Customer SAProuter>/S/3299/H/payroll23-osk.sapsf.com/S/3299/H/<payroll-host>/S/3300 |
In the Logon & Security tab
Fill out the Logon Procedure:
- Language: EN
- Client: the client of your ECP in this example 100
- User: this user should be an ECP user that has the needed authorities
- Password: the password of the ECP user
Save, then press (Connection test) to verify that it is working
Step (7)
Tcode: WE21
Choose Transactional RFC then Create
You can choose to (Generate port name), or you can choose the name you want using (own port name), in this example the name: X01CLNT100
Choose the RFC destination that we created in the previous step, and select (IDoc record types SAP Release 4.x)
Save
Step (8)
Tcode: WE20
Choose partner type LS and Create
Fill:
- The (Partner No.) as the name of the logical system of the ECP in this example: X01CLNT100
- The (Partn. Type): LS
- Ty.: US (User)
- Agent: the name of a user that has authority over the S/4HANA system in this example XYZ
- Lang.: EN
Save
Fill:
- Message Type: COSMAS
- Basic Type: COSMAS01
- Receiver Port: use the receiver port that we created in the previous step in this example: X01CLNT100
Select:
- Pass IDoc Immed.
- Cancel Processing After Syntax Error
Save
1st Parameter
Fill:
- Message Type: ACC_EMPLOYEE_EXP
- Press Code: BAPI
Save
2nd Parameter
Fill:
- Message Type: ACC_EMPLOYEE_PAY
- Press Code: BAPI
Save
3rd Parameter
Fill:
- Message Type: ACC_EMPLOYEE_REC
- Press Code: BAPI
Save
The Partner profile should look like this
Step (9)
Tcode: SE38
Fill Program: RBDMIDOC
Execute
And then fill in Message Type: COSMAS
And then Save
Fill
- Variant name: YK_COSMAS_ECPY
- Variant Description: whatever you want
Save
Step (10)
Tcode: SM36
Choose Job Wizard
Continue
- Job Name: YK_CC_ALE_DELTA_PY
- Job Class: C – Low priority
- Job Status: Scheduled
Continue
ABAP program step
Continue
- ABAP program name: RBDMIDOC
- Variant: YK_COSMAS_ECPY
- Execution language: EN
Continue
Continue
Continue
Choose Immediately
Continue
In the periodic table choose period value
Continue
Choose (none of the above), then (other period), in this example, the day value was set to 1
Then choose Create
Continue
Complete
Step (11)
Tcode: SE38
Program: RBDAPP01
Execute
- IDoc Status: 64
- Message Type:
ACC_EMPLOYEE_EXP
ACC_EMPLOYEE_REC
ACC_EMPLOYEE_PAY
- Package Size: 100
Save to create variant
- Variant Name: whatever you want, in this example: PAY_POST
- Description: whatever you want, in this example: IDoc Processing
Save
Step (12)
Tcode: SM36
- Job Name: whatever you want, in this example: PP_ECP
- Job Class: A
Choose (Start condition)
Choose (Immediate)
Select (Periodic Job)
Choose (Period value) option
Choose (Hourly)
Save the period value and then save the start time
Then Choose (Step)
- ABAP Program Name, and enter the name as RBDAPP01
- Variant field, select the variant that you created, for example, PAY_POST
Save
The S/4HANA configuration is completed
In the second part, the configuration from the ECP side will be described 😊
Very useful and good blog! waiting for more!
Thank you Perry 😊
Hi Ruba,
really very helpful blog.
one question: Which source you have used to get the saprouter strings?
Hi Mario,
I utilized a document provided by SAP titled "Set Up an SNC-Based SAProuter Connection Information on setting up a connection for Employee Central Payroll™ systems hosted on Azure™ & GCP."
However, I was unable to locate it online, so if you want it please let me know so I can share it with you :))
It is very useful and good blog! waiting for more!
Thank you Suresh :))