Item Import Overview~~~~~~~~~~~~~~~~~~~~~~~~~

Use the item import process to import items from your legacy system or PDMsystem. You can import items from any source into Oracle Inventory and OracleEngineering. When you import items through the Item Interface, you create newitems in your Item Master organization or assign existing items to additionalorganizations. You can specify values for all the item attributes, or you canspecify just a few attributes and let the remainder default or remain Null.You can also specify an item template for each item and inherit attributevalues from the template. The Item Interface also lets you import revisiondetails, including past and future revisions and effectivity dates.Validation of imported items is done using the same rules as the item definitionforms, so you are insured of valid items.

The Item Interface reads data from two tables for importing items and itemdetails. You use the MTL_SYSTEMS_ITEM_INTERFACE table for new item numbersand all item attributes. This is the main item interface table, and can bethe only table you choose to use. If you are importing revision details fornew items, you can use the MTL_ITEM_REVISIONS_INTERFACE table. A third table,MTL_INTERFACE_ERRORS, is used for error tracking of all items that the ItemInterface fails. You can import item categories using interface table calledas MTL_ITEM_CATEGORIES_INTERFACE.

Before you use the Item Interface, you must write and run a custom program thatextracts item information from your source system and inserts it into theMTL_SYSTEM_ITEM_INTERFACE table, and (if revision detail is included) theMTL_ITEMS_REVISIONS_INTERFACE table. After you load the items into theseinterface tables, you run the Item Interface to import the data. The ItemInterface assigns defaults, validates data you include, and then imports thenew items. You may also specify an item template for each item being imported.You must import items into the Item Master organization before you import itemsinto additional organizations. You can accomplish this by specifying only yourItem Master organization on first run of the Item Interface. Once this hascompleted, you can run the Item Interface again, this time specifying anadditional or all organizations. You can also use the Item Interface to importa single item material cost and material overhead, and revision details.

Below we will walk through few scenarios of item import and provide answers to frequently asked questions.Understanding Item Import and Debugging Problems with Item ImportScenario: 1Testing the basic item import with minimum columns populated.^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^First always try to populate the master organization with a sample record andtest.

1. How do I know my organization code and organization id ?Select organization_code , organization_id from org_organization_definitionsorder by organization_code;

Sample out put is below.

ORG ORGANIZATION_ID--- -------------------------------V1 204M1 207M2 209M3 606M4 1641M5 1642M6 1643M7 1644

2. How do I know which organization is master to a child organization?select a.organization_id ,a.organization_code,a.master_organization_id,b.organization_codefrom mtl_parameters a, org_organization_definitions bwhere a.master_organization_id = b.organization_idorder by a.organization_code;

Sample out put is below

ORGANIZATION_ID ORG MASTER_ORGANIZATION_ID ORG--------------------------- ------- ---------------------------------------- -------204 V1 204 V1207 M1 204 V1209 M2 204 V1606 M3 204 V11641 M4 204 V11642 M5 204 V11643 M6 204 V11644 M7 204 V1

In the above example for organizations M1 to M7, V1 organization is the master organization.

Populating V1 organization with one new item using just the basic columns.

Please truncate all IOI interface tables before loading mtl_system_items_interface:

ex. TRUNCATE TABLE

TRUNCATE TABLE INV.MTL_SYSTEM_ITEMS_INTERFACE;TRUNCATE TABLE INV.MTL_INTERFACE_ERRORS;TRUNCATE TABLE INV.MTL_ITEM_REVISIONS_INTERFACE;TRUNCATE TABLE INV.MTL_ITEM_CATEGORIES_INTERFACE;

Note: Truncate frees space, delete does not free space.

insert into mtl_system_items_interface(process_flag,set_process_id,transaction_type,organization_id,segment1,description)values(1,1,'CREATE',204,'TESTITEMIMPORT', 'Testing Item Import');commit;

In the above insert Process_Flag = 1. Only when process_flag = 1 will the itemimport program process the record.Set_Process_Id = 1. You can set which ever number you want for this column.This is basically used like a batch number. You can tell item import which setof records to process by entering a set_process_id.Transaction_Type is 'CREATE' when you are inserting new records and 'UDATE'when you are updating existing records.We are using organization_id 204 which is for master organization V1.Note: If you have more than one segment defined for items please populate allthose segments.To check which segments to be populated please got toSetup > Flexfields > Key > Segments . Now query up 'System Items' by puttingit in flexfield title.Select segments button, and now you should be able to see the differentsegments being defined.

