腾讯有数官方文档

添加销售信息

请求地址

product_salesinfos/add

请求方法

POST

请求参数

名称 类型 描述
account_id 必填 integer

推广帐号 id ,有操作权限的帐号 id,包括代理商和广告主帐号id

data_warehouse_id 必填 integer

数据仓库ID

sku_sales_infos 必填 struct[]

商品库存价格列表

数组最大长度 50
external_store_id 必填 string

客户侧店铺/仓库ID

字段长度最小 1 字节,长度最大 32 字节
external_sku_id 必填 string

您为商品SKU分配的唯一ID。 一般而言,是您在商品库为该商品SKU分配的id。

字段长度最小 1 字节,长度最大 128 字节
sale_channel_name 必填 enum

销售渠道:wechat_miniprogram(微信小程序)

枚举列表:{ WECHAT_MINIPROGRAM、WECHAT_H5、PC、APP、H5、JD、VIPSHOP、PDD、OTHER }
store_type 必填 enum

店仓类型
shop:门店仓;warehouse:前置仓;ec_warehouse:电商仓

枚举列表:{ SHOP、WAREHOUSE、EC_WAREHOUSE }
sku_status 必填 enum

商品状态
new:新品;normal:正常:stop:停购

枚举列表:{ NEW、NORMAL、STOP }
price struct

商品价格信息

daily_price float

商品日常售价,单位:元,保留两位小数

current_price 必填 float

商品目前售价,单位:元,保留2位小数
大于等于0,最小值0
current_price需≤sku_price

sku_price 必填 float

商品原价,单位:元,保留2位小数
大于等于0,最小值0
current_price需≤sku_price

sku_promotions struct[]

商品活动及促销价列表

数组最大长度 50
promotion_price float

活动的促销价格

stock 必填 struct

库存信息

sku_stock_status 必填 enum

同一个商品在不同店仓中的销售/上下架状态
on_sale:销售中;off_sale:停售中

枚举列表:{ ON_SALE、OFF_SALE }
target_url_props 必填 struct

商品目标页属性

target_url_miniprogram 必填 string

小程序落地页url类型,长度不超过2048

字段长度最小 1 字节,长度最大 2048 字节
miniprogram_appid 必填 string

微信小程序APP ID

字段长度最小 1 字节,长度最大 1024 字节
labels struct[]

标签列表

name string

商品标签名称

字段长度最小 1 字节,长度最大 64 字节
start_time string

时间

字段长度最小 18 字节,长度最大 20 字节
end_time string

时间

字段长度最小 18 字节,长度最大 20 字节

请求示例

curl 'https://api.e.qq.com/v1.1/product_salesinfos/add?access_token=<ACCESS_TOKEN>&timestamp=<TIMESTAMP>&nonce=<NONCE>' \
-H 'Content-Type: application/json' \
-d 'account_id="<ACCOUNT_ID>"' \
-d 'data_warehouse_id=101' \
-d 'sku_sales_infos=[
    {
        "external_store_id": "9L07",
        "external_sku_id": "B23446",
        "sale_channel_name": "wxapp",
        "store_type": "SHOP",
        "sku_status": "NEW",
        "price": {
            "daily_price": 80,
            "current_price": 78,
            "sku_price": 85,
            "sku_promotions": [
                {
                    "promotion_price": 80
                },
                {
                    "promotion_price": 81
                },
                {
                    "promotion_price": 83
                }
            ]
        },
        "stock": {
            "sku_stock_status": "ON_SALE"
        }
    }
]'

应答字段

应答示例

{
    "code": 0,
    "message": "",
    "data": {}
}