获取商品 | 微信开放文档

# 获取商品

# 接口说明

可通过指定商品ID获取商品具体信息

启用新多级类目树提示：旧的类目树固定为三级类目结构，新的类目树为多级类目结构，过渡期间，新旧类目树兼容使用，请开发者尽快切换到新多级类目树。其中差异请参阅“新旧类目树差异”。此接口新增 cats_v2 字段支持新类目树，详见参数。

# 接口调用请求说明

POST https://api.weixin.qq.com/channels/ec/product/get?access_token=ACCESS_TOKEN

# 请求参数说明

参数	类型	是否必填	描述
product_id	string(uint64)	是	商品ID
data_type	number	否	默认取1 1:获取线上数据 2:获取草稿数据 3:同时获取线上和草稿数据（注意：上架过的商品才有线上数据）

# 请求参数示例

{
    "product_id": "324545",
    "data_type": 1
}

# 返回参数说明

参数	类型	描述
errcode	number	错误码
errmsg	string	错误信息
product	Objct(Product)	商品线上数据，入参data_type==2时不返回该字段；入参data_type==3且商品从未上架过，不返回该字段，具体参数内容可参考：结构体product
edit_product	Objct(Product)	商品草稿数据，入参data_type==1时不返回该字段
sale_limit_info	Objct(ProductSaleLimitInfo)	当日售卖上限提醒，当店铺受到售卖管控时返回，没有返回本字段表示没有无额外限制。具体参数内容可参考：结构体sale_limit_info

# 返回参数示例

{
    "errcode": 0,
    "errmsg": "ok",
    "product": {
        "product_id": "123456789",
        "out_product_id": "OUT_PRODUCT_ID_TEST",
        "title": "任天堂 Nintendo Switch 国行续航增强版",
        "sub_title": "【国行Switch，更安心的保修服务，更快的国行服务器】一台主机三种模式，游戏掌机，随时随地，一起趣玩",
        "head_imgs": [
            "https://mmecimage.cn/p/wx37f38d59298839c3/HJE9eJaEc5bJk-eaArVdILSB7MMaHgdK2-JIn51nMQ"
        ],
        "desc_info": {
            "imgs": [
                "https://mmecimage.cn/p/wx37f38d59298839c3/HJE9eJaEc5bJk-eaArVdILSB7MMaHgdK2-JIn51nMQ"
            ]
        },
        "cats": [
            {
                "cat_id": "1"
            },
            {
                "cat_id": "2"
            },
            {
                "cat_id": "3"
            }
        ],
        "cats_v2": [
            {
                "cat_id": "1"
            },
            {
                "cat_id": "2"
            },
            {
                "cat_id": "3"
            },
            {
                "cat_id": "4"
            }
        ],
        "attrs": [
            {
             "attr_key": "产地",
             "attr_value": "四川成都"
            },
            {
             "attr_key": "材质",
             "attr_value": "玻璃"
            },
            {
            "attr_key": "适用人群",
            "attr_value": "青年;中年"
            },
            {
            "attr_key": "数量",
            "attr_value": "33"
            },
            {
            "attr_key": "精度",
            "attr_value": "3.001"
            },
            {
            "attr_key": "重量",
            "attr_value": "38 mg"
            },
            {
           "attr_key": "毛重",
           "attr_value": "380 kg"
            }          
        ],
        "express_info": {
            "template_id": "123456"
        },
        "status": 5,
        "edit_status": 2,
        "skus": [
            {
                "sku_id": "123456001",
                "out_sku_id": "OUT_SKU_ID_TEST",
                "thumb_img": "",
                "sale_price": 1,
                "stock_num": 5,
                "sku_code": "SKU_CODE_TEST",
                "sku_attrs": [
                    {
                        "attr_key": "产地",
                        "attr_value": "四川成都"
                    },
                    {
                        "attr_key": "材质",
                        "attr_value": "玻璃"
                    },
                    {
                        "attr_key": "适用人群",
                        "attr_value": "青年;中年"
                    },
                    {
                        "attr_key": "数量",
                        "attr_value": "33"
                    },
                    {
                        "attr_key": "精度",
                        "attr_value": "3.001"
                    },
                    {
                         "attr_key": "重量",
                         "attr_value": "38 mg"
                    },
                    {
                         "attr_key": "毛重",
                         "attr_value": "380 kg"
                    }         
                ],
                "status": 0
            }
        ],
        "min_price": 1,
        "spu_code": "SPU_CODE_TEST",
        "product_qua_infos": [
            {
                "qua_id": 1111484,
                "qua_url": [
                    "https://mmecimage.cn/p/wx2b255582a7b4bfd0/HCnhqIWMZSIAJzzDRNmevAzRXj5ZCAZw8vGKYF1GW8Y"
                ]
            },
            {
                "qua_id": 1111491,
                "qua_url": [
                    "https://mmecimage.cn/p/wx2b255582a7b4bfd0/HPySAtxADO1LuDHdmJ7wiSwJzyEicLNTSAE-a10swwM"
                ]
            },
            {
                "qua_id": 1111492,
                "qua_url": [
                    "https://mmecimage.cn/p/wx2b255582a7b4bfd0/HGekHKK4yA_s0Ur3wwgil2x_6sZ7RiFpA4JSSfT_gYI",
                    "https://mmecimage.cn/p/wx2b255582a7b4bfd0/HPfiP6fjCN5BeLJ48i9e0zANmKUuv-hyo55nuUk9mBA"
                ]
            }
        ]
    }
}

