Getting Started

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 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, we can probably help you out.

• FashionUnited Marketplace format Specifications
• Google shopping format Specifications

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 or your account manager.

• HTTPS is mandatory
• Supported file formats

If you are unable to provide a url, only a file, contact FashionUnited Customer Service 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	Required The 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 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 Schema.org property Offer.priceCurrency
shipping_cost	Syntax Decimal
delivery_time	Your product’s delivery time. Example 2 weeks
delivery_days	Automatically populated Automatically 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	Required Your 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	Optional Your 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, which is a combination of Language ISO_639-1 and region ISO_3166-1_alpha-2
public	FashionUnited internal use
market_public	FashionUnited internal use
market_id	FashionUnited internal use
stand_id	FashionUnited internal use