Professional Documents
Culture Documents
1 of 7
https://imdjkoch.wordpress.com/tag/mtl_system_items_interface/
i
18 Votes
This conversion is done for import items from any source into Oracle Inventory and Oracle Engineering.
Description:
When you import items through the Item Interface, you create new items in your item masterorganization
or assign existing items to additional organizations. You can specify values for all the item a ributes, or
you can specify just a few a ributes and let the remainder default or remain null. Here we are importing
items with template.
Interface Table:
The interface table for Item Import is MTL_SYSTEM_ITEMS_INTERFACE and it contains every
column in the Inventory item master table, MTL_SYSTEM_ITEMS.
The columns in the item interface correspond directly to those in the item master table.
Except for ITEM_NUMBER or SEGMENTn columns, ORGANIZATION_CODE or
ORGANIZATION_ID, DESCRIPTION, PROCESS_FLAG, and TRANSACTION_TYPE, all other
columns are optional, either because they have defaults that can be derived, or because the
corresponding a ributes are optional and may be left null.
If you are importing revision details for your new items, you can use the
12/6/2016 2:08 PM
2 of 7
https://imdjkoch.wordpress.com/tag/mtl_system_items_interface/
MTL_ITEM_REVISIONS_INTERFACE table. This table is used only for revision information, and is
not mandatory.
Required Data:
ITEM_NUMBER or SEGMENTn columns
Every row in the item interface table must identify the item and organization. To identify the item when
importing it, you may specify either the ITEM_NUMBER or SEGMENTn columnsthe Item Interface
generates the INVENTORY_ITEM_ID for you.
ORGANIZATION_ID or ORGANIZATION_CODE
You need to specify either the ORGANIZATION_ID or ORGANIZATION_CODE that identi es the
organization.
DESCRIPTION
When you import a new item, you are also required to specify the DESCRIPTION.
TRANSACTION_TYPE & PROCESS_FLAG
There are two other columns the Item Interface uses to manage processing. They are
TRANSACTION_TYPE, which tells the Item Interface how to handle the row, and PROCESS_FLAG,
which indicates the current status of the row.
Always set the TRANSACTION_TYPE column to CREATE, to create an item record (true when both
importing a new item and assigning an already existing item to another organization). This is the only
value currently supported by the Item Interface. The Item Interface uses the PROCESS_FLAG to indicate
whether processing of the row succeeded or failed. When a row is ready to be processed, give the
PROCESS_FLAG a value of 1 (Pending), so that the Item Interface can pick up the row and process it into
the production tables.
Meaning of PROCESS_FLAG Values:
Code
Code Meaning
Pending
Assign complete
Assign/validation failed
Import in process
Import succeeded
Note:
When more than one of these columns has been entered and they con ict, ITEM_NUMBER overrides
12/6/2016 2:08 PM
3 of 7
https://imdjkoch.wordpress.com/tag/mtl_system_items_interface/
Derived Data:
Many columns have defaults that the Item Interface uses when you leave that column null in the item
interface table. Please refer Oracle Manufacturing APIs and Open Interfaces Manual for more details.
Validations:
1] Validation for organization code (standard table: ORG_ORGANIZATION_DEFINITIONS)
2] Validation for Item_number (standard table: mtl_system_items_b)
3] Validation for Description
4] Validation for Primary Unit of Measure (standard table: MTL_UNITS_OF_MEASURE)
5] Validation for Template Name (standard table: mtl_item_templates)
6] Validation for Item Type (standard table: FND_COMMON_LOOKUPS)
7] Validation for ENCUMBRANCE_ACCOUNT (standard table: gl_code_combinations)
8] Validation for EXPENSE_ACCOUNT (standard table: gl_code_combinations)
Note: You can add more validation as per your business requirement.
Record Insertion:
Through your custom program you can insert the below columns in the interface table. Again the list is a
sample one; you can add additional columns as your business requirement.
Columns inserted:
ORGANIZATION_ID
ORGANIZATION_CODE
LAST_UPDATE_DATE
12/6/2016 2:08 PM
4 of 7
https://imdjkoch.wordpress.com/tag/mtl_system_items_interface/
LAST_UPDATED_BY
>fnd_global.user_id
CREATION_DATE
>sysdate
CREATED_BY
>fnd_global.user_id
LAST_UPDATE_LOGIN
>fnd_global.login_id
DESCRIPTION
>Taken from Staging table
SEGMENT1
>Taken from Staging table
PRIMARY_UOM_CODE
>Taken from Staging table
PRIMARY_UNIT_OF_MEASURE >Taken from MTL_UNITS_OF_MEASURE
ITEM_TYPE
>NULL
TEMPLATE_NAME
>Taken from Staging table
TEMPLATE_ID
>Taken from mtl_item_templates
MIN_MINMAX_QUANTITY
>Taken from Staging table
MAX_MINMAX_QUANTITY
>Taken from Staging table
LIST_PRICE_PER_UNIT
>Taken from Staging table
ITEM_CATALOG_GROUP_ID
>Taken from Staging table
SET_PROCESS_ID
>1
PROCESS_FLAG
>1
TRANSACTION_TYPE
>CREATE
(h ps://imdjkoch. les.wordpress.com/2011/06/item-import-concurrent-program-parameters.jpg)
1] All Organizations:
Yes: Run the interface for all organization codes in the item interface table.
No: Run the interface only for the organization you are currently in. Item interface rows for
organizations other than your current organization are ignored.
12/6/2016 2:08 PM
5 of 7
https://imdjkoch.wordpress.com/tag/mtl_system_items_interface/
2] Validate Items:
Yes: Validate all items and their data residing in the interface table that have not yet been validated. If
items are not validated, they will not be processed into Oracle Inventory.
No: Do not validate items in the interface table.
3] Process Items:
Yes: All qualifying items in the interface table are inserted into Oracle Inventory.
No: Do not insert items into Oracle Inventory.
4] Delete Processed Rows:
Yes: Delete successfully processed items from the item interface tables.
No: Leave all rows in the item interface tables.
5] Process Set:
Enter a number for the set id for the set of rows you want to process. The program picks up the rows
marked with that id in the SET_PROCESS_ID column. If you leave this eld blank, all rows are picked up
for processing regardless of the SET_PROCESS_ID column value.
12/6/2016 2:08 PM
6 of 7
https://imdjkoch.wordpress.com/tag/mtl_system_items_interface/
When you encounter rows errored out due to validations, you must rst x the row corresponding to the
error with the appropriate value. Then reset PROCESS_FLAG = 1, INVENTORY_ITEM_ID = null, and
TRANSACTION_ID = null. Then resubmit the row for reprocessing.
Useful Query:
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
Select
SEGMENT1,
DESCRIPTION,
PROCESS_FLAG,
SET_PROCESS_ID,
INVENTORY_ITEM_ID,
ORGANIZATION_ID,
ORGANIZATION_CODE,
CREATION_DATE,
ITEM_TYPE,
UNIT_OF_ISSUE,
TEMPLATE_ID,
TEMPLATE_NAME,
EXPENSE_ACCOUNT,
ENCUMBRANCE_ACCOUNT,
PRIMARY_UOM_CODE,
PRIMARY_UNIT_OF_MEASURE,
MIN_MINMAX_QUANTITY,
MAX_MINMAX_QUANTITY,
TAX_CODE,
REQUEST_ID
from
MTL_SYSTEM_ITEMS_INTERFACE
order by CREATION_DATE;
---------------------------Select
ORGANIZATION_ID,
UNIQUE_ID,
REQUEST_ID ,
TABLE_NAME ,
COLUMN_NAME,
ERROR_MESSAGE
CREATION_DATE,
MESSAGE_TYPE
from
MTL_INTERFACE_ERRORS
order by CREATION_DATE;
12/6/2016 2:08 PM
7 of 7
https://imdjkoch.wordpress.com/tag/mtl_system_items_interface/
12/6/2016 2:08 PM