Description | Manage Foreign Trade Product Classifications |
Name | ManageForeignTradeProductClassificationIn |
Namespace | http://sap.com/xi/A1S/Global |
Process Component Description | Foreign Trade Product Classification |
Process Component Name | ForeignTradeProductClassification |
Process Component Namespace | http://sap.com/xi/FTA/ForeignTradeProductClassification/Global |
Deployment Unit Description | Foundation |
Endpoint Activation | By Scoping of Process Component | Operations |
Release Status | Released |
An interface to manage foreign trade product classifications.
A foreign trade product classification is the assignment of commodity codes required by authorities, to goods traded by a company.
The web service interface Maintain Foreign Trade Product Classifications enables you to classify the material with commodity codes based on the commodity catalog for foreign trade or statistical purpose.
The web service interface Maintain Foreign Trade Product Classifications offers the operation Maintain Bundle.
Configuration Settings
Material classification is enabled in your solution configuration. To find this business option, go to the Business Configuration work center and choose the Implementation Projects view.
Select your implementation project and click Edit Project Scope. In the Scoping step of the project, ensure that Materials is selected within Products, which is selected in General Business Data.
Communication Arrangement
In SAP Business ByDesign, go to the Application and User Management work center -> Input and Output Management -> Communication Arrangements and create a communication arrangement between your company and the manage material classification service.
For more information, see the Communication Arrangements Quick Guide in the Help Center of SAP Business ByDesign.
Maintain Bundle operations enable external applications to create and change business document data.
Action Code
Action codes represent an instruction to the recipient of the web service request to process transmitted message node elements.
Action Code | Description |
---|---|
01 | Create; the system returns an error message if the node element already exists. |
Communication Timeout
Maintain Bundle operation is mass-enabled stateless synchronous web service operation. Transferring or requesting amounts of data that are too large causes communication timeouts. The web service consumer is responsible for ensuring reasonable sizes of data for mass operation.
Response Message
The structure of the response message consists of two parts:
A business document-specific part containing information about IDs and UUIDs of the created and changed business documents
Log items containing system messages including errors, warnings, and information messages raised by the system during processing of the web service request
GDT Documentation
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.
How to extend your interfaces?
It is now possible from FP 4.0 onwards to use the extended fields in the service interfaces.
1. Navigate to the screen on which the extension field is available and select Enter Adaptation mode from the Adapt menu. In adaptation mode, select Edit Screen from the Adapt menu.
2. In the Adaptation panel, under Extension fields select the extension field from the list and under Field properties, click Further Usage.
3. On the Services tab, you will be able to add the extension field to the interface.
4. In the Message column, you can check if the extensibility is supported in the Request message and/or message structure.
Please consider that downloaded WSDLs might be become outdated by extension field changes. If required, download again after the changes and update your coding if required
Important - When a field is added, the name is not taken over 1:1 but shows a more technical name.
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.
You can use the Manage Foreign Trade Product Classification In web service in the following business scenarios:
To classify the material with commodity codes based on the commodity catalog for foreign trade or statistical purpose.
<n0:ForeignTradeProductClassificationBundleMaintainRequest_sync xmlns:n0="http://sap.com/xi/SAPGlobal20/Global"> <ForeignTradeProductClassification ActionCode="01"> <ObjectNodeSenderTechnicalID>Token 14</ObjectNodeSenderTechnicalID> <ProductKey> <ProductTypeCode>To</ProductTypeCode> <ProductIdentifierTypeCode>To</ProductIdentifierTypeCode> <ProductID schemeID="Token 20" schemeAgencyID="Token 21">MDECF-0001-IC01</ProductID> </ProductKey> <ValidityStartDate>2009-07-02</ValidityStartDate> <CustomsCommodityClassificationCode>81726354</CustomsCommodityClassificationCode> </ForeignTradeProductClassification> </n0:ForeignTradeProductClassificationBundleMaintainRequest_sync>
<n0:ForeignTradeProductClassificationBundleMaintainConfirmation_sync xmlns:n0="http://sap.com/xi/SAPGlobal20/Global" xmlns:prx="urn:sap.com:proxy:ACL:/1SAI/TAEA1C6B197A2EBDE1CEDC4:804"> <ForeignTradeProductClassification> <ReferenceObjectNodeSenderTechnicalID>Token 14</ReferenceObjectNodeSenderTechnicalID> <ChangeStateID>20130926092745.1855690</ChangeStateID> <UUID>00163e04-f8fb-1ee3-89d1-bcca72019949</UUID> <ProductKey> <ProductTypeCode>1</ProductTypeCode> <ProductIdentifierTypeCode>1</ProductIdentifierTypeCode> <ProductID>MDECF-0001-IC01</ProductID> </ProductKey> <ValidityStartDate>2009-07-02</ValidityStartDate> </ForeignTradeProductClassification> <Log /> </n0:ForeignTradeProductClassificationBundleMaintainConfirmation_sync>
Description | Maintain foreign trade product classification |
Name | MaintainBundle |
Synchronous | yes |
Release Status | Released |
To maintain one or more foreign trade product classifications.
The web service Maintain Foreign Trade Product classifications enable you to classify the material with commodity codes based on the commodity catalog for foreign trade or statistical purpose.
Configuration Settings
Material classification is enabled in your solution configuration. To find this business option, go to the Business Configuration work center and choose the Implementation Projects view.
Select your implementation project and click Edit Project Scope . In the Scoping step of the project, ensure that Materials is selected within Products,
which is selected in General Business Data.
Communication Arrangement
In SAP Business ByDesign, go to the Application and User Management work center -> Input and Output Management -> Communication Arrangements and create a communication arrangement between your company and the Manage Material Classification Service.
For more information, see the Communication Arrangements Quick Guide in the Help Center of SAP Business ByDesign.
The request message of the Maintain Bundle operation contains the ForeignTradeProductClassificationBundleMaintainConfirmation node, which contains all foregn trade product classification nodes.
Element | Remark |
---|---|
ObjectNodeSenderTechnicalID | Technical ID that the sender gives to a node, for example, 1, 2, 3. |
ChangeStateID | Not required |
ProductKey | Contains information regarding Product , it has sub-nodes |
ProductTypeCode | Possible values are: 1 - material; 2 - service |
ProductID | Product Identifier |
ValidityStartDate | Signifies date from which entered commodity code will be valid |
CustomsCommodityClassificationCode | Commodity code you intend to assign to the given material |
ProductQuantityConversionQuantity | Enter one unit of measure and quantity |
ProductQuantityConversionCorrespondingQuantity | Enter the other unit of measure and quantity |
The attributes are:
Attribute | Remark |
---|---|
actionCode | To create, set to value 01. |
unitCode | Unit Code for Quantity |
Sample:
<n0:ForeignTradeProductClassificationBundleMaintainRequest_sync xmlns:n0="http://sap.com/xi/SAPGlobal20/Global"> <ForeignTradeProductClassification ActionCode="01"> <ObjectNodeSenderTechnicalID>Token 14</ObjectNodeSenderTechnicalID> <ProductKey> <ProductTypeCode>To</ProductTypeCode> <ProductIdentifierTypeCode>To</ProductIdentifierTypeCode> <ProductID schemeID="Token 20" schemeAgencyID="Token 21">MDECF-0001-IC01</ProductID> </ProductKey> <ValidityStartDate>2009-07-02</ValidityStartDate> <CustomsCommodityClassificationCode>81726354</CustomsCommodityClassificationCode> </ForeignTradeProductClassification> </n0:ForeignTradeProductClassificationBundleMaintainRequest_sync>
A positive or negative reply to the request to maintain prdouct classifications. If the creation of one or more classification is not possible, no modification of the bundle is performed at all. If the creation of one or more invoices is possible (with or without errors), all product classifications are created. In all cases, all errors are returned.
The response contains two nodes that are described in the chapters below.
In the SAP Business ByDesign system, you can find the product classifications that the system created using the Manage Foriegn Trade Product Classification service in the following views of the Intrastat ,Product Data , Product and Service Portfolio , Exports work centes :
Work view of the Intrastat work center:
Under Commodity Classifications , you will find Material Classifications , you can check the status of material whether it is classified (assigned to commodity code) or unclassified (no commodity assigned yet).Note , similarly we can access material classification in rest of work centres mentioned above.
In this node all product classifications made by request are returned.
It contains the following elements:
Element | Remark |
ReferenceObjectNodeSenderTechnicalID | Technical ID that the sender gives to a node (for example 1, 2, 3, …) |
ChangeStateID | Not needed |
UUID | Technical Product uuid that the system assigns when it saves the product classification. |
Sample Response:
<n0:ForeignTradeProductClassificationBundleMaintainConfirmation_sync xmlns:n0="http://sap.com/xi/SAPGlobal20/Global" xmlns:prx="urn:sap.com:proxy:ACL:/1SAI/TAEA1C6B197A2EBDE1CEDC4:804"> <ForeignTradeProductClassification> <ReferenceObjectNodeSenderTechnicalID>Token 14</ReferenceObjectNodeSenderTechnicalID> <ChangeStateID>20130926092745.1855690</ChangeStateID> <UUID>00163e04-f8fb-1ee3-89d1-bcca72019949</UUID> <ProductKey> <ProductTypeCode>1</ProductTypeCode> <ProductIdentifierTypeCode>1</ProductIdentifierTypeCode> <ProductID>MDECF-0001-IC01</ProductID> </ProductKey> <ValidityStartDate>2009-07-02</ValidityStartDate> </ForeignTradeProductClassification> <Log /> </n0:ForeignTradeProductClassificationBundleMaintainConfirmation_sync>
Log
The sequence of messages that result when the request is executed.
Example of Log:-
<Log> <MaximumLogItemSeverityCode>3</MaximumLogItemSeverityCode> <Item> <TypeID>002(//FTA/BO_PRDUCTCLAS/)</TypeID> <CategoryCode>INC.BOI</CategoryCode> <SeverityCode>3</SeverityCode> <ReferenceObjectNodeSenderTechnicalID>1</ReferenceObjectNodeSenderTechnicalID> <Note>Commodity code 80002355 does not exist in the commodity catalog</Note> </Item> <Item> <TypeID>002(/AP_PAF_HELPER_TOOLS/)</TypeID> <CategoryCode>SEI.SCV</CategoryCode> <SeverityCode>3</SeverityCode> <ReferenceObjectNodeSenderTechnicalID>1</ReferenceObjectNodeSenderTechnicalID> <Note>Lowercase letters are not allowed in</Note> </Item> </Log>