# 获取合作商品详情

接口应在服务器端调用,不可在前端(小程序、网页、APP等)直接调用,具体可参考接口调用指南

接口英文名:getpromoteproductdetail

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

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

# 1. 调用方式

# HTTPS 调用

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

# 云调用

  • 本接口不支持云调用

# 第三方调用

  • 本接口不支持第三方平台调用。

# 2. 请求参数

# 查询参数 Query String parameters

参数名类型必填示例说明
access_tokenstringACCESS_TOKEN接口调用凭证,可使用 access_token

# 请求体 Request Payload

参数名类型必填说明
shop_appidstring机构商品 所属小店appid
plan_typenumber商品的计划类型 1:定向计划 2:公开计划 3: 机构定向计划 4: 机构普通计划
product_idnumber商品id
get_available_couponboolean填true返回商品可用的机构券
head_supplier_appidstring商品所属供货机构appid【当plan_type为 3 和 4 时,这个参数必传】

# 3. 返回参数

# 返回体 Response Payload

参数名类型说明
errcodenumber错误码
errmsgstring错误信息
productobject商品详情
publish_couponsobjarray商品可用的公开机构券
cooperative_couponsobjarray商品可用的定向机构券

# Res.product Object Payload

商品详情

参数名类型说明
shop_appidstring所属小店appid
product_idstring商品id
product_promotion_linkstring商品卡片透传参数【注意:内嵌商品卡片时一定要传,不然会归因失败】
product_infoobject商品信息
commission_infoobject跟佣信息
head_supplier_infoobject供货机构信息

# Res.publish_coupons(Array) Object Payload

商品可用的公开机构券

参数名类型说明
coupon_idstring券的 id

# Res.cooperative_coupons(Array) Object Payload

商品可用的定向机构券

参数名类型说明
coupon_idstring券的 id

# Res.product.product_info Object Payload

商品信息

参数名类型说明枚举
titlestring标题-
sub_titlestring副标题。如果添加时没录入,回包可能不包含该字段-
head_imgsarray主图,多张,列表,最多9张,每张不超过2MB-
desc_infoobject商详信息-
catsobjarray类目信息-
cats_v2objarray新类目树--类目信息-
skusobjarraysku信息-
product_promotion_linkstring用于在小程序跳转小店场景添加商品时传递跟佣信息-
statusnumber商品的状态枚举值

# Res.product.product_info.desc_info Object Payload

商详信息

参数名类型说明
imgsarray商品详情图片(最多20张)。如果添加时没录入,回包可能不包含该字段
descstring商品详情文字。如果添加时没录入,回包可能不包含该字段

# Res.product.product_info.cats(Array) Object Payload

类目信息

参数名类型说明
cat_idstring类目id
cat_namestring类目名称

# Res.product.product_info.cats_v2(Array) Object Payload

新类目树--类目信息

参数名类型说明
cat_idstring类目id
cat_namestring类目名称

# Res.product.product_info.skus(Array) Object Payload

sku信息

参数名类型说明
sku_idstringskuID
thumb_imgstringsku小图。如果添加时没录入,回包可能不包含该字段
sale_pricenumber售卖价格,以分为单位
stock_numnumbersku库存
sku_attrsobjectsku_attrs
sku_deliver_infoobject预售信息

# Res.product.product_info.skus(Array).sku_attrs Object Payload

sku_attrs

参数名类型说明
attr_keystring属性键key(属性自定义用)
attr_valuestring属性值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 的格式:字符串形式的数字

# Res.product.product_info.skus(Array).sku_deliver_info Object Payload

预售信息

参数名类型说明
stock_typenumbersku库存情况。0:现货(默认),1:全款预售。部分类目支持全款预售,具体参考文档获取类目信息中的字段attr.pre_sale
full_payment_presale_delivery_typenumbersku发货节点,该字段仅对stock_type=1有效。0:付款后n天发货,1:预售结束后n天发货
presale_begin_timenumbersku预售周期开始时间,秒级时间戳,该字段仅对delivery_type=1有效。
presale_end_timenumbersku预售周期结束时间,秒级时间戳,该字段仅对delivery_type=1有效。
full_payment_presale_delivery_timenumbersku发货时效,即付款后/预售结束后{full_payment_presale_delivery_time}天内发货,该字段仅对stock_type=1时有效。

# Res.product.commission_info Object Payload

跟佣信息

参数名类型说明枚举
statusstring商品带货状态 枚举值
service_rationumber服务费率[0, 1000000]-
start_timenumber时间戳,合作开始时间-
end_timenumber时间戳,合作结束时间-

# Res.product.head_supplier_info Object Payload

供货机构信息

参数名类型说明
head_supplier_appidstring商品所属供货机构appid
namestring商品所属供货机构名称

# 4. 枚举信息

# Res.product.product_info.status Enum

商品的状态

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

# Res.product.commission_info.status Enum

商品带货状态

枚举值描述
1已上架推广【可以进行推客带货】
2已下架推广【计划已经下架,下架原因为:上游主动下架或者商品失效等】
3待选品【商家定向机构推广还没有添加到机构合作商品列表中,可以进行推客带货】
5已清退【计划已经下架,下架原因为:命中了联盟清退规则】

# 5. 注意事项

本接口无特殊注意事项

# 6. 代码示例

请求示例

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

返回示例

{
	"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
			}
		}
	}
}

# 7. 错误码

以下是本接口的错误码列表,其他错误码可参考 通用错误码

错误码错误描述解决方案
10024000参数错误,请开发人员检查传递参数是否正确
10024003不合法的appid
10024004不存在该商品
10071033shop_appid错误
10071048参数异常,请检查入参
10071053商品不在架

# 8. 适用范围

本接口暂未明确可调用账号类型,或在业务中根据调用传参自行确定是否可调用,请已实际调用情况为准。