Import Customer Items Into Order Management
Import customer items into Order Management so you can use them throughout the order lifecycle.
-
Use file-based data import, a web service, or REST API. For details and examples, go to REST API for Oracle Supply Chain Management Cloud, expand Order Management, then click Sales Orders for Order Hub.
-
You can't automatically determine the customer item during the import. Your import payload must include a value for the customer item.
Scenario
In this example, assume you must.
-
Import a record that includes customer item DESK-COMP-10 and customer Computer Service and Rentals.
-
Create a relationship between DESK-COMP-10 and inventory item AS54888 (Standard Desktop).
-
Create a relationship between DESK-COMP-10 and inventory item AS54600 (Standard 9000-S Desktop).
-
Rank AS54888 higher than AS54600 so Order Management uses AS54888 first to fulfill the item, then uses AS54600 only if AS54888 isn't available in inventory.
You can create a relationship between the AS54888 and DESK-COMP-10 when you import.
-
The customer item relationship sets up a relationship between the customer item that you import, and the item in inventory that you use to fulfill the customer item.
-
Order Management uses the customer item and sold-to customer details to identify the inventory item to use during order import.
-
If you set up more than one customer item relationship for a customer item, then Order Management uses the customer item relationship that has the lowest rank.
Order import will fail in these situations.
-
You don't set up a customer item relationship for the customer item in the Product Information Management work area.
-
More than one customer item relationship specifies the lowest rank.
Summary of the Setup
-
Set up customer item relationships.
-
Import the customer item.
Set Up Customer Item Relationships
Set up customer item relationships so they support order import.
-
Make sure you have the privileges that you need to administer Product Information Management.
If you don't sign in with these privileges, then the Product Information Management work area won't display your product details and you won't be able to do this procedure. For details, see Privileges That You Need to Implement Order Management.
-
Go to the Product Information Management work area, then click Tasks > Manage Trading Partner Items.
-
On the Manage Trading Partner Items page, click Create Trading Partner Item (the plus icon).
-
In the Create Trading Partner area, set the values.
Attribute
Value
Trading Partner Item
DESK-COMP-10
Type
Customer
Trading Partner
Computer Service and Rentals
Status
Active
Start Date
End Date
Set the time frame when you want Order Management to use this partner item.
The import validates these dates. If the dates in your import don't match the dates that you set on the Create Trading Partner Items page, then the import will fail.
-
In the Relationships area, click Actions > Create.
-
In the Create Customer Item Relationship dialog, set the values, then click OK > Save.
Attribute
Value
Organization
Vision Manufacturing
Set it to the inventory organization that maintains inventory for the AS54888.
Item
AS54888
Rank
1
Enter any numeric value.
-
Enter a value. If you don't enter a value, then Order Management can't identify the inventory item to use during order import, and your import will fail.
-
Make sure the value that you enter is unique across the customer item relationships that you set up for this customer item.
For example, if you set up a rank of 5 for AS54888, and a rank of 5 for AS54600, then the import will fail because Order Management can't determine which customer item relationship takes precedence.
-
-
In the Relationships area, click Actions > Create.
-
In the Create Customer Item Relationship dialog, set the values, then click OK.
Attribute
Value
Organization
Vision Manufacturing
Item
AS54600
Rank
2
-
Click Save > Done.
As an option, you can use file-based data import to import the relationship instead. If you do, set the values in the EGP_ITEM_RELATIONSHIPS_INTF worksheet when you import inventory items.
Attribute |
Value |
---|---|
Item Relationship Type |
CUSTOMER_ITEM_XREF |
Item Number |
AS54888 |
Trading Partner Item Number |
DESK-COMP-10 |
Description |
Customer's part number for the AS54888. |
Make sure you include a value in all other required attributes.
Import the Customer Item
If you're importing source orders through file-based data import, set the values on the DOO_ORDER_LINES_ALL_INT worksheet of the PriceListImportTemplate.xlsm file.
Attribute |
Value |
---|---|
Product Number |
AS54888 |
Customer Product Identifier |
DESK-COMP-10 |
If you're importing through a web service or REST API, set the values in the payload.
Attribute |
Value |
---|---|
ProductNumber |
AS54888 |
CustomerItemId |
DESK-COMP-10 |