---
parser: v2
auto_validation: true
time: 20
tags: [tutorial>advanced, topic>cloud, products>sap-business-technology-platform, software-product>sap-btp--cloud-foundry-runtime-and-environment]
primary_tag: products>sap-business-technology-platform
slug: opps-advanced-scenario-additional-bonus
canonical_url: https://developers.sap.com/tutorials/opps-advanced-scenario-additional-bonus
---

# Apply an Additional Bonus with SAP Omnichannel Promotion Pricing
<!-- description --> Set up an additional bonus as a reward for your customers with SAP Omnichannel Promotion Pricing.

## Prerequisites
- You have completed the tutorial [Apply a Simple Promotion with SAP Omnichannel Promotion Pricing](opps-basic-scenario) and [Apply a Mix-and-Match Promotion with SAP Omnichannel Promotion Pricing](opps-advanced-scenario-mixandmatch).
- You have registered for a trial account on [SAP BTP](hcp-create-trial-account) in the Singapore - Azure region.
- You should be familiar with the SAP BTP trial landscape and terminology (see [Take a Tour of SAP BTP Trial](cp-trial-quick-onboarding)).
- You have a subaccount in the Cloud Foundry environment, with Microsoft Azure as provider and the Singapore region (AP21).
- You have set up SAP Omnichannel Promotion Pricing as described in [Set Up SAP Omnichannel Promotion Pricing](opps-manual-setup).


## You will learn
- How to use the SAP Omnichannel Promotion Pricing trial on SAP BTP
- How to upload a **promotional rule with an additional bonus** with the help of the SAP Business Accelerator Hub
- How to execute a calculation request that includes an additional bonus with SAP Omnichannel Promotion Pricing


---

### Get to know the business scenario


An additional bonus is a reward in the form of one or more free products that customers receive if certain predefined triggers are met. An additional bonus only gives a recommendation for the client application to add the free products to the transaction. They are not added automatically to the transaction.

* Business goal: You want to promote the product **coffee machine** in your **Heidelberg** store (business unit ID: `FC01`). You have created the following promotion: **Buy one coffee machine and one bag of deluxe coffee to get one cleaning kit for free.**
* Your promotion is valid from **May 1st, 2021 until May 7th, 2021**.
* The **regular sales price** for the **coffee machine** (material number: `COFFEE_MACHINE`) is **500 Euro**.
* The **regular sales price** for one package of **deluxe coffee** (material number: `DELUXE_COFFEE`) is **10 Euro**.
* The **regular sales price** for one **cleaning kit** (material number: `CLEANING_KIT`) is **20 Euro**.
* A customer put one **coffee machine** and one package of **deluxe coffee** in the shopping cart.
* You call the Calculation service with the shopping cart information (store, products, date, time).
* The Calculation service includes the **cleaning kit** in the response, giving the recommendation for the client application to add it as a free product to the transaction.



<!-- ### Set up SAP Omnichannel Promotion Pricing


To use the SAP Omnichannel Promotion Pricing trial, you need to:

1. Subscribe to SAP Omnichannel Promotion Pricing
2. Set Up Roles and Authorizations
3. Create Service Instances
4. Create Service Keys

For step-by-step instructions, go to the tutorial [Set Up SAP Omnichannel Promotion Pricing](opps-manual-setup).
 -->


### Create environments in SAP Business Accelerator Hub


In order to continue with the next steps, you need to have already set up your trial environments for the Data Upload service, Data Access service, and Calculation service in the SAP Business Accelerator Hub. If you need guidance, have a look at step 2 of the tutorial [Apply a Simple Promotion with SAP Omnichannel Promotion Pricing](opps-basic-scenario).



### Upload master data - promotional rule


You can now upload the promotional rule that includes the additional bonus with the Data Upload service.

