腾讯有数官方文档

获取销售信息

请求地址

product_salesinfos/get

请求方法

GET

请求参数

名称 类型 描述
account_id 必填 integer

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

data_warehouse_id 必填 integer

数据仓库ID

external_store_id 必填 string

客户侧店铺/仓库ID

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

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

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

销售渠道:WECHAT_MINIPROGRAM(微信小程序),WECHAT_H5(微信H5),PC(自建PC),APP(自建APP),H5(自建H5),JD(京东),VIPSHOP(唯品会),PDD(拼多多),OTHER(其他)

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

请求示例

curl -G 'https://api.e.qq.com/v1.1/product_salesinfos/get?access_token=<ACCESS_TOKEN>&timestamp=<TIMESTAMP>&nonce=<NONCE>' \
-d 'account_id="<ACCOUNT_ID>"' \
-d 'data_warehouse_id=101' \
-d 'external_store_id="9L07"' \
-d 'external_sku_id="B23446"' \
-d 'sale_channel_name="wxapp"'

应答字段

名称 类型 描述
list 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_H5(微信H5),PC(自建PC),APP(自建APP),H5(自建H5),JD(京东),VIPSHOP(唯品会),PDD(拼多多),OTHER(其他)

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

类型(标识为门店还是仓库、电商仓)

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

商品状态,新品/正常商品/停购等

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

商品价格信息

daily_price float

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

current_price float

商品目前售价,单位:元,保留两位小数

sku_price float

商品原价,单位:元,保留两位小数

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 字节

应答示例

{
    "code": 0,
    "message": "",
    "data": {
        "list": [
            {
                "external_store_id": "9L07",
                "external_sku_id": "B23446",
                "sale_channel_name": "wxapp",
                "external_store_name": "福建连江贵安新天地店",
                "store_type": "SHOP",
                "currency_type": "RMB",
                "sku_status": "NEW",
                "price": {
                    "daily_price": 80,
                    "current_price": 78,
                    "sku_price": 85,
                    "sku_promotions": [
                        {
                            "promotion_id": "p08877",
                            "promotion_price": 80
                        },
                        {
                            "promotion_id": "p08077",
                            "promotion_price": 81
                        },
                        {
                            "promotion_id": "p08977",
                            "promotion_price": 83
                        }
                    ],
                    "member_rates": [
                        {
                            "member_class": "level1",
                            "member_discount": 0.98
                        },
                        {
                            "member_class": "level2",
                            "member_discount": 0.97
                        },
                        {
                            "member_class": "level3",
                            "member_discount": 0.87
                        }
                    ]
                },
                "stock": {
                    "stock_total": 9000,
                    "sku_stock_num": 8000,
                    "sku_phy_num": 8500,
                    "sku_sale_num": 7500,
                    "sku_stock_status": "ON_SALE",
                    "stock_type": "value",
                    "stock_batch": "00099",
                    "date_of_manufacture": "2018-08-14 00:00:04",
                    "date_of_expiration": "2048-08-14 00:00:04",
                    "store_unit": "件"
                }
            }
        ]
    }
}