NORCE CHECKOUT

CORE

Order

Logistics

Norce Checkout - Order Management API (0.1)

Build 2026-01-12 08:21:29

The Order Management API is used to create and handle orders

Download OpenAPI description

order.json

order.yaml

Servers

Playground

https://{slug}.api-se.playground.norce.tech/checkout/order/

Stage

https://{slug}.api-se.stage.norce.tech/checkout/order/

Production

https://{slug}.api-se.norce.tech/checkout/order/

Schemas

Item

idstring

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"

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": "2019-08-24T14:15:22Z"
  },
  "upsell": true,
  "attributes": {
    "property1": null,
    "property2": null
  }
}

Logistics

weightinteger(int32)

Weight of the item in grams.

Example: 2500

heightinteger(int32)

Height of the item in millimeters.

Example: 100

widthinteger(int32)

Width of the item in millimeters.

Example: 50

lengthinteger(int32)

Length of the item in millimeters.

Example: 200

tagsArray of strings

Tags that can be used to setup custom delivery rules in delivery modules.

shippingDatestring(date-time)

{
  "weight": 2500,
  "height": 100,
  "width": 50,
  "length": 200,
  "tags": [
    "string"
  ],
  "shippingDate": "2019-08-24T14:15:22Z"
}

Notification

idstring

Unique ID for the Notification

Example: "ocGooDddTOjKOuFmNnkEozEpfuTh"

adapterIdstring

Identifier for the system responsible for this notification. If any reference to configuration is made inside curly braces in Invoke the configuration is found using this identifier.

Example: "jetshop_adapter"

referencestring

Reference for the Notification. Should (but not required to) be unique for the order. Used to track notifications across different orders.

Example: "PuXCudQEiWTOHvquGGolFUVOuy"

descriptionstring

Purpose or effect of the notification.

Example: "Export payment information to Jetshop when order has been completed."

scopestring

Valid json path inside the order. Does not support scope inside arrays.

Example: "/state/currentStatus"

schemaobject

Json schema (https://json-schema.org/draft/2020-12/schema) on the scope. Notification triggers when a change occurs on the scope and the schema is valid for the scope.

Example: {"const":"completed"}

invokestring

Url to invoke on notification trigger. Can include references to adapter configuration and order inside curly braces.

Example: "{configuration.adapter.internalUrl}/api/v1/callbacks/orders/{order.id}/specific-callback"

versionstring

The version of the order body you expect to receive in the callback.

Enum"v0""v1"

delayinteger(int32)

The delay in ms before the notification is sent.

{
  "id": "ocGooDddTOjKOuFmNnkEozEpfuTh",
  "adapterId": "jetshop_adapter",
  "reference": "PuXCudQEiWTOHvquGGolFUVOuy",
  "description": "Export payment information to Jetshop when order has been completed.",
  "scope": "/state/currentStatus",
  "schema": {
    "const": "completed"
  },
  "invoke": "{configuration.adapter.internalUrl}/api/v1/callbacks/orders/{order.id}/specific-callback",
  "version": "v0",
  "delay": 0
}

Checkout

Operations

Checkout Payment

Operations

Checkout Shipping

Operations