bapi extension for sales order creation

3
SAP Note Header Data Symptom This note describes how to proceed if you implemented customer fields in SD tables VBAK, VBAP, and VBEP and now want to supply these fields with the SD BAPIs that have an EXTENSIONIN parameter. Other Terms Unicode Reason and Prerequisites * Solution Technical information on the customer enhancement concept The customer enhancement concept for BAPIs allows the processing of customer-specific fields by means of BAPI. In addition, SAP fields that were not taken into account by the developer during the BAPI implementation and thus do not belong to the standard functions of the BAPI can be processed customer-specifically. !!! If you use the extension parameters according to the BAPI programming guide or the documentation for the customer enhancement concept, only character-type field types are permitted !!! If nevertheless you require a processing of non character-type types, refer to Notes 700795 and 509898. The following description explains by means of an example how to proceed for customer enhancements to SD tables VBAK, VBKD, VBAP and VBEP. Initial situation: The customer has attached own fields to table VBAP, by means of INCLUDE structure CUTEST. This structure includes two fields: CFIELD1, CHAR 10 and CFIELD2, CHAR 3. These 2 fields should now also be maintainable via the BAPI. 1. Structure CUTEST is defined in table VBAP. 2. Since the BAPIs use checkbox structures, you also have to define a corresponding checkbox structure CUTESTX with the following setup for the customer structure: Field name Data element/component type CFIELD2 CHAR1 CFIELD2 CHAR1 3. Then you must use an Include or APPEND to define these customer structures in structures VBAPKOZ and VBAPKOZX. 4. Afterwards you must use the APPEND technique to append the customer structures to BAPI structures BAPE_VBAP and BAPE_VBAPX. 5. Adjust the following structures for customer enhancements in table VBAK: a) VBAKKOZ b) VBAKKOZX c) BAPE_VBAK d) BAPE_VBAKX 6. For customer enhancements on table VBKD that may have header VBKD fields and item VBKD fields, adjust the following structures: 143580 - Information on SD BAPIs and customer enhancement concept  Version 7 Validity:  21.06.2004 - active Language English Released On 21.06.2004 15:44:00 Release Status Released for Customer Component SD-SLS-GF-IF Sales Documents BAPI's CA-BFA-AAP BAPI Concept (for BAPIs see note 813411) Priority Recommendations / Additional Info Category Consulting Other Components

Upload: sapgak

Post on 10-Oct-2015

308 views

Category:

Documents


2 download

DESCRIPTION

BAPI Extension for Sales Order Creation

