Skip to content

商品事件(只推送给旺店通) ​

推送参数 ​

其他默认推送参数文档,参考消息推送-使用说明。
商品创建,商品编辑,商品上架,商品下架,商品删除
参数必选类型描述
msg_type是string消息类型:event-事件
event是string事件类型 :goodsEvent-商品事件
data是object消息内容

data 参数结构

参数必选类型描述
action是string操作类型:goods_create-商品创建,goods_edit-商品编辑,goods_up-商品上架,goods_down-商品下架,goods_del-商品删除 ,goods_sku_del-商品sku伤处
goods_ids是string商品ID, (商品上架/下架/删除,存在多个情况,多个情况,商品ID用','拼接)
goods_base_info是object商品基础信息(商品创建/编辑时返回)
goods_attr否array商品规格属性列表(商品创建/编辑且有规格属性时返回)
goods_sku否array商品SKU列表 (商品创建/编辑且有规格属性时返回)
del_goods_sku否array删除的商品SKU列表 (goods_sku_del时有数据返回)

goods_base_info 参数结构 ​

参数必选类型描述
id是int商品ID
uid是int用户ID
type是string商品类型
name是string商品名称
price是string商品价格
Pics是string商品图片(JSON字符串)
status是int商品状态:0-下架,1-上架
stock是int商品库存
unit是string商品单位
discount_price是string折扣价格
description是string商品描述
desc是string商品详情
goods_encode是string商品/货品编码
goods_specs_encode是string商家编码

goods_attr 参数结构 ​

参数必选类型描述
attr_name是string属性名称
attr_val是array属性值列表

attr_val 参数结构 ​

参数必选类型描述
id是int属性值ID
txt是string属性值文本

goods_sku 参数结构 ​

参数必选类型描述
id是intSKU ID
wx_sku_id是int微信SKU ID
goods_id是int商品ID
sku_true_price是intSKU价格
sku_stock是intSKU库存
goods_attribute_ids是string商品属性ID组合(逗号分隔)
goods_attribute_value是string商品属性值(JSON字符串)
default_sku是int是否默认SKU:1-是,2-否
status是int1:生效2:失效(删除)
sku_encode是stringSKU编码
create_time是string创建时间
update_time是string更新时间

del_goods_sku 参数结构 ​

参数必选类型描述
id是intSKU ID
wx_sku_id是int微信SKU ID
goods_id是int商品ID
sku_true_price是intSKU价格
sku_stock是intSKU库存
goods_attribute_ids是string商品属性ID组合(逗号分隔)
goods_attribute_value是string商品属性值(JSON字符串)
default_sku是int是否默认SKU:1-是,2-否
status是int1:生效2:失效(删除)
sku_encode是stringSKU编码
create_time是string创建时间
update_time是string更新时间

推送示例 ​


{
    "key": "xxxxxxxxxxx",
    "msg_id": "xxxxxxxxxxx",
    "msg_type": "event",
    "event": "goodsEvent",
    "uid": 1234567890,
    "push_msg_url": "https://example.com/webhook/goods-event",
    "data": {
        "action": "goods_del",
        "goods_attr": [
            {
                "attr_name": "规格",
                "attr_val": [
                    {
                        "id": 1001,
                        "txt": "小号"
                    },
                    {
                        "id": 1002,
                        "txt": "中号"
                    }
                ]
            },
            {
                "attr_name": "颜色",
                "attr_val": [
                    {
                        "id": 2001,
                        "txt": "红色"
                    },
                    {
                        "id": 2002,
                        "txt": "蓝色"
                    }
                ]
            }
        ],
        "goods_base_info": {
            "id": 12345,
            "uid": 67890,
            "type": "goods",
            "name": "示例商品",
            "price": "99.00",
            "Pics": "[{\"path\":\"https://example.com/images/goods/12345.jpg\"}]",
            "status": 0,
            "stock": 100,
            "unit": "件",
            "discount_price": "0.00",
            "description": "这是一个示例商品",
            "desc": "商品详细描述信息",
            "goods_encode": "GOODS001",
            "goods_specs_encode": "SPEC001"
        },
        "goods_id": 12345,
        "goods_sku": [
            {
                "id": 5001,
                "wx_sku_id": 0,
                "goods_id": 12345,
                "sku_true_price": 99,
                "sku_stock": 50,
                "goods_attribute_ids": "1001,2001",
                "goods_attribute_value": "[{\"id\":\"1001\",\"name\":\"规格\",\"val\":\"小号\"},{\"id\":\"2001\",\"name\":\"颜色\",\"val\":\"红色\"}]",
                "default_sku": 1,
                "status": 1,
                "sku_encode": "SKU001",
                "create_time": "2024-01-01T00:00:00Z",
                "update_time": "2024-01-01T00:00:00Z"
            },
            {
                "id": 5002,
                "wx_sku_id": 0,
                "goods_id": 12345,
                "sku_true_price": 99,
                "sku_stock": 30,
                "goods_attribute_ids": "1001,2002",
                "goods_attribute_value": "[{\"id\":\"1001\",\"name\":\"规格\",\"val\":\"小号\"},{\"id\":\"2002\",\"name\":\"颜色\",\"val\":\"蓝色\"}]",
                "default_sku": 2,
                "status": 1,
                "sku_encode": "SKU002",
                "create_time": "2024-01-01T00:00:00Z",
                "update_time": "2024-01-01T00:00:00Z"
            },
            {
                "id": 5003,
                "wx_sku_id": 0,
                "goods_id": 12345,
                "sku_true_price": 99,
                "sku_stock": 20,
                "goods_attribute_ids": "1002,2001",
                "goods_attribute_value": "[{\"id\":\"1002\",\"name\":\"规格\",\"val\":\"中号\"},{\"id\":\"2001\",\"name\":\"颜色\",\"val\":\"红色\"}]",
                "default_sku": 2,
                "status": 1,
                "sku_encode": "SKU003",
                "create_time": "2024-01-01T00:00:00Z",
                "update_time": "2024-01-01T00:00:00Z"
            }
        ],
         "del_goods_sku": [
            {
                "id": 5001,
                "wx_sku_id": 0,
                "goods_id": 12345,
                "sku_true_price": 99,
                "sku_stock": 50,
                "goods_attribute_ids": "1001,2001",
                "goods_attribute_value": "[{\"id\":\"1001\",\"name\":\"规格\",\"val\":\"小号\"},{\"id\":\"2001\",\"name\":\"颜色\",\"val\":\"红色\"}]",
                "default_sku": 1,
                "status": 1,
                "sku_encode": "SKU001",
                "create_time": "2024-01-01T00:00:00Z",
                "update_time": "2024-01-01T00:00:00Z"
            },
        ]
    }
}