微信API手册
目录
1. 商品管理接口 -1-
1.1 增加商品 -1-
1.2 删除商品 -6-
1.3 修改商品 -7-
1.4 查询商品 -10-
1.5 获取指定状态的所有商品 -13-
1.6 商品上下架 -14-
1.7 获取指定分类的所有子分类 -15-
1.8 获取指定子分类的所有SKU -16-
1.9 获取指定分类的所有属性 -18-
2. 库存管理接口 -21-
2.1 增加库存 -21-
2.2 减少库存 -22-
3. 邮费模板管理接口 -24-
3.1 增加邮费模板 -24-
3.2 删除邮费模板 -35-
3.3 修改邮费模板 -36-
3.4 获取指定ID的邮费模板 -37-
3.5 获取所有邮费模板 -39-
4. 分组管理接口 -41-
4.1 增加分组 -41-
4.2 删除分组 -42-
4.3 修改分组属性 -43-
4.4 修改分组商品 -44-
4.5 获取所有分组 -45-
4.6 根据分组ID获取分组信息 -46-
5. 货架管理接口 -48-
5.1 增加货架 -48-
5.2 删除货架 -56-
5.3 修改货架 -57-
5.4 获取所有货架 -58-
5.5 根据货架ID获取货架信息 -60-
5.6 开发者将自己的页面作为货架 -61-
6. 订单管理接口 -63-
6.1 订单付款通知 -63-
6.2 根据订单ID获取订单详情 -63-
6.3 根据订单状态/创建时间获取订单详情 -65-
6.4 设置订单发货信息 -68-
6.5 关闭订单 -69-
7. 功能接口 -71-
7.1 上传图片 -71-
商品管理接口
增加商品
接口调用请求说明
协议 https http请求方式 POST 请求Url https://api.weixin.qq.com/merchant/create?access_token=ACCESS_TOKEN POST数据格式 json 请求参数说明
参数 是否必须 说明 access_token 是 调用接口凭证 POST数据 是 商品信息
数据示例：
{
"product_base":{
"category_id":[
"537074298"
],
"property":[
{
"id":"1075741879",
"vid":"1079749967"
},
{
"id":"1075754127",
"vid":"1079795198"
},
{
"id":"1075777334",
"vid":"1079837440"
}
],
"name":"testaddproduct",
"sku_info":[
{
"id":"1075741873",
"vid":[
"1079742386",
"1079742363"
]
}
],
"main_img":"http://mmbiz.qpic.cn/mmbiz/4whpV1VZl2iccsvYbHvnphkyGtnvjD3ulEKogfsiaua49pvLfUS8Ym0GSYjViaLic0FD3vN0V8PILcibEGb2fPfEOmw/0",
"img":[
"http://mmbiz.qpic.cn/mmbiz/4whpV1VZl2iccsvYbHvnphkyGtnvjD3ulEKogfsiaua49pvLfUS8Ym0GSYjViaLic0FD3vN0V8PILcibEGb2fPfEOmw/0"
],
"detail":[
{
"text":"testfirst"
},
{
"img":"http://mmbiz.qpic.cn/mmbiz/4whpV1VZl2iccsvYbHvnphkyGtnvjD3ul1UcLcwxrFdwTKYhH9Q5YZoCfX4Ncx655ZK6ibnlibCCErbKQtReySaVA/0"
},
{
"text":"testagain"
}
],
"buy_limit":10
},
"sku_list":[
{
"sku_id":"1075741873:1079742386",
"price":30,
"icon_url":"http://mmbiz.qpic.cn/mmbiz/4whpV1VZl28bJj62XgfHPibY3ORKicN1oJ4CcoIr4BMbfA8LqyyjzOZzqrOGz3f5KWq1QGP3fo6TOTSYD3TBQjuw/0",
"product_code":"testing",
"ori_price":9000000,
"quantity":800
},
{
"sku_id":"1075741873:1079742363",
"price":30,
"icon_url":"http://mmbiz.qpic.cn/mmbiz/4whpV1VZl28bJj62XgfHPibY3ORKicN1oJ4CcoIr4BMbfA8LqyyjzOZzqrOGz3f5KWq1QGP3fo6TOTSYD3TBQjuw/0",
"product_code":"testingtesting",
"ori_price":9000000,
"quantity":800
}
],
"attrext":{
"location":{
"country":"中国",
"province":"广东省",
"city":"广州市",
"address":"T.I.T创意园"
},
"isPostFree":0,
"isHasReceipt":1,
"isUnderGuaranty":0,
"isSupportReplace":0
},
"delivery_info":{
"delivery_type":0,
"template_id":0,
"express":[
{
"id":10000027,
"price":100
},
{
"id":10000028,
"price":100
},
{
"id":10000029,
"price":100
}
]
}
}
字段 说明 base_attr 基本属性 name 商品名称 category 商品分类id，商品分类列表 main_img 必选 商品主图(图片需调用图片上传接口获得图片Url填写至此，否则无法添加商品。图片分辨率推荐尺寸为640×600) img 必选 商品图片列表( detail 必选 商品详情 text 文字描述 img 图片(图片需调用图片上传接口获得图片Url填写至此，否则无法添加商品) property 商品属性列表 id 属性id vid 属性值id sku_info 商品sku定义 id sku属性 vid sku值 buy_limit 用户商品限购数量 sku_list sku信息列表(多个) sku_id sku信息,参照上述sku_table的定义
格式"id1:vid1;id2:vid2"
规则:id_info的组合个数必须与sku_table个数一致(若商品无sku信息,即商品为统一规格，则此处赋值为空字符串即可) ori_price sku原价(单位:分) price sku微信价(单位:分,微信价必须比原价小,否则添加商品失败) icon_url skuiconurl(图片需调用图片上传接口获得图片Url) quantity sku库存 product_code 商家商品编码 attrext 商品其他属性 isPostFree 是否包邮(0-否,1-是),如果包邮delivery_info字段可省略 isHasReceipt 是否提供发票(0-否,1-是) isUnderGuaranty 是否保修(0-否,1-是) isSupportReplace 是否支持退换货(0-否,1-是) location 商品所在地地址 country 国家(详见《地区列表》说明) province 省份(详见《地区列表》说明) city 城市(详见《地区列表》说明) address 地址 delivery_info 必选 运费信息 delivery_type 运费类型(0-使用下面express字段的默认模板,1-使用template_id代表的邮费模板,详见邮费模板相关API) template_id 邮费模板ID express id 快递ID price 运费(单位:分) 返回数据说明
数据示例：
{
"errcode":0,
"errmsg":"success",
"product_id":"pDF3iYwktviE3BzU3BKiSWWi9Nkw"
}
字段 说明 errcode 错误码 errmsg 错误信息 product_id 商品ID 快递列表
id 说明 10000027 平邮 10000028 快递 10000029 EMS 删除商品
接口调用请求说明
协议 https http请求方式 POST 请求Url https://api.weixin.qq.com/merchant/del?access_token=ACCESS_TOKEN POST数据格式 json 请求参数说明
参数 是否必须 说明 access_token 是 调用接口凭证 POST数据 是 商品信息 POST数据
字段 说明 product_id 商品ID 返回数据说明
字段 说明 errcode 错误码 errmsg 错误信息 修改商品
接口调用请求说明
协议 https http请求方式 POST 请求Url https://api.weixin.qq.com/merchant/update?access_token=ACCESS_TOKEN POST数据格式 json 请求参数说明
参数 是否必须 说明 access_token 是 调用接口凭证 POST数据 是 商品详情信息 POST数据
备注：
product_id表示要更新的商品的ID，其他字段说明请参考增加商品接口。
返回数据说明
字段 说明 errcode 错误码 errmsg 错误信息 查询商品
接口调用请求说明
协议 https http请求方式 GET 请求Url https://api.weixin.qq.com/merchant/get?access_token=ACCESS_TOKEN 请求参数说明
参数 是否必须 说明 access_token 是 调用接口凭证 POST数据
字段 说明 product_id 商品ID 返回数据说明
{
"errcode":0,
"errmsg":"success",
"product_info":{
"product_id":"pDF3iY6Kr_BV_CXaiYysoGqJhppQ",
"product_base":{
"name":"testaddproduct",
"category_id":[
537074298
],
"img":[
"http://mmbiz.qpic.cn/mmbiz/4whpV1VZl2iccsvYbHvnphkyGtnvjD3ulEKogfsiaua49pvLfUS8Ym0GSYjViaLic0FD3vN0V8PILcibEGb2fPfEOmw/0"
],
"property":[
{
"id":"品牌",
"vid":"Fujifilm/富士"
},
{
"id":"屏幕尺寸",
"vid":"1.8英寸"
},
{
"id":"防抖性能",
"vid":"CCD防抖"
}
],
"sku_info":[
{
"id":"1075741873",
"vid":[
"1079742386",
"1079742363"
]
}
],
"buy_limit":10,
"main_img":"http://mmbiz.qpic.cn/mmbiz/4whpV1VZl2iccsvYbHvnphkyGtnvjD3ulEKogfsiaua49pvLfUS8Ym0GSYjViaLic0FD3vN0V8PILcibEGb2fPfEOmw/0",
"detail_html":"testtestagain"
},
"sku_list":[
{
"sku_id":"1075741873:1079742386",
"price":30,
"icon_url":"http://mmbiz.qpic.cn/mmbiz/4whpV1VZl2iccsvYbHvnphkyGtnvjD3ulEKogfsiaua49pvLfUS8Ym0GSYjViaLic0FD3vN0V8PILcibEGb2fPfEOmw/0",
"quantity":800,
"product_code":"testing",
"ori_price":9000000
},
{
"sku_id":"1075741873:1079742363",
"price":30,
"icon_url":"http://mmbiz.qpic.cn/mmbiz/4whpV1VZl28bJj62XgfHPibY3ORKicN1oJ4CcoIr4BMbfA8LqyyjzOZzqrOGz3f5KWq1QGP3fo6TOTSYD3TBQjuw/0",
"quantity":800,
"product_code":"testingtesting",
"ori_price":9000000
}
],
"attrext":{
"isPostFree":0,
"isHasReceipt":1,
"isUnderGuaranty":0,
"isSupportReplace":0,
"location":{
"country":"中国",
"province":"广东省",
"city":"广州市",
"address":"T.I.T创意园"
}
},
"delivery_info":{
"delivery_type":1,
"template_id":103312920
}
}
}
字段 说明 errcode 错误码 errmsg 错误信息 商品详情(字段说明详见增加商品) 获取指定状态的所有商品
接口调用请求说明
协议 https http请求方式 请求Url https://api.weixin.qq.com/merchant/?access_token=ACCESS_TOKEN 请求参数说明
参数 是否必须 说明 access_token 是 调用接口凭证 POST数据 是 商品详情信息 POST数据
字段 说明 返回数据说明
字段 说明 errcode 错误码 errmsg 错误信息 指定状态下的所有商品集合 商品上下架
接口调用请求说明
协议 https http请求方式 请求Url https://api.weixin.qq.com/merchant/modproductstatus?access_token=ACCESS_TOKEN 请求参数说明
参数 是否必须 说明 access_token 是 调用接口凭证 POST数据 是 商品详情信息 POST数据
字段 说明 product_id 商品ID 返回数据说明
字段 说明 errcode 错误码 errmsg 错误信息
接口调用请求说明
协议 https http请求方式 请求Url https://api.weixin.qq.com/merchant/category/getsub?access_token=ACCESS_TOKEN 请求参数说明
参数 是否必须 说明 access_token 是 调用接口凭证 POST数据 是 商品信息 POST数据
字段 说明 cate_id 大分类ID 返回数据说明
字段 说明 errcode 错误码 errmsg 错误信息
接口调用请求说明
协议 https http请求方式 请求Url https://api.weixin.qq.com/merchant/category/getsku?access_token=ACCESS_TOKEN 请求参数说明
参数 是否必须 说明 access_token 是 调用接口凭证 POST数据 是 商品信息 POST数据
字段 说明 _id 商品 返回数据说明
字段 说明 errcode 错误码 errmsg 错误信息 sku_table sku列表 id skuid name sku名称 value_list skuvid列表 id vid name vid名称
接口调用请求说明
协议 https http请求方式 请求Url https://api.weixin.qq.com/merchant/category/?access_token=ACCESS_TOKEN 请求参数说明
参数 是否必须 说明 access_token 是 调用接口凭证 POST数据 是 商品信息 POST数据
字段 说明 cate_id 分类ID 返回数据说明
字段 说明 errcode 错误码 errmsg 错误信息
库存管理接口
增加库存
接口调用请求说明
协议 https http请求方式 POST 请求Url https://api.weixin.qq.com/merchant/stock/add?access_token=ACCESS_TOKEN POST数据格式 json 请求参数说明
参数 是否必须 说明 access_token 是 调用接口凭证 POST数据 是 商品库存信息 POST数据
字段 说明 product_id 商品ID sku_info sku信息,格式"id1:vid1;id2:vid2" quantity 增加的库存 返回数据说明
字段 说明 errcode 错误码 errmsg 错误信息 减少库存
接口调用请求说明
协议 https http请求方式 POST 请求Url https://api.weixin.qq.com/merchant/stock/reduce?access_token=ACCESS_TOKEN POST数据格式 json 请求参数说明
参数 是否必须 说明 access_token 是 调用接口凭证 POST数据 是 商品库存信息 POST数据
字段 说明 product_id 商品ID sku_info sku信息,格式"id1:vid1;id2:vid2" quantity 库存数量 返回数据说明
字段 说明 errcode 错误码 errmsg 错误信息
管理接口
增加
接口调用请求说明
协议 https http请求方式 POST 请求Url https://api.weixin.qq.com/merchant//add?access_token=ACCESS_TOKEN POST数据格式 json 请求参数说明
参数 是否必须 说明 access_token 是 调用接口凭证 POST数据 是 信息 POST数据
字段 说明 Name 邮费模板名称 Assumer 支付方式(0-买家承担运费,1-卖家承担运费) Valuation 计费单位(0-按件计费,1-按重量计费,2-按体积计费) TopFee 具体运费计算 Type 快递类型ID(参见增加商品/快递列表) Normal 默认邮费计算方法 StartStandards 起始计费数量(比如计费单位是按件,填2代表起始计费为2件) StartFees 起始计费金额(单位:分） AddStandards 递增计费数量 AddFees 递增计费金额(单位:分) Custom 指定地区邮费计算方法 StartStandards 起始计费数量 StartFees 起始计费金额(单位:分） AddStandards 递增计费数量 AddFees 递增计费金额(单位:分) DestCountry 指定国家 DestProvince 指定省份 DestCity 指定城市 例子解析：Type为10000027的默认邮费计算，第1件邮费2分，每增加3件邮费增加3分。Type为10000027的指定地区邮费计算，寄送到中国/广东省/广州市的商品，第一件邮费1元，每增加1件邮费增加3分。 返回数据说明
字段 说明 errcode 错误码 errmsg 错误信息 template_id
Country Province City 中国 北京市 北京市 天津市 天津市 石家庄市 唐山市 秦皇岛市 邯郸市 邢台市 保定市 张家口市 承德市 沧州市 廊坊市 衡水市 太原市 大同市 阳泉市 长治市 晋城市 朔州市 晋中市 运城市 忻州市 临汾市 吕梁市 呼和浩特市 包头市 乌海市 赤峰市 通辽市 鄂尔多斯市 呼伦贝尔市 巴彦淖尔市 乌兰察布市 兴安盟 锡林郭勒盟 阿拉善盟 沈阳市 大连市 鞍山市 抚顺市 本溪市 锦州市 营口市 阜新市 辽阳市 盘锦市 朝阳市 葫芦岛市 长春市 吉林市 四平市 辽源市 通化市 白山市 松原市 白城市 延边朝鲜族自治州 哈尔滨市 齐齐哈尔市 鸡西市 鹤岗市 双鸭山市 大庆市 伊春市 佳木斯市 七台河市 牡丹江市 黑河市 绥化市 大兴安岭地区 上海市 南京市 无锡市 徐州市 常州市 苏州市 南通市 连云港市 淮安市 扬州市 镇江市 泰州市 宿迁市 宁波市 温州市 嘉兴市 湖州市 绍兴市 金华市 衢州市 舟山市 台州市 丽水市 合肥市 芜湖市 蚌埠市 淮南市 马鞍山市 淮北市 铜陵市 安庆市 黄山市 滁州市 阜阳市 宿州市 六安市 亳州市 池州市 宣城市 福州市 厦门市 莆田市 三明市 泉州市 漳州市 南平市 龙岩市 宁德市 南昌市 景德镇市 萍乡市 九江市 新余市 鹰潭市 赣州市 吉安市 宜春市 抚州市 上饶市 济南市 青岛市 淄博市 东营市 烟台市 潍坊市 济宁市 泰安市 威海市 日照市 莱芜市 临沂市 德州市 聊城市 滨州市 菏泽市 郑州市 开封市 洛阳市 平顶山市 安阳市 鹤壁市 新乡市 焦作市 濮阳市 漯河市 南阳市 商丘市 信阳市 周口市 驻马店市 省直辖县级行政区划 武汉市 黄石市 十堰市 宜昌市 襄阳市 鄂州市 孝感市 荆州市 黄冈市 咸宁市 随州市 恩施土家族苗族自治州 省直辖县级行政区划 长沙市 株洲市 湘潭市 衡阳市 邵阳市 岳阳市 常德市 张家界市 益阳市 郴州市 永州市 怀化市 娄底市 湘西土家族苗族自治州 广州市 韶关市 深圳市 珠海市 汕头市 佛山市 江门市 湛江市 茂名市 肇庆市 惠州市 梅州市 汕尾市 河源市 阳江市 清远市 东莞市 中山市 潮州市 揭阳市 云浮市 南宁市 柳州市 桂林市 梧州市 北海市 防城港市 钦州市 贵港市 玉林市 百色市 贺州市 河池市 来宾市 崇左市 海口市 三亚市 三沙市 省直辖县级行政区划 重庆市 成都市 自贡市 攀枝花市 泸州市 德阳市 绵阳市 广元市 遂宁市 内江市 乐山市 南充市 眉山市 广安市 达州市 雅安市 巴中市 资阳市 阿坝藏族羌族自治州 甘孜藏族自治州 凉山彝族自治州 贵阳市 六盘水市 遵义市 安顺市 毕节市 铜仁市 黔西南布依族苗族自治州 黔东南苗族侗族自治州 黔南布依族苗族自治州 昆明市 曲靖市 玉溪市 保山市 昭通市 丽江市 普洱市 临沧市 楚雄彝族自治州 红河哈尼族彝族自治州 文山壮族苗族自治州 西双版纳傣族自治州 大理白族自治州 德宏傣族景颇族自治州 怒江傈僳族自治州 迪庆藏族自治州 拉萨市 昌都地区 山南地区 日喀则地区 那曲地区 阿里地区 林芝地区 西安市 宝鸡市 咸阳市 渭南市 延安市 汉中市 榆林市 安康市 商洛市 兰州市 嘉峪关市 白银市 武威市 张掖市 平凉市 酒泉市 庆阳市 定西市 陇南市 临夏回族自治州 甘南藏族自治州 西宁市 海东地区 海北藏族自治州 黄南藏族自治州 海南藏族自治州 果洛藏族自治州 玉树藏族自治州 海西蒙古族藏族自治州 银川市 石嘴山市 吴忠市 固原市 中卫市 乌鲁木齐市 克拉玛依市 吐鲁番地区 哈密地区 昌吉回族自治州 博尔塔拉蒙古自治州 巴音郭楞蒙古自治州 阿克苏地区 克孜勒苏柯尔克孜自治州 喀什地区 和田地区 伊犁哈萨克自治州 塔城地区 阿勒泰地区 自治区直辖县级行政区划
接口调用请求说明
协议 https http请求方式 POST 请求Url https://api.weixin.qq.com/merchant//del?access_token=ACCESS_TOKEN POST数据格式 json 请求参数说明
参数 是否必须 说明 access_token 是 调用接口凭证 POST数据 是 信息 POST数据
字段 说明 template_id 邮费模板 返回数据说明
字段 说明 errcode 错误码 errmsg 错误信息
接口调用请求说明
协议 https http请求方式 POST 请求Url https://api.weixin.qq.com/merchant//update?access_token=ACCESS_TOKEN POST数据格式 json 请求参数说明
参数 是否必须 说明 access_token 是 调用接口凭证 POST数据 是 信息 POST数据
字段 说明 template_id 邮费模板 delivery_template 邮费模板信息(字段说明详见增加邮费模板) 返回数据说明
字段 说明 errcode 错误码 errmsg 错误信息
接口调用请求说明
协议 https http请求方式 POST 请求Url https://api.weixin.qq.com/merchant//getbyid?access_token=ACCESS_TOKEN POST数据格式 json 请求参数说明
参数 是否必须 说明 access_token 是 调用接口凭证 POST数据 是 信息 POST数据
字段 说明 template_id 邮费模板 返回数据说明
字段 说明 errcode 错误码 errmsg 错误信息 邮费模板信息(字段说明详见增加邮费模板) 获取所有邮费模板
接口调用请求说明
协议 https http请求方式 请求Url https://api.weixin.qq.com/merchant//getall?access_token=ACCESS_TOKEN 请求参数说明
参数 是否必须 说明 access_token 是 调用接口凭证 返回数据说明
字段 说明 errcode 错误码 errmsg 错误信息 所有邮费模板集合(字段说明详见增加邮费模板)
分组管理接口
增加分组
接口调用请求说明
协议 https http请求方式 POST 请求Url https://api.weixin.qq.com/merchant/group/add?access_token=ACCESS_TOKEN POST数据格式 json 请求参数说明
参数 是否必须 说明 access_token 是 调用接口凭证 POST数据 是 商品分组信息 POST数据
字段 说明 分组 product_list 商品ID集合 返回数据说明
字段 说明 errcode 错误码 errmsg 错误信息 group_id 分组ID 删除分组
接口调用请求说明
协议 https http请求方式 POST 请求Url https://api.weixin.qq.com/merchant/group/del?access_token=ACCESS_TOKEN POST数据格式 json 请求参数说明
参数 是否必须 说明 access_token 是 调用接口凭证 POST数据 是 商品分组信息 POST数据
字段 说明 group_id 分组ID 返回数据说明
字段 说明 errcode 错误码 errmsg 错误信息 修改分组属性
接口调用请求说明
协议 https http请求方式 POST 请求Url https://api.weixin.qq.com/merchant/group/propertymod?access_token=ACCESS_TOKEN POST数据格式 json 请求参数说明
参数 是否必须 说明 access_token 是 调用接口凭证 POST数据 是 分组属性 POST数据
返回数据说明
字段 说明 errcode 错误码 errmsg 错误信息 修改分组商品
接口调用请求说明
协议 https http请求方式 POST 请求Url https://api.weixin.qq.com/merchant/group/productmod?access_token=ACCESS_TOKEN POST数据格式 json 请求参数说明
参数 是否必须 说明 access_token 是 调用接口凭证 POST数据 是 分组商品信息 POST数据
字段 说明 group_id 分组ID product 分组的商品集合 product_id 商品ID mod_action 修改操作(0-删除,1-) 返回数据说明
字段 说明 errcode 错误码 errmsg 错误信息 获取所有分组
接口调用请求说明
协议 https http请求方式 GET 请求Url https://api.weixin.qq.com/merchant/group/getall?access_token=ACCESS_TOKEN 请求参数说明
参数 是否必须 说明 access_token 是 调用接口凭证 返回数据说明
字段 说明 errcode 错误码 errmsg 错误信息 groups_detail 分组集合 group_name 分组 根据分组ID获取分组信息
接口调用请求说明
协议 https http请求方式 POST 请求Url https://api.weixin.qq.com/merchant/group/getbyid?access_token=ACCESS_TOKEN POST数据格式 json 请求参数说明
参数 是否必须 说明 access_token 是 调用接口凭证 POST数据 是 分组信息 POST数据
字段 说明 group_id 分组ID 返回数据说明
字段 说明 errcode 错误码 errmsg 错误信息 groups_detail 分组信息 group_name 分组名称 product_list 商品ID集合
货架管理接口
增加货架
接口调用请求说明
协议 https http请求方式 POST 请求Url https://api.weixin.qq.com/merchant/shelf/add?access_token=ACCESS_TOKEN POST数据格式 json 请求参数说明
参数 是否必须 说明 access_token 是 调用接口凭证 POST数据 是 货架详情信息 POST数据
字段 说明 shelf_data 货架信息(数据说明详见《货架控件说明》) shelf_banner 货架招牌图片Url(图片需调用图片上传接口获得图片Url填写至此，否则) shelf_name 货架名称
控件1
控件1是由一个分组组成，展示该分组指定数量的商品列表，可与控件2、控件3、控件4联合使用。
POST数据/控件UI
{
"group_info":{
"filter":{
"count":4
},
"group_id":50
},
"eid":1
}
数据说明
字段 说明 group_info 分组信息 count 该控件展示商品个数 group_id 分组ID 控件1的ID 控件2
控件2是由多个分组组成（最多有4个分组），展示指定分组的名称，可与控件1、控件3、控件4联合使用。
POST数据/控件UI
{
"group_infos":{
"groups":[
{
"group_id":49
},
{
"group_id":50
},
{
"group_id":51
}
]
},
"eid":2
}
数据说明
字段 说明 groups 分组数组 group_id 分组ID 控件2的ID 控件3
控件3是由一个分组组成，展示指定分组的分组图片，可与控件1、控件2、控件4联合使用。
POST数据/控件UI
{
"group_info":{
"group_id":52,
"img":"http://mmbiz.qpic.cn/mmbiz/4whpV1VZl29nqqObBwFwnIX3licVPnFV5Jm64z4I0TTicv0TjN7Vl9bykUUibYKIOjicAwIt6Oy0Y6a1Rjp5Tos8tg/0"
},
"eid":3
}
数据说明
字段 说明 group_info 分组信息 group_id 分组ID 分组照片(图片需调用图片上传接口获得图片Url填写至此，否则) eid 控件3的ID 控件4
控件4是由多个分组组成（最多3个分组），展示指定分组的分组图片，可与控件1、控件2、控件4联合使用。
POST数据/控件UI
{
"group_infos":{
"groups":[
{
"group_id":49,
"img":"http://mmbiz.qpic.cn/mmbiz/4whpV1VZl29nqqObBwFwnIX3licVPnFV5uUQx7TLx4tB9qZfbe3JmqR4NkkEmpb5LUWoXF1ek9nga0IkeSSFZ8g/0"
},
{
"group_id":50,
"img":"http://mmbiz.qpic.cn/mmbiz/4whpV1VZl29nqqObBwFwnIX3licVPnFV5G1kdy3ViblHrR54gbCmbiaMnl5HpLGm5JFeENyO9FEZAy6mPypEpLibLA/0"
},
{
"group_id":52,
"img":"http://mmbiz.qpic.cn/mmbiz/4whpV1VZl29nqqObBwFwnIX3licVPnFV5uUQx7TLx4tB9qZfbe3JmqR4NkkEmpb5LUWoXF1ek9nga0IkeSSFZ8g/0"
}
]
},
"eid":4
} 数据说明
字段 说明 groups 分组列表 group_id 分组ID 分组照片(图片需调用图片上传接口获得图片Url填写至此，否则 eid 控件4的ID 控件5
控件5是由多个分组组成，展示指定分组的名称，不可与其他控件联合使用。
POST数据/UI展示
{
"group_infos":{
"groups":[
{
"group_id":43
},
{
"group_id":44
},
{
"group_id":45
},
{
"group_id":46
}
],
"img_background":"http://mmbiz.qpic.cn/mmbiz/4whpV1VZl29nqqObBwFwnIX3licVPnFV5uUQx7TLx4tB9qZfbe3JmqR4NkkEmpb5LUWoXF1ek9nga0IkeSSFZ8g/0"
},
"eid":5
}
数据说明
字段 说明 groups 分组列表 group_id 分组ID 分组照片(图片需调用图片上传接口获得图片Url填写至此，否则 eid 控件5的ID 返回数据说明
字段 说明 errcode 错误码 errmsg 错误信息 shelf_id 货架ID 删除货架
接口调用请求说明
协议 https http请求方式 POST 请求Url https://api.weixin.qq.com/merchant/shelf/del?access_token=ACCESS_TOKEN POST数据格式 json 请求参数说明
参数 是否必须 说明 access_token 是 调用接口凭证 POST数据 是 货架信息 POST数据
字段 说明 shelf_id 货架ID 返回数据说明
字段 说明 errcode 错误码 errmsg 错误信息 修改货架
协议 https http请求方式 请求Url https://api.weixin.qq.com/merchant/shelf/?access_token=ACCESS_TOKEN POST数据格式 json 参数 是否必须 说明 access_token 是 调用接口凭证 POST数据 是 货架详情信息
数据示例：
{
"shelf_id":12345,
"shelf_data":...,
"shelf_banner":"http://mmbiz.qpic.cn/mmbiz/4whpV1VZl2ibrWQn8zWFUh1YznsMV0XEiavFfLzDWYyvQOBBszXlMaiabGWzz5B2KhNn2IDemHa3iarmCyribYlZYyw/0",
"shelf_name":"测试货架"
}
字段 说明 shelf_id 货架ID 图片需调用图片上传接口获得图片Url填写至此，否则返回数据说明
字段 说明 errcode 错误码 errmsg 错误信息 获取所有货架
接口调用请求说明
协议 https http请求方式 GET 请求Url https://api.weixin.qq.com/merchant/shelf/getall?access_token=ACCESS_TOKEN 请求参数说明
参数 是否必须 说明 access_token 是 调用接口凭证 返回数据说明
字段 说明 errcode 错误码 errmsg 错误信息 所有货架集合(字段说明详见增加货架) 根据货架ID获取货架信息
接口调用请求说明
协议 https http请求方式 POST 请求Url https://api.weixin.qq.com/merchant/shelf/getbyid?access_token=ACCESS_TOKEN POST数据格式 json 请求参数说明
参数 是否必须 说明 access_token 是 调用接口凭证 POST数据 是 货架信息 POST数据
字段 说明 shelf_id 货架ID 返回数据说明
字段 说明 errcode 错误码 errmsg 错误信息 货架
functionopenProductView(){
if(typeofWeixinJSBridge=="undefined")
returnfalse;
varpid="pDF3iY_G88cM_d-wuImym3tkVfG5";//只需要传递
WeixinJSBridge.invoke(''openProductViewWithPid'',{
"pid":pid
},function(res){
//返回res.err_msg,取值
//open_product_view_with_id:ok打开成功
alert(res.err_msg);
if(res.err_msg!="open_product_view_with_id:ok"){
WeixinJSBridge.invoke(''openProductView'',{
"productInfo":"{\"product_id\":\""+pid+"\",\"product_type\":0}"
},function(res){
alert(res.err_msg);
});
}
});
}
说明：
变量pid即为在增加商品接口中获得的product_id。
订单管理接口
在用户在微信中付款成功后，微信服务器会将订单付款通知推送到开发者在公众平台网站中设置的回调URL（在开发模式中设置）中，如未设置回调URL，则获取不到该事件推送。
事件推送的内容如下：
1398144192
2
字段说明请见订单详情。
根据订单ID获取订单详情
接口调用请求说明
协议 https http请求方式 POST 请求Url https://api.weixin.qq.com/merchant//getbyid?access_token=ACCESS_TOKEN POST数据格式 json 请求参数说明
参数 是否必须 说明 access_token 是 调用接口凭证 POST数据 是 商品信息 POST数据
字段 说明 _id 订单ID 返回数据说明
id":"pDF3iYx7KDQVGzB7kDg6Tge5OKFo",
"product_name":"安莉芳E-BRA专柜女士舒适内衣蕾丝3/4薄杯聚拢上托性感文胸KB0716",
"product_price":1,
"product_sku":"10000983:10000995;10001007:10001010",
"product_count":1,
"product_img":"http://img2.paipaiimg.com/00000000/item-52B87243-63CCF66C00000000040100003565C1EA.0.300x300.jpg",
"delivery_id":"1900659372473",
"delivery_company":"059Yunda",
"trans_id":"1900000109201404103172199813"
}
}
字段 说明 errcode 错误码 errmsg 错误信息 product_id 商品ID product_name 商品名称 product_price 商品价格(单位:分) product_sku 商品SKU product_count 商品个数 product_img 商品图片 delivery_id 运单ID delivery_company 物流公司编码 trans_id 交易ID 根据订单状态/创建时间获取订单详情
接口调用请求说明
协议 https http请求方式 请求Url https://api.weixin.qq.com/merchant//getbyfilter?access_token=ACCESS_TOKEN POST数据格式 json 请求参数说明
参数 是否必须 说明 access_token 是 调用接口凭证 POST数据
字段 说明 订单状态(不带该字段-全部状态,2-待发货,3-已发货,5-已完成,8-维权中,) begintime 订单创建时间起始时间(不带该字段则不按照时间做筛选) endtime 订单创建时间终止时间(不带该字段则不按照时间做筛选) 返回数据说明
id":"pDF3iYx7KDQVGzB7kDg6Tge5OKFo",
"product_name":"安莉芳E-BRA专柜女士舒适内衣蕾丝3/4薄杯聚拢上托性感文胸KB0716",
"product_price":1,
"product_sku":"10000983:10000995;10001007:10001010",
"product_count":1,
"product_img":"http://mmbiz.qpic.cn/mmbiz/4whpV1VZl2icND8WwMThBEcehjhDv2icY4GrDSG5RLM3B2qd9kOicWGVJcsAhvXfibhWRNoGOvCfMC33G9z5yQr2Qw/0",
"delivery_id":"1900659372473",
"delivery_company":"059Yunda",
"trans_id":"1900000109201404103172199813"
},
{
"order_id":"7197417460812533569",
"order_status":8,
"order_total_price":1,
"order_create_time":1394636235,
"order_express_price":0,
"buyer_openid":"oDF3iY17NsDAW4UP2qzJXPsz1S9Q",
"buyer_nick":"likeacat",
"receiver_name":"张小猫",
"receiver_province":"广东省",
"receiver_city":"广州市",
"receiver_address":"华景路一号南方通信大厦5楼",
"receiver_mobile":"123456",
"receiver_phone":"123456",
"product_id":"pDF3iYx7KDQVGzB7kDg6Tge5OKFo",
"product_name":"项坠333",
"product_price":1,
"product_sku":"1075741873:1079742377",
"product_count":1,
"product_img":"http://mmbiz.qpic.cn/mmbiz/4whpV1VZl2icND8WwMThBEcehjhDv2icY4GrDSG5RLM3B2qd9kOicWGVJcsAhvXfibhWRNoGOvCfMC33G9z5yQr2Qw/0",
"delivery_id":"1900659372473",
"delivery_company":"059Yunda",
"trans_id":"1900000109201404103172199813"
}
]
}
字段 说明 errcode 错误码 errmsg 错误信息 所有订单集合(字段说明详见根据订单ID获取订单详情) 设置订单发货信息
接口调用请求说明
协议 https http请求方式 POST 请求Url https://api.weixin.qq.com/merchant//setdelivery?access_token=ACCESS_TOKEN POST数据格式 json 请求参数说明
参数 是否必须 说明 access_token 是 调用接口凭证 POST数据 是 商品信息 POST数据
字段 说明 _id 订单ID delivery_company 物流公司ID(参考《物流公司ID》) delivery_track_no 运单ID 返回数据说明
字段 说明 errcode 错误码 errmsg 错误信息
物流公司 ID 邮政EMS Fsearch_code 申通快递 002shentong 中通速递 066zhongtong 圆通速递 056yuantong 天天快递 042tiantian 顺丰速运 003shunfeng 韵达快运 059Yunda 宅急送 064zhaijisong 汇通快运 020huitong 易迅快递 zj001yixun
接口调用请求说明
协议 https http请求方式 POST 请求Url https://api.weixin.qq.com/merchant//close?access_token=ACCESS_TOKEN POST数据格式 json 请求参数说明
参数 是否必须 说明 access_token 是 调用接口凭证 POST数据 是 商品信息 POST数据
字段 说明 _id 订单ID 返回数据说明
字段 说明 errcode 错误码 errmsg 错误信息
功能接口
接口调用请求说明
协议 https http请求方式 POST 请求Url https://api.weixin.qq.com/merchant/common/upload_img?access_token=ACCESS_TOKEN POST数据 图片 请求参数说明
参数 是否必须 说明 access_token 是 调用接口凭证 POST数据 是 图片 返回数据说明
字段 说明 errcode 错误码 errmsg 错误信息 image_url 图片Url
-61-
|
|
