Partner API
Reference
Inventory Issues

Inventory issues

The Inventory Issues endpoint presents a list of errors and warnings that impact a store's inventory feed. These issues occur at file, stock, and product levels, enabling you to understand and address specific problems with your inventory data.

File issues

Any issues detected while parsing the uploaded file. File level issues are related to how your inventory data is structured or the file format that is being uploaded.

If any fields are related to the issue, they will be present in affectedHeaders.

Issue TypeSeverityDescription
UnsupportedFileFormaterrorThe file could not be read as a valid CSV or XLSX (Excel 2007+) file. Please check your file formatting.
MissingStockHeadererrorA required column is missing from your file. Please ensure your file contains at least the fields 'barcode', 'quantity' and 'price'.
UnsupportedStockHeaderwarningOne or more colums are present in your stock file that are not recognised and are being ignored.

Stock issues

Any issues detected while validating your stock lines. The processing of certain items may be skipped depending on the issue.

A full count of affected lines per issue will be provided, but only a maximum of 250 lines will be returned in affectedLines.

Issue TypeSeverityDescription
InvalidBarcodeLengtherrorThe barcode length is invalid. Barcodes must be between 3 and 60 characters in length. The invalid barcodes have been excluded.
InvalidBarcodeCharacterserrorInvalid barcode characters detected. Barcodes must only include alphanumeric characters, underscores or dashes. The invalid barcodes have been excluded.
InvalidPricewarningThe item price is invalid. Only items with a price of 0.01 or higher will be processed.
InsufficientStockedItemswarningThere are insufficient items in stock. At least 50 in-stock products are required to display your inventory across all channels.
NegativeQuantitywarningNegative stock quantity provided. Please check your stock tracking to ensure this information is accurate.

Product issues

Any issues detected for stores that upload product data. These issues outline any required fields that are missing and suggested optimisations in the product data provided.

A full count of affected barcodes per issue will be provided, but only a maximum of 250 barcodes will be returned in affectedBarcodes.

Issue TypeSeverityDescription
MissingProductTitleerrorThis product is missing a title. Products without a title will not be displayed in all channels.
MissingProductBranderrorThis product is missing a brand. Products without brand names will not be displayed in all channels.
MissingProductDescriptionerrorThis product is missing a description. Products without descriptions will not be displayed in all channels.
MissingProductImageserrorThis product is missing an image. Products without images will not be displayed in all channels.
InvalidConditionwarningInvalid condition specified: only 'new', 'refurbished' or 'used' are allowed as values.