These use cases apply to order listing v2. We have some recommendation before stepping into these use cases:
- To get better response time, use filters like
limit
,created_from_date
,updated_from_date
,filter_date_by
- To filter orders by operation models, use filters
fulfillment_type
&item_inventory_type
- Exclude statuses
processing
,waiting_payment
in your queries bystatus=nin%7Cprocessing,waiting_payment
Why exclude these statuses? Because only orders those reach status queueing
are meaningful to seller business and they are considered as Tiki Accepted
orders.
List orders those need availability confirmation
GET /integration/v2/orders?page=1&limit=20&status=queueing&item_inventory_type=backorder&item_confirmation_status=waiting&filter_date_by=today
When orders reach status queueing
, some orders require sellers to confirm they have enough stock
to fulfill these orders. In other words, they need to confirm the availability of products for each order item in each order.
Orders that need confirmation:
- Have
status
=queueing
- Have at least 1 item with
item_inventory_type
=backorder
&&item_confirmation_status
=waiting
Supported operation models:
- On-Demand Fulfillment
- Seller Delivery
- Cross Border
- Drop Shipping
List orders that need picking confirmation
GET /integration/v2/orders?page=1&limit=20&fulfillment_type=dropship&status=queueing&item_confirmation_status=seller_confirmed&filter_date_by=last30days
Drop Shipping orders requires picking confirmation once seller has done packaging. To search for these orders:
- Have
fulfillment_type
=dropship
- Have
status
=queueing
- Have at least 1 item with
item_confirmation_status
=seller_confirmed
Supported operation models: Drop Shipping.
List orders those need printing PO or shipping label
GET /integration/v2/orders?page=1&limit=20&status=queueing&item_confirmation_status=seller_confirmed&filter_date_by=today
Orders that need printing shipping labels:
- Have
status
=queueing
- Have at least 1 item with
item_confirmation_status
=seller_confirmed
Supported operation models:
- On-Demand Fulfillment
- Seller Delivery
- Cross Border
- Drop Shipping
List all orders with inventory type backorder
GET /integration/v2/orders?page=1&limit=20&item_inventory_type=backorder&status=nin%7Cprocessing,waiting_payment&filter_date_by=today
Operation models On-Demand Fulfillment, Seller Delivery, Cross Border, Drop Shipping require seller interacts with
Tiki to fulfill orders. Orders of these operation models has one thing in common, each order has at least 1 order item with:
inventory_type
=backorder
Supported operation models:
- On-Demand Fulfillment
- Seller Delivery
- Cross Border
- Drop Shipping
List all orders
GET /integration/v2/orders?page=1&limit=20&status=nin%7Cprocessing,waiting_payment&filter_date_by=today
This sample will list all orders of all operation models, include even Fulfillment by Tiki.
We exclude processing
, waiting_payment
statuses because orders in these status are not officially accepted by Tiki.
Supported operation models: All.
List orders those have been delivered successfully
GET /integration/v2/orders?page=1&limit=20&status=in%7Csuccessful_delivery,complete&filter_date_by=today
These orders have status successful_delivery
(have-just-been-delivered-successfully) or complete
(had-been-delivered-successfully for a time):
Supported operation models: All.