库存变动回调（订单创建）

接口描述

购买者在小红书成功创建订单后，小红书系统会使用该回调接口来通知第三方商家由订单创建引起的库存变化信息。对于库存要求极为敏感的商家，为了及时获取最新订单的创建事件，建议商家接入该回调接口。

注 该接口目的是返回商家库存变化信息。由于该订单可能处于未付款或未被确认的状态，所以该回调接口返回的订单号并不能实时在订单接口中查询到。

回调机制请参阅 "回调接口说明" 模块

回调URL

需要商家在 ARK - 开发者 - 回调URL - OPEN API通用中配置回调URL

请求方法

POST

Header Parameters

名称 说明
timestamp 接口调用时的时间戳，即当前时间戳（时间戳：当前距离Epoch（1970年1月1日) 以秒计算的时间，即unix-timestamp
app-key 三方商家在ark系统的唯一标示
sign 输入参数的签名结果，签名方法见下节
content-type application/json;charset=utf-8

注: header中各字段格式均为string

请求body(content:application/json;charset=utf8)

{
    "package_id": "P124394374937984",
    "time": 14437942734983,
    "total_net_weight": 346,
    "pay_amount": 176,
    "logistics": "red_auto",
    "item_list": [
        {
            "item_id":"accadfereadrercad4eerrdafe1",
            "barcode": "423748732",
            "item_name": "好东西",
            "specification": "50ml",
            "qty": 2,
            "price": 99,
            "pay_price": 88,
            "net_weight": 173
        }
    ]
}

请求body 参数

字段名称 类型 说明
package_id String 订单ID
time Int 用户下单时间,Unix-Time时间戳
total_net_weight Double 订单商品总净重
pay_amount Double 订单支付金额
item_list Array 商品列表
barcode String 商品条码
item_name String 商品名称
specification String 商品规格
qty Int 购买数量，库存减少数量
price Double 商品售价
pay_price Double 实际支付价格
net_weight Double 商品净重
logistics String 物流模式