Last updated

Order Service schemas

The Orders namespace is 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 in Norce is mostly a snapshot view of the orders as they looked when they were created, unless process integrations exists where DeliveryNotes and Invoices are passed to Norce.

Address

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.

Company

Information about Companies in the Order namespace.

Idinteger or null(int32)

The internal id of Company.

Nostring or null

The external code of Company. Usually from an ERP system.

Namestring or null

The name of Company.

OrgNostring or null

The organizational number of Company.

Customer

Information about Customers in the Order namespace.

Idinteger or null(int32)

The internal id of Customer.

Nostring or null

The external code of Customer. Usually from an ERP system.

FirstNamestring or null

The first name of Customer.

LastNamestring or null

The last name of Customer.

Ssnstring or null

The social security number of Customer.

Emailstring or null

The e-mail of Customer.

Phonestring or null

The phone number of Customer.

CellPhonestring or null

The cell phone number of Customer.

CustomerData

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

Companyobject or null

Information about Companies in the Order namespace.

Customerobject or null

Information about Customers in the Order namespace.

Addressobject or null

Information about Addresses in the Order namespace.

DropPointCodestring or null

The external drop point code, if any. Only set for drop points.

DeliveryNotes

DeliveryNote

Information about a DeliveryNote. DeliveryNotes are not created though the API and must be imported to Norce through the Connect service.

Idinteger or null(int32)

The internal Id of the DeliveryNote.

NoteNostring or null[ 0 .. 50 ] characters

The external number of the DeliveryNote. Usually a number from the ERP system. MaxLength: 50

DeliveryDatestring or null(date-time)

The delivery date of the DeliveryNote.

NoteTextstring or null[ 0 .. 255 ] characters

Free text field of the DeliveryNote. MaxLength: 255

DeliveryModestring or null[ 0 .. 50 ] characters

The delivery mode of the items for the DeliveryNote. MaxLength: 50

OrderNostring or null[ 0 .. 50 ] characters

The external order number of the Order related to the DeliveryNote. This usually comes from an ERP. MaxLength: 50

OrderDatestring or null(date-time)

The order date of the Order related to the DeliveryNote.

Culturestring or null[ 0 .. 16 ] characters

The culture code of the DeliveryNote. This is the culture code used when asking for DeliveryNotes, not the original. MaxLength: 16

YourReferencestring or null[ 0 .. 255 ] characters

Not used. MaxLength: 255

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.

SmsNotificationNumberstring or null[ 0 .. 50 ] characters

Not used. MaxLength: 50

ItemsArray of objects or null(DeliveryNoteItem)

The items delivered.

PackagesArray of objects or null(DeliveryNotePackage)

Package information for the DeliveryNote.

DivisionCodestring or null[ 0 .. 50 ] characters

The external store code for the delivering Store. MaxLength: 50

Statusstring or null[ 0 .. 50 ] characters

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

InfoArray of objects or null(Info)

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

DeliveryNoteItem

Information about the items on a DeliveryNote.

Idinteger or null(int32)

The internal id of the DeliveryNoteItem.

RowNumbernumber or null(decimal)

The row number of the DeliveryNoteItem.

ItemNostring or null[ 0 .. 50 ] characters

The PartNo of the DeliveryNoteItem. MaxLength: 50

ItemDescriptionstring or null[ 0 .. 255 ] characters

The name of the DeliveryNoteItem. MaxLength: 255

QtyOrderednumber or null(decimal)

The 1uantity ordered. This is the total quantity ordered.

QtyDeliverednumber or null(decimal)

The quantity delivered. This is the quantity delivered on this DeliverNoteItem.

QtyBackorderednumber or null(decimal)

The quantity not delivered. This is the quantity still missing on this DeliverNoteItem.

Commentstring or null[ 0 .. 255 ] characters

Free text comment on the DeliverNoteItem. MaxLength: 255

Statusstring or null[ 0 .. 50 ] characters

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

TrackingCodesArray of objects or null(Tracking)Deprecated

The external tracking code of the DeliveryNoteItem.

DeliveryNotePackage

Information about each package associated with a DeliveryNote.

Idinteger or null(int32)

The internal id of the DeliveryNotePackage.

ParcelNumberstring or null

The external parcel number of the DeliveryNotePackage from the Speditor. Used to track parcels online.

Statusstring or null

The status text of the DeliveryNotePackage. See ListOrderStatuses for information about available statuses.

