COMMERCE CONNECT
/
Order Service
/
Order Notification
/
Create Order

Documentation Norce Commerce Connect Order Service (4.0)

The Order Service has Entities and Operations concerned with orders created in Norce Commerce.

Download OpenAPI description
openapi.json
openapi.yaml
Languages
Servers
https://customer-slug.api-se.norce.tech/commerce/connect/4.0/

Order Notification

Operations

Create Order

Request

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

Body*/*required
AdditionalInfoArray of objects(CodeValue)(CodeValue)

Client specific information on the order

BillToobject(ClientCustomer)(ClientCustomer)

Represents customer, either a person or a company.

ClientOrderRefstring

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

CurrencyCodestring

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

CustomerOrderCommentstring

Comment field

CustomerOrderRefstring

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

DiscountsArray of objects(Discount)(Discount)

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

DoHoldboolean

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

ErpOrderNostring

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

FeesArray of objects(Fee)(Fee)

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

Headerobject(Header)(Header)

Header information about order.

ItemsArray of objects(OrderItem)(OrderItem)

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

OrderTypeinteger(int32)

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

PaymentsArray 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.

ReferIdinteger(int32)

If order is created from a referral like an ad

SalesContactCodestring

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

SalesContactDivisionstring

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

SellToobject(ClientCustomer)(ClientCustomer)

Represents customer, either a person or a company.

ShipToobject(ClientCustomer)(ClientCustomer)

Represents customer, either a person or a company.

ShippingAdviceobject(ShippingAdvice)(ShippingAdvice)

Represents order shipping information

Sourcestring

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

SubmitDatestring(DateTime)

Timestamp when order was created in Norce Commerce.

curl -i -X POST \
  https://customer-slug.api-se.norce.tech/commerce/connect/4.0/webhooks \
  -H 'Content-Type: */*' \
  -d '[object Object]'

Responses

Order received successfully - No retries

Body*/*
HasErpOrderNobooleanrequired

True if ErpOrder number is provided.

StatusCodestringrequired

Order response status. Allowed values are "OK" or "Failed". Max length: 50

Enum"OK""Failed"
Descriptionstring

Use this for a more information if status code is failed. Max length: 255

ErpOrderNostring

Order number from the ERP, if available. Can be sent in with SendOrderStatus as well. Max length: 50

Order

Operations

Invoice

Operations

POS Shipment

Operations