Now run the item import program ie. Item > Import > Import Items.In Process Set enter 1 as we had used 1 in the set_process_id column. Nowenter 1 in create or update items field and hit OK button.You can check view requests to check whether your request has completedsuccessfully.Now go to master items screen and query on 'TESTITEMIMPORT' the item thatwe had populated and you should be able to see the item.

Similarly you can import the same item for the child organization. Eg. we wantitem 'TESTITEMIMPORT' in organization M1 say Seattle manufacturing then all Ihave to do is replace the organization_id by M1 organization_id. Now the insertstatement will look like this.insert into mtl_system_items_interface(process_flag, set_process_id, transaction_type,organization_id,segment1,description)values(1,1,'CREATE',207,'TESTITEMIMPORT', 'Testing Item Import');commit;Run the item import with the same parameters and then check if the concurrentrequest has completed successfully.Now do Change Organization and go to Organization Item screen and query upTESTITEMIMPORT and you should be able to see the item in M1 organization.Scenario: 2:To import items and use item templates.To see all template names run the following sql.select template_id,template_name,description from MTL_ITEM_TEMPLATES;

To see all the attributes related to template run the following sql.select template_id,attribute_name,enabled_flag,report_user_valuefrom MTL_ITEM_TEMPL_ATTRIBUTES where template_id = &template_id;Please subsitute the template id from the 1st query in the second queryto see the attribute values.In our example I am going to use Purchasing Template.select template_id,template_name,descriptionfrom MTL_ITEM_TEMPLATESwhere template_id = 259;

template_id template_name description----------- ------------- ----------------259 Purchased Item Purchased Item

We are going to insert a new item in the master organization and use thepurchasing template.

insert into mtl_system_items_interface(process_flag, set_process_id, transaction_type,organization_id,segment1,description,TEMPLATE_ID)values(1,1,'CREATE',204,'TESTTEMPLATE', 'Testing Item Import With Template',259);commit;Now run the item import program ie. Item > Import > Import Items.In Process Set enter 1 as we had used 1 in the set_process_id column. Now enter1 in create or update items field and hit OK button.You can check view requests to check whether your request has completedsuccessfully.Now go to master items screen and query on 'TESTTEMPLATE' the item that wehad populated and you should be able to see the item. Now you will see thatthe purchasing attributes are set because we used the purchasing template.

Note: Instead of using template_id we can use template_name and you shouldsee the same effect.insert into mtl_system_items_interface(process_flag, set_process_id, transaction_type,organization_id,segment1,description,TEMPLATE_NAME)values(1,1,'CREATE',204,'TESTTEMPLATE', 'Testing Item Import With Template','Purchased Item');commit;Scenario: 3To import items and material cost associated to it.First check which cost elements are defined for the organizaion.select cost_type_id,cost_type,description from CST_COST_TYPES;Output looks like this.

cost_type_id cost_type description------------ ------------- ------------------------------------1 Frozen Frozen Standard Cost Type2 Average Average Cost Type3 Pending Pending Standard Cost Type

To find the sub element name defined for your organization for a particularcost type please check bom resources table.In our example we are checking for material sub element in organization M1with organization_id = 207 for cost_code type 1.

select resource_code,description,cost_element_id,cost_code_typefrom bom_resources where organization_id = 207and cost_code_type= 1;

resource_code description cost_element_id cost_code_type----------------- -------------------------------- ------------------ -------------------Material Material Sub element 1 1Labor Labor Sub element 1 1Expense Expense Sub element 1 1

In our scenario we want to create a new item in organization M1 along withits material cost (say $11) assuming the same item is already created inmaster organization V1.

insert into mtl_system_items_interface(process_flag, set_process_id, transaction_type,organization_id,segment1,description,template_id,MATERIAL_COST,MATERIAL_SUB_ELEM)values(1,1,'CREATE',207,'TESTCOSTMATERIAL', 'Testing Item Material Cost Import',259,11,'Material');commit;