# 错误码

错误码	错误描述
公共错误码	-
10020050	无权限调用该api，请获取权限后再试
10020051	参数有误，请按照文档要求传参
10020052	商品不存在
10020065	商品未上架
10020207	该类型的商品无法获取草稿数据

# 结构体

# product

商品线上数据

参数	类型	描述
product_id	string(uint64)	小店内部商品ID
out_product_id	string	商家自定义商品ID。如果添加时没录入，回包可能不包含该字段
title	string	标题
sub_title	string	副标题。如果添加时没录入，回包可能不包含该字段
head_imgs	string array	主图,多张,列表,最多9张,每张不超过2MB
desc_info.imgs	string array	商品详情图片(最多20张)。如果添加时没录入，回包可能不包含该字段
desc_info.desc	string	商品详情文字。如果添加时没录入，回包可能不包含该字段
deliver_method	number	发货方式：0-快递发货；1-无需快递，手机号发货；3-无需快递，可选发货账号类型，默认为0，若为无需快递，则无需填写运费模版id
deliver_acct_type	array(number)	发货账号：1-微信openid；2-QQ号；3-手机号；4-邮箱。只有deliver_method=3时，本参数有意义。且当发货账号为微信、QQ和邮箱时，需要更新订单接口读取详情字段，详情参考订单接口的说明。
express_info.template_id	string(uint64)	运费模板ID。如果添加时没录入，回包可能不包含该字段
express_info.weight	number	商品重量，单位克
aftersale_desc	string	售后说明
limited_info.period_type	number	限购周期类型，0无限购，1按自然日限购，2按自然周限购，3按自然月限购
limited_info.limited_buy_num	number	限购数量
extra_service.seven_day_return	number	是否支持七天无理由退货，0-不支持七天无理由，1-支持七天无理由，2-支持七天无理由(定制商品除外)，3-支持七天无理由(使用后不支持)。
extra_service.pay_after_use	number	先用后付，0-不支持先用后付，1-支持先用后付。若店铺已开通先用后付，支持先用后付的类目商品将在上架后自动打开先用后付。
extra_service.freight_insurance	number	是否支持运费险，0-不支持运费险，1-支持运费险。需要商户开通运费险服务，且当前类目支持运费险才会生效。
extra_service.fake_one_pay_three	number	是否支持假一赔三，0-不支持假一赔三，1-支持假一赔三。
extra_service.damage_guarantee	number	是否支持坏损包退，0-不支持坏损包退，1-支持坏损包退。
status	number	商品线上状态，edit_product和product都会返回该字段
edit_status	number	商品草稿状态，以edit_product字段返回的值为准，product不返回，枚举值状态可参考：edit_status
min_price	number	商品 SKU 最小价格（单位：分）
cats[].cat_id	string(uint64)	商家需要先申请可使用类目
cats_v2[].cat_id	string(uint64)	新类目树--商家需要先申请可使用类目
attrs[].attr_key	string	属性键key（属性自定义用）。如果添加时没录入，回包可能不包含该字段
attrs[].attr_value	string	属性值（属性自定义用）。如果添加时没录入，回包可能不包含该字段，参数规则如下： ● 当获取类目信息接口中返回的type：为 select_many， attr_value的格式：多个选项用分号;隔开示例：某商品的适用人群属性，选择了：青年、中年，则 attr_value的值为：青年;中年 ● 当获取类目信息接口中返回的type：为 integer_unit/decimal4_unit attr_value格式：数值单位，用单个空格隔开示例：某商品的重量属性，要求integer_unit属性类型，数值部分为 18，单位选择为kg，则 attr_value的值为：18 kg ● 当获取类目信息接口中返回的type：为 integer/decimal4 attr_value 的格式：字符串形式的数字
spu_code	string	商品编码
brand_id	string(uint64)	品牌id，无品牌为“2100000000”
skus[].sku_id	string(uint64)	skuID
skus[].out_sku_id	string	商家自定义skuID。如果添加时没录入，回包可能不包含该字段
skus[].thumb_img	string	sku小图。如果添加时没录入，回包可能不包含该字段
skus[].sale_price	number	售卖价格，以分为单位
skus[].stock_num	number	sku库存
skus[].sku_code	string	sku编码。如果添加时没录入，回包可能不包含该字段
skus[].sku_attrs[].attr_key	string	属性键key（属性自定义用）
skus[].sku_attrs[].attr_value	string	属性值（属性自定义用）。如果添加时没录入，回包可能不包含该字段，参数规则如下： ● 当获取类目信息接口中返回的type：为 select_many， attr_value的格式：多个选项用分号;隔开示例：某商品的适用人群属性，选择了：青年、中年，则 attr_value的值为：青年;中年 ● 当获取类目信息接口中返回的type：为 integer_unit/decimal4_unit attr_value格式：数值单位，用单个空格隔开示例：某商品的重量属性，要求integer_unit属性类型，数值部分为 18，单位选择为kg，则 attr_value的值为：18 kg ● 当获取类目信息接口中返回的type：为 integer/decimal4 attr_value 的格式：字符串形式的数字
skus[].status	number	sku状态
skus[].sku_deliver_info.stock_type	number	sku库存情况。0:现货（默认），1:全款预售。部分类目支持全款预售，具体参考文档获取类目信息中的字段`attr.pre_sale`
skus[].sku_deliver_info.full_payment_presale_delivery_type	number	sku发货节点，该字段仅对`stock_type=1`有效。0:付款后n天发货，1:预售结束后n天发货
skus[].sku_deliver_info.presale_begin_time	number	sku预售周期开始时间，秒级时间戳，该字段仅对`delivery_type=1`有效。
skus[].sku_deliver_info.presale_end_time	number	sku预售周期结束时间，秒级时间戳，该字段仅对`delivery_type=1`有效。
skus[].sku_deliver_info.full_payment_presale_delivery_time	number	sku发货时效，即付款后/预售结束后`{full_payment_presale_delivery_time}`天内发货，该字段仅对`stock_type=1`时有效。
product_type	number	商品类型。1: 小店普通自营商品；2: 福袋抽奖商品；3: 直播间闪电购商品。注意: 福袋抽奖、直播间闪电购类型的商品为只读数据，不支持编辑、上架操作，不支持用data_type=2的参数获取。
edit_time	number	商品草稿最近一次修改时间
after_sale_info.after_sale_address_id	number	商品的售后地址id，可使用获取地址详情
src_product_id	number	当商品类型位福袋抽奖商品（即product_type==2）且该抽奖商品由橱窗的自营商品导入生成时有值，表示导入的来源商品id，其他场景下该字段无值或者值为0。
product_qua_infos[]	array	商品资质列表
product_qua_infos[].qua_id	string(uint64)	商品资质id，对应获取类目信息中的字段`product_qua_list[].qua_id`
product_qua_infos[].qua_url[]	array(string)	商品资质图片列表
size_chart.enable	bool	是否启用尺码表
size_chart.specification_list	array	尺码表
size_chart.specification_list[].name	string	尺码属性名称
size_chart.specification_list[].unit	string	尺码属性值的单位
size_chart.specification_list[].is_range	bool	尺码属性值是否为区间
size_chart.specification_list[].value_list	array	尺码值与尺码属性值的映射列表
size_chart.specification_list[].value_list[].key	string	尺码值
size_chart.specification_list[].value_list[].value	string	尺码属性值；尺码属性值为非区间时返回
size_chart.specification_list[].value_list[].left	string	尺码属性值的左边界；尺码属性值为区间时返回
size_chart.specification_list[].value_list[].right	string	尺码属性值的右边界；尺码属性值为区间时返回

# sale_limit_info

商品销售库存限制

参数	类型	描述
is_limited	number	是否受到管控，商品存在售卖限制时，固定返回1
title	string	售卖限制标题
sub_title	string	售卖限制描述

# 枚举值

# edit_status

商品草稿状态

枚举值	描述
0	初始值
1	编辑中
2	审核中
3	审核失败
4	审核成功
7	商品异步提交，上传中（处于该状态的商品调用上架商品接口会返回10020067）
8	商品异步提交，上传失败（请重新提交）

# status

商品线上状态

枚举值	描述
0	初始值
5	上架
6	回收站
9	彻底删除，商品无法再进行任何操作
11	自主下架
13	违规下架/风控系统下架
14	保证金不足下架
15	品牌过期下架
20	商品被封禁