即时订单列表

由于小红书上物流模式分为第三方自主发货，小包转运，大包集货和第三方保税模式, 请务必在对接前跟小红书业务方确定自己的物流模式后获取对应的接口对接。 其中第三方保税模式使用的订单模块的接口请联系小红书业务同学获取相应的接口文档。

接口描述

注 该接口支持所有物流模式

可分页获取最多半小时内创建的所有订单信息。

URL

/ark/open_api/v0/packages/latest_packages{?order_time_from}{?order_time_to}{?page_no}{?page_size}

请求参数

字段名称 类型 必填 说明
order_time_from Int 是 查询订单创建时间的开始时间，Unix-Time时间戳
order_time_to Int 是 查询订单创建时间的结束时间，Unix-Time时间戳
page_no Int 否 查询当前分页，从1开始计数
page_size Int 否 分页大小, 默认50，最大值不超过100

补充说明

order_time_from和order_time_to查询订单创建时间的起止时间间隔不得超过30分钟。调用频率建议15分钟一次。

请求方法

GET

返回示例 状态码 200 (content-type: application/json; charset=utf8)

{
    "error_code": 0,
    "data": {
        "current_page": 1,
        "total_page": 1,
        "page_size": 50,
        "total_num": 2,
        "packages": [
        {
          "package_id": "P124394374937984",
          "status": "unconfirmed",
          "time": 1443794273,
          "item_list": [
            {
            "barcode": "423748732",
            "skucode": "423748732",
            "item_name": "好东西",
            "qty": 2,
            }
          ]
        },
        {
          "package_id": "P124394374937985",
          "status": "confirmed",
          "time": 1443794273,
          "item_list": [
            {
            "barcode": "423748733",
            "skucode": "423748733",
            "item_name": "好东西",
            "qty": 1,
            }
          ]
        }
        ]
    },
    "error_msg": null,
    "success": true
}

返回参数

字段名称 类型 说明
current_page Int 查询当前页，从1开始计数
page_size Int 分页大小，默认50
total_page Int 总页数
total_number Int 结果总数
packages Array 订单列表
package_id String 订单ID
time Long 用户下单时间
status String 订单状态，"unconfirmed" 未确认订单，"confirmed"确认订单, "canceled" 取消订单
barcode String 商品条形码
skucode String 小红书编码
qty Int 商品数量

补充说明

用户在小红书APP上下单后库存被锁定:

  • 若该单未付款，30分钟系统自动取消订单；
  • 支付后订单会经历报关和小红书后台系统确认的过程，当该单被系统确认可以给商家查询并发货前，该单处于“未确认”（unconfirmed）状态，之后处于“确认”（confirmed）状态。