Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Headers
A header used by fabric to identify the tenant making the request. You must include tenant id in the authentication header for an API request to access any of fabric’s endpoints. You can retrieve the tenant id , which is also called account id, from Copilot. This header is required.
x-fabric-channel-id identifies the sales channel where the API request is being made; primarily for multichannel use cases. The channel ids are 12 corresponding to US and 13 corresponding to Canada. The default channel id is 12. This field is required.
Unique request ID
Path Parameters
The merchant-defined order identifier provided during the Create Order - POST /orders endpoint.
Body
Response
OK
Order details
Sales channel ID
"12"
Item details
1 - 2147483647 elementsMerchant-defined order identifier. If omitted, this is generated by fabric's sequence generator using Configuration service
"309019176"
1 - 2147483647 elementsStatus code. There are no pre-defined values; possible values are - ORDER_ALLOCATED ("Order Allocated"), ORDER_SHIPPED ("Order Shipped"), ORDER_PARTIALLY_SHIPPED ("Order Partially Shipped"), ORDER_PICKED_UP ("Order Picked Up"), ORDER_PARTIALLY_PICKED_UP ("Order Partially Picked Up"), ORDER_DELIVERED ("Order Delivered"), ORDER_PARTIALLY_DELIVERED ("Order Partially Delivered"), ORDER_RETURNED ("Order Returned"), etc.
"ORDER_CREATED"
Current version of order document. Indicates the number of times the order is updated by any operation.
2
The total amount of price adjustments for all items of the order.
123.45
Price adjustments refer to changes or modifications made to the listed price of a product. A Customer Sales Representative (CSR) makes the price adjustments to provide discounts, promotional offers, or coupons that the shopper used.
System-generated order allocation time (UTC) once the order is allocated using Allocation service
"2022-05-12T09:30:31.198Z"
Final appeasement amount
12.34
Merchant-defined custom attributes. This is a placeholder for additional info (in key: value pairs).
{
"fraudCheckStatus": "UPDATED",
"loyaltyStatus": "N"
}Amount to be returned after order cancellation, calculated as cancelledQuantity / orderedQuantity * itemTotal
12.34
System-generated order cancellation time (UTC). This is returned in the response of Cancel order by ID - POST /orders/{orderId}/actions/cancel or Cancel order by order number - POST /orders/order-number/{orderNumber}/actions/cancel once the order is successfully cancelled.
"2022-05-12T09:30:31.198Z"
Unique cart identifier, either from fabric Cart service or an external Cart service. It is used for linking an order to a specific cart. If available, it is also used for inventory reservation from cart workflow.
"b03b72dc-78d8-4ea4-90fc-2fe6a1fe6569"
Order creation time (UTC)
"2022-05-12T09:30:31.198Z"
Three-letter currency code as defined by ISO-4217
"USD"
Invoice customer
Employee (ID or name) who initiated the request
"43278"
Recalculated total fee, calculated as orderedQuantity* itemFeeTotal
12.34
Total payment captured by fabric Invoice service. If merchant is using third-party service, then this amount will be null. For partial payment scenarios, this value will be different from orderTotal.
12.34
Recalculated order discount
1.23
24-character system-generated order ID
"5349b4ddd2781d08c09890f4"
Order released time (UTC). When an order is placed, its status is On Hold by default and the duration of hold may vary from merchant to merchant (~1 min). After the hold period, the order is released from hold.
"2022-05-12T09:30:31.198Z"
Recalculated orderSubtotal - summationOfAll(itemSubTotal)
123.45
Total amount to be charged for the order = orderSubTotal - orderDiscountTotal + orderFeeTotal + orderTaxTotal
146.9
Merchant-defined order creation time (UTC). It is mandatory in the request body of Create Order endpoint - POST /orders.
"2022-05-12T09:30:31.198Z"
System-generated total discount, auto-filled by Orders service when the order is placed. This is saved for reference in case the value changes later.
1.45
System-generated total fees, auto-filled by Orders service when the order is placed
12.34
System-generated order total, auto-filled by Orders service when the order is placed. This is saved for reference in case the orderTotal changes later.
146.9
System-generated order subtotal, auto-filled by Orders service when the order is placed. This is saved for reference in case the value changes later.
113.45
System-generated total tax, auto-filled by Orders service when the order is placed
12.34
Optionally used as reference, for orders created from Point-of-Sale systems
Return total of order, for return scenarios, calculated as summationOfAll(itemReturnTotal)
12.34
Human-readable brief description based on statusCode
"Order Created"
Order subtype, for further classification
IOS, ANDROID, INTERNATIONAL "INTERNATIONAL"
Recalculated total tax on order summationOfAll(itemTaxTotal)+summationOf(tax[].value)
12.34
Order type. It is critical for order life cycle as it indicates the workflow that varies with the type. For example, Storefront orders have a different workflow than Call Center orders. fabric Orders service offers standard configurations for Storefront, Call Center, Point of Sale, iOS, Android, and International.
WEB, CSC, MOBILE_APP, POS "WEB"
Time of last update to order (UTC)
"2022-05-12T09:30:31.198Z"