Description | Manage Production Bill of Material |
Name | ProductionModelManagementProductionBillOfMaterialMigrationIn |
Namespace | http://sap.com/xi/AP/PC/ProductionModelProcessing/Global |
Product | SAP Business ByDesign |
Process component | Production Model Management |
Process component namespace | http://sap.com/xi/AP/PC/ProductionModelProcessing/Global |
Deployment unit | Foundation |
Endpoint Activation | By Communication Arrangement | Operations |
|
Release Status | Not Released |
Technical documentation on the SAP API Business Hub | Manage Production Bill of Material |
General web service documentation | A2X Web Services (SOAP) |
An interface to create production bills of materials based on migration data.
The Production Bill of Material Migration In inbound service interface contains an operation that receives data for a production bill of material. This data is migrated from a source, for example, a system or a file, to a target system. Based on the data, the operation creates a complete production bill of material. This service is part of Communication Scenario Engineering Design Integration.
The service is part of Communication Arrangement Engineering Design Integration and this arrangement needs to be activated to consume this service.
The materials that are assigned to the production bill of material must be available in the target system before migrating the data.
If the production bill of material is migrated using Engineering Change Processing , the engineering change orders used in the production bill of material must be available in the target system before the data can be migrated.
Message Header specifies the information about the sender, and any information about the receiver.
Element | Description |
---|---|
CreationDateTime | Global Date Time |
SenderBusinessSystemID | Sender Business System ID |
RecipientBusinessSystemID | Recipient Business System ID |
Note : CreationDateTime must be in the format CCYY-MM-DDThh:mm:ss(.sss)Z .Example : 2009-11-02T11:00:48.000+01:00
The vale of RecipientBusinessSystemID should always be equal to _LOCAL_SYSTEM_ALIAS_SAP_INTERNAL_CONSTANT_VALUE_
Example of Request message:
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:glob="http://sap.com/xi/SAPGlobal/Global" xmlns:test="http://xiTest.com/xi/test"> <soapenv:Header/> <soapenv:Body> <glob:ProductionBillOfMaterialMigrateRequest> <MessageHeader> <ID>20091001002</ID> <CreationDateTime>2009-11-02T11:00:48.000+01:00</CreationDateTime> <SenderBusinessSystemID>SMARTBOM</SenderBusinessSystemID> <RecipientBusinessSystemID>_LOCAL_SYSTEM_ALIAS_SAP_INTERNAL_CONSTANT_VALUE_</RecipientBusinessSystemID> <BusinessScope> <TypeCode>3</TypeCode> <ID>229</ID> </BusinessScope> </MessageHeader> <ProductionBillOfMaterial> <ID>MIG_DEMO1</ID> <ItemGroup> <ID>ASSEMBLED_CYLINDER</ID> <Item> <ID>10</ID> <ItemChangeState> <EngineeringChangeOrderID>MTS_FRIII_1</EngineeringChangeOrderID> <MaterialID>MCA-0001</MaterialID> <Quantity unitCode="EA">1.0</Quantity> </ItemChangeState> </Item> <Description> <Description languageCode="EN">Assembled Cylinder</Description> </Description> </ItemGroup> <Variant <ID>1</ID> <MaterialID>MCF-0001</MaterialID> <Quantity unitCode="EA">1.0</Quantity> <ItemChangeStateAssignment> <BillOfMaterialItemGroupID>ASSEMBLED_CYLINDER</BillOfMaterialItemGroupID> <BillOfMaterialItemGroupItemID>10</BillOfMaterialItemGroupItemID> <EngineeringChangeOrderID>MTS_FRIII_1</EngineeringChangeOrderID> </ItemChangeStateAssignment> <Description> <Description languageCode="EN">variant</Description> </Description> <TextCollection> <TextCollection> <Text> <TypeCode>10018</TypeCode> <ContentText languageCode="EN">variant</ContentText> </Text> </TextCollection> </TextCollection> <ConsistencyIndicator>false</ConsistencyIndicator> </Variant> <Description> <Description languageCode="EN">test</Description> </Description> </ProductionBillOfMaterial> </glob:ProductionBillOfMaterialMigrateRequest> </soapenv:Body> </soapenv:Envelope>
You can find the documentation of the global data types in the SAP Community Network. Go to http://scn.sap.com/docs/DOC-17516 and click "View Document".
You can find general information about Web services, their structure and consumption in the Web Services documentation. Please open the Web Services document in a new window.
Sample example of web service request that requests to create production bill of material with one item group and one variant.
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:glob="http://sap.com/xi/SAPGlobal/Global" xmlns:test="http://xiTest.com/xi/test"> <soapenv:Header/> <soapenv:Body> <glob:ProductionBillOfMaterialMigrateRequest> <MessageHeader> <ID>20091001002</ID> <CreationDateTime>2009-11-02T11:00:48.000+01:00</CreationDateTime> <SenderBusinessSystemID>SMARTBOM</SenderBusinessSystemID> <RecipientBusinessSystemID>_LOCAL_SYSTEM_ALIAS_SAP_INTERNAL_CONSTANT_VALUE_</RecipientBusinessSystemID> <BusinessScope> <TypeCode>3</TypeCode> <ID>229</ID> </BusinessScope> </MessageHeader> <ProductionBillOfMaterial> <ID>MIG_DEMO1</ID> <ItemGroup> <ID>ASSEMBLED_CYLINDER</ID> <Item> <ID>10</ID> <ItemChangeState> <EngineeringChangeOrderID>MTS_FRIII_1</EngineeringChangeOrderID> <MaterialID>MCA-0001</MaterialID> <Quantity unitCode="EA">1.0</Quantity> </ItemChangeState> </Item> <Description> <Description languageCode="EN">Assembled Cylinder</Description> </Description> </ItemGroup> <Variant> <ID>1</ID> <MaterialID>MCF-0001</MaterialID> <Quantity unitCode="EA">1.0</Quantity> <ItemChangeStateAssignment> <BillOfMaterialItemGroupID>ASSEMBLED_CYLINDER</BillOfMaterialItemGroupID> <BillOfMaterialItemGroupItemID>10</BillOfMaterialItemGroupItemID> <EngineeringChangeOrderID>MTS_FRIII_1</EngineeringChangeOrderID> </ItemChangeStateAssignment> <Description> <Description languageCode="EN">variant</Description> </Description> <TextCollection> <TextCollection> <Text> <TypeCode>10018</TypeCode> <ContentText languageCode="EN">variant</ContentText> </Text> </TextCollection> </TextCollection> <ConsistencyIndicator>false</ConsistencyIndicator> </Variant> <Description> <Description languageCode="EN">test</Description> </Description> </ProductionBillOfMaterial> </glob:ProductionBillOfMaterialMigrateRequest> </soapenv:Body> </soapenv:Envelope>
Sample example of web service request that requests to create production bill of material with two item groups and one variant.
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:glob="http://sap.com/xi/SAPGlobal/Global" xmlns:test="http://xiTest.com/xi/test"> <soapenv:Header/> <soapenv:Body> <glob:ProductionBillOfMaterialMigrateRequest> <MessageHeader> <ID>20091001002</ID> <CreationDateTime>2009-11-02T11:00:48.000+01:00</CreationDateTime> <SenderBusinessSystemID>SMARTBOM</SenderBusinessSystemID> <RecipientBusinessSystemID>_LOCAL_SYSTEM_ALIAS_SAP_INTERNAL_CONSTANT_VALUE_</RecipientBusinessSystemID> <BusinessScope> <TypeCode>3</TypeCode> <ID>229</ID> </BusinessScope> </MessageHeader> <ProductionBillOfMaterial> <ID>MIG_DEMO3</ID> <ItemGroup> <ID>ASSEMBLED_CYLINDER</ID> <Item> <ID>10</ID> <ItemChangeState> <EngineeringChangeOrderID>MTS_FRIII_1</EngineeringChangeOrderID> <MaterialID>MCA-0001</MaterialID> <Quantity unitCode="EA">1.0</Quantity> </ItemChangeState> </Item> <Description> <Description languageCode="EN">Assembled Cylinder</Description> </Description> </ItemGroup> <ItemGroup> <ID>ASSEMBLED_CYLINDER_01</ID> <Item> <ID>10</ID> <ItemChangeState> <EngineeringChangeOrderID>MTS_FRIII_2</EngineeringChangeOrderID> <MaterialID>MCA-0001</MaterialID> <Quantity unitCode="EA">1.0</Quantity> </ItemChangeState> </Item> <Description> <Description languageCode="EN">Assembled Cylinder</Description> </Description> </ItemGroup> <Variant> <ID>1</ID> <MaterialID>MCF-0001</MaterialID> <Quantity unitCode="EA">1.0</Quantity> <ItemChangeStateAssignment> <BillOfMaterialItemGroupID>ASSEMBLED_CYLINDER</BillOfMaterialItemGroupID> <BillOfMaterialItemGroupItemID>10</BillOfMaterialItemGroupItemID> <EngineeringChangeOrderID>MTS_FRIII_1</EngineeringChangeOrderID> </ItemChangeStateAssignment> <Description> <Description languageCode="EN">variant</Description> </Description> <TextCollection> <TextCollection> <Text> <TypeCode>10018</TypeCode> <ContentText languageCode="EN">variant</ContentText> </Text> </TextCollection> </TextCollection> <ConsistencyIndicator>false</ConsistencyIndicator> </Variant> <Description> <Description languageCode="EN">test</Description> </Description> </ProductionBillOfMaterial> </glob:ProductionBillOfMaterialMigrateRequest> </soapenv:Body> </soapenv:Envelope>
Sample example of web service request that requests to create production bill of material with one item group, two items and one variant.
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:glob="http://sap.com/xi/SAPGlobal/Global" xmlns:test="http://xiTest.com/xi/test"> <soapenv:Header/> <soapenv:Body> <glob:ProductionBillOfMaterialMigrateRequest> <MessageHeader> <ID>20091001002</ID> <CreationDateTime>2009-11-02T11:00:48.000+01:00</CreationDateTime> <SenderBusinessSystemID>SMARTBOM</SenderBusinessSystemID> <RecipientBusinessSystemID>_LOCAL_SYSTEM_ALIAS_SAP_INTERNAL_CONSTANT_VALUE_</RecipientBusinessSystemID> <BusinessScope> <TypeCode>3</TypeCode> <ID>229</ID> </BusinessScope> </MessageHeader> <ProductionBillOfMaterial> <ID>MIG_DEMO4</ID> <ItemGroup> <ID>ASSEMBLED_CYLINDER</ID> <Item> <ID>10</ID> <ItemChangeState> <EngineeringChangeOrderID>MTS_FRIII_1</EngineeringChangeOrderID> <MaterialID>MCA-0001</MaterialID> <Quantity unitCode="EA">1.0</Quantity> </ItemChangeState> </Item> <Item> <ID>20</ID> <ItemChangeState> <EngineeringChangeOrderID>MTS_FRIII_1</EngineeringChangeOrderID> <MaterialID>MCA-0001</MaterialID> <Quantity unitCode="EA">1.0</Quantity> </ItemChangeState> </Item> <Description> <Description languageCode="EN">Assembled Cylinder</Description> </Description> </ItemGroup> <Variant> <ID>1</ID> <MaterialID>MCF-0001</MaterialID> <Quantity unitCode="EA">1.0</Quantity> <ItemChangeStateAssignment> <BillOfMaterialItemGroupID>ASSEMBLED_CYLINDER</BillOfMaterialItemGroupID> <BillOfMaterialItemGroupItemID>10</BillOfMaterialItemGroupItemID> <EngineeringChangeOrderID>MTS_FRIII_1</EngineeringChangeOrderID> </ItemChangeStateAssignment> <Description> <Description languageCode="EN">variant</Description> </Description> <TextCollection> <TextCollection> <Text> <TypeCode>10018</TypeCode> <ContentText languageCode="EN">variant</ContentText> </Text> </TextCollection> </TextCollection> <ConsistencyIndicator>false</ConsistencyIndicator> </Variant> <Description> <Description languageCode="EN">test</Description> </Description> </ProductionBillOfMaterial> </glob:ProductionBillOfMaterialMigrateRequest> </soapenv:Body> </soapenv:Envelope>
Description | Create production bill of material |
Name | CreateProductionBillOfMaterial |
Synchronous | no |
Release Status | Released |
To create a production bill of material based on uploaded migration data.
The Create Production Bill of Material inbound operation creates a complete production bill of material based on bill of material data. This data is migrated from a source, for example, a system or file, to a target system. The operation can create a production bill of material with multiple variants, item change states, and item groups.
The following table shows the list of attributes for the request message header:
Parameters | Remarks |
---|---|
ID | Identification |
UUID | Universally Unique Identification |
ReferenceID | Reference Identification |
ReferenceUUID | Reference UUID |
CreationDateTime | Global Date Time |
TestDataIndicator | Indicates if the business data contained in the message is test data or not |
ReconciliationIndicator | Indicates if the message is a reconciliation message or not. This element is optional. |
SenderBusinessSystemID | Identifier of the business system that sent a business document |
RecipientBusinessSystemID | Identifier of the business system that receives a Business Document |
SenderParty | Party that creates and sends the business document at business application level |
RecipientParty | Party that receives and processes the business document at business application level |
<MessageHeader> <ID>20091001002</ID> <CreationDateTime>2009-11-02T11:00:48.000+01:00</CreationDateTime> <SenderBusinessSystemID>SMARTBOM</SenderBusinessSystemID> <RecipientBusinessSystemID>_LOCAL_SYSTEM_ALIAS_SAP_INTERNAL_CONSTANT_VALUE_ </RecipientBusinessSystemID> <BusinessScope> <TypeCode>3</TypeCode> <ID>229</ID> </BusinessScope> </MessageHeader>
The following table shows the list of attributes for the request message types that can be used for creating production bill of material (PBOM):
Parameters | Remarks |
---|---|
ID | Bill Of Material ID |
ItemGroup | PBOM Migrate Request Item Group |
Variant | PBOM Migrate Request Variant |
AttachmentFolder | PBOM Migrate Request Attachment Folder |
Description | PBOM Description |
TextCollection | PBOM Text Collection |
<ProductionBillOfMaterial> <ID>MIG_DEMO1</ID> <ItemGroup> <ID>ASSEMBLED_CYLINDER</ID> <Item> <ID>10</ID> <ItemChangeState> <EngineeringChangeOrderID>MTS_FRIII_1</EngineeringChangeOrderID> <MaterialID>MCA-0001</MaterialID> <Quantity unitCode="EA">1.0</Quantity> </ItemChangeState> </Item> <Description> <Description languageCode="EN">Assembled Cylinder</Description> </Description> </ItemGroup> <Variant> <ID>1</ID> <MaterialID>MCF-0001</MaterialID> <Quantity unitCode="EA">1.0</Quantity> <ItemChangeStateAssignment> <BillOfMaterialItemGroupID>ASSEMBLED_CYLINDER</BillOfMaterialItemGroupID> <BillOfMaterialItemGroupItemID>10</BillOfMaterialItemGroupItemID> <EngineeringChangeOrderID>MTS_FRIII_1</EngineeringChangeOrderID> </ItemChangeStateAssignment> <Description> <Description languageCode="EN">variant</Description> </Description> <TextCollection> <TextCollection> <Text> <TypeCode>10018</TypeCode> <ContentText languageCode="EN">variant</ContentText> </Text> </TextCollection> </TextCollection> <ConsistencyIndicator>false</ConsistencyIndicator> </Variant> <Description> <Description languageCode="EN">test</Description> </Description> </ProductionBillOfMaterial>
The following table shows the list of attributes for ItemGroup node under PBOM Migrate Request:
Parameters | Remarks |
---|---|
ID | Bill Of Material Item Group ID |
RequiredIndicator | Required Indicator |
MultipleSelectionAllowedIndicator | Multiple Selection Allowed Indicator |
Item | PBOM Migrate Request Item Group Item |
<ItemGroup> <ID>ASSEMBLED_CYLINDER</ID> <Item> <ID>10</ID> <ItemChangeState> <EngineeringChangeOrderID>MTS_FRIII_1</EngineeringChangeOrderID> <MaterialID>MCA-0001</MaterialID> <Quantity unitCode="EA">1.0</Quantity> </ItemChangeState> </Item> <Description> <Description languageCode="EN">Assembled Cylinder </Description> </Description> </ItemGroup>
The following table shows the list of attributes for Item node under PBOM Migrate Request:
Parameters | Remarks |
---|---|
ID | Bill Of Material Item Group Item ID |
ItemChangeState | PBOM Migrate Request Item Group Item Change State |
<Item> <ID>10</ID> <ItemChangeState> <EngineeringChangeOrderID>MTS_FRIII_1</EngineeringChangeOrderID> <MaterialID>MCA-0001</MaterialID> <Quantity unitCode="EA">1.0</Quantity> </ItemChangeState> </Item>
The following table shows the list of attributes for ItemChangeState node under PBOM Migrate Request:
Parameters | Remarks |
---|---|
EngineeringChangeOrderID | External key for identification of engineering change order that is assigned to a BillOfMaterial ItemChangeState |
MaterialID | External key for identification of material which is assigned to a BillOfMaterial ItemChangeState |
Quantity | Quantity of the assigned component material |
<ItemChangeState> <EngineeringChangeOrderID>MTS_FRIII_1</EngineeringChangeOrderID> <MaterialID>MCA-0001</MaterialID> <Quantity unitCode="EA">1.0</Quantity> </ItemChangeState>
The following table shows the list of attributes for Variant node under PBOM Migrate Request:
Parameters | Remarks |
---|---|
ID | Bill Of Material Variant ID |
MaterialID | Product ID |
Quantity | Quantity |
QuantityTypeCode | Quantity Type Code |
ProductRequirementSpecificationID | Requirement Specification ID |
Assignment | PBOM Migrate Request Variant Item Change State Assignment |
ConsistencyIndicator | Consistency Indicator |
<Variant> <ID>1</ID> <MaterialID>MCF-0001</MaterialID> <Quantity unitCode="EA">1.0</Quantity> <ItemChangeStateAssignment> <BillOfMaterialItemGroupID>ASSEMBLED_CYLINDER</BillOfMaterialItemGroupID> <BillOfMaterialItemGroupItemID>10</BillOfMaterialItemGroupItemID> <EngineeringChangeOrderID>MTS_FRIII_1</EngineeringChangeOrderID> </ItemChangeStateAssignment> <Description> <Description languageCode="EN">variant</Description> </Description> <TextCollection> <TextCollection> <Text> <TypeCode>10018</TypeCode> <ContentText languageCode="EN">variant</ContentText> </Text> </TextCollection> </TextCollection> <ConsistencyIndicator>false</ConsistencyIndicator> </Variant>
Example of web service request that requests to create production bill of material with one item group and one variant.
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:glob="http://sap.com/xi/SAPGlobal/Global" xmlns:test="http://xiTest.com/xi/test"> <soapenv:Header/> <soapenv:Body> <glob:ProductionBillOfMaterialMigrateRequest> <MessageHeader> <ID>20091001002</ID> <CreationDateTime>2009-11-02T11:00:48.000+01:00</CreationDateTime> <SenderBusinessSystemID>SMARTBOM</SenderBusinessSystemID> <RecipientBusinessSystemID>_LOCAL_SYSTEM_ALIAS_SAP_INTERNAL_CONSTANT_VALUE_</RecipientBusinessSystemID> <BusinessScope> <TypeCode>3</TypeCode> <ID>229</ID> </BusinessScope> </MessageHeader> <ProductionBillOfMaterial> <ID>MIG_DEMO1</ID> <ItemGroup> <ID>ASSEMBLED_CYLINDER</ID> <Item> <ID>10</ID> <ItemChangeState> <EngineeringChangeOrderID>MTS_FRIII_1</EngineeringChangeOrderID> <MaterialID>MCA-0001</MaterialID> <Quantity unitCode="EA">1.0</Quantity> </ItemChangeState> </Item> <Description> <Description languageCode="EN">Assembled Cylinder</Description> </Description> </ItemGroup> <Variant> <ID>1</ID> <MaterialID>MCF-0001</MaterialID> <Quantity unitCode="EA">1.0</Quantity> <ItemChangeStateAssignment> <BillOfMaterialItemGroupID>ASSEMBLED_CYLINDER</BillOfMaterialItemGroupID> <BillOfMaterialItemGroupItemID>10</BillOfMaterialItemGroupItemID> <EngineeringChangeOrderID>MTS_FRIII_1</EngineeringChangeOrderID> </ItemChangeStateAssignment> <Description> <Description languageCode="EN">variant</Description> </Description> <TextCollection> <TextCollection> <Text> <TypeCode>10018</TypeCode> <ContentText languageCode="EN">variant</ContentText> </Text> </TextCollection> </TextCollection> <ConsistencyIndicator>false</ConsistencyIndicator> </Variant> <Description> <Description languageCode="EN">test</Description> </Description> </ProductionBillOfMaterial> </glob:ProductionBillOfMaterialMigrateRequest> </soapenv:Body> </soapenv:Envelope>