SAP Function BAPI_CONTRACT_CHANGE - BAPI to Change a Purchase Contract

Parameter Reference Type Length Default Optional Text
HEADER BAPIMEOUTHEADER u 347 X Header Data Outline Agreement
HEADERX BAPIMEOUTHEADERX u 54 X Header Data Change Parameter Outline Agreement
PURCHASINGDOCUMENT BAPIMEOUTHEADER-NUMBER C 10 Purchasing Document Number
TECHNICAL_DATA BAPIMEOUTTECH u 4 X Technical Parameters for Outline Agreement BAPIs
TESTRUN BAPIFLAG-BAPIFLAG C 1 X Single-Character Indicator
VENDOR_ADDRESS BAPIMEOUTADDRVENDOR u 1276 X Address Structur Vendor Address

Parameter Reference Type Length Text
EXP_HEADER BAPIMEOUTHEADER u 347 Header Data Outline Agreement

Parameter Reference Length Optional Text
ACCOUNT BAPIMEOUTACCOUNT 420 X Account Assignment Data
ACCOUNTPROFITSEGMENT BAPIMEOUTPROFITSEGMENT 87 X Account Assignment - Profitability Segment Calculation
ACCOUNTX BAPIMEOUTACCOUNTX 50 X Change Parameter - Account Assignment Data
DELIVERY_ADDRESS BAPIMEOUTADDRDELIVERY 1301 X Delivery Address
EXTENSIONIN BAPIPAREX 990 X ExtensionIn (Customer Enhancement)
EXTENSIONOUT BAPIPAREX 990 X ExtensionOut (Customer Enhancement)
HEADER_TEXT BAPIMEOUTTEXT 139 X Header Text
HEAD_CONDITION BAPIMEOUTHEADERCOND 101 X Header Condition
HEAD_CONDITIONX BAPIMEOUTHEADERCONDX 37 X Change Parameter - Header Condition
HEAD_COND_SCALE_QUAN BAPIMEOUTSCALE 39 X Quantity Scale
HEAD_COND_SCALE_VAL BAPIMEOUTSCALEVALUE 46 X Value Scale
HEAD_COND_VALIDITY BAPIMEOUTHEADVALIDITY 26 X Validity Area of Header Condition
HEAD_COND_VALIDITYX BAPIMEOUTHEADVALIDITYX 13 X Change Parameter - Validity Area of Header Condition
ITEM BAPIMEOUTITEM 1000 X Item Data
ITEMX BAPIMEOUTITEMX 145 X Change Parameter - Item Data
ITEM_CONDITION BAPIMEOUTCONDITION 106 X Item Condition
ITEM_CONDITIONX BAPIMEOUTCONDITIONX 42 X Change Parameter - Item Condition
ITEM_COND_SCALE_QUAN BAPIMEOUTITEMSCALEQUAN 44 X Quantity Scale
ITEM_COND_SCALE_VALUE BAPIMEOUTITEMSCALEVAL 51 X Value Scale
ITEM_COND_VALIDITY BAPIMEOUTVALIDITY 35 X Validity Area of Item Condition
ITEM_COND_VALIDITYX BAPIMEOUTVALIDITYX 20 X Change Parameter - Validity Area of Item Condition
ITEM_TEXT BAPIMEOUTITEMTEXT 144 X Item Text
PARTNER BAPIMEOUTPARTNER 41 X Partner Data
PARTNERX BAPIMEOUTPARTNERX 31 X Table Type: Change Parameter Partner Outline Agreement
RELEASE_DOCU BAPIMEOUTRELEASEINFO 112 X Table Type: Change Parameter Partner Outline Agreement
RETURN BAPIRET2 548 X Return Table

Functionality
BAPI for changing a purchase contract.