Tracking

Obsolete Not used. Tracking info is in DeliveryNotePackage.

Idinteger or null(int32)
FreightForwarderstring or null
TrackingCodestring or null

InfoTypes

Info

Information carrier entity. It is used on Orders, DeliveryNotes and Invoices. When setting up InfoTypes on Order use the same Code for Order/OrderItem as for Basket/BasketItem if you want them to be mapped. When creating orders, info-fields will be transferred from basket to order when there is a map with the same code.

Codestring or null

The external code of the Info.

Namestring or null

The name of the Info.

Descriptionstring or null

The description of the Info.

Valuestring or null

The value of the Info.

Invoices

Invoice

Information about an Invoice. Invoices are not created through the API and must be imported to Norce through the Connect service.

Idinteger or null(int64)

The internal id of the Invoice.

InvoiceNostring or null[ 0 .. 50 ] characters

The external invoice number of the Invoice. Usually a number from the ERP system. MaxLength: 50

InvoiceDatestring or null(date-time)

The invoice date of the Invoice.

InvoiceDueDatestring or null(date-time)

The invoice due date of the Invoice.

InvoiceTextstring or null[ 0 .. 255 ] characters

InvoiceText is taken from InvoiceMark in Norce. MaxLength: 255

OrderIdinteger or null(int64)

The internal id of the Order related to the Invoice.

OrderNostring or null[ 0 .. 50 ] characters

The external order number of the Order related to the Invoice. The order number usually comes from an ERP. MaxLength: 50

OrderDatestring or null(date-time)

The order date of the Order related to the Invoice.

Sourcestring or null[ 0 .. 255 ] characters

The Source of the Invoice. 'WEB' is used for all invoices created through Norce. MaxLength: 255

DeliveryDatestring or null(date-time)

The delivery date of the DeliveryNote related to the Invoice.

DeliveryMethodstring or null[ 0 .. 50 ] characters

The delivery method of the Order. MaxLength: 50

PaymentMethodstring or null[ 0 .. 50 ] characters

The payment method of the Order. MaxLength: 50

BillToobject or null

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

OrderFreightnumber or null(decimal)

The total amount for freight on the Invoice.

InvoiceChargenumber or null(decimal)

The total amount for invoice charge on the Invoice.

InvoiceAmountExVatnumber or null(decimal)

The total amount invoiced ex VAT.

VatAmountnumber or null(decimal)

The total VAT amount invoiced.

ItemsArray of objects or null(InvoiceItem)

The invoiced items.

InfoArray of objects or null(Info)

A list of infos used to keep application specific data on the invoice. Not used for credit invoices.

InvoiceNoPspstring or null[ 0 .. 50 ] characters

The invoice number from the PSP. This is only used when the PSP issues invoices. MaxLength: 50

CreditedInvoiceNostring or null[ 0 .. 50 ] characters

The credited invoice number. This is only used for credit invoices and this is the number of the original invoice being credited. MaxLength: 50

IsDebitboolean or null

Indicates if this is a debit invoice (true) or a credit invoice (false).

GroupByKeystring or null[ 0 .. 50 ] characters

GroupByKey can be used to group invoices. All individual invoices on one summary invoice will have this set to the same value. Normal non-summary invoices will have this value set to null. MaxLength: 50

Commentstring or null[ 0 .. 250 ] characters

Free text comment on the Invoice. MaxLength: 250

InvoiceAmountIncVatnumber or null(decimal)

The total amount invoiced inc VAT.

InvoiceItem

Information about each item on an Invoice.

RowNumbernumber or null(decimal)

The row number of the item.

ItemNostring or null[ 0 .. 50 ] characters

The PartNo of the item. MaxLength: 50

ItemDescriptionstring or null[ 0 .. 255 ] characters

The mame of the item. MaxLength: 255

Quantitynumber or null(decimal)

The quantity invoiced. This is the quantity invoiced on this InvoiceItem.

UnitPricenumber or null(decimal)

The unit price of the item, excluding VAT.

UnitDiscountnumber or null(decimal)

The unit discount of the item, excluding VAT.

RowAmountnumber or null(decimal)

The total amount of the item, excluding VAT.

RowAmountVatnumber or null(decimal)

The total VAT of the item.

DeliveryDatestring or null(date-time)

The delivery date of the item.

VatRatenumber or null(decimal)

