Avasam product data requirements and error messages

Good product data is essential to driving sales. This article explains Avasam's data requirements and the error messages you will see when a product does not meet those requirements.

 

As you're providing the information sellers will use when listing your products, the better the quality, the better the listing they can create. This encourages them to source and sell your products, and reduces the chance of returns due to 'Not as described' claims, for example.

As such, we check all products before making them live, and we check any changes provided before updating products to maintain a good standard within the catalogue. 

Products that fail our minimum data requirements will be held in our product staging environment and will require data corrections before they can be made live on the platform

Minimum data requirements

 

Attribute Status Unit Minimum Requirement Maximum requirement
Item title Mandatory Characters 20 characters 80 characters

Short description in HTML

Mandatory Characters, HTML 20 characters   
Image Mandatory Pixels 1 image (multiple preferred, white background preferred). 500 (H) x 500 (L) 9,000 (H) x 9,000 (L)
Supplier SKU (Product ID) Mandatory      
Stock level Mandatory Units  Initial and ongoing accuracy is essential  
Barcode Not mandatory but highly preferred Correct format  8 digits (no duplicates) 15 digits (no duplicates)
Product weight Mandatory Kilograms  0.01kg 99kg
Product dimensions Not mandatory but preferred Centimeters >0  
Brand Mandatory   If unbranded, enter as 'Unbranded'  
Size Mandatory for clothing & footwear      
Colour Not mandatory but preferred      
Item category Mandatory   Use only valid Avasam category codes  
VAT rate Mandatory Percentage    
Cost Price Mandatory GBP excl. VAT At least 25% below RRP  
RRP Not mandatory but recommended GBP incl. VAT    
Variation type Mandatory for variation parents   Refer to the documentation for creating variations with and without Linnworks. (Only single images for parents)  
Parent product ID Mandatory for variation child products   Refer to the documentation for creating variations with and without Linnworks.  

When providing an item title, using as many keywords as possible, such as the brand, will help novice sellers generate search traffic and increase sales overall.

If you aren't experienced in HTML, there are websites and tools to convert text to HTML, such as:

Excluded words and phrases

Though not an exhaustive list, this is an example of the terms we ask not to use in your titles and descriptions - Many are either 'placeholders' or terms that tend to be 'carried over' from specific listing information and may cause problems for sellers:

na,   n.a,   n/a,   www,   xxx,   Zzz,   £££,   $$$,   https,   qwerty,   Do not list,   Not permitted on,   eBay,   Amazon,   OnBuy,   Shopify,   Wish,   WooCommerce,   BigCommerce,   Groupon,   Facebook,   Instagram,   Linked In,   Linked-In,   Twitter,   Pinterest,   Feedback,   Shipping,   Money back ,   Money-back,   Moneyback,   Special offer;   Special-offer;   Special price;   Special-price,   Offer price,   Offer-price,   Sale price,   Sale-price,   Price reduced,   Discount,   Bulk buy,   Bulk-buy,   Limited time only,   Guarantee,   Not available ,   Not for sale,   Read more,   Contact us,   Contact-us,   Email,   E-mail,   Website,   Courier,   Credit card reader,   Debit card reader,   Credit-card reader,   Debit-card reader,   Bitcoin,   Ethereum,   Live animal,   Lottery,   Raffle-   Smart watch,   Spinning,   Spin bike,   Spin-bike,   Potty Putter

If you see a product listing being declined because of a blocked term, simply delete the term and relist the item. 

Data error messages


