SAP BAPI_PROMO_CHANGE Function Module for Change Promotion









BAPI_PROMO_CHANGE is a standard bapi promo change SAP function module available within SAP R/3 or S/4 Hana systems, depending on your version and release level. It is used for Change Promotion processing and below is the pattern details for this FM, showing its interface including any import and export parameters, exceptions etc. there is also a full "cut and paste" ABAP pattern code example, along with implementation ABAP coding, documentation and contribution comments specific to this or related objects.


See here to view full function module documentation and code listing for bapi promo change FM, simply by entering the name BAPI_PROMO_CHANGE into the relevant SAP transaction such as SE37 or SE38.

Function Group: BAPIS1068
Program Name: SAPLBAPIS1068
Main Program: SAPLBAPIS1068
Appliation area:
Release date: 20-Jan-2000
Mode(Normal, Remote etc): Remote-Enabled
Update:



Function BAPI_PROMO_CHANGE pattern details

In-order to call this FM within your sap programs, simply using the below ABAP pattern details to trigger the function call...or see the full ABAP code listing at the end of this article. You can simply cut and paste this code into your ABAP progrom as it is, including variable declarations.
CALL FUNCTION 'BAPI_PROMO_CHANGE'"Change Promotion
  EXPORTING
   PROMOTION =  "Promotion
*  READ_BUFFER =  "Checkbox
*  LANGU =  "Language Key
*  LANGU_ISO =  "Language According to ISO 639
*  TESTRUN =  "Switch to Simulation Mode for Write BAPIs
   PROMOTION_HEADER_NEW =  "Promotion Header Data (After Change)
   PROMOTION_HEADER =  "Promotion Header Data (Before Change)
*  PROMO_REF =  "Interface Structure for Higher-Level Promotion
*  PROMO_REF_NEW =  "Interface Structure for Higher-Level Promotion
*  SOA_SERVICE = ' ' "Checkbox

TABLES
*  TEXTS_NEW =  "Promotion Names (After Change)
   PLANTGROUPS =  "Plant Groups (Before Change)
*  PLANTS =  "Table Parameter: Plants (Changeable)
*  PLANTS_NEW =  "Table Parameter: Plants (Changeable)
*  RETURN =  "Return Parameter(s)
*  EXTENSIONIN =  "Reference Structure for BAPI Parameters ExtensionIn/ExtensionOut
*  TEXTS =  "Promotion Names (Before Change)
   ITEMS_NEW =  "Item Data (After Change)
   ITEMS =  "Item Data (Before Change)
*  DISCOUNTS_NEW =  "Promotion Discounts (After Change)
*  DISCOUNTS =  "Promotion Discounts (Before Change)
   THEMES_NEW =  "Promotion Themes (After Change)
   THEMES =  "Promotion Themes (Before Change)
   PLANTGROUPS_NEW =  "Plant Groups (After Change)
.



IMPORTING Parameters details for BAPI_PROMO_CHANGE

PROMOTION - Promotion

Data type: BAPI1068I1-PROMOTION
Optional: No
Call by Reference: No ( called with pass by value option)

READ_BUFFER - Checkbox

Data type: XFELD
Optional: Yes
Call by Reference: No ( called with pass by value option)

LANGU - Language Key

Data type: BAPI1068I1-LANGU
Optional: Yes
Call by Reference: No ( called with pass by value option)

LANGU_ISO - Language According to ISO 639

Data type: BAPI1068I1-LANGUP_ISO
Optional: Yes
Call by Reference: No ( called with pass by value option)

TESTRUN - Switch to Simulation Mode for Write BAPIs

Data type: BAPI1068I2-TESTRUN
Optional: Yes
Call by Reference: No ( called with pass by value option)

PROMOTION_HEADER_NEW - Promotion Header Data (After Change)

Data type: BAPI1068T22
Optional: No
Call by Reference: No ( called with pass by value option)

PROMOTION_HEADER - Promotion Header Data (Before Change)

Data type: BAPI1068T22
Optional: No
Call by Reference: No ( called with pass by value option)

PROMO_REF - Interface Structure for Higher-Level Promotion

Data type: BAPI1068I3
Optional: Yes
Call by Reference: No ( called with pass by value option)

PROMO_REF_NEW - Interface Structure for Higher-Level Promotion

Data type: BAPI1068I3
Optional: Yes
Call by Reference: No ( called with pass by value option)

SOA_SERVICE - Checkbox

Data type: XFELD
Default: ' '
Optional: Yes
Call by Reference: No ( called with pass by value option)

TABLES Parameters details for BAPI_PROMO_CHANGE

TEXTS_NEW - Promotion Names (After Change)

Data type: BAPI1068T29
Optional: Yes
Call by Reference: Yes

PLANTGROUPS - Plant Groups (Before Change)

Data type: BAPI1068T24
Optional: No
Call by Reference: Yes

PLANTS - Table Parameter: Plants (Changeable)

Data type: BAPI1068T25
Optional: Yes
Call by Reference: Yes

PLANTS_NEW - Table Parameter: Plants (Changeable)

Data type: BAPI1068T25
Optional: Yes
Call by Reference: Yes

RETURN - Return Parameter(s)

Data type: BAPIRET2
Optional: Yes
Call by Reference: Yes

EXTENSIONIN - Reference Structure for BAPI Parameters ExtensionIn/ExtensionOut

Data type: BAPIPAREX
Optional: Yes
Call by Reference: Yes

TEXTS - Promotion Names (Before Change)

Data type: BAPI1068T29
Optional: Yes
Call by Reference: Yes

ITEMS_NEW - Item Data (After Change)

