Notice that an item was not uploaded properly? Was an item not sent to the designated trading partners? Are you running into an unfamiliar error?
If you encounter any of these issues while importing items into Assortment, we recommend reviewing the following checklist to help identify the source of the error or unexpected behavior.
Checklist
Was the item uploaded today?
Typically, items that are uploaded in Assortment successfully will not be sent to a trading partner's system until the next business day. Please keep this timing in mind as you plan your imports.
Does the item have errors for any Trading Partner(s)?
If an item contains errors for a specific trading partner, that item will not be sent to that trading partner. These errors must be resolved before the item can be successfully sent. There are several ways you can review item errors:
You can check all of your item errors on the Errors tab. From here, you can filter items by unique identifier or trading partner.
By unique identifier (Vendor Part Number)
By trading partner
If the errors were for a recently-imported item, you can click the hyperlinked number next to Erred Items for the import in the Import History.
Finally, you can click on the error icon to the left of the item from the Items tab.
Visit Assortment Error Troubleshooting for more information on correcting item data errors.
Did the import have any File Errors?
If an import returned a File Error (shown in the Import History with an exclamation point in a red circle), that typically means the data in that file was not loaded. You can click on the blue "+" to view the file error(s) associated with that import.
Visit Assortment Error Troubleshooting for more information on correcting file errors.
Can you find the item using an Advanced Search?
The Advanced Search function on the Items tab can be helpful in finding items using more in-depth search options.
By default, the Advanced Search function comes with some additional search criteria, however, you can add additional criteria using Add Field.
Adding, for example, the Last Updated Date allows you to see if the item was added or updated within a certain time range.
If the item is found to have been uploaded recently, you can:
Check the item's details from the Items tab
Download the item
Click on the box to the left of the item
Click on the cloud icon at the bottom of the screen
Verify that the item's data looks correct in the downloaded template
Did you upload multiple items with the same Unique Identifier?
Every catalog has identified at least one Unique Identifier. Possible Unique Identifiers can include:
Vendor Part Number
UPC
GTIN
EAN
You can confirm your catalog's Unique Identifier from the Errors tab. Click on the dropdown next to the search bar. In the screenshot below, the Unique Identifier is Vendor Part Number. You can also reach out to your implementation consultant or the Assortment support team at assortment@spscommerce.com to confirm this information.
If an attribute is a Unique Identifier, then values associated with that attribute cannot be duplicated amongst items in the catalog.
For example, if your Unique Identifier is the Vendor Part Number, you could not have two items with the same Vendor Part Number of "VPN-1".
If multiple items share the same value for the Unique Identifier, they will be uploaded as one item in Assortment. To fix this, delete the uploaded item(s), assign a unique identifier to each, and re-upload.
Were you notified via email about a Document Processing Error?
You could receive an email that mentions a Document Processing Error, and including a parcel number and a list of errors. A Document Processing Error indicates that your items errored out in the process of being sent to a trading partner and, most likely, were not received by the trading partner.
If the errors appear to be for item data (for example, the item had a setlist value that wasn't allowed by the trading partner), you can do one of the following:
Correct the errors in your template and re-upload. The items will be re-sent to your trading partner(s) the next business day.
Forward the email to assortment@spscommerce.com who will be happy to assist.
More Information
Check out our Assortment Collection to see all Assortment articles.