Promotion

The Business Object Retail promotion comprises specifications
for a marketing operation that is limited in time and that is meant to
draw increased attention to the enterprise in its sales market. As a rule, it has a sales-promoting effect.

Structure

A retail promotion consists of items that each contain a material that is to be promoted.


An item can be hierarchically structured. In this way, a generic material can be differentiated according to its variants.


A retail promotion can be subdivided according to themes.

To support the retail promotion, advertising media can be used.


To a retail promotion can be assigned several plants whose assortment
is to be extended to include the materials of the promotion. For each
plant is specified the period of time in which it takes part in the promotion.

Comment

A retail promotion is often supported with corresponding conditions
(e.g. grant towards advertising costs) by the vendors and thus concerns the purchasing side as well as the sales side.


Example
A chain of department stores conducts a promotion with the theme
"beginning of school". Stationery is purchased at especially favorable
conditions from the manufacturer and sold to the consumers at a reduced price.

As an adversting medium an insert in regional daily newspapers is used.
All department stores in the "North" region take part from the 1st to the 16th of July in the retail promotion.

Available Methods

• Change : Change Promotion [ BAPI_PROMO_CHANGE ]
  
• ChangeSitePlanning : Change to Plant Planning Data [ BAPI_PROMO_CHANGESITEPLANNING ]
  
• ConfirmRequest : Report Plant's Required Quantities [ BAPI_PROMO_CONFIRMREQUEST ]
  
• CreateFromData : Create [ BAPI_PROMO_CREATE ]
  
• GetAnnouncedList : List of Promotions for a Plant [ BAPI_PROMO_GETANNOUNCEDLIST ]
  
• GetDetail : Detailed Data for a Promotion [ BAPI_PROMO_GETDETAIL ]
  
• GetList : List of Promotions [ BAPI_PROMO_GETLIST ]
  
• GetSitePlanning : Read Plant Planning Data for a Promotion [ BAPI_PROMO_GETSITEPLANNING ] (Obsolete in 46A)
  
• GetSitePlanning1 : Read Plant Planning Data of a Promotion [ BAPI_PROMO_GETSITEPLANNING1 ]
  

Change

You use this method to change the detailed data of a promotion.

The following changes can be made:

Notes

Before you call this method, you must import promotion data using themethod "GetDetail". The imported data must be returned in a comparisonparameter (e.g. PROMOTION_HEADER). The data of the comparison parameteris compared with the database and an error message is issued if discrepancies occur.

The data to be changed is entered in a change parameter (e.g. PROMOTION_HEADER_NEW).

Entries can be deleted and added as follows:

The entry to be deleted is not included in the change parameter

The new entry is added to the change parameter

Promotion items that are not to be changed can be omitted from the comparison and change parameters.

Authorization for authorization object S_TCODE for transaction WAK2 is checked.

Messages are returned in parameter RETURN.

ChangeSitePlanning

This method is used to update quantities and sales prices for the individual plants in the promotion.

Notes

Method GETSITEPLANNING can be used first to determine the item data of the plants for a promotion.

The following authorization objects are checked:

Messages are returned in parameter RETURN. Please see the parameter documentation for the return values and their meaning.

ConfirmRequest

This method is used to update the quantity requested by a plant in the promotion.

Notes

The entry of parameter PLANT or PLANT-CUSTOMER is obligatory

Method GETSITEPLANNING can be used first to determine the item data for the promotion in the plant.

The following authorization objects are checked:

Messages are returned in parameter RETURN. Please see this parameter
documentation for information on the return values and their meaning.

This method will be replaced by the new method CONFIRMREQUEST1.

CreateFromData

You use this method to create a promotion.

Promotions that were planned in another R/3 system or a non-SAP system can be created in the system using this method.

In the R/3 information system, for example, you can define an exceptionthat selects the articles and sites for a promotion. You can assign
this exception to a workflow task, which calls the method to create thepromotion. As of Release 4.6, workflow task 'PROMO_CREATE' is provided for this.

In addition to header data for the promotion, you can create articledata, themes and site groups. You cannot use this method to create
promotion assortment modules and assign these to site groups. Also, youcannot carry out subsequent processing steps such as price activation or allocation table generation with this method.

You can perform a test run for the method, which means that no data is saved to the database.

Notes

The authorization for authorization object S_TCODE for transaction WAK1 is checked.

The promotion type assigned to the promotion must be created in Customizing for the promotion.

The method performs all the necessary consistency checks, and returns
all messages as a return table. The return values and their meanings can be found in the parameter documentation.

The key fields used by the method are described in the parameters.

GetAnnouncedList

This method is used to determine the promotions for a plant. Thepromotions can be selected by entering a sales period and the materialsinvolved, which are determined by entering a material list, materialgroups, or departments. Promotions are only selected if promotion announcement has already been carried out.

Notes

You must enter parameter PLANT or PLANT_CUSTOMER.

To limit the number of materials involved, you can transfer only parameter DEPARTEMENT_RANGE, MATL_GROUP_RANGE or MATERIAL_RANGE.

The following authorization objects are checked:

Messages are returned in parameter RETURN. Please see this parameterdocumentation for information on the return values and their meaning.

GetDetail

You use this method to determine the detailed data of a promotion.

Data is issued on

Notes

You can limit the number of promotion items that are issued by entering selection criteria for

Authorization for authorization object S_TCODE for transaction WAK3 is checked.

Messages are returned in parameter RETURN. The return values and theirmeanings can be found in the relevant parameter documentation.

GetList

You use this method to determine a list of promotions matching the transferred selection options

You can limit the promotion selection by the following:

You can limit the amount of hits using optional parameter "MAXROWS".

Notes

If you limit the selection by entering periods (sales period, order
period), the system displays all promotions with periods that overlap the entered period.

The system checks authorization for authorization object "S_TCODE" for transaction "WAK3".

Messages are returned in parameter "RETURN". See this parameter documentation for information on the return values.

GetSitePlanning

This method is used to determine the detailed data for a promotion.

Notes

You can use parameter SITES to limit the selection of the material/plant items to specific plants. In this case, items are onlyselected if an announcement has already been made.

If parameter SITES is not used to restrict the data, all items are selected, irrespective of plant and announcement status.

The following authorization objects are checked:

1) Announcement status is checked

2) Announcement status is not checked

Messages are returned in parameter RETURN. The return values and their meanings can be found in the parameter documentation.

GetSitePlanning1

This method is used to determine the detailed data of a promotion.

Notes

You can use parameter SITES to limit the material/plant items to specific plants.

If you do not use parameter SITES to restrict the data, all items are selected.

If you select parameter ANNOUNCED_ONLY, items are only selected if an announcement has already been made.

The following authorization objects are checked:

1) Aouuncement status is checked

2) Announcement status is not checked

Messages are returned in parameter RETURN. The parameter documentation for this lists the return values and their meanings.