Enterprise Resource Planning Blogs by SAP
Get insights and updates about cloud ERP and RISE with SAP, SAP S/4HANA and SAP S/4HANA Cloud, and more enterprise management capabilities with SAP blog posts.
cancel
Showing results for 
Search instead for 
Did you mean: 
Clark_Huang
Employee
Employee


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. It includes both self-billing with automatic posting(SBWAP) and self-billing with invoice creation(SBINV).

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



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

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

  3. Choose New.

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

  5. Choose Create.

  6. 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



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

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

  3. Choose New to create a communication system.

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

  5. Choose Create.

  6. 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.

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

  8. 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.

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

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

  11. 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

  • SAP_COM_0158

  • SAP_COM_0159


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

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

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

  3. Choose New.

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

  5. 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



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

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

  3. 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.



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

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

  3. Choose Create.

  4. 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 replicate units of measurement and plants data, to check the integration configuration, as well as to export data.
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.
Archiving SAP_SELFB_ARCHIVING User to process archiving This role allows the user to log on to self-billing apps, performance archiving.
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.


  1. Create a technical user in your own IDP service.

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

  3. Choose Security > Role Collections.

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

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

  6. If you would like to verify the setup through API, you can assign the Admin to the technical user, and remember its username and password which will be used later.


Creating Other Communication Arrangements


For Scenario SAP_COM_0564



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

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

  3. Choose New.

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

  5. 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.

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


 






























Service Path Remark
Credit/Debit Memo – Send Confirmation of Creation with Invoice Reference /api-password/selfbilling-confirmation-service/v1/api/CreditDebitMemoConfirmation_In/V2
Billing Document – Send Confirmation of Fields Updated for Self-Billing /api-password/selfbilling-confirmation-service/v1/api/BillingDocumentUpdateConfirmation_In Only for SBWAP
Billing Document - Send Confirmation of Simulated Pricing /api-password/selfbilling-confirmation-service/v1/api/BdSimulatePricingConfirmation_In
Self-Billing Invoice - Send Creation Confirmation /api-password/selfbilling-confirmation-service/v1/api/SelfBillingInvoiceCreationConfirmation_In Only for SBINV

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.



 

  1. If there are any other outbound services you do not use, deactivate them and save your settings. For example, if you only use SBWAP and no pricing simulation, you can deactivate them as below.


For Scenario SAP_COM_0002(only used for SBWAP)



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

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

  3. Choose New.

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

  5. 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.

  6. 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.

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



For Scenario SAP_COM_0114



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

  2. Choose Communication Management > Communication Arrangements.

  3. Choose New.

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

  5. 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.



  1. 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.

  2. Deactivate all other outbound services.

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

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

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

  6. Choose Replicate.


For Scenario SAP_COM_0116



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

  2. Choose Communication Management > Communication Arrangements.

  3. Choose New.

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

  5. 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.



  1. 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.

  2. 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.

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

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

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

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

  7. Choose Replicate.


Verifying the Setup


After completing all these steps, you can use your billing clerk account to access SAP Self-Billing Cockpit:

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

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


You can verify the setup through the API:

  1. Create Get request in Postman, enter the request url https://<subdomain>/api-password/selfbilling-customizing-service/v1/api/check.

  2. Click the Authorization, choose the Basic Auth for the Type. Enter the username and password of the technical user with the role SAP_BR_ADMINISTRATOR.

  3. If all checks in odataCheck are "200 OK" and no item in Configuration Missing in additionalCheck, the setup is correct.


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.

Additional Information



Blog Post Series for SAP Self-Billing Cockpit