This Partner Reference Application repository provides you with a “golden path” to becoming a SaaS provider of multi-tenant applications based on the SAP Business Technology Platform (SAP BTP).
The guidance covers building, running, and integrating scalable full-stack cloud applications. It includes an ERP-agnostic design that lets you deliver your application as a side-by-side extension to consumers using any SAP solution, such as SAP S/4HANA Cloud, SAP Business One, and SAP Business ByDesign.
By using SAP BTP services and the SAP Cloud Application Programming Model (CAP), your application meets SAP standards for enterprise-class business solutions. It offers a harmonized user experience and seamless integration, including:
- centralized identity and access management,
- a common launchpad,
- cross-application front-end navigation,
- and secure back-channel integration.
The repository includes the “Poetry Slam Manager” application as a ready-to-run example. It also provides tutorials on how to build the application from scratch using an incremental development approach.
Based on this sample application, you will find the bill of materials and a sizing example. This addresses the question "Which BTP resources do I need to subscribe to and in what quantities?" and serves as a basis for cost calculation.
Imagine you're an event manager, for example, Peter, and your job is to organize and host poetry slams.
As your company runs its business on a cloud ERP system provided by SAP, you use its project management component to plan and staff events, to collect costs, and to purchase equipment. Additionally, an SAP partner provided you with a side-by-side application called Poetry Slam Manager (PSM) to publish poetry slam events and to manage bookings of visitors and artists such as Julie.
For security and compliance reasons, it's crucial to you that event publishing and visitor registration are clearly separated from your ERP system. Nevertheless, as a power user working in both systems, you asked the partner to ensure a seamless user experience and navigation between the SAP system and Poetry Slam Manager.
The sample showcases how a side-by-side application benefits from using SAP BTP. The qualities relevant for enterprise-grade partner applications, supported by SAP BTP services and programming models, include:
Upcoming versions of the sample application might include further features provided by the SAP BTP:
- Create and change poetry slam events, publish, and cancel poetry slams.
- Maintain, add, and remove visitors, cancel bookings.
- Calculate the number of free seats and block overbookings.
- Create projects for poetry slam events with one click and preview project information on the Poetry Slam Manager UI (here, ERP authorizations apply in the partner application as well).
- Create and print a guest list.
- Utilize artificial intelligence capabilities to generate innovative titles and descriptions for poetry slams.
- As an ERP user, start Poetry Slam Manager from your ERP launchpad and navigate from Poetry Slam Manager to the associated project in the ERP system.
- Make use of a standardized online development environment using SAP Business Application Studio.
- Use a state-of-the-art web application architecture based on HTML5, Node.js, and SAP HANA Cloud.
- Make use of a model-driven development based on the SAP Cloud Application Programming (CAP) Model, core data services (CDS), and SAP Fiori elements.
- Offer a user experience that matches the SAP standard due to standard floorplan patterns, and out-of-the-box theming and personalization.
- Provide a centralized launchpad that streamlines access to applications, offering a consistent user experience through predefined layout templates and navigation patterns.
- Use a draft concept to allow users to change data in multiple steps without having to publish incomplete changes.
- Benefit from enterprise-grade security by authentication and role-based authorizations in line with SAP product standards and technology alignments.
- Have enterprise-ready compliance by personal data management and audit log.
- Offer seamless and secure front-end and back-channel integration with SAP ERP solutions.
- Deliver open solutions by integration-ready OData APIs and business events following SAP technology alignments.
- Deploy the app as a multi-customer solution.
- Analyze and monitor logging data of the customer deployment.
Join our community!
Would you like to share your own ideas and best practices? Join our discussions about the Partner Reference Application in our SAP Community.
The application is based on SAP Business Technology Platform (SAP BTP) and SAP ERP solutions. Therefore, here's what you need:
- An SAP BTP account, which includes SAP Business Application Studio as a standardized development environment,
- GitHub as your code repository, and
- an SAP ERP system.
To get a more detailed list of the required entitlements, the proposed structure of subaccounts for the deployed Partner Reference Application, and the scaling effects of the multi-tenant solution, go to the Bill of Materials.
This repository explains the development journey along the path from
- development of the core application,
- enhancement to a multi-customer ("multi-tenant") solution,
- integration with different ERP back ends,
- extension with additional features,
- enablement of the application for third-party integrations and extensibility.
A complete and working implementation of the above steps is available in separate branches:
- Core application and multi-tenant deployment: branch main-multi-tenant
- Additional features (based on the multi-tenant implementation): branch main-multi-tenant-features
This allows you to check out those branches and directly work with the respective implementation. You can use GitHub comparisons to understand the changes required along the development journey.
The tutorials are provided in the (main) branch. If you prefer a quick start with a deployment of the poetry slam manager application including all features without further explanation, follow the quick start guide.
Updates to this repository are documented in the change history.
-
Develop the core application focusing on business models, business logic, and UI:
-
Enhance the application for multi-tenant deployments to support multiple customers using shared SAP BTP resources:
- Learn about multitenancy and get an overview of the bill of materials
- Prepare your SAP BTP account for multi-tenant deployment
- Enhance the core application for deployment
- Deploy your SAP BTP multi-tenant application
- Provision your multi-tenant application to consumer subaccounts
- Go on a guided tour to explore the capabilities of the deployed sample application
- Test and troubleshoot multitenancy
- Estimate the required size of the SAP HANA Cloud database
- Estimate the required Cloud Foundry Environment configuration
-
Integrate the application with SAP ERP solutions:
- SAP Business One:
- SAP S/4HANA Cloud Public Edition:
- SAP Business ByDesign:
- Test and troubleshoot an ERP integration
- Go on a guided tour to explore the ERP integration
-
Add additional features and capabilities to your SAP BTP application:
- Manage data privacy
- Observability: logging, metrics, and tracing
- Add capabilities for output management to your application:
- Add capabilities for generative artificial intelligence (GenAI)
-
Enable the application for third-party integrations and extensibility:
- Open the APIs of the SAP BTP application for third-party integrations:
- Enable consumer-specific extensions
- SAP BTP Developer’s Guide
- SAP Cloud Application Programming Model
- SAP Cloud SDK
- SAP Discovery Center
- What's New for SAP Business Technology Platform
- SAP HANA Cloud Administration Guide
There aren't any known issues.
This repository is provided "as-is", we don't offer support. For questions and comments, join the SAP Community.
Copyright (c) 2025 SAP SE or an SAP affiliate company. All rights reserved. This project is licensed under the Apache Software License, version 2.0 except as noted otherwise in the LICENSE file.