This document provides instructions for getting the list of all orders
GET orders API allows retrieval of existing order documents from the OMS. Supports flexible filtering options to fetch orders based on specific criteria such as partyId
or statusId
.
Additionally, the API supports sorting functionality. By utilizing the sortBy
and sortOrder
parameters in the URL, data can be arranged based on fields like grandTotal
in either ascending or descending order.
End Point https://<instance.name>.hotwax.io/api/<publish_point>/orders
Example: https://demo-oms.hotwax.io/api/<publish_point>/orders
viewIndex
Index of the view in pagination.
viewSize
Number of records to fetch per page.
filters
Filters to apply for querying specific orders.
Filters allow users to query orders based on various fields. The structure of the filter includes:
Field
: The field to filter by (e.g., externalId, partyId, statusId). Field_op
: Operator used for the filter condition (e.g., equals, like, etc.). Field_ic
: Ignore case flag (Y for yes, N for no).
This example will fetch all the orders where externalId is 10025, with case-insensitive matching (ignore case set to Y).
HTTP/1.1 200 OK
Content-Type: application/json
id
Unique identifier of the order.
externalId
External identifier of the order.
orderName
Name or identifier of the order.
channel
Sales channel through which the order was placed.
channelDesc
Description of the sales channel.
customerId
ID of the customer associated with the order.
customerExternalId
External ID of the customer.
customerName
Name of the customer.
priority
Priority level of the order.
orderDate
Date and time when the order was created.
entryDate
Date and time when the order was entered into the system.
expireDate
Date and time when the order expires.
statusId
ID indicating the current status of the order.
statusDesc
Description of the current status of the order.
productStoreId
ID of the product store associated with the order.
productStoreName
Name of the product store.
webSiteId
ID of the website associated with the order.
webSiteName
Name of the website.
currencyCode
Currency code used for the order.
currencyCodeDesc
Description of the currency used.
remainingSubTotal
Remaining subtotal amount of the order.
grandTotal
Total amount of the order.
tags
Tags associated with the order.
note
Additional notes or comments related to the order.
orderContacts
Contact information associated with the order (e.g., email).
orderIdentifications
Array of identification details associated with the order (e.g., marketplaces, order IDs).
shipGroup
Array containing shipping group details for the order.
orderAdjustments
Adjustments made to the order (e.g., shipping charges).
orderPaymentPref
Payment preferences for the order (e.g., payment method, status).
billTo
Billing details for the order (e.g., postal address, email, phone).
billFrom
Originating entity details for the order (e.g., company name, address, email, phone).