In the above sql you might have observed we are populating MATERIAL_COST andMATERIAL_SUB_ELEM.Similary we can use MATERIAL_SUB_ELEM_ID, MATERIAL_OH_RATE,MATERIAL_OH_SUB_ELEM and MATERIAL_OH_SUB_ELEM_ID colums.To check the subelements you can go to Cost management responsibility foryour organization and under Setup > Sub-Elements you will see the respectivesubelements being defined.

Now run the item import program ie. Item > Import > Import Items.In Process Set enter 1 as we had used 1 in the set_process_id column.Now enter 1 in create or update items field and hit OK button.You can check view requests to check whether your request has completedsuccessfully.Now go to organization items and query on 'TESTCOSTMATERIAL' the item thatwe had populated and you should be able to see the item.Go to Tools > Item Costs and then hit Open button from Item Cost Summary screenand you should see the details. In out example we see a material cost of $11for the item in cost type 'Frozen'(Standard Costing).

NOTE: Item import cannot be used to update item costs.~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~You have to populate CST_ITEM_CST_DTLS_INTERFACE,CST_RESOURCE_COSTS_INTERFACE,CST_RES_OVERHEADS_INTERFACE and CST_DEPT_OVERHEADS_INTERFACE accordingly.The concurrent request can be launched by navigating to cost->cost massedits->Import Cost Information.The parameters for the Cost Import concurrent program and their description isas follows :

Import Cost Option : A LOV is provided from which the user can select one ofthe import options which may be either to import Only item costs , Onlyresource costs , Only overhead rates or all the cost information .OptionTable from which data is processed

Only item costcst_item_cst_dtls_interface

Only resource costscst_resource_costs_interface

Only overhead ratescst_res_overheads_interface ,cst_dept_overheads_interface

All Cost InformationFrom all the four interface tables

Mode to run this request : A LOV is provided with possible twovalues , 'Insert new cost' or 'Remove and replace cost'.The 'Insert new cost' mode , is useful if you areimporting large # of items and are not sure if that Item/Organization/CostType combination already exists in the production tables, if it does then therow in the interface table would be flaged as errored and not imported.Thiswould prevent any accidental overwrite of already existing data.With 'Remove and replace cost' mode all theprevious cost information for this item, cost_type and organization combinationwill be deleted from the production tables and the new information willoverwrite (replace) the already existing one.

Group Id Option : A LOV is provided from which the user can eitherselect 'ALL' or 'Specific Group Id' . If the user wishes to submit multipleCost Import process requests he can do so by submitting one request per groupid. For doing so the data in the interface tables should be stamped withdistinct group id value by using the NEXTVAL from the sequence generatorCST_LISTS_S .The use of this sequence geneartor is a MUST for generatingmultiple groups or may lead to data corruption as these interface tables areused by other processes too.If the user selects "ALL" from the list then a group IDgenerated by a sequence will replace the group ID in the interface tables (ifany) and all the unprocessed rows from the four interface table (viz.cst_item_cst_dtls_interface , cst_resource_costs_interface ,cst_res_overheads_interface , cst_dept_overheads_interface ) will be processedin one run.

Cost type to import to : The user is provided with a LOV from which heneeds to select the cost type in which he wishes to import the costinformation. Even if the user has populated a cost type or cost type ID in theinterface tables, it would be overwritten with the one that is selected here.The cost types that the user can pick from is restricted to the multi-org,updateable cost types.

Delete succesfull rows : This parameter decides whether thesuccessfully processed rows should be deleted from the interface tables at theend of the run. If the user selects 'Yes' then all the successful rows bedeleted, basically rows that do not have their error flag set to "E".

Importing directly into Frozen/Average cost type (i.e non updateable cost types)and merging of new cost with existing costs is not supported at this time andwould still have to be processed by cost update routines. Also when importingthe costs from the interface table ,material overhead defaults (if any)specified for an Organization/Category would not be respected.

