微信上进行商品创建

商品创建

获取商户信息

使用该接口,商户可获取账号下的类目与号段等信息。

请求示例

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": "食品/茶叶/特产/滋补品"
     }
    ]
   }
  ] 
 }

返回参数说明

参数说明
errcode0为调用成功,否则返回相关错误码。
errmsgok为调用成功,否则返回错误提示。
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格式。

类型:文字介绍

参数是否必须示例值说明
typetext服务栏类型。
name商品介绍对应文字介绍的标题。
text此处可根据品牌商需要,用于简单描述商品或活动。对应文字介绍的内容。

类型:图片跳转

参数是否必须说明
type服务栏类型,图片跳转类型的参数值为"link"。
link对应图片跳转后的网页链接。
image对应跳转入口的图片链接,请参考JSON示例。
showtype值为banner,设置图片跳转类型的服务栏时必填。

类型:普通链接

参数是否必须示例值说明
typelink服务栏类型。
name查看官网链接入口的名称,不超过12个汉字。
linkhttp://www.qq.com对应跳转后的网页链接。
digest点击查看服务栏右侧的引导语,不超过5个汉字。

类型:公众号

参数是否必须示例值说明
typeuser服务栏类型。

类型:微信卡券

参数是否必须示例值说明
typecard服务栏类型。
cardidpbLatjlZyVY2XCKfIDULuD_J_PKI卡券必须为非自定义code(概念说明见微信卡券接口文档)。
digest全场通用服务栏右侧的引导语,不超过5个汉字。

类型:建议零售价

参数是否必须示例值说明
typeprice服务栏类型。
retail_price12.00表示商品的建议零售价,以“元”为单位。

类型:微信小店

参数是否必须示例值说明
typeproduct服务栏类型。
name官网商城微信小店入口的名称。
productidpLHCTjvXB6vIqUYUn51AWsK-sKA8对应小店商品的id,需保证有效。
digest限时折扣服务栏右侧的引导语,不超过5个汉字。

类型:电商链接

参数是否必须示例值说明
typestore服务栏类型。
name京东商城电商入口的名称。
linkhttp://m.jd.com/product/14091549.html对应电商的链接,建议是可以直接购买该商品的页面。
sale_price12.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"
}

返回参数说明

参数说明
errcode0为调用成功,否则返回相关错误码。
errmsgok为调用成功,否则返回错误提示。
pid转译后的商品id,将直接编入“获取商品二维码接口”返回的二维码内容。