获取合作商品详情 | 微信开放文档

# 获取合作商品详情

# 接口说明

可通过该接口获取商品详情

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

# 接口调用请求说明

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

# 请求参数说明

参数	类型	是否必填	描述
appid	string	是	团长商品所属小店appid
product_id	string(uint64)	是	商品id

# 请求参数示例

{
    "product_id": 12345,
    "appid": "test"
}

# 返回参数说明

参数	类型	描述
errcode	number	错误码
errmsg	string	错误信息
item	object Item	商品详情，结构体详情请参考Item结构体

# 返回参数示例

{
    "errcode": 0,
    "errmsg": "ok",
    "item": {
        "appid": "test",
        "product_id": 12345,
        "product_info": {
            "title": "test_title",
            "sub_title": "",
            "head_imgs": [
                "https://test.com/0"
            ],
            "desc_info": {
                "imgs": [
                    "https://test.com/0"
                ],
                "desc": ""
            },
            "cats": [
                {
                    "cat_id": "1421"
                },
                {
                    "cat_id": "1443"
                },
                {
                    "cat_id": "1452"
                }
            ],
             "cats_v2": [
                {
                    "cat_id": "1421"
                },
                {
                    "cat_id": "1443"
                },
                {
                    "cat_id": "1452"
                },
                {
                    "cat_id": "1476"
                }
            ],
            "express_info": {
                "send_time": "",
                "address_info": {
                    "postal_code": "",
                    "province_name": "",
                    "city_name": "",
                    "county_name": ""
                },
                "shipping_method": "NO_FREE"
            },
            "skus": [
                {
                    "sku_id": "670813472",
                    "thumb_img": "",
                    "sale_price": 500,
                    "stock_num": 998,
                    "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"
					}
                    ]
                }
            ]
        }
    }
}

# 错误码

错误码	错误描述
公共错误码	-
10024000	参数错误，请开发人员检查传递参数是否正确
10024003	不合法的appid
10024004	不存在该商品

# 结构体

# Item

商品所有信息

参数	类型	描述
appid	string(uint64)	所属小店appid
product_id	string(uint64)	商品id
product_info	object ProductInfo	商品信息，结构体详情请参考ProductInfo
commission_info	object CommissionInfo	跟佣信息，结构体详情请参考CommissionInfo

# ProductInfo

商品内容

参数	类型	描述
title	string	标题
sub_title	string	副标题。如果添加时没录入，回包可能不包含该字段
head_imgs	string array	主图,多张,列表,最多9张,每张不超过2MB
desc_info	object DescInfo	商详信息，结构体详情请参考DescInfo
cats	Array<object CatInfo>	类目信息，结构体详情请参考CatInfo
cats_v2	Array <object CatInfo>	新类目树--类目信息，结构体详情请参考CatInfo
express_info	object ExpressInfo	快递信息，结构体详情请参考ExpressInfo
skus	Array<object SkuInfo>	sku信息，结构体详情请参考SkuInfo
is_hidden	bool	商品是否在商品列表页对外隐藏

# DescInfo

商品详情信息

参数	类型	描述
imgs	string array	商品详情图片(最多20张)。如果添加时没录入，回包可能不包含该字段
desc	string	商品详情文字。如果添加时没录入，回包可能不包含该字段

# CatInfo

类目信息

参数	类型	描述
cat_id	string(uint64)	类目id
cat_name	string	类目名称

# ExpressInfo

快递信息

参数	类型	描述
send_time	string	发货时间期限
address_info	object AddressInfo	发货地址，结构体详情请参考AddressInfo
shipping_method	string	计费方式：FREE：包邮CONDITION_FREE：条件包邮NO_FREE：不包邮

# AddressInfo

发货地址

参数	类型	描述
postal_code	string	邮编
province_name	string	国标收货地址第一级地址
city_name	string	国标收货地址第二级地址
county_name	string	国标收货地址第三级地址

# SkuInfo

sku信息

参数	类型	描述
sku_id	string(uint64)	skuID
thumb_img	string	sku小图。如果添加时没录入，回包可能不包含该字段
sale_price	number	售卖价格，以分为单位
stock_num	number	sku库存
sku_attrs[].attr_key	string	属性键key（属性自定义用）
sku_attrs[].attr_value	string	属性值value（属性自定义用），参数规则如下： ● 当获取类目信息接口中返回的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 的格式：字符串形式的数字
sku_deliver_info	object SkuDeliverInfo	预售信息，结构体详情请参考SkuDeliverInfo

# SkuDeliverInfo

预售信息

参数	类型	描述
stock_type	number	sku库存情况。0:现货（默认），1:全款预售。部分类目支持全款预售，具体参考文档获取类目信息中的字段`attr.pre_sale`
full_payment_presale_delivery_type	number	sku发货节点，该字段仅对`stock_type=1`有效。0:付款后n天发货，1:预售结束后n天发货
presale_begin_time	number	sku预售周期开始时间，秒级时间戳，该字段仅对`delivery_type=1`有效。
presale_end_time	number	sku预售周期结束时间，秒级时间戳，该字段仅对`delivery_type=1`有效。
full_payment_presale_delivery_time	number	sku发货时效，即付款后/预售结束后`{full_payment_presale_delivery_time}`天内发货，该字段仅对`stock_type=1`时有效。

# CommissionInfo

跟佣信息

参数	类型	描述
status	number	商品带货状态，枚举值详情请参考ItemStatus
service_ratio	number	服务费率[0, 1000000]
ratio	number	佣金费率[0, 1000000]
start_time	number	时间戳，合作开始时间
end_time	number	时间戳，合作结束时间
link	string	带货链接，团长商品状态上架中返回
audit_info	object AuditInfo	待审核信息，结构体详情请参考AuditInfo
normal_commission_info	object NormalCommissionInfo	该商品普通推广下的佣金信息，团长商品上架中且普通推广上架中有效，结构体详情请参考NormalCommissionInfo

# AuditInfo

待审核信息

参数	类型	描述
service_ratio	number	服务费率[0, 1000000]
ratio	number	佣金费率[0, 1000000]
start_time	number	时间戳，合作开始时间
end_time	number	时间戳，合作结束时间

# NormalCommissionInfo

商品普通推广下的佣金信息

参数	类型	描述
ratio	number	佣金费率[0, 1000000]

# 枚举值

# ItemStatus

商品带货状态

枚举值	描述
1	已上架推广
2	已下架推广
5	已清退