Create a new orderlist

POST 
/v2/orderlists

Create a new orderlist

Request

application/json

Body

required

Create orderlist input

productIds string[]

List of product ids

productSources string[]

List of product sources

clusterIds string[]

List of cluster ids

clusterSources string[]

List of cluster sources

type stringrequired

Possible values: [POSITIVE, NEGATIVE]

Orderlist type. One of: [POSITIVE, NEGATIVE]

descriptions

object[]

Orderlist descriptions per language

Array [

language stringrequired

Possible values: >= 2 characters and <= 2 characters

Localized field language code

value stringnullablerequired

Localized field value

]

extras

object[]

Extra field per language

Array [

language stringrequired

Possible values: >= 2 characters and <= 2 characters

Localized field language code

value stringnullablerequired

Localized field value

]

code string

Orderlist code

validFrom date-time

Valid from (Display only)

validTo date-time

Valid to (Display only)

userIds string[]

List of user ids

userSources string[]

List of user sources

partnerEntity string

Partner entity

active string

Default value: Y

Shows if the orderlist is active

companyIds string[]

List of company ids

companySources string[]

List of company sources

Responses

201

Orderlist created

application/json

Schema

Schema

id integerrequired

Orderlist primary identifier

createdAt date-timerequired

Orderlist creation date

lastModifiedAt date-timerequired

Orderlist last modified date

descriptions

object[]

required

Orderlist description per language

Array [

language stringrequired

Possible values: >= 2 characters and <= 2 characters

Language is set as 2 character country code.

value string

Localized field value

]

extras

object[]

Extra field per language

Array [

language stringrequired

Possible values: >= 2 characters and <= 2 characters

Language is set as 2 character country code.

value string

Localized field value

]

code string

Orderlist code

validFrom date-time

Valid from (Display only)

validTo date-time

Valid to (Display only)

type stringrequired

Possible values: [POSITIVE, NEGATIVE]

Orderlist type

partnerEntity string

Partner entity

active stringrequired

Default value: Y

Shows if the orderlist is active

productIds string[]required

List of product ids

clusterIds string[]required

List of cluster ids

userIds string[]required

List of user ids

companyIds string[]required

List of company ids

Example (from schema)

{
  "id": 1234,
  "createdAt": "2022-01-01T00:00:00.000Z",
  "lastModifiedAt": "2022-01-02T00:00:00.000Z",
  "descriptions": [
    {
      "language": "NL",
      "value": "Dutch desc."
    },
    {
      "language": "DE",
      "value": "German desc."
    }
  ],
  "extras": [
    {
      "language": "NL",
      "value": "Dutch"
    },
    {
      "language": "DE",
      "value": "German"
    }
  ],
  "code": "Code123",
  "validFrom": "2022-01-01T00:00:00.000Z",
  "validTo": "2022-01-01T00:00:00.000Z",
  "type": "POSITIVE",
  "partnerEntity": "Partner entity",
  "active": "Y",
  "productIds": [
    1111,
    2222,
    3333
  ],
  "clusterIds": [
    1111,
    2222,
    3333
  ],
  "userIds": [
    1111,
    2222,
    3333
  ],
  "companyIds": [
    1111,
    2222,
    3333
  ]
}

400

Bad request

403

Forbidden

500

Unknown create orderlist error

Loading...