商品创建
获取商户信息
使用该接口，商户可获取账号下的类目与号段等信息。
请求示例
Http请求方式：GET https://api.weixin.qq.com/scan/merchAntinfo/get?access_token=TOKEN
请求参数说明
| 参数 | 是否必须 | 说明 |
|---|---|---|
| access_token | 是 | 公众号的全局凭据，用于接口调用。 |
返回示例
正确的json返回结果如下：
{
"errcode": 0,
"errmsg": "ok",
"brand_tag_list":[
"小耿哥8",
"testtag"
],
"verified_list": [
{
"verified_firm_code": 69300570,
"verified_cate_list": [
{
"verified_cate_id": 538071212,
"verified_cate_name": "食品/茶叶/特产/滋补品"
}
]
},
{
"verified_firm_code": 123,
"verified_cate_list": [
{
"verified_cate_id": 538071212,
"verified_cate_name": "食品/茶叶/特产/滋补品"
}
]
}
]
}
返回参数说明
| 参数 | 说明 |
|---|---|
| errcode | 0为调用成功，否则返回相关错误码。 |
| errmsg | ok为调用成功，否则返回错误提示。 |
| brand_tag_list | 品牌标签列表，创建商品时传入，商户自定义生成的品牌标识字段。 |
| verified_list | 权限列表，包含商户号段、类目ID、类目名称三者的对应关系。 |
| verified_firm_code | 商户号段，表示该商户下有资质的条码号段。 |
| verified_cate_list | 商户类目列表，包含类目ID与对应的类目名称。 |
| verified_cate_id | 商户类目ID，表示该商户下可用于创建商的类目ID |
| verified_cate_name | 商户类目名称，对应类目ID的名称 |
注意：商户容易忽略verified_cate_id，导致下一步商品创建失败。
创建商品
使用该接口，商户可以创建商品信息，设置商品主页，支持条码和二维码两种类型。目前，一个账号最多支持创建10万条商品信息。
请求示例
HTTP请求方式：POSThttps://api.weixin.qq.com/scan/product/create?access_token=tT8VqJWVX4C-WvIG41tyelMclMZsAPFbLxbECsJvIghceqQCMB83hI5bxcInUR-amUrVsKq4bcBmF9PgooNrFA POST数据格式：JSON
POST数据例子：
{
"keystandard": "ean13",
"keystr": "6900000000000",
"brand_info":{
"base_info":{
"title": "扫一扫动态主页demo",
"thumb_url":"http://mmbiz.qpic.cn/mmbiz/AhrnkhhK7rWevHib2pmq1phtply6JicADNrX6Yrvd7LzKERyic3kn3VdSsmFr5F5ibXzj9Al65yWFudmjqcWic1Qe9g/0",
"brand_tag": "小耿哥8",
"category_id": 0,
"store_mgr_type": "auto",
"store_vendorid_list":[],
"color": "auto",
},
"detail_info":{
"banner_list":[
{"link":"http://mmbiz.qpic.cn/mmbiz/AhrnkhhK7rWevHib2pmq1phtply6JicADNic0LvlkCw7s6mZpicib7ict5MhoiaL3gPrYXpibnibOpViaYJFpic12nx4bNZcQ/0",
"desc": "微信相框"},
{"link":"http://mmbiz.qpic.cn/mmbiz/AhrnkhhK7rWevHib2pmq1phtply6JicADNbTfwJmlVXp9k1A80UCFL1a9icwdthmSLh0RuJ5iaKcZBwdXbOicktkwPQ/0",
"desc": "微信相框"},
{"link":"http://mmbiz.qpic.cn/mmbiz/AhrnkhhK7rWevHib2pmq1phtply6JicADNW4FD74oXjEyqHicE9U3H0nTCdLHibo7rRia2TFBQ6tx2Pvic92ica8Wns4Q/0",
"desc": "微信相框"}
],
"detail_list":[
{
"title": "产品名称",
"desc": "微信相框moment"
},
{
"title": "设计团队",
"desc": "微信团队"
},
{
"title": "设计初衷",
"desc": "做一个简单纯粹的电子相框"
},
{
"title": "产品诉求",
"desc": "以相框为纽带，增加子女与父母长辈的沟通，用照片通过微信传递感情交流"
}
]
},
"action_info":{
"action_list":[
{
"type": "price",
"retail_price":"12.00"
},
{
"type": "link",
"name": "banner",
"link": "http://mp.weixin.qq.com",
"image":"http://mmbiz.qpic.cn/mmbiz/AhrnkhhK7rWevHib2pmq1phtply6JicADNgjXTKn0j4TlfXjUOPYBDicVOmG0sdNfUOg9Lzia2g9cbjyTXmOiaB6L1g/0",
"showtype": "banner"
},
{
"type": "link",
"name": "自定义活动1",
"link": "http://p.url.cn/wxscan.php",
},
{
"type": "link",
"name": "自定义活动2",
"link": "http://p.url.cn/wxscan.php",
},
{
"type": "user"
},
{
"type": "text",
"text": "此处可根据品牌商需要，用于简单描述商品或活动。"
}
]
},
"module_info":{
"module_list":[
{
"type": "anti_fake",
"native_show": "fales"，
"anti_fake_url": "weixin.qq.com"
}
]
}
}
}
请求参数说明
POST的主要结构为brand_info，包含商品基本信息base_info、商品详情信息detail_info、推广服务信息action_info和组件信息module_info四部分。
| 参数 | 是否必须 | 说明 |
|---|---|---|
| access_token | 是 | 公众号的全局凭据，用于接口调用。 |
| keystandard | 是 | 商品编码标准，支持ean13、ean8和qrcode标准。 |
| keystr | 是 |
商品编码内容。直接填写商品条码， 标准是ean13，则直接填写商品条码，如“6901939621608”。 标准是qrcode，二维码的内容可由商户自定义，建议使用商品条码，≤20个字符，由大小字母、数字、下划线和连字符组成。 注意：编码标准是ean13时，编码内容必须在商户的号段之下，否则会报错。 |
| base_info | 是 | 商品的基本信息。 |
| detail_info | 是 | 商品的详细描述信息。 |
| action_info | 是 | 商品的推广服务区信息。 |
| module_info | 否 | 商品的组件信息。 |
base_info部分
| 参数 | 是否必须 | 说明 |
|---|---|---|
| title | 是 | 商品名称，建议不超过15个字，超过部分在客户端上以省略号显示。 |
| thumb_url | 是 | 商品缩略图，推荐尺寸为180px*180px，大小不超过50k，支持jpg、png、gif、jpeg格式。 |
| brand_tag | 是 | 品牌字段，如“宝洁海飞丝”、“宝洁飘柔”。 |
| category_id | 是 | 商品类目ID，通过“获取商户信息”接口获取。 |
| store_mgr_type | 否 | 是否展示有该商品的电商渠道，识别条件是编码内容。auto为自动，由微信识别展示渠道；custom为自定义，商户可指定store_vendorid_list内的渠道出现。 |
| store_vendorid_list | 否 | 电商渠道，如果store_mgr_type为custom，则可从以下电商渠道进行选择：2为亚马逊，3为当当网，4为京东，9为一号店，11为聚美优品，19为酒仙网 |
| color | 否 | 主页头部背景色。设置“auto”或不填则自动取色；也支持传入十六进制颜色码自定义背景色。比如，“FFFFFF”代表纯白色。注意：颜色码不识别大小写，也不需要传入“#” |
detail_info部分
| 参数 | 是否必须 | 说明 |
|---|---|---|
| banner_list | 是 | 商品详情页中图文详情可设置多张图片。 |
| link | 是 | 商品详情页中图文详情的图片，640px*320px，单张≤200k，支持jpg、png、gif、jpeg格式，最多可上传6张。 |
| desc | 否 | 商品详情页中图文详情的描述，≤80个汉字。 |
| detail_list | 是 | 商品详情页中可设置多组商品属性。 |
| title | 是 | 商品详情页中商品属性名称，≤6个汉字。 |
| desc | 否 | 商品详情页中商品属性内容，≤80个汉字。 |
action_info部分
| 参数 | 是否必须 | 说明 |
|---|---|---|
| action_list | 是 | 商品主页中可设置多个服务栏。 |
| type | 是 | 服务栏的类型，Media,视频播放；Text，文字介绍；Link，图片跳转；Link，普通链接；User，公众号；Card，微信卡券；Price，建议零售价；Product，微信小店；Store，电商链接；recommend，商品推荐。 |
类型：视频播放
| 参数 | 是否必须 | 说明 |
|---|---|---|
| type | 是 | 服务栏类型,视频类型的参数值为"media"。 |
| link | 是 | 对应的视频链接，仅支持在v.qq.com上传的视频内容，格式请按JSON示例拼接。 |
| image | 是 | 对应视频的封面，推荐尺寸690px*320px，大小不超过200k，支持jpg、png、gif、jpeg格式。 |
类型：文字介绍
| 参数 | 是否必须 | 示例值 | 说明 |
|---|---|---|---|
| type | 是 | text | 服务栏类型。 |
| name | 否 | 商品介绍 | 对应文字介绍的标题。 |
| text | 是 | 此处可根据品牌商需要，用于简单描述商品或活动。 | 对应文字介绍的内容。 |
类型：图片跳转
| 参数 | 是否必须 | 说明 |
|---|---|---|
| type | 是 | 服务栏类型，图片跳转类型的参数值为"link"。 |
| link | 是 | 对应图片跳转后的网页链接。 |
| image | 是 | 对应跳转入口的图片链接，请参考JSON示例。 |
| showtype | 是 | 值为banner，设置图片跳转类型的服务栏时必填。 |
类型：普通链接
| 参数 | 是否必须 | 示例值 | 说明 |
|---|---|---|---|
| type | 是 | link | 服务栏类型。 |
| name | 是 | 查看官网 | 链接入口的名称，不超过12个汉字。 |
| link | 是 | http://www.qq.com | 对应跳转后的网页链接。 |
| digest | 否 | 点击查看 | 服务栏右侧的引导语，不超过5个汉字。 |
类型：公众号
| 参数 | 是否必须 | 示例值 | 说明 |
|---|---|---|---|
| type | 是 | user | 服务栏类型。 |
类型：微信卡券
| 参数 | 是否必须 | 示例值 | 说明 |
|---|---|---|---|
| type | 是 | card | 服务栏类型。 |
| cardid | 是 | pbLatjlZyVY2XCKfIDULuD_J_PKI | 卡券必须为非自定义code（概念说明见微信卡券接口文档）。 |
| digest | 否 | 全场通用 | 服务栏右侧的引导语，不超过5个汉字。 |
类型：建议零售价
| 参数 | 是否必须 | 示例值 | 说明 |
|---|---|---|---|
| type | 是 | price | 服务栏类型。 |
| retail_price | 是 | 12.00 | 表示商品的建议零售价，以“元”为单位。 |
类型：微信小店
| 参数 | 是否必须 | 示例值 | 说明 |
|---|---|---|---|
| type | 是 | product | 服务栏类型。 |
| name | 是 | 官网商城 | 微信小店入口的名称。 |
| productid | 是 | pLHCTjvXB6vIqUYUn51AWsK-sKA8 | 对应小店商品的id，需保证有效。 |
| digest | 否 | 限时折扣 | 服务栏右侧的引导语，不超过5个汉字。 |
类型：电商链接
| 参数 | 是否必须 | 示例值 | 说明 |
|---|---|---|---|
| type | 是 | store | 服务栏类型。 |
| name | 是 | 京东商城 | 电商入口的名称。 |
| link | 是 | http://m.jd.com/product/14091549.HTML | 对应电商的链接，建议是可以直接购买该商品的页面。 |
| sale_price | 是 | 12.50 | 对应商品的价格，单位元。 |
类型：商品推荐
| 参数 | 是否必须 | 说明 |
|---|---|---|
| type | 是 | 服务栏类型，商品推荐的值为recommende。 |
| recommend_type | 是 | 表示商品推荐的方式，目前只支持指定，值为appointed。 |
| recommend_list | 是 | 表示指定要推荐的商品列表 |
| keystandard | 是 | 表示被推荐的商品编码格式。 |
| keystr | 是 | 表示被推荐商品的编码内容。 |
“商品推荐”的JSON示例：
{
"type": "recommend",
"recommend": {
"recommend_type": "appointed",
"recommend_list": [
{
"keystandard": "ean13",
"keystr": "6900000000001"
},
{
"keystandard": "ean13",
"keystr": "6900873042720"
}
]
}
}
module_info部分
| 参数 | 是否必须 | 说明 |
|---|---|---|
| module_list | 否 | 未来可设置多个组件，目前仅支持防伪组件。 |
| type | 否 | 组件的类型，目前仅包括防伪组件anti_fake。 |
| native_show | 否 | 设置为true时，防伪结果使用微信提供的弹窗页面展示，商户仅需调用“商品管理”部分的组件消息接口回传产品真假信息。设置为false时，无防伪弹窗效果。 |
| anti_fake_url | 否 | 商户提供的防伪查询链接，当native_show设置为false时必填。 |
注意：
1、推广服务区action_info部分，入口数量规则如下：
1)至少设置一个推广类型；
2)文字介绍、公众号和微信卡券三种推广类型，每种类型最多只能分别设置1个；
3)普通链接、公众号、微信卡券三种类型合计最多设置3个；
4)图片跳转链接和视频播放只能二选一展示；
2、商品主页中必须存在至少一个价格信息，价格的展示渠道有四种：
1)在base_info中定义store_mgr_type和store_vendorid_list字段。如果商品在设置的电商渠道有销售，则会有售卖入口在【购买区】展示。例如：“洋河-天之蓝 480ml”在“京东商城”有销售，假设京东商城又在该商品设置的电商渠道列表中，则会有“京东商城”的售卖入口出现。
2)在微信小店（Product）类型中设置productid，购买区将出现对应商品的微信小店售卖入口。
3)在电商链接（Store）类型中设置目标地址链接（link），购买区将出现所配置的外部商城售卖入口。
4)在建议零售价（Price）类型中设置retail_price字段。如果商品没有设置前文所述的任何一种购买渠道，也会有该商品建议零售价展示。
返回示例
正确的JSON返回结果如下：
{
"errcode": 0,
"errmsg": "ok",
"pid": "5g0B4A90aqc"
}
返回参数说明
| 参数 | 说明 |
|---|---|
| errcode | 0为调用成功，否则返回相关错误码。 |
| errmsg | ok为调用成功，否则返回错误提示。 |
| pid | 转译后的商品id，将直接编入“获取商品二维码接口”返回的二维码内容。 |