微信小店
微信门店
微信智能接口
微信设备功能

商品创建

出自微信公众平台开发者文档
跳转到: 导航, 搜索

商品创建

获取商户信息

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

请求示例

HTTP请求方式:GET
https://api.weixin.qq.com/scan/merchantinfo/get?access_token=TOKEN

请求参数说明

参数 是否必须 说明
access_token 公众号的全局凭据,用于接口调用。

返回示例

正确的JSON返回结果如下:

{
 "errcode": 0,
 "errmsg": "ok",
 "verified_cate_list":[
  {
   "verified_cate_id": 200531967,
   "verified_cate_name": "调味品"
  }
 ],
 "verified_firm_code_list":[8888],
 "brand_tag_list":[
  "小耿哥8",
  "testtag"
 ]
}

返回参数说明

参数 是否必须
errcode 0为调用成功,否则返回相关错误码。
errmsg ok为调用成功,否则返回错误提示。
verified_cate_id_list 商户类目列表,包含类目ID与对应的类目名称。
verified_cate_id 商户类目ID,表示该账户下可用于创建商品的类目ID。
verified_cate_name 商户类目名称,对应类目ID的名称。
verified_firm_code_list 商户号段列表,包含该账户下有资质的条码号段。
brand_tag_list 品牌标签列表,创建商品时传入,商户自定义生成的品牌标识字段。

注意:商户容易忽略verified_cate_id,导致下一步商品创建失败。

创建商品

使用该接口,商户可以创建商品信息,设置商品主页。目前,一个账号最多支持创建10万条商品信息。

请求示例

HTTP请求方式:POST
https://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"},
{"link":"http://mmbiz.qpic.cn/mmbiz/AhrnkhhK7rWevHib2pmq1phtply6JicADNbTfwJmlVXp9k1A80UCFL1a9icwdthmSLh0RuJ5iaKcZBwdXbOicktkwPQ/0"},
{"link":"http://mmbiz.qpic.cn/mmbiz/AhrnkhhK7rWevHib2pmq1phtply6JicADNW4FD74oXjEyqHicE9U3H0nTCdLHibo7rRia2TFBQ6tx2Pvic92ica8Wns4Q/0"}
   ],
   "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四部分

商品主页示例2.png

参数 是否必须 说明
access_token 公众号的全局凭据,用于接口调用。
keystandard 商品编码标准,暂时只支持ean13和ean8两种标准。
keystr 商品编码内容。直接填写商品条码,如“6900000000000”;注意:编码标准是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张。
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,在微信系统内唯一区分一个商品。