Minimum columns in each table that the user needs to provide1. CST_ITEM_CST_DTLS_INTERFACEThe columns that the user has to provide area. Inventory_item_idb. organization_ID or organization_code.c. resource_ID or resource_code for cost elements other than 1(material).If we are importing cost into material cost element and default materialsubelement has been specified on 'Define Organization parameters' formthen that would be respected unless the user overides it with a valuein this column.d. usage_rate_or_amounte. cost_element_ID or cost_elementf. Process Flag (must be set to 1)We default values for based_on_rollup, shrinkage_rate, inventory_asset_flag,lot_size from the row from CST_ITEM_COSTS for this item and the default costtype(default cost type of the cost type specified to import the costs into). Ifthere is no such row already defined in CST_ITEM_COSTS, then, the values forthese 4 columns also need to be specified and they have to be the same for allrows of this item, cost type and organization combination.

CST_RESOURCE_COSTS_INTERFACEa. Resource_ID or resource_codeb. organization_ID or organization_codec. resource_rated. Process_flag (must be set to 1)CST_RES_OVERHEADS_INTERFACEa. Resource_ID or resource_codeb. Overhead_ID or overheadc. Organization_ID or organization_coded. Process_flag(must be set to 1)CST_DEPT_OVERHEADS_INTERFACEa. Department_ID or departmentb. Overhead_ID or overheadc. Organization_IDd. Rate_or_amounte. Process_flag(must be set to 1)The other columns will be defaulted.

This is available for only 11.5.9 and above customers.Customers on 11.5.8 can apply patch 2193391 to get this functionality.

Please refer to costing Manuals for further details.^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^In case you have any questions please log a Support Request with the Costing Group^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^Sample cost update statement is below

INSERT INTO CST_ITEM_CST_DTLS_INTERFACE(INVENTORY_ITEM_ID,ORGANIZATION_ID,COST_TYPE,RESOURCE_CODE,USAGE_RATE_OR_AMOUNT,COST_ELEMENT_ID,PROCESS_FLAG)VALUES(9935,207,'Pending','Material',17,1,1);commit;Using this I update the pending cost for the item from $11 to $17.Now once the pending cost is updated you will have to use 'Update Standard Cost'Concurrent program to update Frozen cost for the item from the pending cost.Scenario: 4To import item and revisions associated to it.When ever you import a new item based on the Starting revision specified under'Revison/Lot/Serial' tab in organization parameters screen the default revisongets assigned to the item. For eg. the default revision in V1 organization is'A' when we do item import this revision gets associated to the item.Now lets import a new item with revision 'B' which is not the default revision.

insert into mtl_system_items_interface(process_flag, set_process_id, transaction_type,organization_id,segment1,description,REVISION)values(1,1,'CREATE',204,'TESTREVB1', 'Testing Item Revision','B');

Now run the item import program ie. Item > Import > Import Items.In Process Set enter 1 as we had used 1 in the set_process_id column.Now enter 1 in create or update items field and hit OK button.You can check view requests to check whether your request has completedsuccessfully.Now go to organization items and query on 'TESTREVB1' the item that wehad populated and you should be able to see the item.Go to Tools > Revisions and then you should be able to see two records onewith revision 'A' which is the default revision and another with revision 'B'that we had populated.

In case you want to import a new revision say revision 'C'. You directlypopulate the MTL_ITEM_REVISIONS_INTERFACE table and then run item import.

insert into MTL_ITEM_REVISIONS_INTERFACE(item_number,revision, revision_label,implementation_date, effectivity_date,process_flag, organization_id ,set_process_id, transaction_type)values('TESTREVB1','C','C',sysdate,sysdate,1,204,1,'CREATE');Commit;

Now run the item import.In Process Set enter 1 as we had used 1 in the set_process_id column.Now enter 1 in create or update items field and hit OK button.You can check view requests to check whether your request has completedsuccessfully.When you query up the item 'TESTREVB1' You will see the new revision 'C'.Scenario: 5Lets take into consideration we have to import more than two revisions along with item creation.We will be populating MTL_ITEM_REVISIONS_INTERFACE.The key point here is the IMPLEMENTATION_DATE should increment cronologically.

insert into mtl_system_items_interface(process_flag, set_process_id, transaction_type,organization_id,segment1,description)values(1,1,'CREATE',204,'TESTREVB2', 'Testing Item Revision');

