Article parameters

An article is the fundamental unit of inventory — a unique product sold on the marketplace, identified by its own SKU. A specific red t-shirt in size medium is one article; the t-shirt available in several colours and sizes is a product, made up of many articles. Each article carries its own data and can have its own images, description and pricing.

This page describes every field of the article model. For how to group articles into products, see Product variations.

Required parameters

Parameter	Description	Data type	Market-specific
`sku`	Your unique ID for the article	String (1–64)	No
`status`	Sale status	`for sale` or `paused`	No
`quantity`	Quantity in stock	Integer (0–500 000)	No
`main_image`	Direct link to the main image	String (1–1500), valid URL	No
`markets`	Countries the article is for sale in	See Market codes	No
`title`	Article name	See Title and description	Per language
`description`	Detailed description	See Title and description	Per language
`price`	Article price	See Prices	Yes
`shipping_time`	Delivery time to the customer	See Shipping time	Yes

Optional parameters

Parameter	Description	Data type	Market-specific
`parent_sku`	Group identifier for a product	String (1–64)	No
`category`	Category of the article	String	No
`properties`	Article properties	See Properties	Per language
`variational_properties`	Which properties differentiate variants	See Product variations	No
`brand`	Manufacturer name	String (1–50)	No
`gtin`	Global identifier	String (8–14)	No
`images`	Additional image links	List of strings (1–1500), max 10	No
`unique_selling_points`	Key selling points	See Unique selling points	Yes
`specifications`	Technical specifications	See Specifications	Yes
`classifications`	Classification attributes	See Classifications	No
`delivery_type`	Delivery method	See Delivery type	Yes
`kn_number`	Combined nomenclature code	String (1–48)	No
`shipped_from`	Origin of shipment	`EU` or `NON_EU`	No
`manufacturer`	Manufacturer and GPSR details	See Manufacturer	No
`shipping_configuration_ids`	Configuration IDs overriding your default shipping configurations	List of UUIDs	No

shipping_configuration_ids applies to CDON only. See the Shipping Configurations section.

Standard codes

Market codes

Code	Country
`SE`	Sweden
`DK`	Denmark
`FI`	Finland
`NO`	Norway

Market codes follow ISO-3166-1 alpha-2.

Language codes

Code	Description
`sv-SE`	Swedish (Sweden)
`en-US`	English (United States)
`da-DK`	Danish (Denmark)
`fi-FI`	Finnish (Finland)
`nb-NO`	Norwegian (Norway)

The format combines an ISO-639-1 language code and an ISO-3166-1 alpha-2 region code with a hyphen — for example en-US.

Currency codes

Code	Description	Market
`SEK`	Swedish krona	`SE`
`DKK`	Danish krone	`DK`
`EUR`	Euro	`FI`
`NOK`	Norwegian krone	`NO`

Currency codes follow ISO-4217.

Properties

Properties are key/value pairs defined by the marketplace, in three types.

Field	Type	Required
`name`	String	Yes
`value`	String (1–36)	Yes
`language`	String (5)	Required on free-text properties; not used on the others

{
  "properties": [
    { "name": "color",            "value": "Deep Green", "language": "en-US" },
    { "name": "preset-size_SML",  "value": "xxl" },
    { "name": "weight_kg",        "value": "0.5" }
  ]
}

Note that size and preset-size_SML are different properties. size is free text — any
string you like, with a language. preset-size_SML takes a value from a fixed list and needs no
language. Sizes such as xxl belong to the pre-defined property.

Free-text properties

Custom string values, 1–36 characters. A language is required on every free-text property.

color · connection_type · flavor · material · pattern · phone_case_type · size

Pre-defined properties

These take a value from a fixed list.

Property	Allowed values
`preset-color`	`red`, `blue`, `green`, `orange`, `yellow`, `purple`, `pink`, `gold`, `silver`, `multicolor`, `white`, `gray`, `black`, `turquoise`, `brown`, `beige`, `transparent`
`preset-connection_type`	`bluetooth`, `usb-c`, `micro-usb`, `lightning`, `3.5mm`
`preset-hair_type`	`dry hair`, `normal hair`, `curly hair`, `damaged hair`, `frizzy hair`, `fine hair`, `dry scalp`, `dyed hair`
`preset-media_format`	`dvd`, `blu-ray`, `4k ultra hd`, `cd`, `vinyl`
`preset-pattern`	`abstract and geometry`, `animals and animal patterns`, `nature and environment`, `plants and fruit`, `space and scifi`, `text and quotes`, `camouflage`, `glitter`, `marble and stone`, `vehicles`, `flags and symbols`, `maps`, `characters and celebrities`, `fantasy`, `retro`
`preset-refurb_grading`	`a+`, `a`, `b`, `c`
`preset-refurb_warranty`	`2`, `6`, `12`, `24` (months of warranty)
`preset-size_SML`	`one size`, `xxs`, `xs`, `s`, `m`, `l`, `xl`, `xxl`
`preset-skin_type`	`dry skin`, `normal skin`, `mature skin`, `oily skin`, `mixed skin`, `acne`

