Fonction SAP BAPI_PROMO_GETLIST - List of Promotions

Paramètre Reférence Type Long. Valeur par déf. Facultatif Description
LANGU BAPI1068I1-LANGU C 1 X Language Key
LANGU_ISO BAPI1068I1-LANGUP_ISO C 2 X Language According to ISO 639
MAXROWS BAPI1068I1-MAXROWS I 4 X Maximum Number of Lines of Hits
ON_SALE_FROM BAPI1068I1-SALES_DATE_FROM D 8 X On Sale to Consumers From
ON_SALE_TO BAPI1068I1-SALES_DATE_TO D 8 X On Sale To Consumers To
ORDER_FROM BAPI1068I1-ORDER_FROM D 8 X Earliest Order Date
ORDER_TO BAPI1068I1-ORDER_TO D 8 X Latest Order Date

Paramètre Reférence Long. Facultatif Description
DISTR_CHAN_RANGE BAPI1068T15 7 X Range Table for the Distribution Channel for the Promotion Header Data
PROMOTIONLIST BAPI1068T17 93 X List of Promotions
PROMOTION_NAME_RANGE BAPI1068T13 83 X Range Table for Promotion Description
PROMOTION_RANGE BAPI1068T11 23 X Range Table for Promotion Number
PROMOTION_TYPE_RANGE BAPI1068T12 11 X Range Table for Promotion Type
RETURN BAPIRET2 548 X Return parameter
SALES_ORG_RANGE BAPI1068T14 11 X Range Table for the Sales Organization in the Promotion Header Data
STATUS_RANGE BAPI1068T16 5 X Range Table for the Processing Status of the Promotion

Functionality
You use this method to determine a list of promotions matching thetransferred 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, orderperiod), the system displays all promotions with periods that overlapthe entered period.
    The system checks authorization for authorization object "S_TCODE" fortransaction "WAK3".
    Messages are returned in parameter "RETURN". See this parameterdocumentation for information on the return values.

    Description
    The language key indicates the language in which the promotion name isdisplayed.

    Default
    If no language is entered, the system uses the logon language.

    Description
    The language key indicates the language in which the promotion name isdisplayed.
    This parameter can only be used as an alternative to paramter'Language'. If a value is entered for both parameters, the system usesthe value in parameter 'Language'.

    Description
    Parameter "MAXROWS" limits the scope of the returned list ofpromotions.
    If parameter "MAXROWS" is not transferred, the list contains allpromotions that match the selection criteria.

    Description
    You use this parameter to limit the selection of promotions by salesperiod.. All promotions with a sales period that overlaps with theentered period are selected.
    For further information, see the documentation on data elementOn Sale to Consumers From.

    Description
    You use this parameter to limit the selection of promotions by salesperiods. All promotions with a sales period that overlaps with theentered period are selected.
    For further information, see the documentation on data elementOn Sale To Consumers To.

    Description
    You use this parameter to limit the selection of promotions by orderperiod. All promotions with an order period that overlaps with theentered period are selected.
    For further information, see the documentation on data elementEarliest Order Date.

    Description
    You use this parameter to limit the selection of promotions by orderperiod. All promotions with an order period that overlaps with theentered period are selected.
    For further information, see the documentation on data elementLatest Order Date.

    Description
    You use this selection parameter to limit the selection of promotionsby distribution channel.

    Description
    The header data of the selected promotions is output in this table.

    Description
    You use this selection parameter to limit the selection of promotionsby promotion name.
    The content of variable "LANGU" or "LANGU_ISO" is used as the languagekey.

    Description
    You use this selection parameter to limit the selection of promotionsby promotion number.

    Description
    You use this selection parameter to limit the selection of promotionsby promotion type.

    Description
    This parameter contains the error messages for the method.

    Value range
    If errors occur, the following error messages are issued:
    TYPE,,ID,,Number,,Message
    E,,WU,,670,,You are not authorized to use this transaction
    I,,WU,,357,,Language code not found. Logon language & used
    E,,WU,,098,,Start of sale cannot be before end of sale
    E,,WU,,453,,Start of order period cannot be before end of
    ,, ,, ,,order period
    I,,WU,,687,,The system could not determine a promotion
    ,, ,, ,,matching the selection criteria
    I,,WU,,740,,The number of promotions was limited to &1

    Description
    You use this selection period to limit the number of promotions bysales organization.

    Description
    You use this selection parameter to limit the selection of promotionsby processing status.