Create an order
Creates an order. After an order is created, Notification APIs of fabric OMS send order notification to customers.
Authorizations
Bearer authentication header of the form Bearer <token>
, where <token>
is your auth token.
Headers
The x-site-context
header is a JSON object that contains information about the source you wish to pull from. The mandatory account
is the 24 character identifier found in Copilot. The channel
(Sales channel ID), stage
(environment name), and date
attributes can be used to further narrow the scope of your data source.
"{\"date\": \"2023-01-01T00:00:00.000Z\", \"channel\": 12, \"account\": \"1234abcd5678efgh9ijklmno\",\"stage\":\"production\"}"
Body
Order object
Unique order number to be provided by merchant
"309019176"
Sales channel ID
"12"
Order status code
"ORDER_CREATED"
Array of items for which order is processed
1 - 2147483647
elements1 - 2147483647
elementsActual order creation date when the order was created for the first time.
"2022-05-12T09:30:31.198Z"
ID of the cart for which order is created
"b03b72dc-78d8-4ea4-90fc-2fe6a1fe6569"
Platform of order creation, for example, website, mobile application, point of sale, and so on.
WEB
, CSC
, MOBILE_APP
, POS
"WEB"
Operating system of the platform mentioned in the type
field.
IOS
, Android
, International
"International"
ID of the employee who created the order or who helped creating the order.
"43278"
Order retail object for reatil transactions. For non-retail transactions, only location number is provided.
Base price of the ordered items before discounts. It does not include tax amount.
123.45
Discounted amount
1.23
Order value after discount. Discount value is subtracted from order sub total.
12.34
Total tax amount applicable on the order subtotal value.
12.34
Total order value after calculating discount and tax values.
146.9
Currecy code used for order amount
"USD"
Order status description
"Order created"
Array of discount objects
Order customer model
Notes section to be used for CSR only
Response
Order Created
Order response body
Unique order number
"309019176"
Sales channel ID
"12"
"ORDER_CREATED"
1 - 2147483647
elements1 - 2147483647
elementsNumber of updates happened to the order. Order-update refers to replacement, appeasement added, address change or any other order related update to the particular order.
Auto generated ID once the order created successfully
"5349b4ddd2781d08c09890f4"
Actual order creation date
"2022-05-12T09:30:31.198Z"
Order cancellation date if any
"2022-05-12T09:30:31.198Z"
Order allocation date after order is created
"2022-05-12T09:30:31.198Z"
ID of the cart where order is placed
"b03b72dc-78d8-4ea4-90fc-2fe6a1fe6569"
Platfrom using which order is created
WEB
, CSC
, MOBILE_APP
, POS
"WEB"
Operating system of the platfom as mentioned in the type
field. If you want to configure any custom valuefor this field, contact fabric.
IOS
, Android
, International
"International"
Order process name
"CANCEL"
Employee ID used when an employee places an order on behave of the customer.
"43278"
Order retail object for reatil transactions. For non-retail transactions, only location number is provided.
Order value after calculating discounts and any applicable fees
123.45
Original order total value
113.45
Final discount value on order amount
1.23
Original discount on order value
1.45
Total fees, if any, applicable on order amount
12.34
Original fees appliable on shipping of items
12.34
Total tax amount appliable on shipping of items
12.34
Appeasement amount, if any, processed on the order
12.34
Original tax amount on order during fist time order creation
12.34
Return amount incase of order return
12.34
Cancel amount incase of order cancellation
12.34
Invoice value on order
12.34
Total order amount after calculating fees, discounts, retrurn and cancellation if any
146.9
Order amount during first time order creation after calculating all fees, taxes, and discounts
146.9
"USD"
"Order Created"
{
"type": "String/Number/JSON",
"purchaseOrder": "String",
"salesRepId": "String",
"approve": "String",
"fraudCheckSessionId": "aee6d1face0e4d55948d1e30b6240048",
"fraudCheckStatus": "UPDATED",
"fraudCheckTransId": "0R12TQ46",
"fraudScore": "31"
}
Array of appeasements, if any
Order customer model
Order dispatched date and time
Date and time when the original order is modified for the first time, for example for return, cancellation or replacement
Date and time when the exisiting order is updated