insert into MTL_ITEM_REVISIONS_INTERFACE(item_number,revision, revision_label,implementation_date, effectivity_date,process_flag, organization_id ,set_process_id, transaction_type)values('TESTREVB2','A','A',sysdate,sysdate,1,204,1,'CREATE');insert into MTL_ITEM_REVISIONS_INTERFACE(item_number,revision, revision_label,implementation_date, effectivity_date,process_flag, organization_id ,set_process_id, transaction_type)values('TESTREVB2','B','B',sysdate+.0003472,sysdate+.0003472,1,204,1,'CREATE');

insert into MTL_ITEM_REVISIONS_INTERFACE(item_number,revision, revision_label,implementation_date, effectivity_date,process_flag, organization_id ,set_process_id, transaction_type)values('TESTREVB2','C','C',sysdate+.0023472,sysdate+.0023472,1,204,1,'CREATE');COMMIT;

Now run the item import program ie. Item > Import > Import Items.In Process Set enter 1 as we had used 1 in the set_process_id column. Now enter1 in create or update items field and hit OK button.You can check view requests to check whether your request has completedsuccessfully.Now go to organization items and query on 'TESTREVB2' the item that we hadpopulated and you should be able to see the item. Go to Tools > Revisions andthen you should be able to see three records one with revision 'A' ,another with revision 'B' and the thrid one is 'C' that we had populated.Note: We have been inctementing the minutes section by sysdate+.0003472and sysdate+.0023472 so that the implementation date is in cronological order.Scenario: 6Lets take into consideration we have to import item categories along with items.select category_id,structure_id,segment1,description,category_concat_segs,structure_namefrom mtl_categories_vwhere segment1 = 'DAIRY'order by category_id,structure_id;

category_id structure_id segment1description category_concat_segs structure_name---------------------------------------------------------------------------------------1440 51466 DAIRYDairy Products DAIRY Inventory Class

1861 51467 DAIRYDairy Products DAIRY Planning Class

1869 51470 DAIRYDairy Products DAIRY Sales Class

1886 51766 DAIRYDAIRY DAIRY L Product Line

select category_set_id,category_set_name,description,structure_name,structure_idfrom mtl_category_sets_v where category_set_name = 'Inventory Class';

category_set_id category_set_name description structure_namestructure_id---------------------------------------------------------------------90 Inventory Class Inventory Class Inventory Class51466In our example we want to use category 'DAIRY' which has a category_id of1440 and category set 'Inventory Class' which has category_set_id of 90.You can go to the application Setup > Items > Categories > Category Codesand using examine get the category id.You can go to the application Setup > Items > Categories > Category Setsand using examine get the category set id.

insert into mtl_system_items_interface(process_flag, set_process_id, transaction_type,organization_id,segment1,description)values(1,1,'CREATE',204,'TESTCATG1', 'Testing Item Categories');

insert into MTL_ITEM_CATEGORIES_INTERFACE(item_number,category_set_id, category_id,process_flag, organization_id ,set_process_id, transaction_type)values('TESTCATG1',90,1440,1,204,1,'CREATE');In the above insert statement you could use CATEGORY_SET_NAME and CATEGORY_NAMEinstead of CATEGORY_SET_ID and CATEGORY_ID.commit;

Now run the item import program ie. Item > Import > Import Items.In Process Set enter 1 as we had used 1 in the set_process_id column.Now enter 1 in create or update items field and hit OK button.You can check view requests to check whether your request has completedsuccessfully.Now go to organization items and query on 'TESTCATG1' the item that we hadpopulated and you should be able to see the item. Go to Tools > Categoriessand then you should be able to see category Dairy associated to the item.

To verify you can run the following querySelect * from MTL_ITEM_CATEGORIES where inventory_item_id in(select distinct inventory_item_id from mtl_system_items_b where segment1 = 'TESTCATG1');It shows one record.

NOTE: Populating set_process_id is mandatory for categories import. Please putthe same set process id when you run the import program.

Updating exsisting item categories:~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~Updated transaction can only be performed as a combination of DELETEassignment, then CREATE.Lets take our above example of item 'TESTCATG1' which has now category 'DAIRY'associated with it. I want to update category 'DAIRY' with a new category'BAKERY' whose category_id is 1436 for item 'TESTCATG1'.

