×

[PR]この広告は3ヶ月以上更新がないため表示されています。
ホームページを更新後24時間以内に表示されなくなります。




Sapass

 Simplify SAP R/3 development with Excel VBA/VB RFC  
Home> Bapi>Promotion



Index

Promotion

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.


11-Dec-2005


Methods

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 ]

11-Dec-2005


Change

Change


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

The following changes can be made:

  • Header data (change)
  • Promotion items (delete, add, change)
  • Promotion themes (delete, add)
  • Plant groups (delete, add, change)

  • 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:

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

  • Add:
  • 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.


    11-Dec-2005


    ChangeSitePlanning

    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:


  • S_TCODE: Authorization for transaction WAK2
  • Messages are returned in parameter RETURN. Please see the parameter documentation for the return values and their meaning.


    11-Dec-2005


    ConfirmRequest

    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:

  • S_TCODE: Authorization for transaction WAK10
  • W_AUFT_RMB: Authorization for the customer number of the plant with activity 31
  • 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.


    11-Dec-2005


    CreateFromData

    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.


    11-Dec-2005


    GetAnnouncedList

    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:


  • S_TCODE: Authorization for transaction WAK11
  • W_AUFT_RMB: Authorization for customer number of the plant with activity 03 (Display)
  • Messages are returned in parameter RETURN. Please see this parameterdocumentation for information on the return values and their meaning.



    11-Dec-2005


    GetDetail

    GetDetail


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

    Data is issued on

  • Promotion header
  • Promotion items (materials)
  • Promotion themes
  • Plant groups
  • Notes

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


  • Material numbers
  • Promotion themes
  • Material group
  • 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.


    11-Dec-2005


    GetList

    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:

  • Promotion number
  • Promotion type
  • Promotion description
  • Sales organization

  • Distribution channel
  • Processing status of the promotion
  • Promotion sales period
  • Promotion order period
  • 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.


    11-Dec-2005


    GetSitePlanning

    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

  • S_TCODE: Authorization for transaction WAK11

  • W_AUFTRMB: Authorization for the customer number of the plant with activity 03 (Display)
  • 2) Announcement status is not checked

  • S_TCODE: Authorization for transaction WAK3
  • Messages are returned in parameter RETURN. The return values and their meanings can be found in the parameter documentation.


    11-Dec-2005


    GetSitePlanning1

    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

  • S_TCODE: Authorization for transaction WAK11

  • W_AUFTRMB: Authorization for the customer number of the plant with activity 03 (Display)
  • 2) Announcement status is not checked

  • S_TCODE: Authorization for transaction WAK3
  • Messages are returned in parameter RETURN. The parameter documentation for this lists the return values and their meanings.


    11-Dec-2005