1688 KA Order Fulfillment Flow: From Creation to After-Sales

API Endpoint: /alibaba/ka/order/page
Status Enum: PoolOrderStatusEnum
Last Updated: May 28, 2026

📋 Order Status Overview

Status Code	Enum Name	Chinese	Description
1	`WAITING_FOR_PAYMENT`	待付款	Awaiting buyer payment
2	`PAYMENT_IN_PROGRESS`	支付中	Payment being processed
4	`WAITING_FOR_SENT`	待发货	Awaiting shipment
5	`SENT`	已发货	Shipped by seller
10	`FINISHED`	已完成	Order completed
-1	`CANCEL`	已取消	Order cancelled

📋 refund Status Overview

Status Code	Enum Name	Chinese	Description
18	`REFUNDING`	退款/售后中	REFUNDING
20	`REFUND_FINISHED`	售后完成	REFUND FINISHED

英文版

中文版

The solid line indicates the interface call【实线】表示的接口调用
-->The dotted line indicates message push【虚线】表示的是消息推送

🔄 Main Business Flows

Flow 1: Normal Fulfillment (Success)

WAITING_FOR_PAYMENT(1) ← Order placed
  ↓
WAITING_FOR_SENT(4) ← Procurement completed
  ↓
SENT(5) ← Seller shipped
  ↓
FINISHED(10) ← Order completed

Time Requirements: Each phase typically takes 1-7 days depending on supplier

Flow 2: Payment Exception Flow

WAITING_FOR_PAYMENT
  ↓
PAYMENT_IN_PROGRESS ← Start payment
  ↓ (Payment successful)
WAITING_FOR_SENT

OR

PAYMENT_IN_PROGRESS
  ↓ (Payment failed)
CANCEL

Allowed initial statuses for refund:

WAITING_FOR_SENT(4) - Awaiting shipment

SENT(5) - Shipped

FINISHED(10) - Completed

📝 API Response Example

{
  "code": "200",
  "message": "success",
  "data": {
    "total": 1,
    "data": [
      {
        "tradeNo": "PT20250528001",
        "deliveryAddress": {
          "name": "John Doe",
          "phone": "13800138000",
          "province": "Guangdong",
          "city": "Shenzhen",
          "district": "Nanshan",
          "detailAddress": "Tech Park Road XX"
        },
        "orderVOList": [
          {
            "orderId": "1688-12345678",
            "orderStatus": 4,
            "orderStatusDesc": "WAITING_FOR_SENT",
            "orderTotalAmount": 15800,
            "orderHandlingPrice": 50,
            "subOrderList": [
              {
                "id": "1001",
                "subOrderId": "sub-001",
                "subOrderStatus": 4,
                "subOrderStatusDesc": "WAITING_FOR_SENT",
                "productName": "Product A",
                "quantity": 2,
                "subTotalPrice": 15800,
                "refundId": null
              },
              {
                "id": "1002",
                "subOrderId": "sub-002",
                "subOrderStatus": 5,
                "subOrderStatusDesc": "SENT",
                "productName": "Product B",
                "quantity": 1,
                "refundId": null
              }
            ]
          }
        ]
      }
    ]
  }
}

OrderStatusMaunal.md

1688 KA Order Fulfillment Flow: From Creation to After-Sales#

📋 Order Status Overview#

📋 refund Status Overview#

🔄 Main Business Flows#

Flow 1: Normal Fulfillment (Success)#

Flow 2: Payment Exception Flow#