In-Depth Exploration of JD.com API: Order and Transaction Interfaces

Introduction

The product API allows you to display, filter, and view product information, but only by integrating the "order chain" can you realize a complete e-commerce transaction. This article dives into:

• How to use jingdong.pop.orders.get to fetch order lists

• How to use jingdong.pop.order.get to query individual order details

• How to process shipping

• How to track logistics information

• Common errors and suggested solutions

1. Order List API: jingdong.pop.orders.get

1. Purpose

Used to retrieve a list of store orders, supporting filtering by order time, status, and pagination.

2. Request Parameters

Package as 360buy_param_json:

{
"order_state": "WAIT_SELLER_STOCK_OUT",
"start_date": "2025-04-01 00:00:00",
"end_date": "2025-04-05 23:59:59",
"page": 1,
"page_size": 20
}

3. Response Example

{
"jingdong_pop_orders_get_responce": {
"order_info_list": {
"order_info": [
{
"order_id": 1234567890,
"order_total_price": 199.99,
"order_state": "WAIT_SELLER_STOCK_OUT",
"consignee_info": {
"name": "Zhang San",
"full_address": "Chaoyang District, Beijing..."
}
}
]
}
}
}

2. Order Detail API: jingdong.pop.order.get

1. Purpose

Used to retrieve detailed information of a single order, including recipient info, item list, payment, and delivery method.

2. Request Parameter (JSON)

{
"order_id": 1234567890
}

Note: System-level parameters like method, timestamp, access_token are also required.

3. Response Example

{
"jingdong_pop_order_get_responce": {
"order_info": {
"order_id": 1234567890,
"freight_price": 8.00,
"order_state": "WAIT_SELLER_STOCK_OUT",
"items": [
{
"sku_id": 1000001,
"name": "Xiaomi Phone",
"price": 899.00,
"num": 1
}
],
"payment_type": "Online Payment",
"receiver_info": {
"name": "Li Si",
"address": "Nanjing, Jiangsu Province..."
}
}
}
}

3. Order Status Enumeration

4. Shipping API: jingdong.pop.order.ship

This API allows you to mark the order as shipped and submit the tracking number.

Request Example

{
"order_id": 1234567890,
"logistics_id": 1010,
"waybill": "JD123456789CN",
"trade_no": "optional"
}

You must obtain the corresponding logistics_id from JD's logistics system.

5. Logistics Tracking API: jingdong.pop.order.track

Request Example

{
"order_id": 1234567890
}

Response Example

{
"jingdong_pop_order_track_responce": {
"order_tracks": [
{
"time": "2025-05-01 10:00:00",
"content": "Package picked up"
},
{
"time": "2025-05-02 15:45:00",
"content": "Arrived at Nanjing distribution center"
}
]
}
}

6. Recommended Process Flow

1. Customer places order → System regularly calls pop.orders.get to fetch new orders

2. Retrieve order details → Call pop.order.get to get product and recipient info

3. System processes shipping → Call pop.order.ship to submit tracking number

4. Show delivery progress → Call pop.order.track to get logistics updates

5. After-sales service → Extend to refund, return, and complaint APIs as needed

7. Error Handling Suggestions

8. Summary

By integrating JD's transaction APIs, developers can build a complete order processing workflow, including order fetching, detail queries, shipping operations, and logistics tracking. For enterprise developers, mastering these core APIs helps establish a stable and efficient e-commerce system, providing a foundation for expanded after-sales services such as refunds, returns, and complaints.

Articles related to APIs :

• JD Open Platform Practical Guide ③: Full Analysis of Product Query and Detail APIs

• JD API Authentication and Signature Mechanism: A Complete Guide for Secure Integration

• Complete Guide to Accessing the JD Open Platform (JOS)

For seamless and efficient access to the Jingdong API, please contact our team : support@luckdata.com