This guide explains how to configure integration between SAP Self-Billing Cockpit and an SAP S/4HANA system. Follow the sections below step by step.
The complete setup involves the following major tasks:
SU01.SAP_ALL/SAP_APP./IWFND/MAINT_SERVICE (Activate and Maintain Services).
If the system returns HTTP 200, the service is working. Otherwise choose Add Service and add the missing service.
| External Service Name | Processing Mode | System Aliases | Remarks |
| API_BUSINESS_PARTNER | Routing-based | required | |
| API_SD_SA_SOLDTOPARTYDETN | Co-deployed only | ||
| API_OUTBOUND_DELIVERY_SRV | Routing-based | required | Version: 2 |
| API_BILLING_DOCUMENT_SRV | Co-deployed only | ||
| API_SUBSQNT_BILLG_DOC_SBI_SRV | Co-deployed only | ||
| API_PRODUCT_SRV | Routing-based | required | |
| API_SALESORGANIZATION_SRV | Co-deployed only | ||
| API_SALES_DOCUMENT_REASON_SRV | Routing-based | required | |
| API_COMPANYCODE_SRV | Co-deployed only | ||
| API_CREDIT_MEMO_REQUEST_SRV | Co-deployed only | only used for Invoice Creation | |
| API_DEBIT_MEMO_REQUEST_SRV | Co-deployed only | only used for Invoice Creation |
Download the SAP Cloud Connector from the SAP Tools website and install it on a server that remains continuously available. If the server is shut down, the connection between SAP Self-Billing Cockpit and SAP S/4HANA will break. For details, see Cloud Connector for SAP BTP Connectivity.
| Region | Europe(Frankfurt) – AWS cf.eu10.hana.ondemand.com |
| Subaccount | <Your subaccount ID> |
| Display Name | By yourself |
| Login E-Mail | <Your subaccount user> |
| Password | <Your subaccount user password> |
| Location ID | Don’t need to maintain |
| Description | By yourself |
SMICM → GOTO → Services.
SAP S/4HANA ports:Go to the Transaction SMICM. Choose from the menu “GOTO -> Services”.You can find the ports and host information.
/ for all resources) or define specific allowed paths.
OData | /sap/opu/odata/sap/API_BILLING_DOCUMENT_SRV |
OData | /sap/opu/odata/sap/API_BUSINESS_PARTNER |
OData | /sap/opu/odata/sap/API_OUTBOUND_DELIVERY_SRV;v=0002 |
OData | /sap/opu/odata/sap/API_PRODUCT_SRV |
OData | /sap/opu/odata/sap/API_SALESORGANIZATION_SRV |
OData | /sap/opu/odata/sap/API_SALES_DOCUMENT_REASON_SRV |
OData | /sap/opu/odata/sap/API_SD_SA_SOLDTOPARTYDETN |
OData | /sap/opu/odata/sap/API_SUBSQNT_BILLG_DOC_SBI_SRV |
OData | /sap/opu/odata/sap/API_COMPANYCODE_SRV |
SOAP | The value of the additional property CREATE_BILLING_URL_PATH configured in the destination |
SOAP | The value of the additional property UPDATE_JE_URL_PATH configured in the destination |
SOAP | The value of the additional property UPDATE_BILLING_URL_PATH configured in the destination |
SOAP | The value of the additional property SIMULATE_PRICING_PATH configured in the destination |
OData | /sap/opu/odata/sap/API_BILLING_DOCUMENT_SRV |
OData | /sap/opu/odata/sap/API_BUSINESS_PARTNER |
OData | /sap/opu/odata/sap/API_OUTBOUND_DELIVERY_SRV;v=0002 |
OData | /sap/opu/odata/sap/API_PRODUCT_SRV |
OData | /sap/opu/odata/sap/API_SALESORGANIZATION_SRV |
OData | /sap/opu/odata/sap/API_SALES_DOCUMENT_REASON_SRV |
OData | /sap/opu/odata/sap/API_SD_SA_SOLDTOPARTYDETN |
OData | /sap/opu/odata/sap/API_SUBSQNT_BILLG_DOC_SBI_SRV |
OData | /sap/opu/odata/sap/API_CREDIT_MEMO_REQUEST_SRV |
OData | /sap/opu/odata/sap/API_DEBIT_MEMO_REQUEST_SRV |
OData | /sap/opu/odata/sap/API_COMPANYCODE_SRV |
SOAP | The value of the additional property CREATE_BILLING_URL_PATH configured in the destination |
SOAP | The value of the additional property CREATE_INVOICE_URL_PATH configured in the destination |
SOAP | The value of the additional property SIMULATE_PRICING_PATH configured in the destination |
SELFB_DEST_S4HANA (must match exactly)SAP_CLIENT
Create role collections in SAP BTP and assign the recommended roles:
SAP_BR_ADMINISTRATORSAP_SELFB_CLERKSAP_SELFB_CR_APISAP_SELFB_TR_APIAssign these collections to your technical and business users as required.
This section covers:
DRFIMGDRFOUT and SM36This guide explains how to configure, execute, and optionally schedule master data replication from SAP S/4HANA to SAP Self-Billing Cockpit
Follow these steps for each object, using its specific service name and endpoint path.
Log on to SAP S/4HANA and run SOAMANAGER.
Navigate to Service Administration → Web Service Configuration.
Search for the required service (listed below).
Choose Create → Manual Configuration.
Enter a logical port name and description.
Mark the port as default, then choose Next.
Under Consumer Security:
Set Authentication: User ID / Password
Enter the SAP BTP technical user credentials
Click Next
Under HTTP Settings → URL Components, configure:
Protocol: HTTPS
Host: <subdomain>.eu10.selfbilling.cloud.sap
Port: 443
Path: (see table below)
Under SOAP Protocol:
RM Protocol: SAP RM
Message ID Protocol: SAP Message ID
Data Transfer Scope: Minimal Data Transfer
Transfer Protocol: Transfer via HTTP header
Activate and save the logical port as the default port.
| Units of Measurement | UNITOFMEASUREMENTMASTERDATAREPLICATIONBUNDLEREQUEST_OUT | /api-password/selfbilling-core-service/v1/erpintegration/data/UnitOfMeasurementMasterDataReplicationBundleRequest_In |
| Plants | PLANTMASTERDATAREPLICATIONBUNDLEREQUEST_OUT | /api-password/selfbilling-core-service/v1/erpintegration/data/plantsSync |
Note:
If using a custom identity provider, append:?login_hint=%7B%22origin%22%3A%22sap.custom%22%7D
to the end of the path.
Steps below apply to both UoM and Plant models, with only the implementation differing.
Run DRFIMG.
Navigate to:
Data Replication → Define Custom Settings for Data Replication → Define Replication Models
Choose New Entries and create:
A replication model name (e.g., UOM_999, PLANT_999)
A description
Save the model.
Select the model → choose Assign Outbound Implementation.
Choose New Entries, assign outbound implementation (see table below).
Select the outbound implementation → choose
Assign Target Systems for Repl. Model / Outb. Impl.
Add a new entry with your business system name.
(For UoM only) Assign outbound parameters if required.
Return and activate the replication model.
| Units of Measurement | ARIBA_999 |
| Plants | LMDR_PLANT |
Use this single process for both UoM and Plant models.
Run DRFOUT.
Select:
The replication model created earlier
The corresponding outbound implementation
Set Replication Mode = Manual.
Execute data replication.
Ensure the SAP Self-Billing Cockpit subscription is active.
The SAP BTP technical user must have the role:
SAP_BR_ADMINISTRATOR
Trigger manual replication whenever master data is updated before the scheduled job runs.
After executing replication, return to the selection screen.
Save the selection as a variant.
Enter:
Variant name
Description
Save.
(Repeat once for UoM and once for Plant replication.)
This procedure is identical for both replication models.
Run SM36.
Choose Job Wizard.
Provide:
Job Name
ABAP Program: RDRF_MESSAGE_OUT
Variant: Select the variant (UoM or Plant)
Set scheduling frequency
Save and activate the job.
Monitor under Own Jobs
The steps are similar for Units of Measurement and Plants; only the specific service names and outbound implementations differ.
Key tasks:
SOAMANAGER./AIF/CONTENT_EXTRACT to extract deployment scenario SAP_COM_0002.Log on to your SAP S/4HANA system and run transaction SOAMANAGER to open the SOA Manager.
Navigate to Service Administration → Web Service Configuration.
Search for the object JOURNALENTRYBULKCHANGEREQUEST_ and select the result.
Choose Create Service to create a binding.
In the Provider Security tab:
Set Transport Level Security to SSL (HTTPS).
Set Transport Channel Authentication to User ID / Password.
Activate the binding.
Run transaction SOAMANAGER again.
Navigate to Service Administration → Web Service Configuration.
Search for the object CO_FINS_JOURNAL_ENTRY_BULK_CHA and select the result.
Under Create, choose Manual Configuration.
Enter a logical port name and description, mark it as the default logical port, and note the port name for later use.
On the Consumer Security tab:
Select User ID / Password as the authentication method.
Enter the User Name and Password of the technical user created in SAP BTP.
On the HTTP Settings tab:
Protocol: HTTPS
Host: <subdomain>.eu10.selfbilling.cloud.sap
Port: 443
Path: /api-password/selfbilling-confirmation-service/v1/api/JournalEntryBulkChangeConfirmation_In
Keep all other fields as default.
Note:
If you use a custom identity provider (instead of SAP ID service), append the following to the end of the path:?login_hint=%7B%22origin%22%3A%22sap.custom%22%7D
On the SOAP Protocol tab:
RM Protocol: SAP RM
Message ID Protocol: Suppress ID Transfer
Data Transfer Scope: Minimal Data Transfer
Transfer Protocol: Transfer via HTTP Header
Choose Next and complete the configuration.
In SAP S/4HANA, run transaction SPRO.
Navigate to:
SAP Reference IMG → Financial Accounting → Financial Accounting → Global Settings → API Settings for API Monitoring → Map External System and Logical Port
Choose New Entries and maintain the following:
External System ID: Your BTP subaccount tenant ID
Logical Port: The outbound logical port created earlier
Run transaction /AIF/CONTENT_EXTRACT.
Extract deployment scenario SAP_COM_0002.
This section includes:
SOAMANAGER.Log on to your SAP S/4HANA system and run transaction SOAMANAGER to open the SOA Manager.
Navigate to Technical Administration → Profile, then choose Create Profile.
On the General tab, enter a profile name and choose Next.
On the Security tab:
Set Transport Level Security to SSL (HTTPS).
Set Transport Channel Authentication to User ID / Password.
Choose Next, then Finish.
Activate the profile.
In SOAMANAGER, go to Service Administration → Pending Tasks.
Choose Switch to Expert Mode.
Choose Filter by Profile and Version, select the profile you created, and set Version = 1.
Choose Rebuild List to refresh the pending-task list for that profile.
Choose Process List and verify that all tasks were processed successfully.
In SOAMANAGER, navigate to Technical Administration → Provider Systems.
Choose Create Special → Create Third-Party System.
On the General tab:
Enter a system name (use the tenant ID of your BTP subaccount).
Select the security profile you created.
Choose Next.
On Services Search Settings, enter the SAP S/4HANA credentials that WSIL will use, then choose Check to verify authentication.
Return to the provider systems list, select the provider system you created, and choose Edit.
On the WSDL Assignments tab, choose Upload and upload the outbound WSDL files you downloaded from the API Hub.
Important: Before uploading, update any host/subdomain placeholders in the WSDL files to match your environment (<subdomain>.eu10.selfbilling.cloud.sap, or your custom host).
If you use a custom identity provider instead of the SAP ID service, append the following to each service path:
?login_hint=%7B%22origin%22%3A%22sap.custom%22%7DContinue through the wizard and activate the provider system.
If you see a connection-check warning when validating the provider system, it is often a transient or expected message depending on your network/WSIL setup — you can ignore it if other checks pass and WSDLs upload successfully.
In SOAMANAGER, go to Service Administration → Logon Data Management.
Create logon data entries with the Authentication Method set to User/Password (or X.509 as required) and store the credentials. Save your changes.
Open the Assignments tab and choose Create.
For Provider IBC Reference, select the provider system you defined earlier. Choose Restrict to Service Group / Consumer Factory and enter the service group:
SDBIL_SBI_BD_UPD_API_OUT Choose Next, select the logon data you created, and choose Finish.
Repeat the assignment (steps 3–5) for these service groups:
SDBIL_SBI_CDM_API_OUT
SDBIL_SBI_SMLTE_API_OUT
SDBIL_SBI_BD_CREATE_API_OUT
In SOAMANAGER, go to Service Administration → Local Integration Scenario Configuration and create a new integration scenario.
On the Service Definitions tab, add the inbound services and assign the security profile you created:
BD_UPDATE_SBI_REQUEST_IN
CREDITDEBITMEMOREQUEST_IN
BDSIMULATEPRICINGREQUEST_IN
BDCREATESELFBILLINGREQUEST_IN
Then choose Next.
Add the outbound service groups and set the Provider IBC Reference to the provider system you created:
SDBIL_SBI_BD_UPD_API_OUT
SDBIL_SBI_CDM_API_OUT
SDBIL_SBI_SMLTE_API_OUT
SDBIL_SBI_BD_CREATE_API_OUT
For Logon Data, select the logon entry you created earlier.
Confirm and activate the integration scenario.
In SOAMANAGER → Service Administration → Pending Tasks, switch to Expert Mode.
Choose Filter by Business Scenario, and enter the integration scenario name you created.
Choose Process List — this creates the logical ports and other objects defined by the scenario.
Run transaction /AIF/CONTENT_EXTRACT and extract the deployment scenario SAP_COM_0564.
Run transaction SPRO.
Navigate to:
SAP Reference IMG → Cross-Application Components → Processes and Tools for Enterprise Applications → Enterprise Services → Point-to-Point Enablement for Asynchronous Enterprise Services → Activate Support for Point2Point Communication Activate support if it is not already enabled.
Download the WSDLs for these services from the API Hub and upload them to your provider system. Update host/subdomain placeholders before upload.
CreditDebitMemoConfirmation_Out | Yes | Yes | Used in versions earlier than S/4HANA 2020 FPS02 |
CreditDebitMemoConfirmation_Out_V2 | Yes | Yes | Use for S/4HANA 2020 FPS02 or later |
BD_Update_SBI_Confirmation_Out | No | Yes | |
BDSimulatePricingConfirmation_Out | Yes | Yes | |
BDCreateSelfBillingConfirmation_Out | Yes | No |
SBINV / SBWAP columns indicate whether each API is present for standard Self-Billing (SBINV) and Self-Billing with Adjustment Processing (SBWAP) scenarios.
Add the following properties to the destination:
| Name | Value | Remark |
| CREATE_BILLING_URL_PATH | Path of the API for creating credit memos or debit memos in your SAP S/4HANA system | |
| UPDATE_JE_URL_PATH | Path of the API for updating journal entries in your SAP S/4HANA system | Only for SBWAP |
| UPDATE_BILLING_URL_PATH | Path of the API for updating billing documents in your SAP S/4HANA system | Only for SBWAP |
| CREATE_INVOICE_URL_PATH | Path of the API for creating invoices in your SAP S/4HANA system | Only for SBINV |
| SIMULATE_PRICING_PATH | Path of the API for pricing simulation in your SAP S/4HANA system | |
| UI_BILLING_PATH | It is in the format of https://<host>/sap/bc/ui5_ui5/ui2/ushell/shells/abap/FioriLaunchpad.html#BillingDocument-displayFactSheet&/C_BillingDocumentFs('%s'), where <host> is your host name. | |
| UI_SALES_ORDER_PATH | It is in the format of https://<host>/sap/bc/ui5_ui5/ui2/ushell/shells/abap/FioriLaunchpad.html#SalesOrder-displayFactSheet&/C_SalesorderFs('%s'), where <host> is your host name. | |
| UI_DELIVERY_PATH | It is in the format of https://<host>/sap/bc/ui5_ui5/ui2/ushell/shells/abap/FioriLaunchpad.html#OutboundDelivery-displayFactSheet&/C_OutboundDeliveryFs('%s'), where <host> is your host name. | |
| UI_CMR_PATH | It is in the format of https://<host>/sap/bc/ui5_ui5/ui2/ushell/shells/abap/FioriLaunchpad.html?sap-client=<sap client>#CreditMemoRequest-display?CreditMemoRequest=%s, where <host> is your host name and <sap client> is the client number of your SAP S/4HANA system. | |
| UI_DMR_PATH | It is in the format of https://<host>/sap/bc/ui5_ui5/ui2/ushell/shells/abap/FioriLaunchpad.html?sap-client=<sap client>#DebitMemoRequest-display?DebitMemoRequest=%s, where <host> is your host name and <sap client> is the client number of your SAP S/4HANA system. | |
| SAP_CLIENT | Client number of your SAP S/4HANA system. |
To obtain the correct paths, use SOAMANAGER → Web Service Configuration and check the Calculated Access URL for each service binding.
Follow the steps below to obtain the endpoint paths required for configuring billing-related services in your SAP S/4HANA system.
Log on to your SAP S/4HANA system and run transaction SOAMANAGER to open the SOA Manager.
In the Service Administration section, choose Web Service Configuration.
Search for the object named JOURNALENTRYBULKCHANGEREQUEST_ and open the result.
Select the service that you created for updating journal entries and display its Binding.
Choose Transport Settings and note the value in Calculated Access URL.
This represents the API endpoint for updating journal entries.
→ Assign this value to the property UPDATE_JE_URL_PATH.
Repeat Steps 1–3 above for each of the following services, and assign the extracted Calculated Access URL to the corresponding property name.
| Service for updating billing documents | UPDATE_BILLING_URL_PATH | BD_UPDATE_SBI_REQUEST_IN |
| Service for creating billing documents | CREATE_BILLING_URL_PATH | CREDITDEBITMEMOREQUEST_IN |
| Service for simulating pricing | SIMULATE_PRICING_PATH | BDSIMULATEPRICINGREQUEST_IN |
| Service for invoice creation | CREATE_INVOICE_URL_PATH | BDCREATESELFBILLINGREQUEST_IN |
This section explains how to validate your integration configuration. The example below uses the service for updating journal entries, but the same approach applies to other related services.
Log on to your SAP S/4HANA system and run transaction SOAMANAGER to open the SOA Manager.
Under Service Administration, choose Web Service Configuration.
Search for the object CO_FINS_JOURNAL_ENTRY_BULK_CHA and open the result.
Select the service you created for updating journal entries and choose Ping Web Service.
If the response shows HTTP 405, the integration setup is correct.
Repeat the steps above to ping and validate the following services in your SAP S/4HANA system:
| Purpose | Object Name |
| Service for updating billing documents | SDBIL_SBI_BD_UPD_API_OUT |
| Service for creating billing documents | SDBIL_SBI_CDM_API_OUT |
| Service for simulating prices | SDBIL_SBI_SMLTE_API_OUT |
| Service for invoice creation | SDBIL_SBI_BD_CREATE_API_OUT |
You can further validate the configuration of OData services and the destination by performing a check through the API.
Open Postman and create a GET request.
Enter the following URL: https://<subdomain>/api-password/selfbilling-customizing-service/v1/api/check
Replace <subdomain> with the subdomain of your BTP subaccount.
Go to Authorization, set Type = Basic Auth, and enter the username and password of the technical user assigned with the SAP_BR_ADMINISTRATOR role.
Execute the request.
Expected Result:
All items under odataCheck return “200 OK”
Configuration Missing under additionalCheck is empty
If both conditions are satisfied, your integration setup is correct.👌
• SAP Self-Billing Cockpit Product Documentation
• SAP Self-Billing Cockpit on SAP Store
You must be a registered user to add a comment. If you've already registered, sign in. Otherwise, register and sign in.
| User | Count |
|---|---|
| 21 | |
| 18 | |
| 17 | |
| 10 | |
| 9 | |
| 9 | |
| 8 | |
| 7 | |
| 7 | |
| 7 |