Create a Single-Code Coupon with SAP Omnichannel Promotion Pricing

At first, you create a single-code coupon object with the Coupon Management service.

Navigate to the Coupon Management service of SAP Omnichannel Promotion Pricing on the SAP Business Accelerator Hub. Log on with the same information that you use for your SAP BTP trial account.

1. Navigate to the Try Out section.
2. On the right-hand side, select the trial environment you have created for the Coupon Management service.
3. On the left-hand side, choose Coupon.
4. Open the POST request /Coupon.

5. Copy the following raw data and paste it into the body:

   json

   Copy

   { 
     "status": "INACTIVE",
     "displayID": "ANNIVERSARY25",
     "type": "SINGLECODE",
     "name": "ANNIVERSARY25",
     "validFrom": "2026-01-01",
     "validTo": "2026-12-31",
     "couponCodeValidityPeriodInDays": 365,
     "maxRedemptionCountPerCouponCode": 100000
   }
   

6. Choose Run.
7. Make sure you get the HTTP response 201.
8. From the response, note down the technical coupon ID (ID) as you will need it later.

The response should look like this:

With this, you have created a single-code coupon object with the name ANNIVERSARY25 and a validity period from January 1, 2026 to December 31, 2026. The coupon can be redeemed 100,000 times.

Optional: If you want to check whether you have successfully created the single-code coupon ANNIVERSARY25, you can proceed with the following steps:

1. On the left-hand side, choose Coupon.
2. Open the GET request /Coupon.
3. Choose Run.
4. Make sure you get the HTTP response 200.
5. In the response body, you should see the coupon that you have created.

When creating the coupon, you set the status of the coupon object to inactive. Now, change the status of the coupon object to active.

1. On the left-hand side, choose Coupon.
2. Open the PATCH request /Coupon({ID}).
3. Choose Parameters.
4. For ID, enter the technical coupon ID (ID) from the coupon object you have just created.

5. Copy the following raw data and paste it into the body.

   json

   Copy

   { 
     "status": "ACTIVE"
   }
   

6. Choose Run.
7. Make sure you get the HTTP response 200.

You have now successfully changed the status of the coupon object.

Now that you have created the coupon object and set it to active, you create the coupon code to be used in your promotional campaign.

1. On the left-hand side, choose Coupon.
2. Open the POST request /Coupon({ID})/CouponManagementService.createCouponCode.
3. Choose Parameters.
4. For ID, enter the technical coupon ID (ID) from the coupon object you have just created.

5. Copy the following data and paste it into the body:

   json

   Copy

   { 
   "codeValue": "ANNIVERSARY25"
   }
   

6. Choose Run.
7. Make sure you get the HTTP response 200.

With this, you have created the coupon code ANNIVERSARY25. Your marketing system can now read the coupon information from the Coupon Management service and drive your promotional campaign, for example by distributing the coupon code to your target customers.

You can now continue with the next tutorial Use the SAP Omnichannel Promotion Pricing Apps for Maintaining Promotions and Generic Attributes where you will use the SAP Omnichannel Promotion Pricing apps to make configurations, to maintain a generic attribute, and to upload promotions. You then associate the single-code coupon with a promotion.

• Official Product Documentation
• Trial Documentation
• SAP Omnichannel Promotion Pricing on the SAP Business Accelerator Hub