Notes

  • Master conditions

    • When creating outline agreements, you can specify only one periodper variable key. This means that just one period can be specified forthe document header (i.e. condition table A019). The same applies toeach item (i.e. condition table A016) and to each item/plant combination(i.e. condition table A068).
    You can use any periods. However they must not overlap for a variablekey.
    When conditions are changed, new condition records are neverthelesswritten.
    • Because volume rebate conditions are not taken into account in
      • outline agreements, they are not processed.
      • No subitems (e.g. inclusive/exclusive bonus quantities, display,
        • etc.) are taken into account.
        • The control key for quality management in procurement
          • (EKPO-SSQSS) and the certificate category (EKPO-ZGTYP) are onlytaken into account to a certain extent. These two items of informationare copied from the reference contract or material master, but cannot bechanged; neither are any checks carried out for these two fields.
          • The revision level (EKPO-REVLV) cannot be changed because various
            • quality management routines were not implemented.
            • Version management (Document Change Management) is not supported.

            • External services (planned or unplanned) are not supported.

            • The creation or changing of configurations is not supported.

              • Further information
              When a purchase contract is changed (activity 02), the followingauthorization objects are checked:

              • M_RAHM_BSA Document type in contract

              • M_RAHM_EKG Purchasing group in contract

              • M_RAHM_EKO Purchasing organization in contract

              • M_RAHM_WRK Plant in contract

                • Description
                The parameter contains the header data of the purchase contract.

                Description
                This parameter contains the header data of the purchase contract.

                Description
                The parameter contains the change structure for the header data of thepurchase contract.

                Description
                Uniquely identifies an instance of thebusiness object
                BUS2014 (purchase contract).

                Default
                The parameter is mandatory.

                Description
                The following fields can be populated:

                • MESSAGING_APPL: Selection of application for message output

                • NO_MESSAGING: No message determination

                • NO_MESSAGE_REQ: Without message output

                • NO_AUTHORITY_CHECK: Do not carry out authorization check

                  • Value range
                  MESSAGING_APPL can have the following instances:

                  • A: Automatic determination of application

                  • B: Scheduling agreement output without schedule lines or contract

                  • C: Output scheduling agreement schedule lines (not relevant to purchase
                    • contracts)
                    • N: No message output

                      • The parameters NO_MESSAGING, NO_MESSAGE_REQ und NO_AUTHORITY_CHECK canbe:
                      • 'X' active

                        • or
                        • ' ' inactive.

                          • Description
                          The parameter TestRun is used in the writing BAPIs (CreateXXX andChangeXXX) to check the information on the instance prior to actualcreation of the object instance in the database. In the process, thecreation of the object instance is only simulated and the data is notupdated.

                          Value range
                          The parameter can have the following instances:

                          • 'X' describes the simulation mode

                          • ' ' describes the update run

                            • Description
                            The parameter specifies a vendor address that differs from the one inthe master record.

                            Description
                            The parameter contains the account assignment data for a contract item.

                            Value range
                            It is necessary to populate the item number ITEM_NO and the number ofthe account assignment SERIAL_NO, otherwise an assignment betweendatabase information (EKKN) and BAPI interface is not possible.

                            Description
                            The parameter contains the data on the basis of which a newprofitability segment(CO-PA) is created for the account assignment.
                            Upon creation, both the characteristics and the characteristic valuesare validated against the information specified in the system.

                            Description
                            The parameter contains the change parameter of the account assignmentdata for contract items.

                            Description
                            The parameter contains the delivery address per item. The system createsa separate address in Central Address Management for each address thatis passed on.

                            Description
                            INCLUDE BAPI_CONTRACT_SAG_MEANING OBJECT DOKU ID TX

                            Default
                            INCLUDE BAPI_CONTRACT_SAG_MEAN_DEF1 OBJECT DOKU ID TX

                            Description
                            INCLUDE BAPI_CONTRACT_SAG_MEANING OBJECT DOKU ID TX

                            Default
                            INCLUDE BAPI_CONTRACT_SAG_MEAN_DEF1 OBJECT DOKU ID TX

                            Description
                            This parameter contains the long texts of the contract header.

                            Default
                            The TEXT_ID field must always start with K. If you use adifferent value, it is automatically corrected by the BAPI.
                            Example:

                            • TEXT_ID ,,,,= 'K03'

                            • TEXT_FORM,, = '*'

                            • TEXT_LINE ,,,,= 'Hello World'

                            • DELETE_IND

                              • Description
                              INCLUDE BAPI_CONTRACT_SAG_KOND_KOPF OBJECT DOKU ID TX

                              Description
                              The parameter contains the change parameter for the master conditions ofthe contract header.

                              Description
                              INCLUDE BAPI_CONTRACT_SAG_KOND_KOPF OBJECT DOKU ID TX

                              Description
                              INCLUDE BAPI_CONTRACT_SAG_KOND_KOPF OBJECT DOKU ID TX

                              Description
                              INCLUDE BAPI_CONTRACT_SAG_KOND_KOPF OBJECT DOKU ID TX

                              Description
                              The parameter contains the change parameter for the validity period ofthe header master conditions.

                              Description
                              The parameter contains the general item data for a purchase contractinstance.

                              Description
                              The parameter contains the change parameter for the general item data ofa purchase contract instance.

                              Description
                              INCLUDE BAPI_CONTRACT_SAG_KOND_POSI OBJECT DOKU ID TX

                              Description
                              The parameter contains the change parameter for the item masterconditions.

                              Description
                              INCLUDE BAPI_CONTRACT_SAG_KOND_POSI OBJECT DOKU ID TX

                              Description
                              INCLUDE BAPI_CONTRACT_SAG_KOND_POSI OBJECT DOKU ID TX

                              Description
                              INCLUDE BAPI_CONTRACT_SAG_KOND_POSI OBJECT DOKU ID TX

                              Description
                              The parameter contains the change parameter for the validity period ofthe item master conditions.

                              Description
                              The TEXT_ID field must always start with K. If you use adifferent value, it is automatically corrected by the BAPI.
                              Beispiel:

                              • ITEM_NO,,,,= '00010'

                              • TEXT_ID,,,,= 'K03'

                              • TEXT_FORM,,= '*'

                              • TEXT_LINE,,= 'Hello World'

                              • DELETE_IND

                                • Description
                                The parameter contains the partner data for a purchase contract. You canspecify the partners at the following levels:

                                • Purchasing organization

                                • Purchasing organization and plant

                                • Purchasing organization, plant, and vendor subrange

                                  • Default
                                  Key fields are: partner role, plant, and vendor subrange.

                                  Description
                                  The parameter contains the change parameter for the partner data for apurchase contract.

                                  Default
                                  Key fields are: partner role, plant, and vendor subrange.

                                  Description
                                  The parameter returns the release order documentation for the currentpurchase contract on an item-wise basis.

                                  Description
                                  With this parameter, messages regarding exception situations or successmessages are returned to the calling program.
                                  Currently, it is only possible to assign the messages for the followingstructures/tables:

                                  • Header data HEADER

                                  • Item data ITEM

                                  • Account assignment data ACCOUNT

1548033Authorization check on transaction code ME32K
1075141BAPIs valid for usage with AFS6.0
1327694Dump Type conflict in MM-PUR BAPIs
1046794FAQ: BAPI for outline agreement