LISTING PRODUCTS

Article Specifications

Article

The article is the item that is being bought by the customer.

Each article has a sku, the unique identifier in your system. Fyndiq assigns every article an Article-ID as the unique identifier in Fyndiq’s system.

As a merchant you upload articles.

You can assign up to 10 tags to each article, including a main tag, for great exposure, read more about tags and our main tag list here:

Product

Products are collection, or groups, of articles, shown to the customer under the same product card and as variations.

The parent_sku is the group identifier in your system. Articles with the same parent_sku are assigned the same Product-ID.

The articles in a product differentiate themselves according to criteria of variation which are defined in the article fields color and size.

As a merchant you do not upload products but you create products by assigning a same parent_sku to articles variations.

6 articles, grouped into 1 product (t-shirt with color and size variations)

Since we are using the article as base unit for our data model, article variations within a product can have different attributes (prices, images, stock etc.):

NOTE: A product can be composed of one article (variation) only, it is a single product.


Article fields

sku

Type of data:

String (1-64 characters)

Definition:

The sku is the unique identifier used by the merchant and cannot exceed 64 characters. It represents the item that is on sale (the article in Fyndiq language). Two articles cannot have the same sku.

The sku is mapped to the Fyndiq’s article ID.


parent_sku

Type of data:

String (1-64 characters)

Definition:

The reference used by Fyndiq to group article variations into a product. The parent_sku  must be the same for all articles included in the product.

The parent_sku  is mapped to the Fyndiq’s product ID.


status

Type of data:

String

Accepted values:

“for sale”; “paused”

Definition:

Use this field to set the status of your article. Should it be on sale or paused?


quantity

Type of data:

Non-negative integer (max. 500 000)

Definition:

The quantity, in stock, of the article that is to be offered on Fyndiq.

Examples:

“0”, “15”, “259”


markets

Type of data:

List of strings (Country code, 2 characters each)

Definition:

Determine the markets (=countries) where your article will be on sale. For now, Sweden (SE) is the only open market. Codes as per ISO 3166 alpha-2.

Allowed values:

SE


title

Type of data:

String (5-200 characters)

Definition:

Element that allows the article to be identified. It must be constructed professionally in order to improve searchability.

More information on how to set your title in the product title section.


description

Type of data:

String (10-4096 characters)

Definition:

Detailed, well-structured and clearly formulated text to describe the article. The description MUST NOT contain any HTML or other formatting.

More information on how to edit your description in the product description section.


tags

Type of data:

List of strings (0-50 characters each)

Definition:

Non-hierarchical keyword or term assigned to each article. This kind of metadata helps to describe an item and allows it to be categorised and found by browsing or searching on Fyndiq.

More information on how to choose tags in the tags section.


main_image

Type of data:

Valid URL

Definition:

Direct URL link to the image. See the product image section for more information on our picture policy.


images

Type of data:

List of valid URLs

Definition:

Direct links to the extra images you want to add. There is a maximum of 10 extra images.See the product image section for more information on our picture policy.


size

Type of data:

String (0-50 characters)

Definition:

Criteria for variations within a product. More information and suggested values for the field size can be found on our guidelines, in the size section.


color

Type of data:

String (0-50 characters)

Definition:

Color of the article. Criteria for variations within a product. The list of suggested values for the field color can be found in the color section of our guidelines.


brand

Type of data:

String (0-50 characters)

Definition:

Manufacturer of the item.


gtin

Type of data:

String (8, 12 or 13)

Definition:

Global Trade Item Number, unique global identifier used by companies in order to identify all of their trade items. A valid GTIN is required for all branded products.

Accepted formats:

Valid GTIN code: GTIN-8, GTIN-12 (UPC), GTIN-13 (EAN)

GTIN calculator:

https://www.gs1.org/check-digit-calculator


original_price

Type of data:

Decimal

Definition:

Price of the article, before selling on Fyndiq. The original_price  must be higher than the actual selling price on Fyndiq. The currency must be given in a three letter currency code as per ISO-4217 standard.

Examples:
  • Accepted: 9.99 USD

  • Non-accepted: 9.99$


price

Type of data:

Decimal

Definition:

Selling price of the item, it must be equal or lower than the original_price. The currency must be given in a three letter currency code as per ISO-4217 standard. See the pricing section and the VAT section  for more information.

Examples:
  • Accepted: 5.99 USD

  • Non-accepted: 5.99$


shipping_price

Type of data:

Decimal

Definition:

Shipping cost per product. The currency must be given in a three letter currency code as per ISO-4217 standard.

Examples:
  • Accepted: 1.79 USD

  • Non-accepted: 1.79$


shipping_time

Type of data:

String (1-9 characters)

Definition:

Time period for the package to reach the customer (range, in days).

Examples:
  • Accepted: 10 – 15

  • Accepted: 20 – 28

  • Non-accepted: one month

  • Non-accepted: 1 month