Item

idstringread-only

Unique identifier for the order

Example: "ci_FpEzyBvBBUyKxkeNriFUxZOCje"

referencestring

Optional. Platform cart item reference.

namestring

Descriptive name of the item.

Example: "T-Shirt XL"

skustring

SKU or article number.

Example: "A000123"

productTypestring

Product type, physical is the default. Other options include Digital, GiftCard and Bundle.

Enum"physical""digital""giftCard""bundle""placeholder"

itemsArray of objects(Item)

A List of items, useful for when this item is a bundle containing other items.

urlstring

URL to the product page.

Example: "https://example.com/products/A000123"

imageUrlstring

URL to an image showing the item.

Example: "https://example.com/products/A000123/images/1"

quantityinteger(int32)

Quantity of the item.

Example: 2

unitstring

Unit used to describe the quantity. Ex. st, kg

Example: "st"

priceobject

Unit price, excluding discount

totalobject

Total sum for all quantities including discount.

originalTotalobject

Total sum for all quantities excluding discount.

vatRatenumber(double)

Value-added tax. 25% would be input as 0.25.

Example: 0.25

discountsArray of objects(Discount)

Discounts applied to item.

logisticsobject

Logistics-related information for shipping and handling of the item.

upsellboolean

Indicates if item should be added after order has been accepted.

attributesobject

Allows you to store any custom attributes for the item.

{
  "id": "ci_FpEzyBvBBUyKxkeNriFUxZOCje",
  "reference": "string",
  "name": "T-Shirt XL",
  "sku": "A000123",
  "productType": "physical",
  "items": [
    {}
  ],
  "url": "https://example.com/products/A000123",
  "imageUrl": "https://example.com/products/A000123/images/1",
  "quantity": 2,
  "unit": "st",
  "price": {
    "includingVat": 1234,
    "excludingVat": 987.2
  },
  "total": {
    "includingVat": 1234,
    "excludingVat": 987.2
  },
  "originalTotal": {
    "includingVat": 1234,
    "excludingVat": 987.2
  },
  "vatRate": 0.25,
  "discounts": [
    { … }
  ],
  "logistics": {
    "weight": 2500,
    "height": 100,
    "width": 50,
    "length": 200,
    "tags": [ … ],
    "shippingDate": "2026-10-05T00:00:00Z",
    "shippingDates": { … },
    "delivery": { … }
  },
  "upsell": true,
  "attributes": {
    "property1": null,
    "property2": null
  }
}

Norce Checkout - Order Management API (1.0)

Schemas

HttpStatusCode

Item

ItemDelivery

Checkout

Checkout Payment

Checkout Shipping