# 获取合作商品详情

# 接口说明

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

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

# 接口调用请求说明

POST https://api.weixin.qq.com/channels/ec/promoter/get_promote_product_detail?access_token=ACCESS_TOKEN

# 请求参数说明

参数 类型 是否必填 描述
shop_appid string 团长商品 所属小店appid
product_id number 商品id
plan_type number 商品的计划类型 1:定向计划 2:公开计划

# 请求参数示例

{
    "shop_appid":"SHOPAPPID",
    "product_id": 1,
    "plan_type": 1
}

# 返回参数说明

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

# 返回参数示例

{
	"errcode": "0",
	"errmsg": "ok",
	"product": {
		"shop_appid": "test",
		"product_id": 12345,
		"product_promotion_link": "",
		"product_info": {
			"title": "test_title",
			"sub_title": "",
			"head_imgs": [
				"https://test.com/0"
			],
			"desc_info": {
				"imgs": [
					"https://test.com/0"
				],
				"desc": ""
			},
			"cats_v2": [{
				"cat_id": "1421"
			}],
			"express_info": {
				"send_time": "",
				"address_info": {
					"postal_code": "",
					"province_name": "",
					"city_name": "",
					"county_name": ""
				},
				"shipping_method": "NO_FREE"
			},
			"extra_service": {
				"seven_day_return": 0,
				"pay_after_use": 0,
				"freight_insurance": 0,
				"fake_one_pay_three": 0,
				"damage_guarantee": 0
			},
			"statistical_data": {
				"good_ratio": 0,
				"sales_in_30_days": 1
			},
			"skus": [{
				"sku_id": "670813472",
				"thumb_img": "",
				"sale_price": 500,
				"stock_num": 998,
				"sku_attrs": [{
					"attr_key": "产地",
					"attr_value": "四川成都"
				}]
			}]
		},
		"commission_info": {
			"status": 1,
			"service_ratio": 1,
			"start_time": 1,
			"end_time": 1,
			"normal_commission_info": {
				"ratio": 1
			}
		}
	}
}

# 错误码

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

# 结构体

# product

商品所有信息

参数 类型 描述
shop_appid string 所属小店appid
product_id string(uint64) 商品id
product_promotion_link string 商品卡片透传参数【注意:内嵌商品卡片时一定要传,不然会归因失败】
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
skus Array<object SkuInfo> sku信息,结构体详情请参考SkuInfo
product_promotion_link string 用于在小程序跳转小店场景添加商品时传递跟佣信息

# DescInfo

商品详情信息

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

# CatInfo

类目信息

参数 类型 描述
cat_id string(uint64) 类目id
cat_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]
start_time number 时间戳,合作开始时间
end_time number 时间戳,合作结束时间

# 枚举值

# ItemStatus

商品带货状态

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