insert into MTL_ITEM_CATEGORIES_INTERFACE(item_number,category_set_id, category_id,process_flag, organization_id ,set_process_id, transaction_type)values('TESTCATG1',90,1440,1,204,1,'DELETE');

insert into MTL_ITEM_CATEGORIES_INTERFACE(item_number,category_set_id, category_id,process_flag, organization_id ,set_process_id, transaction_type)values('TESTCATG1',90,1436,1,204,1,'CREATE');commit;

Run item import.In Process Set enter 1 as we had used 1 in the set_process_idcolumn. Now enter 2 in create or update items field as we are updating theexsisting item and changing its category. Hit OK button.You can check view requests to check whether your request has completedsuccessfully.When you query up item 'TESTCATG1' and select the categories from tools youwill find that the category 'BAKERY' is now asscoiated with the item.Scenario: 7Lets take into consideration we have to import item catalogs along with items.In our example we want to associate 'ADSL Modem' catalog to our item.

select ITEM_CATALOG_GROUP_ID,SEGMENT1 from MTL_ITEM_CATALOG_GROUPS_Bwhere ITEM_CATALOG_GROUP_ID = 161;ITEM_CATALOG_GROUP_ID SEGMENT1--------------------- ----------------------------------------161 ADSL Modem

select ITEM_CATALOG_GROUP_ID,ELEMENT_NAME,ELEMENT_SEQUENCE,DESCRIPTIONfrom mtl_descriptive_elementswhere ITEM_CATALOG_GROUP_ID = 161;

ITEM_CATALOG_GROUP_ID ELEMENT_NAME ELEMENT_SEQUENCE DESCRIPTION--------------------- ------------ ---------------- -----------161 2wire 10 2wire161 linksys 20 linksysdesc

insert into mtl_system_items_interface(process_flag, set_process_id, transaction_type,organization_id,segment1,description,ITEM_CATALOG_GROUP_ID)values(1,1,'CREATE',204,'TESTCATA1', 'Testing Item Catalog',161);commit;

Now run the item import program ie. Item > Import > Import Items.In Process Set enter 1 as we had used 1 in the set_process_id column. Now enter1 in create or update items field and hit OK button.You can check view requests to check whether your request has completedsuccessfully.Now go to organization items and query on 'TESTCATA1' the item that we hadpopulated and you should be able to see the item. Go to Tools > Catalogsand then you should be able to see 'ADSL Modem' along with descriptiveelements '2wire' and 'linksys'. In 11.5.9 you have to manually enter thevalues for descriptive elements. In 11.5.10 API to import descriptive elementvalues will be present.Scenario: 8Lets understand how to update existing items.Lets say I have an item 'ODC' which has no buyer code in Seattle organization(M1 organization code). I want to update and asscoiate 'West, Rod' as buyerto the item 'ODC'.First I check under Setup > Items > Attribute Contol to check if it controlledat the organization level or master level. In our case the attribute iscontrolled at the Org Level.Now we check if Rod exists in the list of valid buyers.

select agent_id,agent_name,start_date_active,end_date_activefrom PO_AGENTS_V where agent_name like '%Rod%';

agent_id agent_name start_date_active end_date_active-------- ---------- ----------------- ---------------10183 West, Rod 17-FEB-04

select inventory_item_id from mtl_system_items_bwhere segment1 = 'ODC'and organization_id = 207;207 organization id is for M1(Seattle organization)INVENTORY_ITEM_ID-----------------9372Now use the above values in the insert script.insert into mtl_system_items_interface(process_flag, set_process_id, transaction_type, organization_id,inventory_item_id, BUYER_ID)values(1,1,'UPDATE',207,9372,10183);commit;Now you will observe that the transaction type is 'UPDATE' because we areupdating an existing record. I am also using inventory_item_id because whenyou use id's the performance is better. And also when running the item importI use value 2 in create or update items field.

Now run the item import program ie. Item > Import > Import Items.In Process Set enter 1 as we had used 1 in the set_process_id column. Now enter2 in create or update items field and hit OK button.You can check view requests to check whether your request has completedsuccessfully.Now go to organization items and query on 'ODC' item in M1 organization. Underpurchasing tab you will see that the buyer 'West, Rod' populated.