TRANSCRIPT

  • SAP Note

    Header Data

    Symptom

    This note describes how to proceed if you implemented customer fields in SD tables VBAK, VBAP, and VBEP and now want to supply these fields with the SD BAPIs that have an EXTENSIONIN parameter.

    Other Terms

    Unicode

    Reason and Prerequisites

    *

    Solution

    Technical information on the customer enhancement concept

    The customer enhancement concept for BAPIs allows the processing of customer-specific fields by means of BAPI. In addition, SAP fields that were not taken into account by the developer during the BAPI implementation and thus do not belong to the standard functions of the BAPI can be processed customer-specifically. !!! If you use the extension parameters according to the BAPI programming guide or the documentation for the customer enhancement concept, only character-type field types are permitted !!! If nevertheless you require a processing of non character-type types, refer to Notes 700795 and 509898. The following description explains by means of an example how to proceed for customer enhancements to SD tables VBAK, VBKD, VBAP and VBEP. Initial situation: The customer has attached own fields to table VBAP, by means of INCLUDE structure CUTEST. This structure includes two fields: CFIELD1, CHAR 10 and CFIELD2, CHAR 3. These 2 fields should now also be maintainable via the BAPI.

    1. Structure CUTEST is defined in table VBAP.

    2. Since the BAPIs use checkbox structures, you also have to define a corresponding checkbox structure CUTESTX with the following setup for the customer structure: Field nameData element/component type CFIELD2CHAR1 CFIELD2 CHAR1

    3. Then you must use an Include or APPEND to define these customer structures in structures VBAPKOZ and VBAPKOZX.

    4. Afterwards you must use the APPEND technique to append the customer structures to BAPI structures BAPE_VBAP and BAPE_VBAPX.

    5. Adjust the following structures for customer enhancements in table VBAK:

    a) VBAKKOZ

    b) VBAKKOZX

    c) BAPE_VBAK

    d) BAPE_VBAKX

    6. For customer enhancements on table VBKD that may have header VBKD fields and item VBKD fields, adjust the following structures:

    143580 - Information on SD BAPIs and customer enhancement concept

    Version 7 Validity: 21.06.2004 - active Language English

    Released On 21.06.2004 15:44:00 Release Status Released for Customer Component SD-SLS-GF-IF Sales Documents BAPI's

    CA-BFA-AAP BAPI Concept (for BAPIs see note 813411)

    Priority Recommendations / Additional Info Category Consulting

    Other Components

  • a) VBAKKOZ and VBAKKOZ

    b) VBAPKOZ and VBAPKOZX, if the commercial customer fields have to be supplied also on item level

    c) BAPE_VBAK and BAPE_VBAKX

    d) BAPE_VBAP and BAPE_VBAPX, if the commercial customer fields are supposed to be filled in also on item level.

    7. Adjust the following structures for customer enhancements in table VBEP:

    a) VBEPKOZ

    b) VBEPKOZX

    c) BAPE_VBEP

    d) BAPE_VBEPX

    8. In general, the data in the BAPI interface is stored in the internal communication structures (VBAKKOM and others). From there, this data is processed in SD tables (VBAK and others).

    9. If you fill parameter EXTENSIONIN with customer data, you must fill the corresponding standard parameters at least with the key fields. Example:In order 4711 customer field VBAP-CFIELD2 of item 20 should be changed to 'XYZ'. The following entries are required: Import:BAPIVBELN-VBELN = '0000004711'document number BAPISDHD1X-UPDATEFLAG = 'U' UPDKZ for document header Tables: BAPISDITM-ITM_NUMBER= '000020'item number BAPISDITMX-ITM_NUMBER = '000020'item number + BAPISDITMX-UPDATEFLAG = 'U'UPDKZ for item The EXTENSION table must be filled as follows: STRUCTUREVALUEPART11234567890123 BAPE_VBAP0000004711000020XYZ BAPE_VBAPX0000004711000020 X

    Additional information

    For additional information refer to the implementation guide for BAPI programming, chapter 'Customer enhancement concepts for BAPIs'. See also Note 170183.

    Validity

    This document is not restricted to a software component or software component version

    References

    This document refers to:

    SAP Notes

    This document is referenced by:

    SAP Notes (12)

    1807670 Incorrect enhancement category in BAPE_VBAKX 1071365 FAQ: New fields in R/3 system from EEW enhancements 1053817 Distributing customer-specific fields from CRM to R/3

    763791 BAPI_SALESORDER_SIMULATE delivery priority 700795 Enhancement category of BAPI enhancement structures 550431 FAQ: BAPI in sales - general questions 509898 BAPI enhancement concept and Unicode 414020 MASS: Customer fields are not mass-maintainable 356849 BAPI problems during customer enhancements of VBKD 150242 Including additional fields in interfaces 143602 Incorrect processing EXTENSIONIN in SD BAPIs

    93091 Information about the BAPIs in Sales and Distribution

    550431 FAQ: BAPI in sales - general questions 1053817 Distributing customer-specific fields from CRM to R/3

  • 509898 BAPI enhancement concept and Unicode 1807670 Incorrect enhancement category in BAPE_VBAKX 763791 BAPI_SALESORDER_SIMULATE delivery priority 1071365 FAQ: New fields in R/3 system from EEW enhancements 700795 Enhancement category of BAPI enhancement structures 356849 BAPI problems during customer enhancements of VBKD 414020 MASS: Customer fields are not mass-maintainable 93091 Information about the BAPIs in Sales and Distribution 150242 Including additional fields in interfaces 143602 Incorrect processing EXTENSIONIN in SD BAPIs