A rate to multiply with price to get price inc VAT. 25% VAT equals a VatRate of 1.25.

UnitPriceIncVatnumber or null(decimal)

The unit price of the item, including VAT.

InvoiceListItem

Information about an Invoice used in lists. This is a more light weight representation of the Invoice than the Invoice entity.

Idinteger or null(int64)

The internal id of the Invoice.

InvoiceNostring or null

The external invoice number of the Invoice. Usually from an ERP system.

InvoiceDatestring or null(date-time)

The invoice date of the Invoice.

InvoiceDueDatestring or null(date-time)

The invoice due date of the Invoice.

InvoiceTextstring or null

InvoiceText is taken from InvoiceMark in Norce.

OrderNostring or null

The ERP order number of the Order related to the Invoice.

OrderDatestring or null(date-time)

The order date of the Order related to the Invoice.

Sourcestring or null

The source of the Invoice. 'WEB' is used for all invoices created through Norce.

DeliveryDatestring or null(date-time)

The delivery date of the Order.

DeliveryMethodstring or null

The delivery method of the Order.

PaymentMethodstring or null

The payment method of the Order.

BillToobject or null

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

InvoiceAmountExVatnumber or null(decimal)

The total amount invoiced excluding VAT.

VatAmountnumber or null(decimal)

The total VAT amount invoiced.

InvoiceNoPspstring or null

The invoice number from the PSP. This is only used when the PSP issues invoices.

IsDebitboolean or null

Indicates if this is a debit invoice (true) or a credit invoice (false).

GroupByKeystring or null

GroupByKey can be used to group invoices. All individual invoices on one summary invoice will have this set to the same value. Normal non-summary invoices will have this value set to null.

InvoiceAmountIncVatnumber or null(decimal)

The total amount invoiced including VAT.

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.

Orders

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.

OrderItem

Information about the Items on an Order.

RowNumbernumber or null(decimal)

The row number of the OrderItem.

PartNostring or null[ 0 .. 50 ] characters

The PartNo of the OrderItem. MaxLength: 50

Namestring or null[ 0 .. 255 ] characters

The name of the OrderItem. MaxLength: 255

QtyOrderednumber or null(decimal)

The quantity ordered. This is the total quantity ordered.

UnitPricenumber or null(decimal)

The unit price of the Item, excluding VAT.

UnitDiscountnumber or null(decimal)

The unit discount of the Item, excluding VAT.

RowAmountnumber or null(decimal)

The total amount of the Item, excluding VAT.

VatRatenumber or null(decimal)

A rate to multiply with price to get price inc VAT. 25% VAT equals a VatRate of 1.25.

ImageKeystring or null(uuid)

A unique id for the image at our image server. Url for images are formed like http://[client specific CDN]/{ImageKey}. Preset, height and width can be sent as parameters.

Typeinteger or null(int32)

Sku type internal id for this order item.

Statusstring or null[ 0 .. 50 ] characters

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

InfoArray of objects or null(Info)

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

ParentRowNumbernumber or null(decimal)

The parent row number of the OrderItem, if any.

PriceRecommendednumber or null(decimal)

This is the recommended price of the item when the order was created.

PriceCatalognumber or null(decimal)

This is the catalog price of the item when the order was created.

PriceStandardnumber or null(decimal)

This is the standard price of the item when the order was created.

UnitPriceIncVatnumber or null(decimal)

The unit price of the item, including VAT.

OrderListItem

Information about an Order used in lists. This is a more light weight representation of the Order than the Order entity.

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

The order number of the Order, usually from an ERP.

OrderDatestring or null(date-time)

The order date of the Order.

Statusstring or null

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

Sourcestring or null

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

Currencystring or null

The currency code of 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

The payment method of the Order.

DeliveryMethodstring or null

The delivery method of 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

The delivery mark of the Order. Gets its value from the OrderReference field of the basket.

DropPointobject or null

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

ItemsArray of objects or null(OrderItem)

The items on the Order.

InfoArray of objects or null(Info)

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

OrderPagedList

Obsolete, Use OrderPagedList2 Orders in a paged list format. The Items property contains all current orders, depending on paging, and the ItemCount the total number of orders.

ItemCountinteger or null(int32)

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

ItemsArray of objects or null(Order)

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

OrderPagedList2

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

ItemCountinteger or null(int32)

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

ItemsArray of objects or null(OrderListItem)

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