Kontakt

Ansicht
Dokumentation

BAPI_MATERIAL_BOM_GROUP_CREATE - Creation of a Material BOM Group

BAPI_MATERIAL_BOM_GROUP_CREATE - Creation of a Material BOM Group

RFUMSV00 - Advance Return for Tax on Sales/Purchases   CPI1466 during Backup  
This documentation is copyright by SAP AG.
SAP E-Book

Functionality

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.

Caution:

  • 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

Example

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

BOMGROUP

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.


VARIANTS

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

ITEMS

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.

SUBITEMS

Contains the sub item data

  • Quantity (SUBITEM_QTY)

  • Installation location (INSTALLATION_POINT)

and so on.

MATERIAL RELATIONS

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)

ITEMASSIGNMENTS

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.

SUBITEM ASSIGNMENTS

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 .

TEXTS

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.


Notes

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.

Further information





Parameters

ALL_ERROR
BOMGROUP
ITEMASSIGNMENTS
ITEMS
MATERIALRELATIONS
RETURN
SUBITEMASSIGNMENTS
SUBITEMS
TESTRUN
TEXTS
VARIANTS

Exceptions

Function Group

CPCC_BUS1080

BAL_S_LOG - Application Log: Log header data   Addresses (Business Address Services)  
This documentation is copyright by SAP AG.

Length: 12519 Date: 20240523 Time: 173213     sap01-206 ( 144 ms )