Introduction
The Product Feed provides Mapp with structured product data and stock availability. This information is used to generate product recommendations.
You need to send Mapp a Product Feed containing details of all products on which recommendations are based. The file should be sent at least daily to ensure the data shown to users stays as fresh as possible, taking stock and availability into account.
Product Feed Format and Delivery
You send Mapp a Product Feed that contains details of all products and their availability. The feed should be sent at least once a day. More frequent updates are encouraged where possible.
The Product Feed can be provided as a CSV or XML file.
CSV format
CSV feeds should include one row per size and color variant.
ID | Name | Size | Variant ID |
|---|---|---|---|
ABC | Fluffy Green Jumper | 10 | ABC-10 |
ABC | Fluffy Green Jumper | 12 | ABC-12 |
Please ensure that:
Literal double quotes and commas in attribute values are correctly escaped
Files are encoded in UTF-8 without a BOM
XML format
The following example shows a simple XML-based Product Feed with product-level data and size variants:
<?xml version="1.0" ?>
<Products>
<Product>
<Id>ABC</Id>
<Name>Fluffy green Jumper</Name>
<Description>A detailed description of the product</Description>
<Price>7</Price>
<BrandName>Nike</BrandName>
<URL>https://example.org/my-product</URL>
<Currency>GBP</Currency>
<Category>Dresses</Category>
<Material>Cotton</Material>
<Variants>
<Variant>
<Id>ABC-10</Id>
<Size>10</Size>
<IsAvailable>true</IsAvailable>
</Variant>
<Variant>
<Id>ABC-12</Id>
<Size>12</Size>
<IsAvailable>false</IsAvailable>
</Variant>
</Variants>
</Product>
</Products>Attributes
The Product Feed includes attributes that describe each product and its availability.
For a complete list of supported fields, see the Attributes Reference.
Development Sample Feed
If development work is required before the Product Feed can be used, Mapp may request a sample feed.
This can include:
A small development sample, often containing only a few products, used to implement and validate feed parsing
A testing sample that contains the full product inventory from a test environment, used to ensure both test environments contain the same products.
Delivery
You transfer files to Mapp Fashion via SFTP. Mapp Fashion provides SFTP credentials, or alternatively polls your SFTP server.
If you operate IP allowlisting, our IP addresses will need to be permitted access.