Error code Error name Error message
1001 Item title Number of characters Item title must be between 20 and 80 characters long - this is to meet the requirements of the leading eCommerce platforms
1002 Item title Exclude keywords Item title includes non-compliant phrase: [INSERT BLOCKED KEYWORD] - please remove this phrase and try again
1003 Short description Minimum and maximum characters Short description must be between 20 and 9,999 characters long - the more detail you can provide, the better your sellers can represent the product
1004 Short description Exclude keywords Short description includes non-compliant phrase: [INSERT BLOCKED KEYWORD] - please remove this phrase and try again
1005 Long description Minimum and maximum characters Long description must be max 9,999 characters long - the more detail you can provide, the better your sellers can represent the product
1006 Long description Exclude keywords Long description includes non-compliant phrase: [INSERT BLOCKED KEYWORD] - please remove this phrase
1007 Image Image size Image size must be Min 500 pixels x Max 9,000 pixels - this is to meet the requirements of the leading eCommerce platforms
1008 Image File type Invalid image file type, please upload in jpg, jpeg or png format
1009 Image Number of images Please upload a minimum of 1 image or a maximum of 9 images
1011 Barcode Duplicate check A product with this barcode <barcode> already exists - please check you haven't already listed this product or assign a new barcode
1012 Barcode Number of characters The barcode format is invalid, it must be a minimum of 8 characters
1013 Barcode Characters type The barcode format is invalid, it can only include numbers
1014 Product weight Units measure Product weight must be stated in kilograms
1015 Product weight Minimum and Maximum values Product weight must be 0.01 kg to 250kg
1016 Product height Units measure Product height must be stated in centimeters
1017 Product height Minimum and Maximum values Product height must be >0 cm
1018 Product length Units measure Product length must be stated in centimeters
1019 Product length Minimum and Maximum values Product length must be >0 cm
1020 Product width Units measure Product width must be stated in centimeters
1021 Product width Minimum and Maximum values Product width must be >0 cm
1022 Product depth Units measure Product depth must be stated in centimeters
1023 Product depth Minimum and Maximum values Product depth must be >0 cm
1024 Brand Value check Brand attribute is missing. Please enter the brand name. If the product doesn't have a brand name, please enter as "Unbranded"
1025 Colour Value check Colour attribute is mandatory for products in this category - please enter the exact colour of the product and be careful not to mix closely related colours such as red, pink and purple
1026 Size Value check Size attribute is mandatory for products in this category - please enter the size of the product
1027 Product master category Value check Avasam product category number is invalid. Please insert a valid category number according to the list set out here: https://help.avasam.com/avasam-product-category-codes-for-suppliers
1028 VAT Rate Value Please enter a VAT rate between 0 to 30%
1029 Cost Price (ex VAT) Value check Cost price value must be >0. The cost price is the price at which your sellers will purchase the product from you
1030 Cost Price (ex VAT) Special characters Cost price format is invalid, it must contain numbers only. The cost price is the price at which your sellers will purchase the product from you
1032 RRP (inc VAT) Special characters RRP format is invalid, it must contain numbers only. It is important you only upload realistic RRPs so as not to mislead your sellers
1033 RRP min (inc VAT) Minimum and Maximum RRP price must be minimum 5% and maximum 500% higher than product cost price. It is important you only upload realistic RRPs so as not to mislead your sellers
1034 Variation type Value check Variation type attribute is mandatory for all parent products. Please insert either "Size", "Colour" or "Colour and Size". A variation product is one that is part of a family of related products whereby only the size, colour, or both colour and size, differ. The parent is the generic master and the children are the specific variations of the product
1035 Size Variant (child product) Value check The "Size" attribute is mandatory for size variant products. A variation product is one that is part of a family of related products whereby only the size, colour, or both colour and size, differ. The parent is the generic master and the children are the specific variations of the product
1036 Variant (child product) Duplicate check One or more child products within this variant are the same size, colour or both. Please insert different sizes or colour for each variant. A variation product is one that is part of a family of related products whereby only the size, colour, or both colour and size, differ. The parent is the generic master and the children are the specific variations of the product
1037 Colour Variant (child product) Value check The "Colour" attribute is mandatory for "Colour" variant products. A variation product is one that is part of a family of related products whereby only the size, colour, or both colour and size, differ. The parent is the generic master and the children are the specific variations
1038 Colour Variant (child product) Duplicate check One or more child products within this variation are the same colour. Please insert different colours for each variant. A variation product is one that is part of a family of related products whereby only the size, colour, or both colour and size, differ. The parent is the generic master and the children are the specific variations
1039 Colour & Size Variant (child product) Value check "Colour" and "Size" attributes are mandatory for "Colour and "Size" variant products. A variation product is one that is part of a family of related products whereby only the size, colour, or both colour and size, differ. The parent is the generic master and the children are the specific variations
1040 Colour & Size Variant (child product) Duplicate check One or more child products within this variation have the same colour and size combination. Please insert different colour and size combinations for each variant. A variation product is one that is part of a family of related products whereby only the size, colour, or both colour and size, differ. The parent is the generic master and the children are the specific variations
1041 Barcode Block This barcode is blocked on Avasam and therefore the product cannot be listed - please do not attempt to list this product
1042 Brand Block This brand is blocked on Avasam and therefore cannot be listed - please do not attempt to list this brand
1043 Supplier product ID Block characters This product ID includes a non-permitted character: [INSERT BLOCKED CHARACTER] Please remove the character
1044 Block keywords Block This product includes a non-permitted phrase: [INSERT BLOCKED PHRASE] Please remove this phrase
1045 Incorrect image The image must correctly represent the item. Please replace this image
1046 Variation missing Variation (child) products are missing for this parent. A varation product is one that is part of a family of related products whereby only the size, colour, or both colour and size, differ. The parent is the generic master and the children are the specific variations
1047 Policy breach This product has faced a policy or IP related breach from a sales channel and is therefore not permitted to be listed
1048 Product safety breach This product has faced a product safety or recall-related breach from a sales channel and is therefore not permitted to be listed
777 [Field] required [Field] required
786 Upload image S3 server Unable to upload an image.
789 Invalid image url Invalid image url. Please check the image URL of the image you are attempting to upload
901 Parent product missing Parent product is missing. A variation product is one that is part of a family of related products whereby only the size, colour, or both colour and size, differ. The parent is the generic master and the children are the specific variations