Show TOC

Function documentationCreating Promotions from Promotion Messages with Multiple Promotions

 

The customer sends promotion data (location products, promotion quantities, time buckets) for multiple promotions in a promotion message. In the promotion message, however, the customer can only maintain one promotion ID on the header level of the promotion message.The promotion message only contains one promotion ID, therefore, SAP Supply Network Collaboration (SAP SNC) cannot automatically update existing promotions or create new promotions from the customer's promotion data. SAP SNC must first determine if there are existing promotions in the system that are relevant to the customer's promotion data. Once SAP SNC has determined which data is relevant to existing promotions, it can either update promotions or create new promotions by assigning the time buckets of the location product time series from the promotion message to the corresponding promotion in SAP SNC.

Prerequisites

You have made settings in Customizing for Supply Network Collaboration under Start of the navigation path Demand Next navigation step Promotion Next navigation step Settings for Inbound Promotion XML Messages End of the navigation path as follows:

  • Under Define Settings for Inbound Processing of Promotion XML Messages you have made the following settings:

    • To set up the system so that it can assign time buckets to promotions for the creation or update of multiple promotions, you have selected the Expect Internal Promotion ID checkbox. However, you have ensured that there is no internal promotion ID in the promotion message

    • To calculate promotion start dates from the time buckets in the promotion message, you have determined an offset in days for the start dates in the DateOffset field.

    • To determine which time series data (promotion sales forecast data or promotion order forecast data) you want to use when you create or update multiple promotions from the time buckets of a promotion message, you have selected the FcstData (Promotion Sales Forecast Data or Order Forecast Data) checkbox

  • You have listed all existing promotions in SAP SNC in the Determine Promotion IDs Customizing activity. You must have entered the start and end dates of the promotion

  • To ensure that the system assigns an event type to the promotion, you have assigned event types to promotion IDs under Determine Promotion Attributes.

Features

Determining the Promotion ID

The customer can only include one promotion ID on the header level of the promotion message. If the customer sends a promotion message with multiple promotions, SAP SNC must first determine which promotions already exist in the system before it can assign the time buckets from a location product in the promotion message to an existing promotion or create a new promotion from the customer's promotion data. To determine which promotions exist, SAP SNC compares the customer's promotion data to the promotions you have listed in the Determine Promotion IDs Customizing activity. You list the following data:

  • The customer who sends the data for this promotion

  • The product and the product hierarchy

    Note Note

    Product hierarchies from the SAP ERP system can contain key attributes such as brand, size or pack numbers in its character string. For more information, see Example. By implementing the Business Add-In (BAdI) method DETERMINE_BSP from the BAdI Maintain Settings for Promotion Planning (/SAPAPO/ICH_PROM_EXT), you can extract the brand number, size number and pack number from the product hierarchy number, for example to search using the brand, size or pack numbers of the product, or to map other fields in place of the product hierarchy. For more information, see Example.

    End of the note.

  • The ship-to location

  • The start and end date of the promotion

  • The promotion ID

Upon receipt of the promotion message, SAP SNC automatically compares the promotions listed in Customizing with the promotion data in the promotion message and either automatically updates promotions or creates new promotions. If you want to change or extend the search parameters for the determination of promotion IDs, you can use the Business Add-In (BAdI) Determine Promotion ID. You can find the BAdI under Start of the navigation path Business Add-Ins (BAdIs) for SAP SNC Next navigation step Demand Next navigation step Promotion Next navigation step Determine Promotion IDs End of the navigation path.

Determining the Event Type

Once the system has determined the promotion ID, SAP SNC can automatically search for the corresponding event type using entries you have maintained in the Determine Promotion Attributes Customizing activity. If the system finds an event type assigned to the promotion ID there, it assigns it to the promotion. If you want to change or extend the search parameters for the determination of promotion attributes, you can use the BAdI Determine Promotion Attributes. You can find the BAdI under Start of the navigation path Business Add-Ins (BAdIs) for SAP SNC Next navigation step Demand Next navigation step Promotion Next navigation step Determine Promotion Attributes End of the navigation path.

Creating Promotions Based on the Promotion Time Series Type

In a promotion message, the customer can send time series for a location product based on the following time series types:

  • Promotion order forecast data

  • Promotion sales forecast data

In the standard system, the system uses the promotion order forecast data if the promotion message contains both types of promotion data. However, when creating promotions, you can set up the system so that it creates promotions only using the promotion sales forecast data.

Determining Promotion IDs for Multiple Promotions That Do Not Share the Same Parameter Set

If the system has created multiple promotions from a promotion message, but a resulting promotion contains more than one location product that does not share the same promotion parameter set, the system creates multiple promotion IDs for that promotion. To distinguish between the promotion IDs, the system separates the promotion IDs by assigning a numeric suffix, such as _001, _002, and so on.

Example

Using Alternative Values for the Product Hierarchy

The product hierarchy is an 18 character string, 123456789101213141. In the SAP ERP system, the brand number, size number, and pack number can be included in the product hierarchy string. In this example, the brand number, size number, and pack number are the numbers 5678910 in the product hierarchy string 123456789101213141.

More Information

Example: Creating Multiple Promotions