SAP Function Modules

Share |

BAPI_MATERIAL_BOM_GROUP_CREATE SAP Function module - Creation of a Material BOM Group

BAPI_MATERIAL_BOM_GROUP_CREATE is a standard SAP function module that performs Creation of a Material BOM Group functionality. This is available within standard R/3 SAP systems depending on version and release level.

Below are the pattern details for this FM showing its interface including any import, export and tables parameters. There is also a list of Exceptions and for your convenience any standard documentation available. All this information and more can also be viewed if you enter the function module name BAPI_MATERIAL_BOM_GROUP_CREATE into the relevant SAP transaction such as SE37 or SE80.

Contribute (Add Comments)
Within the comments section below there is also an opportunity for you to add useful hints, tips and information specific to this SAP function. This will then be available for you and other users to easily find by simply searching on the object name BAPI_MATERIAL_BOM_GROUP_CREATE or its description.

Associated Function Group: CPCC_BUS1080
Released Date: 04.02.2000
*   testrun = SPACE             " bapiflag      Switch to Simulation Session for Write BAPIs
*   all_error = SPACE           " xflag         Output All Errors
    bomgroup =                  " bapi1080_bgr_c  BOM group CREATE-/CHANGE BAPI material BOM
    variants =                  " bapi1080_bom_c  Alternative/Variant CREATE-/CHANGE BAPI Material BOM
*   items =                     " bapi1080_itm_c  Components CREATE-/CHANGE BAPI Material BOM
*   subitems =                  " bapi1080_sui_c  Sub item CREATE-/CHANGE BAPI Material BOM
    materialrelations =         " bapi1080_mbm_c  Material assignment CREATE-/CHANGE BAPI Material BOM
*   itemassignments =           " bapi1080_rel_itm_bom_c  Assignments CREATE-/CHANGE BAPI ITM/BOM material BOMs
*   subitemassignments =        " bapi1080_rel_sui_itm_c  Assignments CREATE-/CHANGE BAPI SUI/ITM Mat.BOMs
*   texts =                     " bapi1080_txt_c  Long text line: CREATE-/CHANGE BAPI for material BOMs
    return =                    " bapiret2      Return parameter



This method enables you to create a material BOM with all its assigned objects.