Note:INCOIN does not support updating item numbers. Enhancement request 6507704already logged for this.Scenario: 9In this scenario you will learn how to populate character and number columns and make it null.Just from our above example we have buyer 'West, Rod' populated for item 'ODC'.Now for some reason we want to make null for buyer for item ODC.Buyer id column is a number column. To make it null we have to populate -999999.

insert into mtl_system_items_interface(process_flag, set_process_id, transaction_type, organization_id,inventory_item_id, BUYER_ID)values(1,1,'UPDATE',207,9372,-999999);commit;

Now run the item import program ie. Item > Import > Import Items.In Process Set enter 1 as we had used 1 in the set_process_id column. Now enter2 in create or update items field and hit OK button.You can check view requests to check whether your request has completedsuccessfully.Now go to organization items and query on 'ODC' item in M1 organization.Under purchasing tab you will see that the buyer field is updated to null.

Suppose planner 'S.Peters' is asscoiated to item ODC. You want to make it null.PLANNER_CODE in mtl_system_items_interface is a charracter type. To make itnull we have to use '!'.insert into mtl_system_items_interface(process_flag, set_process_id, transaction_type, organization_id,inventory_item_id, PLANNER_CODE)values(1,1,'UPDATE',207,9372,'!');commit;

Now run the item import program ie. Item > Import > Import Items.In Process Set enter 1 as we had used 1 in the set_process_id column. Now enter2 in create or update items field and hit OK button.You can check view requests to check whether your request has completedsuccessfully.Now go to organization items and query on 'ODC' item in M1 organization.Under general planning tab you will see that the planner is updated to null.Note: To make number columns null use -999999 and to make character columnsnull use '!' exclamation.Frequently Asked Questions (FAQ):a. How do I know what error has occurred?Ans . The process_flag in mtl_system_items_interface will be 3. Now the errormessage will be in mtl_interface_errors table.The record in mtl_system_items_interface will have a transaction_id.There will be corresponding record with error code and explanation inmtl_interface_errors.select transaction_id from mtl_system_items_interface where process_flag = 3;Now substitue the &transaction_id value in the following sql by the value thatyou get in the ablove sql. You should be able to see the error.select message_name,column_name,error_message from mtl_interface_errorswhere transaction_id = &transaction_id;b. What things should I check if I getting errors?Ans. First check if you are populating the correct values in all the fields.Then check if there are any mandatory descriptive flexfield columns. You cango to application setup > flexfields > descriptive > segments and on querytype ?Items? in title field and then check each segment whether it is mandatoryand whether it is doing any validation against some pre-existing values insome value set. If so check if the corresponding attributes are populatedproperly. Many times user forgets to populate mandatory values and item importfails.Also check for invalid objectsSelect object_name,object_type from all_objects where status = 'INVALID';If any invalid objects please recompile those and retest item import.c. I run item import but records are not getting processed. The process_flag is still 1.Ans. Check under sysadmin> concurrent managers whether inventory namageris running. Then check if there is suffcient memory and extent spaces.UseNote 1019721.6andNote 1020085.6to determine if there is a memory orextents issue. Please check if there is sufficient roll back segments ,system global area and tablespace.Please use the following truncate . This frees up space.TRUNCATE TABLE INV.MTL_SYSTEM_ITEMS_INTERFACE;TRUNCATE TABLE INV.MTL_INTERFACE_ERRORS;TRUNCATE TABLE INV.MTL_ITEM_REVISIONS_INTERFACE;TRUNCATE TABLE INV.MTL_ITEM_CATEGORIES_INTERFACE;Now try importing one record and see if you are able to import it successfully.If you see ORA-1654 happens while inserting records into mtl_pending_item_statustable in the log file (01654, 00000, "unable to extend index %s.%s by %sin tablespace %s") please use ALTER TABLESPACE ADD DATAFILE statement toadd one or more files to the tablespace indicated.d. What do I do to check more in to errors and see where the import is failing?Ans. From sysdamin please set the following profile options.INV: Debug Trace: set Yes to turn on the debug functionality.

INV:Debug Level: set 10 , to print the detail debug messages.

