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 Type | Severity | Description |
|---|---|---|
UnsupportedFileFormat | error | The file could not be read as a valid CSV or XLSX (Excel 2007+) file. Please check your file formatting. |
MissingStockHeader | error | A required column is missing from your file. Please ensure your file contains at least the fields 'barcode', 'quantity' and 'price'. |
UnsupportedStockHeader | warning | One 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 Type | Severity | Description |
|---|---|---|
InvalidBarcodeLength | error | The barcode length is invalid. Barcodes must be between 3 and 60 characters in length. The invalid barcodes have been excluded. |
InvalidBarcodeCharacters | error | Invalid barcode characters detected. Barcodes must only include alphanumeric characters, underscores or dashes. The invalid barcodes have been excluded. |
InvalidPrice | warning | The item price is invalid. Only items with a price of 0.01 or higher will be processed. |
InsufficientStockedItems | warning | There are insufficient items in stock. At least 50 in-stock products are required to display your inventory across all channels. |
NegativeQuantity | warning | Negative 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 Type | Severity | Description |
|---|---|---|
MissingProductTitle | error | This product is missing a title. Products without a title will not be displayed in all channels. |
MissingProductBrand | error | This product is missing a brand. Products without brand names will not be displayed in all channels. |
MissingProductDescription | error | This product is missing a description. Products without descriptions will not be displayed in all channels. |
MissingProductImages | error | This product is missing an image. Products without images will not be displayed in all channels. |
InvalidCondition | warning | Invalid condition specified: only 'new', 'refurbished' or 'used' are allowed as values. |