SAP-samples/partner-reference-application

Partner Reference Application 'Poetry Slam Manager'

Description

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 Public Edition, 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.

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.

About the Sample Application Poetry Slam Manager

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.

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.

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.

Requirements

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 (a trial account is not sufficient),
• GitHub as your code repository, and
• an SAP ERP system.

The partner reference application targets SAP partners. To learn more about becoming an SAP partner, see the partner program of SAP. However, the tutorials also work for multi-tenant applications of SAP customers.

Overview

This repository explains the development journey along the path as shown in the picture:

A complete and working implementation of the above steps is available in separate branches:

1. Core application and multi-tenant deployment: branch main-multi-tenant
2. 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.

Tutorials

0. Getting started:

   1. Bill of Materials: Learn about the required entitlements and the proposed structure of subaccounts
   2. Learn more about the architecture of the sample application
   3. Prepare your SAP BTP account for development

1. Develop the core application focusing on business models, business logic, and UI:

   1. Develop the core of the SAP BTP application
      1. Develop the domain model and the business logic with SAP Cloud Application Programming Model
      2. Develop the user interface with SAP Fiori elements
      3. Enhance the business solution with translation and authorization
   2. Go on a guided tour to explore the capabilities of the sample application
   3. Ensure code quality, test, and troubleshoot the application

2. Enhance the application for multi-tenant deployments to support multiple customers using shared SAP BTP resources:

   1. Learn about multitenancy and get an overview of the bill of materials
   2. Prepare your SAP BTP account for multi-tenant deployment
   3. Enhance the core application for deployment
   4. Deploy your SAP BTP multi-tenant application
   5. Provision your multi-tenant application to consumer subaccounts
   6. Go on a guided tour to explore the capabilities of the deployed sample application
   7. Test and troubleshoot multitenancy

3. Integrate the application with SAP ERP solutions:

   1. SAP Business One:
      1. Learn more about the prerequisites and the purpose of SAP Business One integration
      2. Integrate the SAP BTP application with SAP Business One
      3. Configure the integration with SAP Business One
   2. SAP S/4HANA Cloud Public Edition:
      1. Learn more about the prerequisites and the purpose of SAP S/4HANA Cloud Public Edition integration
      2. Integrate the SAP BTP application with SAP S/4HANA Cloud Public Edition
      3. Configure the integration with SAP S/4HANA Cloud Public Edition
   3. SAP Business ByDesign:
      1. Learn more about the prerequisites and the purpose of SAP Business ByDesign integration
      2. Integrate the SAP BTP application with SAP Business ByDesign
      3. Configure the integration with SAP Business ByDesign
   4. Test and troubleshoot an ERP integration
   5. Go on a guided tour to explore the ERP integration

4. Add additional features and capabilities to your SAP BTP application:

   1. Manage data privacy with the SAP Audit Log service
   2. Observability: logging, metrics, and tracing using SAP Cloud Logging service
   3. Add capabilities for output management to your application:
      1. Manage forms with the SAP Forms service by Adobe
      2. Print documents using the SAP Print service
   4. Send notifications and emails with SAP Build Work Zone
   5. Add capabilities for generative artificial intelligence (GenAI) using SAP AI Core service
   6. Schedule jobs and add background execution with the SAP Job Scheduling service
   7. Store Attachments using SAP Document Management service

5. Enable the application for third-party integrations and extensibility:

   1. Open the APIs of the SAP BTP application for third-party integrations:
      1. Enable API access to SAP BTP applications using service broker
      2. Configure and consume the APIs of the SAP BTP application
      3. Create an API service for remote integrations without draft handling
   2. Embed the application in a SAP S/4HANA Cloud Public Edition developer extensibility scenario:
      1. Enhance the application to look up the latest sales order information
      2. Configure the connection with SAP S/4HANA Cloud Public Edition
   3. Enable the application for extensibility:
      1. Enable consumer-specific extensions
      2. Enable business logic extensions
   4. Enable key user flexibility using SAP Build Work Zone

6. Operational aspects of multi-tenant SaaS applications

   1. Upgrading multi-tenant SaaS applications
   2. Estimate the required size of the SAP HANA Cloud database
   3. Estimate the required Cloud Foundry environment configuration
   4. Estimate the SAP Cloud Logging Service Consumption
   5. Capabilities of SAP Continuous Integration and Delivery Service

More Information

• SAP Build: Learn more about SAP Build product capabilities, use cases, and customer stories.
• SAP Build Learning: Learn how to extend SAP applications by building AI agents, developing applications with or without code, automating processes, and offering digital workspaces.
• SAP Build Trial: Start your free trial of SAP Build.
• SAP BTP Developer’s Guide: Introduction to the SAP BTP Developer’s Guide. The starting point for developing a business application on SAP BTP.
• SAP Cloud Application Programming Model: Build enterprise-grade cloud applications with maximized productivity, fueled by proven best practices, served out of the box.
• SAP Cloud SDK: The one-stop shop for developing and extending SAP applications in the cloud.
• SAP Discovery Center: Implement your use cases on SAP BTP, with step-by-step guidance and a well-established support from topic experts and SAP Community.
• What's New for SAP Business Technology Platform: Get an overview of the new and changed features for SAP BTP.
• SAP HANA Cloud Administration Guide: This guide describes how to create and configure SAP HANA Cloud instances using SAP HANA Cloud Central and the command line interface.
• SAP Partner Program: The SAP PartnerEdge program offers four simple engagement models – Build, Sell, Service, and Run.

The partner reference application family:

• Partner reference application for a tenant-specific extension: Explore the Partner Reference Application Extension “Catering Management” and realize customer-specific extensions in multi-tenant applications.
• Partner reference application for a cross-stack extension: Explore the Cross-Stack Partner Reference Extension “Poetry Slam Event Commerce” and combine SAP S/4HANA Cloud Public Edition on-stack extensions with SAP BTP-based multi-tenant solutions.
• Partner Reference Application using ABAP RESTful Application Programming Model (RAP): Explore the ABAP Partner Reference Application “Music Festival Manager” and learn how to develop multi-tenant solutions on the SAP BTP ABAP Environment.

Known Issues

There aren't any known issues.

Get Support

This repository is provided "as-is", we don't offer support. For questions and comments, join the SAP Community.

License

Copyright (c) 2026 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.

Disclaimer

This repository contains sample code provided “as is” for instructional purposes only. SAP makes no warranties and accepts no liability, except in cases of gross negligence or willful misconduct. All included data is fictitious and contains no real personal, confidential, or sensitive information. Do not use this tutorial app productively with real personal data. SAP is not responsible if anyone uses it to capture personal data.