Create Order

A post of the Order Request for the ERP or OMS,
Read more about the how to implement a receiver here

Request
Request Body schema: application/json
Array of objects <CodeValue> (CodeValue)

Client specific information on the order

object <ClientCustomer> (ClientCustomer)

Represents customer, either a person or a company.

ClientOrderRef
string

Usually weborder number (basket id in Norce Commerce). For orders from external source this is their number. Max length: 50

CurrencyCode
string

Currency code in ISO 4217 format, e.g. "SEK", "EUR", "USD". Max length: 3

CustomerOrderComment
string

Comment field

CustomerOrderRef
string

Buyers reference, usually added in the checkout for B2B orders. Max length: 50

Array of objects <Discount> (Discount)

List of order discounts that are not represented on order lines. Not commonly used.

DoHold
boolean

True if web solution thinks that this order should be manually validated before processed

ErpOrderNo
string

Usually empty. If exists this is a suggestion from web solution which order number the order should have in ERP. Max length: 50

Array of objects <Fee> (Fee)

Collection of fees on the order. Not commonly used, the fees are mostly implemented as order items with TypeGroup "Fee".

object <Header> (Header)

Header information about order.

Array of objects <OrderItem> (OrderItem)

Collection of order rows. Other than the articles this collection can also contain fees such as freight.

OrderType
integer <int32>

Order type:
1 = Order
3 = Subscription/Recurring order
5 = External order

Array of objects <Payment> (Payment)

An order can have several payments. Usually this is only one, but sometime there are an additional payment method like giftcard or a voucher.

ReferId
integer <int32>

If order is created from a referral like an ad

SalesContactCode
string

Code of sales contact if a sales rep should be marked as seller. Max length: 50

SalesContactDivision
string

Code of sales department if a sales dep should be marked as seller. Max length: 50

object <ClientCustomer> (ClientCustomer)

Represents customer, either a person or a company.

object <ClientCustomer> (ClientCustomer)

Represents customer, either a person or a company.

object <ShippingAdvice> (ShippingAdvice)

Represents order shipping information

Source
string

Order source. Should be WEB for all orders created from client web sites.

SubmitDate
string <DateTime>

Timestamp when order was created in Norce Commerce.

Responses
200

Order received successfully - No retries

400

Bad Request - Trigger retries

401

Unauthorized - Trigger retries

408

Request Timeout - Trigger retries

503

Service Unavailable - Trigger retries

post/webhooks
Request samples
application/json
{
  • "AdditionalInfo": [
    ],
  • "BillTo": {
    },
  • "ClientOrderRef": "string",
  • "CurrencyCode": "string",
  • "CustomerOrderComment": "string",
  • "CustomerOrderRef": "string",
  • "Discounts": [
    ],
  • "DoHold": true,
  • "ErpOrderNo": "string",
  • "Fees": [
    ],
  • "Header": {
    },
  • "Items": [
    ],
  • "OrderType": 0,
  • "Payments": [
    ],
  • "ReferId": 0,
  • "SalesContactCode": "string",
  • "SalesContactDivision": "string",
  • "SellTo": {
    },
  • "ShipTo": {
    },
  • "ShippingAdvice": {
    },
  • "Source": "string",
  • "SubmitDate": "string"
}