Skip to content

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.

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.

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

AttributeFormatRequirements
nameRequired

Example
Black dress Lucy

Syntax
Max 255 characters

Schema.org property
Product.name

brand_nameRequired

Syntax
Max 255 characters

Schema.org property
Product.brand

source_product_idRequired

Example
A123C5

Syntax
Max XX characters

Schema.org property
Product.sku

source_variant_idRequired- 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
seasonRequired

The season your product belongs to.

Example
SS21

category_pathOptional

Syntax
Max 255 characters

category_mainRequired

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_subOptional

Syntax
Max 255 characters

category_threeOptional

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_daysAutomatically 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

imageRequired

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_imageOptional

Your product’s additional image URL

Example
https://​cdn.myb2bshop.​com/3000-2.jpg

localeFashionUnited 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

publicFashionUnited internal use
market_publicFashionUnited internal use
market_idFashionUnited internal use
stand_idFashionUnited internal use