Navigate to the [Data Upload service of SAP Omnichannel Promotion Pricing on SAP Business Accelerator Hub](https://api.sap.com/api/DataUpload/resource). Log on with the same login information that you use for your SAP BTP account.

![Data Upload Regular Promotional Rule 1](https://raw.githubusercontent.com/sap-tutorials/Tutorials/master/tutorials/opps-advanced-scenario-additional-bonus/Data Upload Regular Promotional Rule 1.png)
![Data Upload Regular Promotional Rule 2](https://raw.githubusercontent.com/sap-tutorials/Tutorials/master/tutorials/opps-advanced-scenario-additional-bonus/Data Upload Regular Promotional Rule 1b.png)

1. For **API Environment**, select the trial environment you have created for the Data Upload service.
2. On the left-hand side, choose **Upload promotions using OAuth2**.
3. Open the **POST** request `/idocinbound`.
4. Choose **Try Out**.
5. For the **Request body**, choose `application/xml`.
6. Copy the following raw data and paste it into the body:
```XML
<?xml version="1.0" encoding="utf-8"?>
<_-ROP_-PROMOTION03>
    <IDOC BEGIN="1">
        <EDI_DC40 SEGMENT="1">
            <IDOCTYP>/ROP/PROMOTION02</IDOCTYP>          
        </EDI_DC40>
        <_-ROP_-E1_PROMOTION SEGMENT="1">
            <CHANGED_ON>20210505145958</CHANGED_ON>
            <CHANGE_INDICATOR>I</CHANGE_INDICATOR>
            <EFFECTIVE_DATE>20210501000000</EFFECTIVE_DATE>
            <EXPIRY_DATE>20210507235959</EXPIRY_DATE>
            <EXTERN_PROMO_ID>000000000000000000000000000000001001</EXTERN_PROMO_ID>
            <LOGSYS>ABCCLNT999</LOGSYS>
            <MIN_PPS_RELEASE>6000000</MIN_PPS_RELEASE>
            <OFFER_ID>42010AEE03C21EEB9AC2AE5E5D380D47</OFFER_ID>
            <ORIGIN>01</ORIGIN>
            <PROMOTION_ID>9103</PROMOTION_ID>
            <PROMOTION_TYPE>OPP</PROMOTION_TYPE>
            <STATUS_TCD>AC</STATUS_TCD>
            <_-ROP_-E1_PROMOTION_BU SEGMENT="1">
                <BU_ID>FC01</BU_ID>
                <BU_TYPE>1040</BU_TYPE>
            </_-ROP_-E1_PROMOTION_BU>
            <_-ROP_-E1_PROMOTION_RULE SEGMENT="1">
                <ELIGIBILITY_ID>9104</ELIGIBILITY_ID>
                <ONLY_BASKET_MODE>X</ONLY_BASKET_MODE>
                <PRICE_RULE_ID>9104</PRICE_RULE_ID>
                <PROMO_RULE_ID>9104</PROMO_RULE_ID>
                <RESOLUTION>1</RESOLUTION>
                <SALE_RETURN_TCD>00</SALE_RETURN_TCD>
                <SEQUENCE>9104</SEQUENCE>
                <RULE_NAME>PromoRule 9104</RULE_NAME>
                <_-ROP_-E1_ELIGIBILITY SEGMENT="1">
                    <COMBINATION_CODE>&amp;&amp;</COMBINATION_CODE>
                    <EFFECTIVE_DATE>20210501000000</EFFECTIVE_DATE>
                    <ELIGIBILITY_ID>9104</ELIGIBILITY_ID>
                    <EXPIRY_DATE>20210507235959</EXPIRY_DATE>
                    <INTERVAL_AMT>0.00000</INTERVAL_AMT>
                    <INTERVAL_QTY>0.000</INTERVAL_QTY>
                    <LIMIT_AMT>0.00000</LIMIT_AMT>
                    <LIMIT_QTY>0.000</LIMIT_QTY>
                    <MERCH_SET_ID>0</MERCH_SET_ID>
                    <PARENT_ELIGIB_ID>9104</PARENT_ELIGIB_ID>
                    <PROMO_RULE_ID>9104</PROMO_RULE_ID>
                    <ROOT_ELIGIB_ID>9104</ROOT_ELIGIB_ID>
                    <STATUS_TCD>AC</STATUS_TCD>
                    <THRESHOLD_AMT>0.00000</THRESHOLD_AMT>
                    <THRESHOLD_QTY>0.000</THRESHOLD_QTY>
                    <TRANS_TOTAL_AMT>0.00000</TRANS_TOTAL_AMT>
                    <TYPE_CODE>COMB</TYPE_CODE>
                </_-ROP_-E1_ELIGIBILITY>
                <_-ROP_-E1_ELIGIBILITY SEGMENT="1">
                    <EFFECTIVE_DATE>20210501000000</EFFECTIVE_DATE>
                    <ELIGIBILITY_ID>9105</ELIGIBILITY_ID>
                    <EXPIRY_DATE>20210507235959</EXPIRY_DATE>
                    <INTERVAL_AMT>0.00000</INTERVAL_AMT>
                    <INTERVAL_QTY>1.000</INTERVAL_QTY>
                    <ITEM_ID>COFFEE_MACHINE</ITEM_ID>
                    <LIMIT_AMT>0.00000</LIMIT_AMT>
                    <LIMIT_QTY>9999999999.000</LIMIT_QTY>
                    <MERCH_SET_ID>0</MERCH_SET_ID>
                    <PARENT_ELIGIB_ID>9104</PARENT_ELIGIB_ID>
                    <PROMO_RULE_ID>9104</PROMO_RULE_ID>
                    <ROOT_ELIGIB_ID>9104</ROOT_ELIGIB_ID>
                    <STATUS_TCD>AC</STATUS_TCD>
                    <THRESHOLD_AMT>0.00000</THRESHOLD_AMT>
                    <THRESHOLD_QTY>1.000</THRESHOLD_QTY>
                    <THRESHOLD_TCD>QUTI</THRESHOLD_TCD>
                    <TRANS_TOTAL_AMT>0.00000</TRANS_TOTAL_AMT>
                    <TYPE_CODE>ITEM</TYPE_CODE>
                    <UOM_ISO_CODE>PCE</UOM_ISO_CODE>
                </_-ROP_-E1_ELIGIBILITY>
                <_-ROP_-E1_ELIGIBILITY SEGMENT="1">
                    <EFFECTIVE_DATE>20210501000000</EFFECTIVE_DATE>
                    <ELIGIBILITY_ID>9106</ELIGIBILITY_ID>
                    <EXPIRY_DATE>20210507235959</EXPIRY_DATE>
                    <INTERVAL_AMT>0.00000</INTERVAL_AMT>
                    <INTERVAL_QTY>1.000</INTERVAL_QTY>
                    <ITEM_ID>DELUXE_COFFEE</ITEM_ID>
                    <LIMIT_AMT>0.00000</LIMIT_AMT>
                    <LIMIT_QTY>9999999999.000</LIMIT_QTY>
                    <MERCH_SET_ID>0</MERCH_SET_ID>
                    <PARENT_ELIGIB_ID>9104</PARENT_ELIGIB_ID>
                    <PROMO_RULE_ID>9104</PROMO_RULE_ID>
                    <ROOT_ELIGIB_ID>9104</ROOT_ELIGIB_ID>
                    <STATUS_TCD>AC</STATUS_TCD>
                    <THRESHOLD_AMT>0.00000</THRESHOLD_AMT>
                    <THRESHOLD_QTY>1.000</THRESHOLD_QTY>
                    <THRESHOLD_TCD>QUTI</THRESHOLD_TCD>
                    <TRANS_TOTAL_AMT>0.00000</TRANS_TOTAL_AMT>
                    <TYPE_CODE>ITEM</TYPE_CODE>
                    <UOM_ISO_CODE>PCE</UOM_ISO_CODE>
                </_-ROP_-E1_ELIGIBILITY>
                <_-ROP_-E1_PRICE_RULE SEGMENT="1">
                    <CALCULATION_BASE>00</CALCULATION_BASE>
                    <CALC_BASE_SEQUENCE>1-</CALC_BASE_SEQUENCE>
                    <CONSIDER_PREVIOUS_RULES>X</CONSIDER_PREVIOUS_RULES>
                    <COUPON_VALIDITY>0</COUPON_VALIDITY>
                    <CURRENCY_ISO_CODE>EUR</CURRENCY_ISO_CODE>
                    <DISC_METHOD_TCD>00</DISC_METHOD_TCD>
                    <EX_PRICE_RULE_ID>0000000000000000000</EX_PRICE_RULE_ID>
                    <ITEM_METHOD>00</ITEM_METHOD>
                    <MAM_LIMIT_CNT>0.000</MAM_LIMIT_CNT>
                    <NEW_PRICE_AMT>0.00000</NEW_PRICE_AMT>
                    <NEW_SET_PRCE_AMT>0.00000</NEW_SET_PRCE_AMT>
                    <PRICE_MODIF_AMT>0.00000</PRICE_MODIF_AMT>
                    <PRICE_MODIF_PERC>0.000</PRICE_MODIF_PERC>
                    <PRICE_RULE_ID>9104</PRICE_RULE_ID>
                    <ROUNDING_METHOD>00</ROUNDING_METHOD>
                    <ROUND_DECIMALS>2</ROUND_DECIMALS>
                    <ROUND_DESTINATION>1</ROUND_DESTINATION>
                    <RULE_CTRL_CODE>SP</RULE_CTRL_CODE>
                    <STATUS_TCD>AC</STATUS_TCD>
                    <SUBSEQ_NEW_PRICE_AMT>0.00000</SUBSEQ_NEW_PRICE_AMT>
                    <SUBSEQ_PRICE_MODIF_AMT>0.00000</SUBSEQ_PRICE_MODIF_AMT>
                    <SUBSEQ_PRICE_MODIF_PERC>0.000</SUBSEQ_PRICE_MODIF_PERC>
                    <TYPE_CODE>AB</TYPE_CODE>
                    <_-ROP_-E1_ADD_BONUS SEGMENT="1">
                        <ITEM_ID>CLEANING_KIT</ITEM_ID>
                        <ITEM_TCD>IT</ITEM_TCD>
                        <ADD_BONUS_ID>9108</ADD_BONUS_ID>
                        <MERCH_SET_ID>0</MERCH_SET_ID>
                        <QUANTITY>1.000</QUANTITY>
                        <UOM_ISO_CODE>PCE</UOM_ISO_CODE>
                    </_-ROP_-E1_ADD_BONUS>
                </_-ROP_-E1_PRICE_RULE>
            </_-ROP_-E1_PROMOTION_RULE>
            <_-ROP_-E1_PROMOTION_TEXT SEGMENT="1">
                <DESCRIPTION>Buy one coffee machine and one bag deluxe coffee and get one cleaning kit for free</DESCRIPTION>
                <NAME>ADD_BONUS</NAME>
                <SPRAS_ISO>EN</SPRAS_ISO>
            </_-ROP_-E1_PROMOTION_TEXT>
        </_-ROP_-E1_PROMOTION>
    </IDOC>
</_-ROP_-PROMOTION03>
```
1. Choose **Execute**.
2. Make sure you get the HTTP response **200**.

With this, you uploaded the promotional rule "Buy one coffee machine and one bag of deluxe coffee to get one cleaning kit for free" (promotion ID: `9103`) for the **Heidelberg** store (business unit ID: `FC01`) and the validity period **May 1st, 2021 to May 7th, 2021**.



### Upload master data - regular sales price


>In this tutorial, you only need to upload the regular sales price for the cleaning kit. You have already uploaded the regular sales price of **500 Euro** for the product **coffee machine** (material number: `COFFEE_MACHINE`, unit of measure: `PCE`) and for the product **DELUXE COFFEE** with the validity period **May 1st, 2021 to December 31st, 2021** in step 3 of the tutorial [Apply a Mix-and-Match Promotion with SAP Omnichannel Promotion Pricing](opps-advanced-scenario-mixandmatch).

Navigate to the [Data Upload service of SAP Omnichannel Promotion Pricing on SAP Business Accelerator Hub](https://api.sap.com/api/DataUpload/resource).

![Data Upload Regular Sales Price 1](https://raw.githubusercontent.com/sap-tutorials/Tutorials/master/tutorials/opps-advanced-scenario-additional-bonus/Data-Upload-Regular-Sales-Price-1.png)
![Data Upload Regular Sales Price 1b](https://raw.githubusercontent.com/sap-tutorials/Tutorials/master/tutorials/opps-advanced-scenario-additional-bonus/Data Upload Regular Sales Price 1b.png)

1. For **API Environment**, select the trial environment you have created for the Data Upload service.
2. On the left-hand side, choose **Upload prices using OAuth2**.
3. Open the **POST** request `/idocinbound`.
4. Choose **Try Out**.
5. For the **Request body**, choose `application/xml`.
6. Copy the following raw data and paste it into the body:
```XML
<?xml version="1.0" encoding="UTF-8"?>
<_-ROP_-BASE_PRICE01>
<IDOC BEGIN="1">
	<EDI_DC40 SEGMENT="1">
		<IDOCTYP>/ROP/BASE_PRICE01</IDOCTYP>
	</EDI_DC40>
	<_-ROP_-E1_BASE_PRICE SEGMENT="1">
		<LOGSYS>ABCCLNT999</LOGSYS>
		<BU_TYPE>1040</BU_TYPE>
		<PRICE_CLASSIFIC>PRICE_VAT</PRICE_CLASSIFIC>
		<_-ROP_-E1_BUSINESS_UNIT SEGMENT="1">
			<BU_ID>FC01</BU_ID>
		</_-ROP_-E1_BUSINESS_UNIT>
		<_-ROP_-E1_ITEM SEGMENT="1">
			<ITEM_ID>CLEANING_KIT</ITEM_ID>
			<_-ROP_-E1_ITEM_PRICE SEGMENT="1">
				<PRICE_AMT>20.00000</PRICE_AMT>
				<COND_SPR_UNIT>1</COND_SPR_UNIT>
				<EFFECTIVE_DATE>20210501000000</EFFECTIVE_DATE>
				<EXPIRY_DATE>20211231235959</EXPIRY_DATE>
				<UOM_ISO_CODE>PCE</UOM_ISO_CODE>
				<CURRENCY_ISO_CODE>EUR</CURRENCY_ISO_CODE>
			</_-ROP_-E1_ITEM_PRICE>
		</_-ROP_-E1_ITEM>
		</_-ROP_-E1_BASE_PRICE>
</IDOC>
</_-ROP_-BASE_PRICE01>
```
7. Choose **Execute**.
8. Make sure you get the HTTP response **200**.

With this, you uploaded the regular sales price for the **cleaning kit** for the **Heidelberg** store (business unit ID: `FC01`) and the validity period **May 1st, 2021 to December 31st, 2021**.




### Check uploaded master data


You can use the **Data Access** service for checking your uploaded data. If you need guidance, have a look at step 4 of the tutorial [Apply a Simple Promotion with SAP Omnichannel Promotion Pricing](opps-basic-scenario).


### Calculate the effective sales price


You can now calculate the effective sales price based on the data you have uploaded in the previous steps.

**Scenario**: A customer has one **coffee machine** (material number: `COFFEE_MACHINE`) and one package of **deluxe coffee** (material number: `DELUXE_COFFEE`) in the shopping cart. The customer wants to purchase it on **May 5th, 2021** in the **Heidelberg** store (business unit ID: `FC01`).

**Desired Result**: The Calculation service includes the **cleaning kit** as additional bonus in the response, giving the recommendation for the client application to add it as a free product to the transaction.

Let's see if this is the case:

![Calculation 1](https://raw.githubusercontent.com/sap-tutorials/Tutorials/master/tutorials/opps-advanced-scenario-additional-bonus/Calculation 2.png)
![Calculation 2](https://raw.githubusercontent.com/sap-tutorials/Tutorials/master/tutorials/opps-advanced-scenario-additional-bonus/Calculation 2b.png)


1. Navigate to the [Calculation service on the SAP Business Accelerator Hub](https://api.sap.com/api/PriceCalculation/resource).
2. For **API Environment**, select your trial environment for the Calculation service.
3. Open the **POST** request `/restapi/{tenantName}` and choose **Try Out**.
4. In the field `tenantName` enter the `identityzone` from the service key you have created for the Calculation service in your SAP BTP account.
>If you need more information about service keys, go to step 4 in the tutorial [Set Up SAP Omnichannel Promotion Pricing](opps-manual-setup).

5. For the **Request body**, choose `application/xml`.
6. Copy the following raw data and paste it into the body:

```XML
<PriceCalculate xmlns="http://www.sap.com/IXRetail/namespace/" InternalMajorVersion="7" InternalMinorVersion="0">
	<ARTSHeader ActionCode="Calculate" MessageType="Request">
		<MessageID>123456789</MessageID>
		<DateTime>2021-05-05T18:13:51.0</DateTime>
		<BusinessUnit TypeCode="RetailStore">FC01</BusinessUnit>    
        <MasterDataSourceSystemID>ABCCLNT999</MasterDataSourceSystemID>
	</ARTSHeader>
   <PriceCalculateBody TransactionType="SaleTransaction" NetPriceFlag="false">
	  <TransactionID>3456789</TransactionID>
	  <DateTime>2021-05-05T18:13:51.0</DateTime>
    <ShoppingBasket>
      <LineItem>
         <SequenceNumber>0</SequenceNumber>
         <Sale ItemType="Stock" NonDiscountableFlag="false" FixedPriceFlag="false">
            <TaxIncludedInPriceFlag>false</TaxIncludedInPriceFlag>
            <NonPieceGoodFlag>false</NonPieceGoodFlag>
            <PriceTypeCode>00</PriceTypeCode>
            <NotConsideredByPriceEngineFlag>false</NotConsideredByPriceEngineFlag>
            <ItemID>COFFEE_MACHINE</ItemID>   
            <Quantity Units="1" UnitOfMeasureCode="PCE">1</Quantity>
           </Sale>
      </LineItem>
      <LineItem>
         <SequenceNumber>1</SequenceNumber>
         <Sale ItemType="Stock" NonDiscountableFlag="false" FixedPriceFlag="false">
            <TaxIncludedInPriceFlag>false</TaxIncludedInPriceFlag>
            <NonPieceGoodFlag>false</NonPieceGoodFlag>
            <PriceTypeCode>00</PriceTypeCode>
            <NotConsideredByPriceEngineFlag>false</NotConsideredByPriceEngineFlag>
            <ItemID>DELUXE_COFFEE</ItemID>   
            <Quantity Units="1" UnitOfMeasureCode="PCE">1</Quantity>
           </Sale>
      </LineItem>
    </ShoppingBasket>  
   </PriceCalculateBody>
</PriceCalculate>
```

Make sure you get the HTTP response **200**.



### Additional information

* [Official Product Documentation](https://help.sap.com/docs/OPP)
* [Trial Documentation](https://help.sap.com/docs/OPP/0c145d124b784b548b618cda8a5b2aba/31b8aedc8ce14fcd9f6021ad4f6323c9.html)
* [SAP Omnichannel Promotion Pricing on the SAP Business Accelerator Hub](https://help.sap.com/docs/OPP/7c87270e23c64c2aa922ce297a6df23d/67a9da084cf84e058cb3a3911971bdd0.html?version=Cloud)

---