## Getting started with Marketplace
### Requirements
To be incorporated to the **marketplace**, product data needs to be delivered in
a machine-friendly format. The product data specification outlines the
requirements for product data.
## Product data specification
Use this specification to format your product information for FashionUnited
Partner programs, such as the B2B Marketplace. It is important to use the
correct format, as we use this product data to create listings in the B2B
Marketplace and respond to queries.
Feel free to follow the
[Google Shopping format](https://support.google.com/merchants/answer/7052112) if
your system already supports it. Do you have a custom format and is it not easy
for you to change it to our required format?
[Contact us](mailto:marketplace@fashionunited.com), we can probably help you
out.
- **FashionUnited Marketplace format** [Specifications](#fields)
- **Google shopping format**
[Specifications](https://support.google.com/merchants/answer/7052112)
## Data format
- Delimited file format (**CSV**, TSV, tab, comma, semicolon, pipe) is
**preferred**, JSON supported as well. XML on request.
## Deliver your data
Send the **url** with your feed containing the product data to
[FashionUnited Customer Service](mailto:marketplace@fashionunited.com) or your
account manager.
- HTTPS is **mandatory**
- Supported [file formats](#data-format)
If you are unable to provide a url, only a file, contact
[FashionUnited Customer Service](mailto:marketplace@fashionunited.com) to
provide you with Cloud bucket access where you can upload your product data.
## Fields
| Attribute | Format | Requirements |
| ----------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| name | Required **Example**
`Black dress Lucy`
**Syntax**
Max 255 characters
**Schema.org property**
`Product.name`
| |
| brand_name | Required **Syntax**
Max 255 characters
**Schema.org property**
`Product.brand`
| |
| source_product_id | Required **Example**
`A123C5`
**Syntax**
Max XX characters
**Schema.org property**
`Product.sku`
| |
| source_variant_id | Required | - Unique ID per variant - Variants are: sizes, colors etc. You can use your own, as long as we have have a unique ID per size/color variant. |
| description | **Example**
`Jersey, embroidered detailing, solid color, wide neckline, sleeveless, no pockets, rear closure, zip, unlined.`
**Schema.org property**
`Product.description`
| |
| short_description | | |
| material | Your product's fabric or material
**Example**
`cotton`
**Schema.org property**
`Product.material`
| |
| print | | |
| season | RequiredThe season your product belongs to.
**Example**
SS21
| |
| category_path | Optional **Syntax**
Max 255 characters
| |
| category_main | Required **Syntax**
Max 255 characters
| Use the [FashionUnited categories](/docs/marketplace/categories/) or use your own. We can map your categories to ours, as long as they are used consistently. |
| category_sub | Optional **Syntax**
Max 255 characters
| |
| category_three | Optional **Syntax**
Max 255 characters
| |
| url | Your product’s landing page (b2b webshop)
**Example**
`https://www.myb2bshop.com/prd/lp.php?id=3000`
**Schema.org property**
`Offer.url`
| |
| genders | Your product's gender
**Example**
`men`, `women` and `unisex`
| |
| age_groups | Your product's age group
**Example**
`babies`, `children` and `adults`
| |
| color_name | Your product's color
**Example**
`black`
**Syntax**
Max 255 characters
**Schema.org property**
`Product.color`
| |
| sizes | **Example**
`S`, `42`, `140/146`, `75C`, `80 Cm`
| |
| price_amount | **Syntax**
Decimal
| |
| price_currency | **Example**
`EUR`
**Syntax**
[ISO_4217](https://en.wikipedia.org/wiki/ISO_4217)
**Schema.org property**
`Offer.priceCurrency`
| |
| shipping_cost | **Syntax**
Decimal
| |
| delivery_time | Your product's delivery time.
**Example**
`2 weeks`
| |
| delivery_days | Automatically populatedAutomatically populated, if delivery_time is set. You can override.
| |
| order_quantity | | |
| gtin | Your product’s Global Trade Item Number (GTIN)
**Example**
3234567890560
**Syntax**
Max 14 numeric characters
**Schema.org property**
`Product.gtin8`
`Product.gtin12`
`Product.gtin13`
`Product.gtin14`
| |
| mpn | Your product’s Manufacturer Part Number (mpn)
**Example**
FA12345UNITED
**Syntax**
Max 255 characters
**Schema.org property**
`Product.mpn`
| |
| image | RequiredYour product’s main image URL
**Example**
`https://cdn.myb2bshop.com/3000.jpg`
**Schema.org property**
`Product.image`
| **For the image URL:** - Link to the main image of your product
- Start with
http or https - Use an encoded URL that complies with RFC 2396 or RFC 1738. For example, a comma would be represented as "%2C"
**For the image:** - Accurately display the product you're selling
- Use an accepted format:
JPEG (.jpg/.jpeg), PNG (.png) and WEBP (.webp) - For apparel products, use an image of at least
250 x 250 pixels - Don't submit an image larger than
64 megapixels or a file larger than 16MB - Don't scale up an image or submit a thumbnail
- Don't include promotional text, watermarks, or borders
- Don't submit a placeholder or a generic image
|
| alternate_image | OptionalYour product’s additional image URL
**Example**
`https://cdn.myb2bshop.com/3000-2.jpg`
| |
| locale | FashionUnited internal use **Example**
`nl-NL` or `en-US`
**Syntax**
[Language Localization](https://en.wikipedia.org/wiki/Language_localisation), which is a combination of Language [ISO_639-1](https://en.wikipedia.org/wiki/ISO_639-1) and region [ISO_3166-1_alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2)
| |
| public | FashionUnited internal use | |
| market_public | FashionUnited internal use | |
| market_id | FashionUnited internal use | |
| stand_id | FashionUnited internal use | |