INV Item Cross Reference Upload creates, updates and deletes Oracle Inventory item cross references from Excel – the alternative part numbers held against an item, such as supplier, customer or GTIN numbers – as maintained in the Cross References window (Item form, Tools > Cross References). The cross reference types themselves are set up in the Cross Reference Types form.

When to use it

  • Load supplier or customer part numbers in bulk during implementation or data migration.
  • Add cross references for a newly created cross reference type.
  • Mass-update cross reference values or their descriptions.
  • Remove cross references that are no longer used.

Before you start

  • Your responsibility has access to the upload and to the item master organization and organizations you maintain.
  • The cross reference type exists and is not disabled.
  • For an organization-specific cross reference, the item is assigned to that organization.
  • Revision and Unit Of Measure are only used with the GTIN cross reference type named in the profile option INV: GTIN Cross Reference Type.

Step 1 – Set the parameters

Open INV Item Cross Reference Upload in Blitz Report and set the parameters:

ParameterMeaning
Upload ModeCreate opens an empty sheet; Create, Update (default) downloads existing cross references for editing and lets you add new ones.
ItemDownloads the cross references of this item.
Cross Reference TypeDownloads cross references of this type, for example Vendor or GTIN.
Cross ReferenceDownloads a specific cross reference value.
Organization CodeDownloads the cross references specific to this organization. Cross references applicable to all organizations are not included when it is set.
Blitz Report run screen for INV Item Cross Reference Upload with Upload Mode Create, Update, Item CM74123 and Cross Reference Type Vendor

Step 2 – Run to download the Excel file

Click Run. The Excel file downloads and opens with one row per existing cross reference, or an empty sheet.

Excel file with the two existing Vendor cross references of item CM74123, one applicable to all organizations and one for organization M1

Step 3 – Enter or change the cross references

Identify the item with Item Master Org (defaults to the master organization of your current inventory organization) and Item; Item Description fills in automatically. Choose the Cross Reference Type and enter the Cross Reference – the alternative part number itself – and optionally a Description. Descriptions are stored in your session language.

Set Applicable To All Orgs to Yes for a cross reference valid in every organization, or leave it blank and enter an Org to restrict it to one organization. Revision (which also needs an Org) and Unit Of Measure apply to the GTIN cross reference type only.

On a downloaded row you can change any of these values, including the Cross Reference itself. To remove a cross reference, set Delete Cross Reference to Yes on its downloaded row.

Excel file with the description of cross reference 12-2345-AM changed, marked Update, and a new Vendor cross reference OD-551203 for organization M2 added, marked Create

Step 4 – Validate and Save

Click Validate and Save. This checks for missing required values and the Org, Revision and Unit Of Measure rules above, then saves the file. Correct any rows it flags before uploading.

Both edited rows show status Valid after Validate and Save

Step 5 – Upload the file

In Blitz Report click Upload and select the saved file. This submits the upload request, which creates, updates or deletes each cross reference.

File Upload page with the saved Excel file selected for upload

Step 6 – Review the result report

When the request completes, a result report opens listing every uploaded row with its status and message.

Result report showing cross reference 12-2345-AM updated and OD-551203 created with status Success

What’s produced

  • Item cross references created, updated or deleted.
  • A result report listing every row with a status (success or error) and a message.

Common questions

Why do I have to enter an Item Master Org?
Item numbers are unique only within an item master organization, and an instance can have more than one. It identifies the item and restricts the Item, Org, Revision and Unit Of Measure lists.

Does this create cross reference types?
No. Types are maintained in the Cross Reference Types form.

What is the difference between Applicable To All Orgs and Org?
Applicable To All Orgs makes the cross reference valid in every organization; an Org restricts it to that organization. A row has one or the other, never both.

Can I add the same cross reference twice?
No. A new row with the same item, type, cross reference and organization as an existing cross reference updates that cross reference, and a second row for the same cross reference in one file is rejected.

How do I maintain the descriptive flexfield?
The Default template excludes the descriptive flexfield columns. Create your own template that includes Xref Attribute Category and the attribute columns.

Why does my row say No change?
Nothing on the row differs from what is stored, so the cross reference was left as it is.

Troubleshooting

MessageCauseWhat to do
Org is required unless Applicable To All Organizations is set.Neither an Org nor Applicable To All Orgs was entered.Enter an Org, or set Applicable To All Orgs to Yes.
Org must be blank when Applicable To All Organizations is set.Both were entered on the same row.Clear one of them.
Unit of Measure is only applicable to the GTIN cross reference type.A Unit Of Measure was entered for another type.Clear the Unit Of Measure, or choose the GTIN type.
Revision is only applicable to the GTIN cross reference type.A Revision was entered for another type.Clear the Revision, or choose the GTIN type.
Revision requires an Org and is not applicable when Applicable To All Organizations is set.A Revision was entered on a row without an Org.Enter an Org, or clear the Revision.
Duplicate cross reference. This cross reference has already been processed in this upload.The same cross reference appears on more than one row of the file.Remove the duplicate row.
Cross reference cannot be deleted. The cross reference no longer exists.Delete Cross Reference is Yes on a row whose cross reference is not in the database.Download the cross references again and delete from the downloaded row.
<Column> is invalidA value is not in the column’s list, for example an Org the item is not assigned to.Pick the value from the cell’s list.
Other Oracle messagesThe Oracle cross reference API rejected the row.Read the message and correct the row.