In extreme case, the entire BOM group can be transferred, that means
  • All variants of a variant BOM or alternatives of a multiple BOM

  • The entire history

  • All material assignments

  • All items

  • All subitems

  • This enables the the data to be transferred from the non-SAP system in one step.

  • Make sure that a BOM can not be transferred several times. That also means that you can not first transfer a part of the BOM group, such as part of the variants or items (particularly with regard to history) and then in a second run, transfer the rest (additional variants, assignments, other historical statuses and so on).

  • A prerequisite for the successful transfer of a BOM, is that all business objects, to which a BOM refer have first been transferred into the SAP System. These are

  • Material masters

  • Document info records, provided document items exist in the BOM

  • Classes, provided class items are to be transferred

  • Change numbers tha control the change status of the BOMs

  • Standard texts, provided they are to be included in the long text of the BOM group, variants or items


    You want to transfer several (entire) BOM groups with complete history.
  • In other words, the variants (in the case of variant BOMs) or alternatives (in the case of multiple BOMs) with their history and assigned long texts.

  • The assignment of assembly materials - possibly from different plants - to BOMs.

  • The corresponding items with their historical statuses and their long texts.

  • The sub items of these items

  • For this you generate entries in the following tables, which are organized into three categories.
  • Tables that define objects

  • BOMGROUP,,,,,,-,,,,Basic data for the entire BOM group

  • VARIANTS,,,,,,,,-,,,,Variant or alternative data

  • ITEMS,,,,,,,,-,,,,Items

  • SUBITEMS,,,,,,,,-,,,,Subitems

  • Tables that define the relationship between objects

  • MATERIALRELATIONS,,,,-,,Assignment of the header materials to the BOM groups, with the relevant requirements

  • ITEMASSIGNMENTS,,,,-,,Assignment requirements of the components to the variants or alternatives

  • SUBITEMASSIGNMENTS,,,,-,,Assignments of subitems to items

  • Tables with other assigned attributes

  • TEXTS,,,,-,,Long texts for individual objects

  • The BOM groups are cumulated within the running transfer with a unique group definition of up to 32 characters (BOM_GROUP_IDENTIFICATION). This is entered in all table entries. Provided an external (unique) BOM group is to be placed in the SAP System, this can be used for identification.
    Each object can be uniquely identified within a BOM group in the field OBJECT_ID. In order to be able to easily recognize the object in the data stream of the import, the field OBJECT_TYPE is also filled with the value:
  • BOM,,,,in the table VARIANTS

  • BGR,,,,in the table BOMGROUP

  • ITM,,,,in the table ITEMS

  • SUI,,,,in the table SUBITEMS

  • In addition to this general data, the tables are individually created as follows

    Contains the essential basic characteristics of a BOM group such as
  • BOM usage (BOM_USAGE)

  • Authorization group (AUTH_GROUP)

  • Description (BOM_TEXT)

  • and so on.

    Contain the variant specific data such as

  • Laboratory (LAB_DESIGN)

  • Base quantity to which the component quantities refer (BASE_QTY)

  • Validity entries such as change number (CHANGE_NO) and/or key date (VALID_FROM_DATE)

  • In the field FUNCTION you place the value
  • NEW,,,,if the variant runs in on a specified key date

  • DEL ,,,,if the variant runs out on a specified key date

    Contains the component attributes. Competing attributes that refer to primary objects, such as component material (COMPONENT), document number (DOCUMENT_NUMBER), class number (CLASS_NUM) are determined by the item category (ITEM_CAT). Read the information in SAP Customizing about the relevant item types and about the other attributes related to the specified primary objects.

    Contains the sub item data
  • Quantity (SUBITEM_QTY)

  • Installation location (INSTALLATION_POINT)

  • and so on.

    Contains - by entering the variant BOM number - the assignments of the assembly materials to the BOM with the requirements
  • Plant

  • Lot size area for multiple BOMs (LOT_SIZE_FROM, LOT_SIZE_TO)

    Assigns the components of the individual variants/alternatives to BOM groups.
    In the fields SUB_OBJECT_TYPE, SUB_OBJECT_ID you enter the BOM components and in the fields SUPER_OBJECT_TYPE, SUPER_OBJECT_ID you enter the variants/alternatives. This means, you deposit the values from the fields OBJECT_TYPE and OBJECT_ID from the table ITEMS in the field SUB_OBJECT_TYPE, SUB_OBJECT_ID and the values from the fields OBJECT_TYPE and OBJECT_ID from the table VARIANTS in the fields SUPER_OBJECT_TYPE, SUPER_OBJECT_ID .
    The validity of the assignments is determined by the valid-from date (VALID_FROM_DATE) or change number (CHANGE_NO)
    The field FUNCTION has to be scheduled with a value
  • NEW,,,,component created with this validity

  • DEL,,,,component deleted with this validity.

    Assigns the sub items to the components
    You enter the subitem in the fields SUB_OBJECT_TYPE, SUB_OBJECT_ID the components in the fields SUPER_OBJECT_TYPE, SUPER_OBJECT_ID. That means, you deposit the values from the fields OBJECT_TYPE and OBJECT_ID of table SUBITEMS into the fields SUB_OBJECT_TYPE, SUB_OBJECT_ID and the values from the fields OBJECT_TYPE and OBJECT_ID from table ITEMS into the fields SUPER_OBJECT_TYPE, SUPER_OBJECT_ID .

    The table TEXTS contains the individual long text lines for all the objects whose long texts can be assigned. The assignment to the relevant objects is produced in the fields OBJECT_TYP and OBJECT_ID.

    To secure the data in the database, you have to carry out a COMMIT WORK for each BOM group.
    All errors that occur are logged in the export parameter RETURN. In the case of inconsistencies, the entire BOM group to be generated is rejected.
    The messages specified in the export parameter RETURN, are arranged as follows:
  • Messages with the message Id BAPI provide information about the general results when processing the input.

  • 000,,Processing was successful

  • 001,,Processing failed

  • Messages with the message Id BAPI1080 provide detailed information about the processing.

  • The detail messages fall into two groups:
  • Message 028 highlights errors or warnings that result from the analysis of the structure of the transferred BOM data. In the case that only warnings are given then the processing has been continued and finished successfully provided no other error messages occur. Still, in this case, the warning should be followed.

  • Message 029 highlights errors in the data of the individual imported objects (variants, items and so on). The process is

  • cancelled.
    In addition to messages 028 and 029, other (error) messages are given, which better describe the affected sub-objects (variants, items and so on) or their relationship with each other. The identification of the object takes place using the message variable BOM_GROUP_IDENTIFICATION to identify the addected BOM group, and OBJECT_TYP and OBJECT_ID to identify the objects (variants, items and so on) within a group.
    Also (if available) the application log and/or the relevant internal message last set in the API are given in the export parameter RETURN.
    Documentation extract taken from SAP system, Copyright (c) SAP AG

    comments powered by Disqus