Introduction
The Product Feed provides Mapp Fashion with structured product data and stock availability. This data powers product recommendations and enrichment workflows across the platform.
You must send Mapp Fashion a Product Feed containing all products that should be considered for recommendations. The feed should be updated at least once per day to ensure that product data, stock levels, and availability remain accurate. More frequent updates are encouraged where possible, particularly for retailers with rapidly changing inventory.
Product Feed Format and Delivery
You send Mapp Fashion a Product Feed containing details of all products and their availability.
The feed can be provided in CSV or XML format.
CSV Format
CSV feeds must contain one row per variant (for example, each size and colour combination).
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 Product Feed Attributes Reference.
Validation and Error Handling
During ingestion, feeds are automatically validated to ensure structural integrity and data quality.
Error handling follows three levels:
Critical errors
(for example unreadable files, incorrect encoding, or missing mandatory columns)
→ the entire feed is rejected.
Row-level errors
(for example invalid enum values, duplicate identifiers, or missing required fields)
→ affected rows are skipped while the remainder of the feed is processed.
Warnings
(for example missing optional attributes)
→ the feed is accepted, but the issues are logged for review.
A validation report is generated for every processed feed, providing visibility into errors, warnings, and skipped rows.
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.