Data type: BAPI1068T23
Optional: No
Call by Reference: Yes

ITEMS - Item Data (Before Change)

Data type: BAPI1068T23
Optional: No
Call by Reference: Yes

DISCOUNTS_NEW - Promotion Discounts (After Change)

Data type: BAPI1068T31
Optional: Yes
Call by Reference: Yes

DISCOUNTS - Promotion Discounts (Before Change)

Data type: BAPI1068T31
Optional: Yes
Call by Reference: Yes

THEMES_NEW - Promotion Themes (After Change)

Data type: BAPI1068T10
Optional: No
Call by Reference: Yes

THEMES - Promotion Themes (Before Change)

Data type: BAPI1068T10
Optional: No
Call by Reference: Yes

PLANTGROUPS_NEW - Plant Groups (After Change)

Data type: BAPI1068T24
Optional: No
Call by Reference: Yes

Copy and paste ABAP code example for BAPI_PROMO_CHANGE Function Module

The ABAP code below is a full code listing to execute function module POPUP_TO_CONFIRM including all data declarations. The code uses the original data declarations rather than the latest in-line data DECLARATION SYNTAX but I have included an ABAP code snippet at the end to show how declarations would look using the newer method of declaring data variables on the fly. This will allow you to compare and fully understand the new inline method. Please note some of the newer syntax such as the @DATA is not available until a later 4.70 service pack (SP8), which i why i have stuck to the origianl for this example.

DATA:
lv_promotion  TYPE BAPI1068I1-PROMOTION, "   
lt_texts_new  TYPE STANDARD TABLE OF BAPI1068T29, "   
lt_plantgroups  TYPE STANDARD TABLE OF BAPI1068T24, "   
lv_read_buffer  TYPE XFELD, "   
lt_plants  TYPE STANDARD TABLE OF BAPI1068T25, "   
lt_plants_new  TYPE STANDARD TABLE OF BAPI1068T25, "   
lt_return  TYPE STANDARD TABLE OF BAPIRET2, "   
lt_extensionin  TYPE STANDARD TABLE OF BAPIPAREX, "   
lv_langu  TYPE BAPI1068I1-LANGU, "   
lt_texts  TYPE STANDARD TABLE OF BAPI1068T29, "   
lt_items_new  TYPE STANDARD TABLE OF BAPI1068T23, "   
lv_langu_iso  TYPE BAPI1068I1-LANGUP_ISO, "   
lt_items  TYPE STANDARD TABLE OF BAPI1068T23, "   
lv_testrun  TYPE BAPI1068I2-TESTRUN, "   
lt_discounts_new  TYPE STANDARD TABLE OF BAPI1068T31, "   
lv_promotion_header_new  TYPE BAPI1068T22, "   
lt_discounts  TYPE STANDARD TABLE OF BAPI1068T31, "   
lv_promotion_header  TYPE BAPI1068T22, "   
lv_promo_ref  TYPE BAPI1068I3, "   
lt_themes_new  TYPE STANDARD TABLE OF BAPI1068T10, "   
lt_themes  TYPE STANDARD TABLE OF BAPI1068T10, "   
lv_promo_ref_new  TYPE BAPI1068I3, "   
lv_soa_service  TYPE XFELD, "   ' '
lt_plantgroups_new  TYPE STANDARD TABLE OF BAPI1068T24. "   

  CALL FUNCTION 'BAPI_PROMO_CHANGE'  "Change Promotion
    EXPORTING
         PROMOTION = lv_promotion
         READ_BUFFER = lv_read_buffer
         LANGU = lv_langu
         LANGU_ISO = lv_langu_iso
         TESTRUN = lv_testrun
         PROMOTION_HEADER_NEW = lv_promotion_header_new
         PROMOTION_HEADER = lv_promotion_header
         PROMO_REF = lv_promo_ref
         PROMO_REF_NEW = lv_promo_ref_new
         SOA_SERVICE = lv_soa_service
    TABLES
         TEXTS_NEW = lt_texts_new
         PLANTGROUPS = lt_plantgroups
         PLANTS = lt_plants
         PLANTS_NEW = lt_plants_new
         RETURN = lt_return
         EXTENSIONIN = lt_extensionin
         TEXTS = lt_texts
         ITEMS_NEW = lt_items_new
         ITEMS = lt_items
         DISCOUNTS_NEW = lt_discounts_new
         DISCOUNTS = lt_discounts
         THEMES_NEW = lt_themes_new
         THEMES = lt_themes
         PLANTGROUPS_NEW = lt_plantgroups_new
. " BAPI_PROMO_CHANGE




ABAP code using 7.40 inline data declarations to call FM BAPI_PROMO_CHANGE

The below ABAP code uses the newer in-line data declarations. This allows you to see the coding differences/benefits of the later inline syntax. Please note some of the newer syntax below, such as the @DATA is not available until 4.70 EHP 8.

"SELECT single PROMOTION FROM BAPI1068I1 INTO @DATA(ld_promotion).
 
 
 
 
 
 
 
 
"SELECT single LANGU FROM BAPI1068I1 INTO @DATA(ld_langu).
 
 
 
"SELECT single LANGUP_ISO FROM BAPI1068I1 INTO @DATA(ld_langu_iso).
 
 
"SELECT single TESTRUN FROM BAPI1068I2 INTO @DATA(ld_testrun).
 
 
 
 
 
 
 
 
 
DATA(ld_soa_service) = ' '.
 
 


Search for further information about these or an SAP related objects



Comments on this SAP object

What made you want to lookup this SAP object? Please tell us what you were looking for and anything you would like to be included on this page!