NORCE CHECKOUT

SHIPPING ADAPTERS

NShiftSelectionResult

Norce Checkout - nShift Adapter API (1.0.0)

Build 2026-01-13 12:26:53

The nShift Adapter API is used to create and manage nShift shippings.

Download OpenAPI description

nshift-adapter.json

nshift-adapter.yaml

Servers

https://docs.norce.io/

Callback

Shipping

Schemas

NShiftSelectedAddon

Represents a selected addon in the nShift widget result.

addonIdstring or null

ID of the addon.

pricenumber or null(double)

Price that has been added to the total price because this addon is selected.

originalPricenumber or null(double)

Original price that has been added to the total original price because this addon is selected.

fieldsArray of objects or null(NShiftFieldValue)

Array of field inputs under the selected addon.

additionalValuesobject or null

Additional key-value pairs defined by the checkout configuration.

{
  "addonId": "string",
  "price": 0.1,
  "originalPrice": 0.1,
  "fields": [
    { … }
  ],
  "additionalValues": {
    "property1": null,
    "property2": null
  }
}

NShiftSelectionResult

Represents the result object from the nShift Checkout widget when a user makes a selection. This is sent via the resultCallback when the user interacts with the widget.

validboolean

Whether the result is valid and can be used to create a shipment.

sessionIdstring or null

UUID of the session used to request the shipping options. Required to create a shipment.

checkoutIdstring or null

UUID of the checkout configuration used to generate the shipping options.

checkoutVersionstring or null

Version number of the checkout configuration used to generate the shipping options.

optionIdstring or null

UUID of the shipping option that is selected in the widget. Required to create a shipment.

pickupPointIdstring or null

Carrier-specific ID of the pickup point selected in the widget. Required only if the shipping option uses pickup points.

timeSlotIdstring or null

Carrier-specific ID of the time slot selected in the widget. Required only if the shipping option uses time slots.

addonsArray of objects or null(NShiftSelectedAddon)

Array of addons selected under the selected shipping option.

fieldsArray of objects or null(NShiftFieldValue)

Array of field inputs under the selected shipping option.

totalPricenumber or null(double)

Total price of the selected shipping option and any selected addons.

totalOriginalPricenumber or null(double)

Total original price of the selected shipping option and any selected addons.

taxRatenumber or null(double)

Tax rate set in the checkout configuration.

additionalValuesobject or null

Additional key-value pairs defined by the checkout configuration.

resultsVersionstring or null

Version of the results object. Currently always "2".

widgetVersionstring or null

Version of the widget that generated the results object. Currently always "2".

{
  "valid": true,
  "sessionId": "string",
  "checkoutId": "string",
  "checkoutVersion": "string",
  "optionId": "string",
  "pickupPointId": "string",
  "timeSlotId": "string",
  "addons": [
    { … }
  ],
  "fields": [
    { … }
  ],
  "totalPrice": 0.1,
  "totalOriginalPrice": 0.1,
  "taxRate": 0.1,
  "additionalValues": {
    "property1": null,
    "property2": null
  },
  "resultsVersion": "string",
  "widgetVersion": "string"
}

NShiftSession

shippingIdstring or null

Shipping identifier

sessionIdstring or null

Session id

selectedOptionIdstring or null

The currently selected shipping option ID. In CreateSession this is the first valid option, in GetSession this is the option that was previously selected (from shipping reference). Used by the frontend to preselect the same option when the user refreshes the checkout page.

settingsobject or null

Widget settings for the nShift checkout widget

dataobject or null

Shipping options data from nShift (matching ShippingOptionsResponse format for widget compatibility)

{
  "shippingId": "string",
  "sessionId": "string",
  "selectedOptionId": "string",
  "settings": {
    "widgetVersion": "string",
    "theme": "string",
    "themeOverride": { … },
    "mode": "string",
    "widthBreakpoints": { … }
  },
  "data": {
    "options": [ … ],
    "addons": [ … ],
    "fields": [ … ],
    "categories": [ … ]
  }
}

Norce Callbacks

Operations

nShift client side callbacks

Operations

nShift Delivery Checkout Orders

Operations