微信小店
取消
中文
中文
EN
取消
  • 联盟带货机构

    • # 获取商品基础详情

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

    接口英文名：getproductdetail

    你可以在本接口获取最详细的通用商品信息（例如商品销量、价格、图片等）；商品推广相关的参数（如推广链接等）请分别在推客带货和达人带货接口中获取。

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

    # 1. 调用方式

    # HTTPS 调用

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

    # 云调用

    • 本接口不支持云调用

    # 第三方调用

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

    # 2. 请求参数

    # 查询参数 Query String parameters

    参数名类型必填示例说明
    access_tokenstring是ACCESS_TOKEN接口调用凭证，可使用 access_token

    # 请求体 Request Payload

    参数名类型必填示例说明
    shop_appidstring是SHOPAPPID机构商品 所属小店appid
    product_idnumber是1商品id

    # 3. 返回参数

    # 返回体 Response Payload

    参数名类型示例说明
    errcodenumber0错误码
    errmsgstringok错误信息
    itemobject商品详情

    # Res.item Object Payload

    商品详情

    参数名类型说明
    shop_appidstring所属小店appid
    product_idnumber商品id
    product_infoobject商品信息
    shopobject店铺信息

    # Res.item.product_info Object Payload

    商品信息

    参数名类型说明
    titlestring标题
    sub_titlestring副标题。如果添加时没录入，回包可能不包含该字段
    head_imgsarray主图,多张,列表,最多9张,每张不超过2MB
    desc_infoobject商详信息
    skusobjarraysku信息
    cats_v2objarray新类目树--类目信息
    statusnumber商品状态：5-上架销售中，其他值为非正常状态
    monthly_sales_rangenumber近30天销量范围：0-销量在0~10；10-销量在10~50；50-销量在50~100；100-销量在100~300；300-销量在300~500；500-销量在500~800；800-销量在800~1000；1000-销量在1000~3000；3000-销量在3000~5000；5000-销量在5000~8000；8000-销量在8000~10000；10000-销量在10000+；

    # Res.item.product_info.desc_info Object Payload

    商详信息

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

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

    sku信息

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

    # Res.item.product_info.skus(Array).sku_attrsObject 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.item.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.item.product_info.cats_v2(Array) Object Payload

    新类目树--类目信息

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

    # Res.item.shop Object Payload

    店铺信息

    参数名类型说明
    namestring店铺名称
    scorenumber店铺评分，如463
    iconstring店铺图标

    # 4. 注意事项

    本接口无特殊注意事项

    # 5. 代码示例

    请求示例

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

    返回示例

    {
	"errcode": "0",
	"errmsg": "ok",
	"product": {
		"shop_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_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": "四川成都"
				}]
			}]
		},
		"shop": {
			"name": "xx",
			"score": 463,
			"icon": "https://xx"
		}
	}
}

    # 6. 错误码

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

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

    # 7. 适用范围

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