Fonction SAP BAPI_PROMO_GETSITEPLANNING - Detailed Data for the Plants Involved in a Promotion

Paramètre Reférence Type Long. Valeur par déf. Facultatif Description
LANGU BAPI1068I1-LANGU C 1 X Language
LANGU_ISO BAPI1068I1-LANGUP_ISO C 2 X Language in ISO Code
PROMOTION BAPI1068I1-PROMOTION C 10 Promotion Number

Paramètre Reférence Long. Facultatif Description
PROMOTIONDATA BAPI1068E1 338 Promotion Header Data
PROMOTIONDATA_NEW BAPI1068E1_NEW 388 X Promotion interface structure: Header data
PROMOTIONITEMSDATA BAPI1068T2 719 Promotion Item Data
RETURN BAPIRET2 548 Error Messages
SITES BAPI1068T6 14 Table for the Plants

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

Notes
You can use parameter SITES to limit the selection of thematerial/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 areselected, 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 theirmeanings can be found in the parameter documentation.

      Description
      Information on the meaning of the parameter can be found in therelevant data element documentation:
      Language

      Default
      If you do not enter a language, the system uses the log-on language.

      Description
      For information on the meaning of the parameter, please see therelevant data element documentation:
      Language in ISO code
      This parameter can only be used as an alternative to parameter'Language'. If values are entered in both parameters, the value inparameter 'Language' takes priority.

      Description
      For informaiton on the meaning of the promotion number, please see therelevant data element documentation:
      Promotion number

      Description
      This parameter is used to return the promotion header data of one ormore plants to a table.
      For informaiton on the meaning of the fields in the table, please seethe relevant data element documentation:
      Promotion
      Promotion status
      Subsequent processing status
      Latest date for replying to promotion announcement
      Purchase price conditions valid from
      Purchase price conditions valid to
      Start of promotion listing
      End of promotion listing
      Earliest order date
      Latest order date
      Earliest delivery date
      Latest delivery date
      On sale to consumers from
      On sale to consumers to
      Goods receipt of promotion merchandise in plant
      Reason for promotion block
      Promotion blocked on
      Promotion announcement category
      Language

      Description
      This parameter is used to return the promotion header data for one ormore plants to a table.
      For information on the meaning of the fields in the table, please seethe relevant data element documentation:
      Customer number
      Plant description
      Material number
      Material description
      Material number of generic material
      Material group
      Promotion item number
      Promotion theme
      Minimum order quantity
      Planned sales quantity
      Planned allocation quantity
      Quantity requested by store
      Allocation unit
      Sales unit
      Planned sales price (gross)
      Planned sales price (net)
      Currency
      Sales price unit
      Standard sales price
      Purchase price (gross)
      Purchase price (net)
      Sales currency
      Purchasing currency in ISO code
      Price unit of purchase price
      Purchase order price unit
      Purchase order price unit in ISO code
      Return type
      Earliest order date
      Latest order date
      Earliest delivery date
      End of delivery period
      Purchase order date at vendor
      Allocation table number
      Item number of allocation table
      Reason for promotion block
      Description of blocking reason
      Item blocked on
      Indicator for price point adjustment
      Language
      Language in ISO code
      Indicator: confirmation necessary

      Description
      Error messages for the method

      Range
      If errors occur, the following messages are issued:
      TYPE ID Number Message
      E WU 555 Enter customer or plant
      E WU 577 Plant & does not exist
      E WU 554 Customer & does not exist
      E WU 001 Promotion & does not exist
      E WU 202 Internal error occurred during authorization check
      E WU 669 You have no authorization for customer &
      E WU 670 You have no authorization for this transaction

      Description
      This parameter is used to limit the plants for which promotion data isto be determined. If it is used, promotion items are only returned if apromotion announcement has already been made. You can use parameterIGN_ANNOUNC if you do not want this check to take place.
      Alternatively, the plant number or customer number of a plant can betransferred.
      For information on the meaning of the parameter, please see therelevant data element documentation:
      Plant number
      Customer number of the plant