1.1. Inbound order message push
1.1.1. SERVICE_TYPE
PUSH_ASN_ORDER
1.1.2. Push message content
| Params | Require | DataType | Sample | Description |
|---|---|---|---|---|
| asnNumber | Y | String | “A230109129883” | Inbound order number |
| trackNumber | N | String | Tracking number | |
| skuList | Y | List<Sku> | SKU receipt data | |
| status | Y | String | Inbound order status FINISHED or CLOSED | |
| finishedTime | Y | Date | The condition of the completion time of the inbound order must be passed, and the value is passed only when status=FINISHED | |
| customNumber | N | String | Reference number |
Sku
| Params | Require | DataType | Sample | Description |
|---|---|---|---|---|
| quantity | Y | Number | 100 | The quantity received |
| sku | Y | String | Sku | sku |
| batchNo | N | String | Batch number, only applicable to Qianyi WMS | |
| mfgDate | N | String | 2025-10-01 | Production date, only applicable to Qianyi WMS |
| expDate | N | String | 2025-10-01 | Expiration date, only applicable to Qianyi WMS |
| originCountry | N | String | CN | Country of production, only applicable to Qianyi WMS |
example（default form-data type）：
JSON type： {"appId":"TEST","bizParam":"{\"asnNumber\":\"A250619145545\",\"customNumber\":\"2025061900007\",\"status\":\"RECEIVING\",\"trackNumber\":\"CGDD0000787\",\"setSkuList\":[{\"sku\":\"LIP005\",\"quantity\":1},{\"quantity\":1,\"sku\":\"LIP005\"}]}","serviceType":"PUSH_ASN_ORDER","timestamp":"1754016113505","sign":"77fd745547a99d46cf5d2f17697a7c6e"}
FORM-DATA type： {appId=1111-3, bizParam={"asnNumber":"A250731147584","customNumber":"1000832922","finishedTime":1753942939000,"skuList":[{"damageNum":0,"goodNum":9,"quantity":9,"sku":"PPB24700027"}],"status":"FINISHED","trackNumber":"4700041511"}, serviceType=PUSH_ASN_ORDER, timestamp=1753942939728, sign=8f40f3de6778c990bc7b762314b182ac}
1.2. Push tracking status sepc
1.2.1. SERVICE_TYPE
PUSH_TRACKING_PACKAGE
1.2.2. Request
Base
| Params | Require | DataType | Sample | Description |
|---|---|---|---|---|
| orderNumber | Y | String | “S230109129883” | System order number |
| onlineOrderId | Y | String | xsasx | online Order number |
| trackingNumber | Y | String | trackingNumber | 11111 |
| carrier | Y | String | carrier | LEX TH |
| status | Y | String | CREATED | Logistics tracking status |
example（default form-data type）：
JSON type： {"appId":"1751530655877-10658", "bizParam":"{\"carrier\":\"J&T Express\",\"onlineOrderId\":\"579877366324626911\",\"orderNumber\":\"S2508053858595\",\"status\":\"CREATED\",\"trackingNumber\":\"762388742732\"}", "serviceType":"PUSH_TRACKING_PACKAGE", "timestamp":1754373394777, "sign":"c0fe6c3ab1a92831dffa5796fbf08a27"}
FORM-DATA type： {appId=1751530655877-10658, bizParam={"carrier":"J&T Express","onlineOrderId":"579877366324626911","orderNumber":"S2508053858595","status":"CREATED","trackingNumber":"762388742732"}, serviceType=PUSH_TRACKING_PACKAGE, timestamp=1754373394777, sign=c0fe6c3ab1a92831dffa5796fbf08a27}
1.3. Order Shipping info
1.3.1. SERVICE_TYPE
PUSH_SALES_ORDER_SHIPPING_INFO
1.3.2. request
| Params | Require | DataType | Sample | Description |
|---|---|---|---|---|
| orderNumber | Y | String | “S200222115613” | System Order number |
| onlineOrderNumber | Y | String | platform order number | |
| trackingNumber | Y | String | trackingNumber | |
| carrier | Y | String | carrier | |
| shippingTime | Y | Datetime | Shipping time，"yyyy-MM-dd hh:mm:ss SSS" | |
| status | Y | String | Sales order status |
example（default form-data type）：
JSON type： {"appId":"TEST","bizParam":"{\"carrier\":\"SHIPDOC\",\"onlineOrderNumber\":\"2507311347270601016525823\",\"orderNumber\":\"S250731147586\",\"shippingTime\":1754014435000,\"status\":\"WAIT_SHIP\",\"trackingNumber\":\"223243444\"}","serviceType":"PUSH_SALES_ORDER_SHIPPING_INFO","timestamp":"1754272685482","sign":"7cbc7305af85fb2eed308866c4fbaf89"}
FORM-DATA type： {appId=1111-3, bizParam={"carrier":"SHIPDOC","onlineOrderNumber":"2507311347270601016525823","orderNumber":S250731147586,"shippingTime":1754014435000,"status":"WAIT_SHIP","trackingNumber":"223243444"}, serviceType=PUSH_SALES_ORDER_SHIPPING_INFO, timestamp=1754272685482, sign=7cbc7305af85fb2eed308866c4fbaf89}
1.4. Refund process info
1.4.1. SERVICE_TYPE
PUSH_RETURN_ORDER_INFO
1.4.2. request
| Params | Require | DataType | Sample | Description |
|---|---|---|---|---|
| returnNumber | Y | String | “B200308115691” | refund order number |
| orderNumber | Y | String | “S200222115613” | sales Order number |
| onlineOrderNumber | Y | String | “DA200221115559” | ref online number |
| status | Y | String | “FINISH” | Refund order status |
| returnSkuList | Y | List<ReturnSku> | See ReturnSKU |
ReturnSku(refund sku details)
| Params | Require | DataType | Sample | Description |
|---|---|---|---|---|
| sku | Y | String | “abc” | sku |
| orderSkuId | Y | Number | orderSkuId | |
| quantity | Y | Number | 1 | The actual number of returns |
example（default form-data type）：
JSON type： {"serviceType":"PUSH_RETURN_ORDER_INFO","appId":"15167732016","sign":"b55826f1b417bd398aacf61aaa8abe23","bizParam":"{\"orderNumber\":\"THTZD000859\",\"returnSkuList\":[{\"orderSkuId\":45,\"quantity\":1,\"sku\":\"JCDF692024YH002\"}],\"onlineOrderNumber\":\"THTZD000859\",\"returnNumber\":\"B250801537077\",\"status\":\"WAIT_STORAGE\"}","timestamp":"1754033260116"}
FORM-DATA type： {serviceType=PUSH_RETURN_ORDER_INFO,appId=15167732016,sign=b55826f1b417bd398aacf61aaa8abe23,bizParam={\"orderNumber\":\"THTZD000859\",\"returnSkuList\":[{\"orderSkuId\":45,\"quantity\":1,\"sku\":\"JCDF692024YH002\"}],\"onlineOrderNumber\":\"THTZD000859\",\"returnNumber\":\"B250801537077\",\"status\":\"WAIT_STORAGE\"},timestamp=1754033260116}
1.5. subscribe order status
1.5.1. SERVICE_TYPE
SUBSCRIBE_ORDER
1.5.2. 请求参数
| 字段名 | 字段描述 | 类型 | 必填 | 备注 |
|---|---|---|---|---|
| orderType | order type | String | Y | inbound order：ASN |
| orderList | order list | Array | Y | |
| └ orderNumber | number | String | Y |
1.5.3. 返回参数
| 参数 | 是否必须 | 类型 | 示例 | 备注 |
|---|---|---|---|---|
| orderList | Y | Array | fail list | |
| └ orderNumber | Y | String | order number | |
| └ errorMessage | Y | String | error message |