COMMERCE SERVICES

Order Service

Order

Norce Commerce Order v1.1 service (1.1)

The Orders namespace has Entities and Operations used for orders and other related Entities such as DeliveryNotes and Invoices. This namespace has nothing to do with the Checkout process where orders are created, but is more related to order history shown on pages like MyPage and such. The Order history is mostly a snapshot view of the orders as they looked when they got created in Norce, unless process integrations exists where DeliveryNotes and Invoices are passed to Norce.

Download OpenAPI description

openapi-v1.json

openapi-v1.yaml

Servers

Playground

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

Stage

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

Production

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

DeliveryNotes

Contains endpoints for handling package and parcel information from a POS perspective.

Operations

InfoTypes

Contains endpoints for viewing metadata for extended fields on the order and orderitems.

Operations

Invoices

Contains endpoints for viewing invoice information on orders or baskets.

Operations

Orders

Contains endpoints for viewing orders and it`s metadata.

Operations

Schemas

InvoicePagedList

Invoices in a paged list format. The Items property contains all current invoices, depending on paging, and the ItemCount the total number of invoices.

ItemCountinteger or null(int32)

The total number of invoices. Can be used to manage paging. Use PageSize to calculate number of pages.

ItemsArray of objects or null(InvoiceListItem)

Current list of invoices for the current page if paging is used. Otherwise all invoices will be in the list.

{
  "ItemCount": 0,
  "Items": [
    { … }
  ]
}

Order

Information about an Order.

Idinteger or null(int64)

The internal id of the Order in Norce.

QuotationIdinteger or null(int32)

The internal id of the quotation/basket used to create the Order.

OrderNostring or null[ 0 .. 50 ] characters

The external order number of the Order, usually from an ERP. MaxLength: 50

OrderDatestring or null(date-time)

The order date of the Order.

Statusstring or null[ 0 .. 50 ] characters

The status text of the Order. See ListOrderStatuses for information about available statuses. MaxLength: 50

Sourcestring or null[ 0 .. 255 ] characters

The source of the Order. 'WEB' is used for all orders created through Norce. MaxLength: 255

Currencystring or null[ 0 .. 3 ] characters

The currency code of the Order. MaxLength: 3

ItemsArray of objects or null(OrderItem)

The items on the Order.

SellToobject or null

Information about the Customers in the Order namespace. It has information about Customer, any Company and addresses.

BillToobject or null

Information about the Customers in the Order namespace. It has information about Customer, any Company and addresses.

ShipToobject or null

Information about the Customers in the Order namespace. It has information about Customer, any Company and addresses.

OrderTotalIncVatnumber or null(decimal)

The total amount on the Order including VAT.

OrderTotalExVatnumber or null(decimal)

The total amount on the Order excluding VAT.

PaymentMethodstring or null[ 0 .. 50 ] characters

The payment method of the Order. MaxLength: 50

DeliveryMethodstring or null[ 0 .. 50 ] characters

The delivery method of the Order. MaxLength: 50

DeliveryNotesArray of objects or null(DeliveryNote)

The delivery notes of the Order.

InfoArray of objects or null(Info)

A list of infos used to keep application specific data on the order.

TypeIdinteger or null(int32)

The type of the order. 1 for normal sales order and 3 for orders from subscriptions. 2 is reserved for purchase orders.

DeliveryMarkstring or null[ 0 .. 255 ] characters

The delivery mark of the Order. Gets it's value from the OrderReference field of the basket. MaxLength: 255

DropPointobject or null

Information about the Customers in the Order namespace. It has information about Customer, any Company and addresses.

{
  "Id": 0,
  "QuotationId": 0,
  "OrderNo": "string",
  "OrderDate": "2019-08-24T14:15:22Z",
  "Status": "string",
  "Source": "string",
  "Currency": "str",
  "Items": [
    { … }
  ],
  "SellTo": {
    "Company": { … },
    "Customer": { … },
    "Address": { … },
    "DropPointCode": "string"
  },
  "BillTo": {
    "Company": { … },
    "Customer": { … },
    "Address": { … },
    "DropPointCode": "string"
  },
  "ShipTo": {
    "Company": { … },
    "Customer": { … },
    "Address": { … },
    "DropPointCode": "string"
  },
  "OrderTotalIncVat": 0,
  "OrderTotalExVat": 0,
  "PaymentMethod": "string",
  "DeliveryMethod": "string",
  "DeliveryNotes": [
    { … }
  ],
  "Info": [
    { … }
  ],
  "TypeId": 0,
  "DeliveryMark": "string",
  "DropPoint": {
    "Company": { … },
    "Customer": { … },
    "Address": { … },
    "DropPointCode": "string"
  }
}

OrderAddress

Information about Addresses in the Order namespace.

Line1string or null

The first address line of the Address.

Line2string or null

The second address line of the Address.

CareOfstring or null

The care of part of the Address.

Citystring or null

The city of the Address.

ZipCodestring or null

The zipcode of the Address.

Countrystring or null

The name of the country of the Address.

CountryCodestring or null

The code of the country of the Address.

Regionstring or null

The region of the Address.

ShippingPhoneNumberstring or null

Phone number for shipping address. Only applicable in shipping addresses.

GlobalLocationNostring or null

The Global Location Number (GLN) is part of the GS1 systems of standards. It is a simple tool used to identify a location and can identify locations uniquely where required. This is only used for invoice addresses.

{
  "Line1": "string",
  "Line2": "string",
  "CareOf": "string",
  "City": "string",
  "ZipCode": "string",
  "Country": "string",
  "CountryCode": "string",
  "Region": "string",
  "ShippingPhoneNumber": "string",
  "GlobalLocationNo": "string"
}