# 微信官方正品接入

# 1. 名词解释

dataSourceId：有数数据源，可将 dataSourceId 理解为数据的集合。一个有数数据源可被授权给多个广告商品应用。

# 2. 填写《申请表》

参见接入指引。

# 3. 完成有数接入

按照腾讯有数数据管理 (opens new window)<数据接入>-<接入工具>-<接入进度>内容完成接入，若有数已完成接入此步骤可跳过。

# 4. 开发 get 接口后通知有数小助手进行联调

# 4.1 请求地址

/sku_info/get

# 4.2请求方式

传输：HTTP(POST)

协议：json

# 4.3 性能要求

QPS300以上，响应耗时100ms以内。

# 4.4 接口协议

# 请求参数

参数	样例	描述
app_id	youshu	商家分配给有数的app_id，固定为youshu
nonce	61794670f155b	随机字符串
sign	sha256	签名算法
timestamp	1569232087	当前时间戳（秒级）
signature	aee30792812d7b09ba7d3aa67c24e16c6a7ea81282ac728ad5966dd1b3eef6d5	签名结果

请求参数设计请参考有数计算签名方法。

# 请求体参数

针对不同业务场景，我们提供两套接口方案。

# 方案1：电商版接口，适用服饰、美妆行业等电商类小程序

名称	类型	必填	描述
external_sku_ids	string[]	Y	您为商品SKU分配的唯一ID，支持批量，最多不超过 50 个

# 方案2：多店版接口，使用生鲜、外卖等到家类小程序

名称	类型	必填	描述
external_store_id	string	Y	指定用于微信官方正品场景的唯一店铺/仓库id
external_sku_ids	string[]	Y	您为商品SKU分配的唯一ID，支持批量，最多不超过 50 个

# 返回体参数

一级名称	二级名称	三级名称	类型	描述
external_sku_id			string	商品 skuid。色码款商品必填。字段长度最小 1 字节，长度最大 128 字节
media_info			object	商品图片及视频信息数组最大长度 10
	primary_imgs		object	主图图片信息列表数组最大长度 10
		img_url	string	商品主图地址；图片320*320以上，1张，正方形图片可正常打开字段长度最小 1 字节，长度最大 2048 字节
	imgs		object	图片信息列表数组最大长度 10
		img_url	string	商品图片地址；图片320*320以上，10张，正方形图片可正常打开字段长度最小 1 字节，长度最大 2048 字节
sales_info
	is_available		boolean	上架状态；true：上架；false：下架
	sku_stock_status		enum	同一个商品在不同店仓中的销售状态 1：库存＞0；2：库存≤0（常见为售罄/暂无库存商品在页面底部展示，可标记为状态2）
desc_info			object	商品描述属性
	product_name_chinese		string	商品中文名字段长度最小 1 字节，长度最大 100 字节
price			object	商品价格信息
	current_price		float	商品目前售价，单位：元，保留2位小数；大于等于0，最小值0；current_price需≤sku_price
	sku_price		float	商品原价，单位：元，保留2位小数；大于等于0，最小值0；current_price需≤sku_price

# 请求示例

# 方案1：电商版

{
	"external_sku_ids":["aaa","bbb"]
}

# 方案2：多店版

{
	"external_store_id": "123",
	"external_sku_ids":["aaa","bbb"]
}

# 返回示例

[
	{
		"external_sku_id": "SKU_123456",
		"media_info": {
			"primary_imgs": {
				"img_url": "http://abcd.com/1.jpg" // 商品主图，320*320以上
			},
			"imgs": [
				{
					"img_url": "http://abcd.com/1.jpg" // 商品图，320*320以上
				},
				{
					"img_url": "http://abcd.com/2.jpg" // 商品图，320*320以上
				}
			],
		},
		"sales_info": {
			"is_available": true, // 上下架状态，true：上架；false：下架
			"sku_stock_status": 1 // 同一个商品在不同店仓中的销售状态                },
		"desc_info": {
				"product_name_chinese": "商品名称" // 商品名称
			},
			"price": {
				"current_price": 1.2, // 商品现价，单位元
				"sku_price": 5.3 // 商品原价，单位元
			}
		}
	}
]

# 5. 接入商品数据

针对不同业务场景，我们提供两套上报方案。

# 方案1：电商版接口，适用服饰、美妆行业等电商类小程序

数据类型	行为/接口名称	行为/接口描述
商品接口	/data-api/v1/sku_info/add	商品信息添加（电商版）
商品接口	/data-api/v1/sku_info/update	商品信息更新（电商版）
流量接口	/data-api/v1/analysis/add_wxapp_daily_visit_trend	上报日访问趋势

# 方案2：多店版接口，使用生鲜、外卖等到家类小程序

数据类型	行为/接口名称	行为/接口描述
商品接口	/data-api/v1/store/add	门店仓库添加/变更（多店版）
商品接口	/data-api/v1/sku/add	商品 SKU 添加/变更（多店版）
商品接口	/data-api/v1/salesinfo/add	销售信息添加/变更（多店版）