For every item that a user purchases from your store there is a corresponding
Order. Each order corresponds with one SKU. The order object provides you with the destination, item and any other required information to fulfill a user’s order.
With this API you can fetch order that require fulfillment and orders that have been updated since a given period. This API also allows you to fulfill one order at a time by providing tracking information for an order.
Orders can be in several different states depending on what has happened. State
APPROVED means that the order is ready to ship. State
SHIPPED means that the order has been marked as shipped by you. State
REFUNDED means that the order has been refunded to the user and should not be fulfilled. State
REQUIRE_REVIEW means that the order is under review for fraudulent activity and should not be fulfilled.
Container for all the details about how to ship the order to its destination
Joom’s unique identifier for the buyer of the order
The color of the item that was ordered (if applicable)
The amount of money that Joom pays you for the product (per unit)
Number of days left to fulfill this order. Order not fulfilled will be automatically refunded.
Number of hours left to fulfill this order. Order not fulfilled will be automatically refunded.
The UTC date and time of the last update to the order (for example, the last change in state)
Joom’s unique identifier for the order
The UTC date and time of when the order was placed
Final order price with all the discounts and markups applied
Order price without discounts and markups
Joom’s unique identifier for the Product being ordered
The image of the product
The name of the product
The number of units that the user has purchased
The UTC time when the order was refunded
The date when the order was marked as shipped
The amount of money user pays for shipping for the product (per unit)
The amount of money that Joom pays you for shipping the product (per unit)
This is the courier that has been used to ship the package
The size of the item that was ordered (if applicable)
The unique identifier of the item in your system
The state of the order. This value can be:
Orders can be grouped under unique identifiers if the user makes several purchases at once
Joom’s unique identifier for the Product Variation that was ordered
Shipping option for Joom Express orders
The unique identifier that your carrier provided so that the user can track their package as it is being delivered. Tracking number should only contain alphanumeric characters with no space between them
The note to the user when you marked the order as shipped (if applicable)
The amount of time it takes for the shipment to reach the buyer. Provide a time range in number of days. Lower bound cannot be less than 2 days