Feeds
This document outlines the fields required for your product and returns feeds. If you are reading this, it is likely because we have requested a feed of your products and returns, or you want to learn more about the fields we collect from your content management system (CMS).
File Format
CSV
When providing data in CSV format, please follow these guidelines to ensure compatibility and smooth processing:
- Separators: Use standard commas as field separators
- Text Enclosure: Use double quotes around text fields that contain special characters or spaces (e.g.,
"40 - FR") - Price Formatting: Format all prices with two decimal places (e.g.,
19.99) - Date Format: Use ISO 8601 format for dates (e.g.
YYYY-MM-DD)
These preferences align with RFC 4180 guidelines for CSV files, which is the most widely accepted standard. Following these guidelines ensures your CSV files will be compatible with standard CSV processing tools and spreadsheet applications.
Products
To import your products, we need the following information:
| Field | Description |
|---|---|
| product_id | A unique identifier for the product. This should match the value used in both the feeds and the widget. |
| product_name | The name of the product as it appears on your product detail page. |
| product_brand | The brand associated with the product. (Example: “BrandName”) |
| product_gender | The intended gender for the product: man, woman, or unisex. (Example: “woman”) |
| product_sizes | The sizes available for the product. (Example: “S,M,L,XL”) |
| product_page_url | The URL that leads to the product detail page on your website. |
| product_image_url | The URL for a product’s image. |
| product_category | The category of the product. It can be composed of multiple layers. (Example: “Top > T-shirts”) |
| product_body_part | The region of the human body that the product is designed to fit or cover. Acceptable values are: bosom, top, bottom, feet, or full. |
Returns
To process returned products, we need the following information:
| Field | Description |
|---|---|
| order_id | A unique identifier for the order in which the product was purchased. |
| order_date | The date when the product was purchased (ISO 8601). (Example: “2021-07-20”) |
| return_date | The date when the product was returned (ISO 8601). (Example: “2021-07-25”) |
| return_reason | The reason for the product’s return. (Example: “Too small”) |
| product_id | A unique identifier for the product. This should match the value used in both the feeds and the widget. |
| product_name | The name of the product as it appears on your product detail page. |
| product_size | The size of the returned product. (Example: “M”) |
| product_quantity | The number of units of the product being returned. (Example: 2) |
| product_price | The price paid by the customer for the product. (Example: 29.99) |
| product_currency | The currency code of price (ISO 4217). (Example: “EUR”) |