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.
Showing results for 
Search instead for 
Did you mean: 
Product and Topic Expert
Product and Topic Expert

Integrate the ABAP environment of the SAP Business Technology Platform with SAP S/4HANA Cloud in a few clicks and some oldskool copy 'n paste.

In this blog post you will find the tutorial video embedded with references and additional information.

For the related blog posts, visit

Questions? Please post as comment.

Useful? Give us a like and share on social media.


Hands-On Video Tutorials

What You Will Learn

In the video we cover how to prepare the SAP S/4HANA Cloud tenant to accept connections from the SAP Business Technology Platform (BTP) ABAP environment using OAuth, how to configure a destination in your BTP subaccount pointing to SAP S/4HANA Cloud, and what objects you need to create and code to write to make the API calls.


To follow along, you'll need

  • SAP S/4HANA Cloud tenant with an account privileged to create a communication arrangement (SAP_CORE_BC_COM)

  • SAP BTP ABAP Environment with an account authorized to create destinations

  • ABAP Development Tools (ADT)

Code Sample

For the code sample used in this tutorial and a step-by-step description of the ABAP development activities, visit the SAP Development Center

Integrating the ABAP Environment with SAP S/4HANA Cloud

In this short video tutorial, we cover the concepts, configure the communication arrangement, the destination, and showcase the code sample.


0:00 - Introduction and documentation

3:00 - Download Trust from SAP BTP Subaccount Destinations

4:00 - Create communication arrangement in SAP S/4HANA Cloud

4:40 - Upload signing certificate to the communication system

5:10 - Get URL of ABAP environment

5:45 - Create communication user for inbound communication

7:25 - Get hostname of inbound service URL (OData) and OAuth 2.0 details

8:00 - Create new destination for the SAP BTP subaccount

9:10 - Using ADT, create a service consumption model 

9:25 - Get API EDMX from SAP API Business Hub

10:00 - Create HTTP service

10:25 - Create business partner using API call

10:45 - Verification in SAP S/4HANA Cloud


Administration Activities

For this scenario, we need to create a communication arrangement with communication system and user on our SAP S/4HANA tenant. For the OAuth 2.0 trust, we need to update a signing key that we can download from our SAP BTP subaccount.

The illustration below shows the administration activities. Previously, it was required to create a service instance of the destination service, create a service key for this instance, and create a communication arrangement in the ABAP environment. This is no longer required and a destination defined at the subaccount suffices (not shown here).

To call the API, as developer, we need to create a service definition using the metadata from the SAP S/4HANA Cloud tenant (or the SAP API Business Hub, alternatively) and an HTTP Service with API handler.

The figure below shows the configuration of the OAUTH2SAMLBearerAssertion destination. Time of writing, the configuration requires the copy and paste of a number of settings from the communication arrangement of the SAP S/4HANA Cloud tenant, as documented

The figure below shows the generated service consumption model from the EDMX. The model is references in the HTTP service object.

The figure below shows the HTTP Service with the handler class (for the sample code see the tutorial) and URL.

The user calling the URL needs to the master data specialist business partner data role (BR_BUPA_MASTER_SPECIALIST).

Additional Resources 

SAP Help Portal

For the documentation of the procedure, visit

For more information about communication arrangements, see

For more information about extending SAP S/4HANA Cloud, see

For more information about the Business Partner API, visit

SAP API Business Hub

To download the EDMX for the API and learn more about the different APIs and entities, see

Share and Connect

Questions? Please post as comment.

Useful? Give us a like and share on social media.


If you would like to receive updates, connect with me on

For the author page of SAP PRESS, visit

Over the years, for the SAP HANA Academy, SAP’s Partner Innovation Lab, and à titre personnel, I have written a little over 300 posts here for the SAP Community. Some articles only reached a few readers. Others attracted quite a few more.

For your reading pleasure and convenience, here is a curated list of posts which somehow managed to pass the 10k-view mile stone and, as sign of current interest, still tickle the counters each month.