小红书 API

订单列表

POST/ark/open_api/v3/common_controller

	错误码	错误码描述
	-2000400	请求参数错误

请求参数

startTime

integer

时间范围起点

必需

endTime

integer

时间范围终点

必需

timeType

integer

必需

startTime/endTime对应的时间类型，1 创建时间限制 end-start<=24h、2 更新时间限制 end-start<=30min 倒序拉取最后一页到第一页

packageType

integer

可选

订单类型，0/null 全部 1 普通 normal 2 定金预售 3 全款预售 4 延迟发货 5 换货补发

packageStatus

integer

可选

订单状态，0全部 1已下单待付款 2已支付处理中 3清关中 4待发货 5部分发货 6待收货 7已完成 8已关闭 9已取消 10换货申请中

pageNo

integer

可选

页码，默认1，限制100

pageSize

integer

可选

查询总数，默认50，限制100

{
  "startTime": 1612518379,
  "endTime": 1612518379,
  "timeType": 1,
  "packageType": 1,
  "packageStatus": 1,
  "pageNo": 1,
  "pageSize": 50
}

示例代码

返回响应

成功(200)

HTTP 状态码: 200

内容格式: JSONapplication/json

total

integer

订单总数

必需

pageNo

integer

必需

当前页数请求参数中的值

pageSize

integer

必需

页大小请求参数中的值

maxPageNo

integer

必需

最大页码数方便直接从最后一页拉数据

orderList

array [object {27}]

订单信息

必需

packageId

string

订单号

可选

packageType

integer

可选

订单类型，1普通 2定金预售 3全款预售 4延迟发货 5换货补发

packageStatus

integer

可选

订单状态，1已下单待付款 2已支付处理中 3清关中 4待发货 5部分发货 6待收货 7已完成 8已关闭 9已取消 10换货申请中

packageAfterSalesStatus

integer

可选

售后状态，1无售后 2售后处理中 3售后完成(含取消) 4售后拒绝 5售后关闭 6平台介入中

cancelStatus

integer

可选

申请取消状态，0未申请取消 1取消处理中

createdTime

integer

创建时间单位ms

可选

paidTime

integer

支付时间单位ms

可选

updateTime

integer

更新时间单位ms

可选

deliveryTime

integer

可选

订单发货时间单位ms

cancelTime

integer

可选

订单取消时间单位ms

finishTime

integer

可选

订单完成时间单位ms

promiseLastDeliveryTime

integer

可选

承诺最晚发货时间单位ms

planInfoId

string

物流方案id

可选

planInfoName

string

物流方案名称

可选

receiverCountryId

string

收件人国家id

可选

receiverCountryName

string

目前仅中国

可选

receiverProvinceId

string

收件人省份id

可选

receiverProvinceName

string

收件人省份

可选

receiverCityId

string

收件人城市id

可选

receiverCityName

string

收件人城市

可选

receiverDistrictId

string

收件人区县id

可选

receiverDistrictName

string

收件人区县名称

可选

customerRemark

string

用户备注

可选

sellerRemark

string

商家标记备注

可选

sellerRemarkFlag

integer

可选

商家标记优先级，ark订单列表展示旗子颜色 1灰旗 2红旗 3黄旗 4绿旗 5蓝旗 6紫旗

originalPackageId

string

可选

原始订单编号，换货订单的原订单

logistics

string

可选

物流模式red_express三方备货直邮(备货海外仓),red_domestic_trade(三方备货内贸),red_standard(三方备货保税仓),red_auto(三方自主发货),red_box(三方小包),red_bonded(三方保税)

{
  "total": 500,
  "pageNo": 1,
  "pageSize": 50,
  "maxPageNo": 100,
  "packageList": [
    {
      "packageId": "P141***1412",
      "packageType": 1,
      "packageStatus": 1,
      "packageAfterSalesStatus": 1,
      "cancelStatus": 1,
      "createdTime": 1612518379000,
      "paidTime": 1612518379000,
      "updateTime": 1612518379000,
      "deliveryTime": 1612518379000,
      "cancelTime": 1612518379000,
      "finishTime": 1612518379000,
      "promiseLastDeliveryTime": 1612518379000,
      "planInfoId": "null",
      "planInfoName": "null",
      "receiverCountryId": "null",
      "receiverCountryName": "中国",
      "receiverProvinceId": "null",
      "receiverProvinceName": "江苏省",
      "receiverCityId": "null",
      "receiverCityName": "苏州市",
      "receiverDistrictId": "null",
      "receiverDistrictName": "相城区",
      "customerRemark": "null",
      "sellerRemark": "null",
      "sellerRemarkFlag": 1,
      "originalPackageId": "P123***4123",
      "logistics": "red_express"
    }
  ]
}

最后修改时间： 1 年前