INV: Debug file (Including the complete path):The path is one of the directories from the validdirectories defined in the obtained v$parameterthrough the following sql :select valuefrom v$parameterwhere name = 'utl_file_dir';

Make sure to include the file name at the end of thepath,e.g. '//trx_mgr.log'

MRP: Debug Mode 'Yes'2. After setting the above system profile values go to Sysadmin > Concurrent >Program > Define. Query on short name 'INCOIN'. Now check enable trace and save.Now run the item import the log file of item import will give more details.Note: A log file may not be generated in the directory, what developmentwants is the concurrent request log file after the above settingsare done.To identify the correct trace file please run the following queryselect request_id,oracle_process_idfrom fnd_concurrent_requestswhere request_id = &request_id;Please substitute &request_id by the correct request id from the concurrent program.The trace file in the trace directory would have the number thatyou get for oracle_process_id from the above query as a part of the file name.eg: if oracle_process_id = 22771The file could be ora22771.trce. 11.5.9 Item import issues and patches to be applied.^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^1. Cannot create items -Patch 32154732. INV_IOI_REV_BAD_ORDER error message for revisions -Patch 32263593. Item import fails with no error message -Patch 32263594. Item import completes but process_flag = 4 and set_process_id = -999-Patch 32263595. If duplicate records for one master IOI does not import child recs forother master records. The error message that you will get is "This ChildItem has no Master Item record in MTL_SYSTEM_ITEMS" -Patch 3474468f. List of documents required while logging a tar on item import.1. Dump of records in all 4 interface tables (in excel spread sheet includingcolumn headers) MTL_SYSTEM_ITEMS_INTERFACE,MTL_INTERFACE_ERRORS,MTL_ITEM_REVISIONS_INTERFACE and MTL_ITEM_CATEGORIES_INTERFACE before runningimport and after running import.2. Output of BOMCHECK.sql SeeNote 244145.13. Raw Trace, Tkprof of trace and log files after doing settings recommended insection d(What do I do to check more in to errors and see wherethe import is failing?) above.4. Version of INCOIN from the server.g. Some examples of errors and what it might meana.Some times users are unable to import items to child organization. They mightget error DEFAULT_INCLUDE_IN_ROLLUP_FLAG,INVENTORY_ITEM_STATUS_CODE,INVENTORY_PLANNING_CODE,PLANNER_CODE,PLANNING_MAKE_BUY_CODE,FIXED_LOT_MULTIPLIER,ROUNDING_CONTROL_TYPE,CARRYING_COSTCheck the corresponding attribute values.If planner code is set at Master level please make it organization level.(Ref. Oracle Inventory User Guide pg 5-52 - General Planning Attribute Group )"Planner Code This attribute is controlled at the Organization level only."b.Some times users might get MESSAGE NAME : BOM_PARSE_ITEM_ERRORorMESSAGE NAME : INV_IOI_ERRERROR MESSAGE : *** BAD RETURN CODE b ***Please do the following1)Please see that setup > Receiving > (Purchasing and Receiving) setups are complete.2)Please auto extend all MTL Tables and MTL Indexes.3)Please auto extend Table Space.4)Re-Link all Inventory libraries. Relink INCOIN.o.5)Compile all Inventory Key Flex Fields.6)Compile all invalid objects.7)Please check all INV profile options are set.8)Now truncate the interface tables and populate it with few recordsand run import. The error should go.h. Is there an API for Item creation and updation?Refer toNote 760498.1Item API Or Concurrent Manager, Which One Is Best For Item Creation?

Other useful references:^^^^^^^^^^^^^^^^^^^^^^^^^^

Refer toNote:170590.1How to Use Item Open Interface (IOI) to Import Item Category AssignmentsRefer toNote:109628.1FAQ for Item ImportRefer toNote:221911.1How To Import Catalog Descriptive Values During Item Catalog ImportUpdating Items using Open InterfaceOracle Manufacturing APIs and Open Interface ManualFor questions on the Item Open Interface set-up and usage, visit theMaster Data Management Community

ReferencesNOTE:423551.1- How to create a Category Set and Assign Items to CategoriesNOTE:760498.1- Item API Or Concurrent Manager, Which One Is Best For Item Creation?