Numerical properties

Integers or decimals, sent as strings, 1–50 characters.

shoe_size_eu · shoe_size_uk_men · shoe_size_uk_women · shoe_size_us_men · shoe_size_us_women · size_cm · size_gb · size_m · size_mm · size_unit · volume_l · volume_ml · weight_g · weight_kg

Markets

The countries the article is for sale in.

{ "markets": ["SE", "DK"] }

Prices

Market-specific pricing, VAT included. The amount field is named amount_including_vat — always send that name.

Field	Type	Required	Notes
`market`	String (2)	Yes	A market code
`amount_including_vat`	Decimal (1–7)	Yes
`currency`	String (3)	Yes	A currency code
`vat_rate`	Decimal	No	Defaults to the market rate

{
  "price": [
    { "market": "SE", "value": { "amount_including_vat": 79, "currency": "SEK" } },
    { "market": "DK", "value": { "amount_including_vat": 99, "currency": "DKK" } }
  ]
}

Shipping time

Delivery time range per market.

Field	Type	Required
`market`	String (2)	Yes
`min`	Integer 0–21	Yes
`max`	Integer 1–21	Yes

{
  "shipping_time": [
    { "market": "SE", "min": 2, "max": 5 },
    { "market": "DK", "min": 4, "max": 9 }
  ]
}

Delivery type

Delivery method per market. Available types: mailbox, service_point, home_delivery.

{
  "delivery_type": [
    { "market": "SE", "value": "mailbox" },
    { "market": "DK", "value": "service_point" }
  ]
}

Title and description

Both are supplied per language.

title — String (5–150 characters)
description — String (10–4096 characters)

{
  "title": [
    { "language": "sv-SE", "value": "This is the title in Swedish" },
    { "language": "en-US", "value": "This is the title in English" }
  ]
}

Unique selling points

Field	Type
`language`	String (5)
`value`	List of strings, max 30 characters each

{
  "unique_selling_points": [
    { "language": "en-US", "value": ["Water resistant", "Long battery life"] },
    { "language": "sv-SE", "value": ["Vattenbeständig", "Lång batteritid"] }
  ]
}

Specifications

Technical details organised by language, then by section. Each attribute has a name, a value and an optional description.

{
  "specifications": [
    {
      "language": "en-US",
      "value": [
        {
          "name": "Technical Details",
          "value": [
            { "name": "Screen size",      "value": "6.1 inch", "description": "Screen size measured diagonally" },
            { "name": "Battery capacity", "value": "4500mAh" }
          ]
        }
      ]
    }
  ]
}

Classifications

Product classification attributes.

`CONDITION`

Value	Meaning
`NEW`	Brand new product
`REFURB`	Refurbished product

`RESTRICTED`

Value	Meaning
`ADULT`	Adult-only product

{ "classifications": [ { "name": "CONDITION", "value": "REFURB" } ] }

Manufacturer

Manufacturer and EU responsible-person details, as required by GPSR.

Field	Type	Required	Notes
`name`	String	Yes	Company name
`address`	Object	Yes	Physical address
`website`	String	No
`email`	String	No
`responsible_person`	Object	No	Required if the manufacturer is outside the EU

Address

Field	Type	Required
`street_address`	String	Yes
`city`	String	Yes
`postal_code`	String	Yes
`country`	String (2)	Yes

Responsible person — only needed if the manufacturer is outside the EU

Field	Type	Required
`name`	String	Yes
`phone`	String	No
`email`	String	No

{
  "manufacturer": {
    "name": "Manufacturer Company Name",
    "address": {
      "street_address": "123 Manufacturing Street",
      "city": "Industrial City",
      "postal_code": "12345",
      "country": "SE"
    },
    "website": "https://manufacturer.example.com",
    "email": "[email protected]",
    "responsible_person": {
      "name": "EU representative",
      "phone": "+234-567-8900",
      "email": "[email protected]"
    }
  }
}