Product Feed
- 2 Minutes to read
- Print
- DarkLight
Product Feed
- 2 Minutes to read
- Print
- DarkLight
Article summary
Did you find this summary helpful?
Thank you for your feedback!
A list of all your products with stock availability on which our recommendations are based.
You will need to send us a product feed containing details of all the products and their stock levels on which we'll base our recommendations. This feed will typically be a CSV or XML file containing all garments, which is set to us at least daily. More frequent updates on stock levels are encouraged.
Attributes
For a full list of fields, please see the Attributes Reference.
Development Sample Feed
When the feed requires development work before being available, we may request a sample of your product feed to aid our development.
A development sample, often no more than a few products, to allow us to write and validate our feed parsing code.
A testing sample with the full inventory from your test environment allows further validation and ensures that the retailer and Mapp Fashion test environments contain the same products.
FAQ
How frequently should the file be provided?
The product feed should be updated at least daily. More frequent updates on stock levels are encouraged.
Can we upload to your (s)ftp server?
We don't operate an FTP server. We do provide S3 access.
Should out-of-stock items be included?
In general, items should only be removed from the feed if the customer is no longer able to view them. In particular, if an item is only available in some of its sizes, it is preferable that the feed continue to list all of those sizes so that we can differentiate between an item being out of stock in a size and never being produced in that size.
Do you require attributes such as style, fit, etc?
Our styling team and automated processes assign attributes to products; however, it is helpful to include them if they are available.
Is it possible to update stock levels more frequently?
If you require more frequent updates to availability data, you can provide a separate stock feed (either full or incremental). The stock feed should be a CSV file with the following columns:
product_id which is an identifier identifying the size and color-specific variant the row refers toavailability which is either a numerical quantity or a status (IN_STOCK, OUT_OF_STOCK, LOW_STOCK)
Can you support multiple locales?
Yes. We recommend XML-based feeds for this (otherwise, the file tends to get very wide). You can add a locale attribute to the necessary attributes.
Our images follow a systematic naming convention. Do I need to provide all image URLs?
Please provide image URLs where possible. If this is not feasible, please do get in touch.
Any product attribute that you require us to display or return in API responses must be included, such as alternate image URLs.
Was this article helpful?