The SAP S/4HANA integration allows to sync general ledger data from Deel to SAP S/4HANA. This article explains how to set up the integration and configure it so that data can sync successfully.
In this article
Before you begin
To configure the SAP S/4HANA integration, make sure you have:
- A SAP S/4HANA user with the admin role
SAP_BR_ADMINISTRATOR- Alternatively, a business role with access to the catalogs
SAP_CORE_BC_EXTorSAP_CORE_BC_COM
- Alternatively, a business role with access to the catalogs
- The ID of your SAP S/4HANA account. You can retrieve this from the URL. If the URL is
https://my415205.s4hana.cloud.sap/ui#Shell-home, the account ID ismy415205.
Prepare SAP S/4HANA
Step 1. Create a communication user
Use the app Maintain Communication Users to create a new communication user.
Save the username and password for use during Deel setup.
Step 2. Create a communication system
Use the app Communication Systems to create a communication system. When you do, make sure to select the following options:
| Location | Option |
|---|---|
| Technical Data | Select the Inbound Only option |
| Users for Inbound Communication | Add the user created in Step 1, selecting username and password as the authentication method. |
Step 3. Create communication arrangements
Use the app Communication Arrangements to create a communication arrangements for each of the following scenarios:
| Scenario ID | Name | Scopes |
|---|---|---|
SAP_COM_0002 |
Finance - Posting Integration | Required to consume APIs related to journal entries |
SAP_COM_0087 |
SAP Analytics Cloud for Planning Integration | Required for general APIs, such as listing company codes |
SAP_COM_0303 |
Finance - Accounting Analytics Integration | Required for general APIs, such as listing previously created journal entry lines |
When creating the scenarios, set them as follows:
- Give each scenario a name that can help you identify it later. For example,
DEEL_SAP_COM_0002. - Set the Communication System to the one created in Step 2.
- (Only for
SAP_COM_0002andSAP_COM_0087) Deactivate theService Statusoption for all the Outbound Services.
Set up the integration
Step 1. Connect to SAP S/4HANA
1. In the left sidebar, select Apps & Automation to expand its submenu, then select App Store.
If a Welcome to your Deel Apps & Integrations dialog appears, select I'll do that later or close it to access the search field.
2. On the Apps overview page, enter SAP S/4HANA in Find apps.
3. Select the SAP S/4HANA result with the subtitle Accounting software by SAP.
4. On the SAP S/4HANA integration page, select Connect SAP S/4HANA.
5. On Enter Account credentials, enter the SAP account ID and the communication-user username and password created in Step 1, then select Continue.
6. On Connect company codes to Deel, map each Deel entity to its SAP S/4HANA company code, then select Continue.
7. On Notification settings, add the recipients who should receive integration notifications, then select Complete setup.
The integration is now connected to SAP S/4HANA.
Step 2. Sync the General Ledger
Before you begin, make sure the payroll cycle is Completed and its General Ledger has already been generated using a General Ledger template. If the General Ledger row shows Generate rather than Sync General Ledger, generate the ledger first or ask the payroll or finance administrator to do so.
1. In the left sidebar, select Payroll to expand its submenu, then select Payroll cycles.
2. Select the Completed tab. If no completed cycles appear, open the filters panel, reset the Period filter, select Show results, and then return to Completed. Completed cycles from the last 60 days are shown by default; use the Period filter to locate older cycles.
3. Find the relevant entity and payroll period, then select View details.
4. On the completed payroll-cycle page, scroll to Documents, then select Post-approval.
5. In the General ledger row, select Sync General Ledger.
6. On the Connect to an account system dialog, select SAP S/4HANA, then select Continue.
7. On Sync Payroll Journal Entry, map accounts and segments as needed. Your mappings are saved for future payroll journal-entry syncs.
8. Select Sync to S/4HANA.
After the sync completes, select Open in S/4HANA to view the journal entry in SAP S/4HANA.
View the sync history
Once syncs are completed, you can view the details of each sync from the sync history page.
1. In the left sidebar, select Apps & Automation to expand its submenu, then select App Store.
2. In the App Store side panel, expand My apps if needed and locate SAP S/4HANA. If it is not visible, use Find apps to search for SAP S/4HANA.
3. Select the SAP S/4HANA result, identified by the subtitle Accounting software by SAP.
4. On the SAP S/4HANA integration page, select Details next to the sync event you want to review.
5. Review the sync details. If available, select View to open the journal entry in SAP S/4HANA in a new tab.
If the page shows only Connect SAP S/4HANA, the integration is not connected in the current organization. Sync history and Details are unavailable until the connection is configured and at least one sync has occurred.
