Skip to main content

Create an order list

Create an order list to control which products specific users or companies can (or cannot) order.

Mutation​

mutation CreateOrderlist($input: OrderlistCreateInput!) {
  orderlistCreate(input: $input) {
    id
    type
    active
    code
    descriptions { language value }
    validFrom
    validTo
  }
}

Variables​

{
  "input": {
    "type": "POSITIVE",
    "descriptions": [
      { "language": "EN", "value": "Approved industrial heating products" },
      { "language": "NL", "value": "Goedgekeurde industriële verwarmingsproducten" }
    ],
    "code": "HEAT-APPROVED-2026",
    "productIds": [25, 26, 28],
    "active": "Y"
  }
}

Response​

{
  "data": {
    "orderlistCreate": {
      "id": 230,
      "type": "POSITIVE",
      "active": "Y",
      "code": "HEAT-APPROVED-2026",
      "descriptions": [
        { "language": "EN", "value": "Approved industrial heating products" },
        { "language": "NL", "value": "Goedgekeurde industriële verwarmingsproducten" }
      ],
      "validFrom": null,
      "validTo": null
    }
  }
}

List types​

TypeBehavior
POSITIVEAssigned users/companies can only see and order products on this list. All other products are hidden.
NEGATIVEAssigned users/companies cannot see or order products on this list. All other products remain available.

How it works​

Order lists are a B2B access control mechanism. A POSITIVE list restricts a user's catalog to a curated set of approved products, while a NEGATIVE list hides specific products (e.g. hazardous materials, competitor brands). Products can be referenced by ID (productIds) or by external source (productSources). Use validFrom and validTo to make lists time-bound. Use companyIds or userIds on creation to assign the list immediately, or use the separate assign mutations afterward.

See also​