Create Part
The following API structure tables list all the APIs and the respective API fields that are required to create a material master record within the current version of SAP. These APIs are listed in the order in which they are invoked.
BAPI_MATERIAL_SAVEREPLICA
This API is used to create all material data in SAP and needs to be called for each material to be created in each plant. This API does not process multiple materials in multiple organizations with one API invocation. The following table provides details on this API.
* 
The BAPI_MATERIAL_SAVEREPLICA passes data in English. Additional characterization is required to render other supported languages.
Windchill Attribute Name
API Structure
API Field
API Field Description
Value (if Default used)
Source
Transform
number
HEAD
DATA
MATERIAL
Material
N/A
Windchill
N/A
partType
HEAD
DATA
MATL_
TYPE
Material type
N/A
Windchill
Cross Reference
N/A
HEAD
DATA
BASIC_
VIEW
Basic data view
X
Default
N/A
N/A
HEAD
DATA
IND-SECTOR
Industry sector
M
(Mechanical Engineering)
Default
N/A
N/A
HEAD
DATA
MRP_VIEW
MRP view
X
Default
N/A
defaultunit
CLIENT
DATA
BASE_
UOM
Basic unit of measure
N/A
Windchill
Cross Reference
defaultunit
CLIENT
DATAX
BASE_
UOM
Basic unit of measure
X
Default
N/A
N/A
MATERIAL DESCRIPTION
LANGU_
ISO
Language ISO
EN
Windchill
N/A
name
MATERIAL DESCRIPTION
MATL_
DESC
Material Description
N/A
Windchill
N/A
TargetID
PLANT
DATA
PLANT
Plant
N/A
Windchill
Sub-string
N/A
PLANT
DATA
MRP_TYPE
MRP Type
ND
Default
N/A
org
PLANT
DATAX
PLANT
Plant
N/A
Windchill
Sub-string
N/A
PLANT
DATAX
MRP_TYPE
MRP Type
X
Default
N/A
Source
PLANT
DATA
PROC_TYPE
Procurement Type
N/A
Windchill
Cross Reference
N/A
PLANT
DATAX
PROC_TYPE
Procurement Type
X
Default
N/A
* 
Note the following:
PlantData and PlantdataX should not contain duplicate values for that same part and plant combination. The same part and plant combination may exist in different views, such as design and manufacturing. For this reason you should only enter one entry for the same part and plant combination.
PRTDATA and PRTDATAX should only be populated for Process Material or Tooling of the category Tool, and not for Material.
The MRP view is only required when the Procurement Type (Source) is created or changed.
The procurement type in the PLANTDATA STRUCTURE is required if creating or changing the Procurement Type (Source).
The procurement type in the PLANTDATAX STRUCTURE is required if creating or changing the Procurement Type (Source).
CCAP_REV_LEVEL_MAINTAIN
This API creates a new revision level for the material created with BAPI_MATERIAL_SAVEREPLICA function. The revision level is created when a change number is defined and sent from Windchill PDMLink. The change master record for the change number must exist in SAP before running this API. The following table provides details on this API.
WC Attribute Name
API Structure
API Field
API Field Description
Value If Default
Source
Transform
Change number
HEADER
CHANGE _NO
Change Number
Windchill
N/A
N/A
HEADER
FL_ COMMIT_ AND_ WAIT
Flag for Commit and Wait
X
Default
N/A
Number
HEADER
MATERIAL
Material
Winchill
This should be the same value that was used for the BAPI_MATERIAL_SAVEREPLICA
N/A
Version
HEADER
REV_ LEVEL_ NEW
REV_ LEVEL_ NEW
Windchill
N/A
CALO_INIT_API
This API should be invoked before the CCAP_REV_LEVEL_MAINTAIN API is called to create a part revision level. It is not necessary to pass any data into this function module. The defaults written into the API when it is done executing meet theWindchill ESI requirements. The following table illustrates the defaults passed in automatically upon execution of this API and provides details on it.
Windchill Attribute Name
API Structure
API Field
API Field Description
Value If Default
Source
Transform
N/A
N/A
N/A
N/A
N/A
N/A
N/A
BAPI_TRANSACTION_COMMIT
This API is used to commit a transaction to the SAP system. If the return message generated from executing the BAPI_MATERIAL_SAVEREPLICA API is a success, then this API is executed. When this API is executed, all part data sent from Windchill PDMLink, if it includes plant data, it is committed to the MARA and MARC SAP database tables. Refer to the Windchill Enterprise Systems Integration Customizer's Guide - SAP for an explanation of howWindchill ESI interprets the results of the SAP API calls. The following table provides details on this API.
* 
No data is passed through the BAPI_TRANSACTION_COMMIT function module but it is necessary to call the module to release the material in case invalid data is passed through. There are no variations of data inputs for this API for different data requirements. Refer to theWindchill Enterprise Systems Integration Customizer's Guide - SAP for an explanation of how SAP APIs are called in sequence to execute eachWindchill ESI business function.
Windchill Attribute Name
API Structure
API Field
API Field Description
Value If Default
Source
Transform
N/A
HEADER
Wait
Wait
X
Default
N/A
BAPI_TRANSACTION_ROLLBACK
This API is used to rollback a transaction to the SAP distribution target. If the return message generated from the BAPI_MATERIAL_SAVEREPLICA function is not a success then this API is executed. When this API is executed, all part data sent fromWindchill PDMLink is rolled back, and if plant data is sent, it is not committed to the MARA and MARC SAP database tables. Refer to theWindchill Enterprise Systems Integration Customizer's Guide - SAP for an explanation of howWindchill ESI interprets the results of the SAP API calls. The following table provides details on this API.
* 
No data is passed through the BAPI_TRANSACTION_ROLLBACK function module but it is necessary to call the module. Refer to theWindchill Enterprise Systems Integration Customizer's Guide - SAP for an explanation of how SAP APIs are called in sequence to execute eachWindchill ESI business function.
Windchill Attribute Name
API Structure
API Field
API Field Description
Value If Default
Source
Transform
N/A
N/A
N/A
N/A
N/A
N/A
N/A
Was this helpful?