Prerequisites

former_member619544 · ‎04-15-2021

This blog post describes how to set up integration between SAP Self-Billing Cockpit and an SAP S/4HANA Cloud system without requiring a cloud connector.

Prerequisites

You have set up your global account and subaccount.

You are assigned the Administrator role for the global account.

You are assigned the Security Administrator role for the subaccount to configure authorizations using role collections.

Enabling Communication in SAP S/4HANA Cloud

Creating a Communication User

Log on to the SAP Fiori launchpad in the SAP S/4HANA Cloud system.

Start the Maintain Communication Users app by choosing Communication Management > Maintain Communication Users.

Choose New.

Enter the name, description, and password of the new user.

Choose Create.

Record the user name and password for future use.
They are required when you create communication arrangements and destinations to SAP S/4HANA Cloud via the SAP BTP cockpit.

Creating a Communication System

Log on to the SAP Fiori launchpad in the SAP S/4HANA Cloud system.

Launch the Communication Systems app by choosing Communication Management > Communication Systems.

Choose New to create a communication system.

On the New Communication System screen, specify the system ID and system name.

Choose Create.

In the Technical Data area, specify the hostname (that is, the host URL of the self-billing tenant excluding https://, such as <subdomain>.eu10.selfbilling.cloud.sap), the logical system name, and the business system name (that is, your subaccount ID assigned by the SAP BTP cockpit).
The subdomain is specified by you when you create a subaccount. Ensure that it is identifiable and meaningful for you. You can find your subdomain and subaccount ID via the SAP BTP cockpit.

In the Users for Inbound Communication area, add a user.

On the New Inbound Communication User screen, enter the name of the communication user you have created earlier, specify the authentication method, and save the settings.

In the Users for Outbound Communication area, add a user.

On the New Outbound Communication User screen, enter the name of the technical user you have created earlier.

Save your settings and record the communication system name for future use.

Creating Communication Arrangements

Create communication arrangements for the following scenarios before you proceed:

SAP_COM_0367

SAP_COM_0008

SAP_COM_0106

SAP_COM_0120

SAP_COM_0087

All these scenarios follow the same configuration procedure, so this part uses scenario SAP_COM_0367 as an example.

Log on to the SAP Fiori launchpad in the SAP S/4HANA Cloud system.

Launch the Communication Arrangements app by choosing Communication Management > Communication Arrangements.

Choose New.

In New Communication Arrangement, choose SAP_COM_0367 under Scenario, modify the arrangement name if necessary, and choose Create.

In theCommon Data section, select the communication system you have created earlier in "Creating a Communication System".
The previously created communication user is automatically added to the Inbound Communication section and Outbound Communication section (if any).
If there are any other outbound services, deactivate them and save your settings.

Subscribing to SAP Self-Billing Cockpit

Configuring Destinations

Log on to the SAP BTP cockpit (Cloud Foundry environment) with your registered subaccount.

Choose Connectivity > Destinations > New Destination to create a new destination for mobile services.

In the Destination Configuration wizard, enter the following:

Name: SELFB_DEST_S4HANA

URL: Hostname of the SAP S/4HANA Cloud system

Authentication: Basic Authentication

User: The communication user you have created in "Creating a Communication User".

Password: The password of the communication user you have created earlier.

Save your settings and choose Check Connection to check whether the connection has been securely set up.

Choose Service Marketplace in the navigation tree, navigate to the SAP Self-Billing Cockpit tile, and open it.

Choose Create.

In the displayed screen, choose an application plan (for example, default) and proceed as instructed.

After the subscription is complete, the status changes to Subscribed.

Assigning Role Collections to Users

You can manage role collections as needed. The following table lists the recommended role collections.

Role Collection	Role	User	Remarks
Admin	SAP_BR_ADMINISTRATOR	A technical user on BTP	This role grants the technical user rights to do the job scheduling.
Billing_Clerk	SAP_SELFB_CLERK	Billing clerk	This role allows the billing clerk to log on to self-billing apps, make configurations, check document status, and perform processing tasks.
Confirmation	SAP_SELFB_CR_API	A technical user on BTP	This role allows the technical user to receive confirmation messages from SAP S/4HANA Cloud.
Transmission	SAP_SELFB_TR_API	A technical user on BTP	This role allows the technical user to send transmissions to SAP Self-Billing Cockpit.

Create a technical user in your own IDP service.

Log on to the SAP BTP cockpit (Cloud Foundry environment) with your registered subaccount.

Choose Security > Role Collections.

Create a role collection, enter a name and a description, and save the settings.

Choose the newly created role collection, and edit it by adding the corresponding role.

Creating Other Communication Arrangements

For Scenario SAP_COM_0564

Log on to the SAP Fiori launchpad in the SAP S/4HANA Cloud system.

Launch the Communication Arrangements app by choosing Communication Management > Communication Arrangements.

Choose New.

In New Communication Arrangement, choose SAP_COM_0564 under Scenario, modify the arrangement name if necessary, and choose Create.

In the Common Data section, select the communication system you have created earlier in "Creating a Communication System".
The previously created communication user is automatically added to the Inbound Communication section and Outbound Communication section.

In the Outbound Services section, enter the path for the following services:

Service	Path
Credit/Debit Memo - Send Confirmation of Creation with Invoice Reference	/api-password/selfbilling-confirmation-service/v1/api/CreditDebitMemoConfirmation_In
Billing Document - Send Confirmation of Fields Updated for Self-Billing	/api-password/selfbilling-confirmation-service/v1/api/BillingDocumentUpdateConfirmation_In

Note:
If you use a custom identity service as an alternative to the SAP ID service, add ?login_hint=%7B%22origin%22%3A%22sap.custom%22%7D to the end of the service path.

The service URL is automatically generated based on the tenant host name and the entered path. For example, <Self-Billing Tenant URL>/api-password/selfbilling-confirmation-service/v1/api/CreditDebitMemoConfirmation_In and <Self-Billing Tenant URL>/api-password/selfbilling-confirmation-service/v1/api/BillingDocumentUpdateConfirmation_In.

If there are any other outbound services, deactivate them and save your settings.

For Scenario SAP_COM_0002

Log on to the SAP Fiori launchpad in the SAP S/4HANA Cloud system.

Launch the Communication Arrangements app by choosing Communication Management > Communication Arrangements.

Choose New.

In New Communication Arrangement, choose SAP_COM_0002 under Scenario, modify the arrangement name if necessary, and choose Create.

In the Common Data section, select the communication system you have created earlier in "
Creating a Communication System".
The previously created communication user is automatically added to the Inbound Communication section and Outbound Communication section.

In the Outbound Services section, enter the following path for the “Journal Entry - Change (Asynchronous) Confirmation” service: /api-password/selfbilling-confirmation-service/v1/api/JournalEntryBulkChangeConfirmation_In.

Note:
If you use a custom identity service as an alternative to the SAP ID service, add ?login_hint=%7B%22origin%22%3A%22sap.custom%22%7D to the end of the service path.

If there are any other outbound services, deactivate them and save your settings.

For Scenario SAP_COM_0114

Log on to the SAP Fiori launchpad in the SAP S/4HANA Cloud system.

Choose Communication Management > Communication Arrangements.

Choose New.

In New Communication Arrangement, select SAP_COM_0114 under Scenario, modify the arrangement name if required, and choose Create.

In the Common Data section, select the communication system you have created earlier in “Creating a Communication System”.
The previously created communication user is automatically added to the Inbound Communication section and Outbound Communication section.

In the Outbound Services section, set the path for the Unit of Measurement - Replicate (A2X) service to the following: /api-password/selfbilling-core-service/v1/erpintegration/data/UnitOfMeasurementMasterDataReplicationBundleRequest_In.

Note:
If you use a custom identity service as an alternative to the SAP ID service, add ?login_hint=%7B%22origin%22%3A%22sap.custom%22%7D to the end of the service path.

Deactivate all other outbound services.

Under Additional Properties, define Replication Model and save its value (such as SB_UOM) for future use.

Navigate to the SAP Fiori launchpad and launch the Replicate by Replication Model

From the dropdown list of Replication Model, choose an option beginning with the replication model defined in Step 8, such as SB_UOM_999.

Choose Replicate.

For Scenario SAP_COM_0116

Log on to the SAP Fiori launchpad in the SAP S/4HANA Cloud system.

Choose Communication Management > Communication Arrangements.

Choose New.

In New Communication Arrangement, select SAP_COM_0116 under Scenario, modify the arrangement name if required, and choose Create.

In the Common Data section, select the communication system you have created earlier in “Creating a Communication System”.
The previously created communication user is automatically added to the Inbound Communication section and Outbound Communication section.

In the Outbound Services section, set the path for the Plants - Replicate service to the following: /api-password/selfbilling-core-service/v1/erpintegration/data/plantsSync.

Deactivate all other outbound services.
Note:If you use a custom identity service as an alternative to the SAP ID service, add ?login_hint=%7B%22origin%22%3A%22sap.custom%22%7D to the end of the service path.

Under Job Execution Details, define the fields based on your own needs (daily execution is recommended).

Under Additional Properties, define Replication Model and save its value (such as SB_PLANT) for future use.

Navigate to the SAP Fiori launchpad and launch the Replicate by Replication Model

From the dropdown list of Replication Model, choose an option beginning with the replication model defined in Step 9, such as SB_PLANT_999.

Choose Replicate.

Verifying the Setup

After completing all these steps, you can use your billing clerk account to verify the setup:

Log on to the SAP BTP cockpit (Cloud Foundry environment) with your registered subaccount.

Navigate to your application plan, and choose Go to Application.
You can now view the apps in SAP Self-Billing Cockpit.

Summary

To set up integration between SAP Self-Billing Cockpit and an SAP S/4HANA Cloud system, we need to first enable communication in the SAP S/4HANA Cloud system and then subscribe to an application plan of SAP Self-Billing Cockpit via the SAP BTP cockpit.

If you're interested in similar topics, you can follow its tag and my profile.

Surely, you're cordially invited to provide your feedback and insights in the comments section.