《微信小店API手册v17.docx》由会员分享，可在线阅读，更多相关《微信小店API手册v17.docx（75页珍藏版）》请在三一办公上搜索。
1、微信小店API手册V1.17目录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获
2、取所有邮费模板- 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根据订单状态/创建时间获取订单详情
3、- 65 -6.4设置订单发货信息- 68 -6.5关闭订单- 69 -7.功能接口- 71 -7.1上传图片- 71 -1. 商品管理接口1.1 增加商品1.1.1 接口调用请求说明协议httpshttp请求方式POST请求UrlPOST数据格式json1.1.2 请求参数说明参数是否必须说明access_token是公众号的调用接口凭证，由access_token生成接口获得POST数据是商品详细信息1.1.3 POST数据数据示例：product_base: category_id: 537074298,property: id: 1075741879,vid: 1079749967,i
4、d: 1075754127,vid: 1079795198,id: 1075777334,vid: 1079837440,name: testaddproduct,sku_info: id: 1075741873,vid: 1079742386,1079742363,main_img: img: ,detail: text: test first,img: ,text: test again,buy_limit: 10,sku_list: sku_id: 1075741873:1079742386,price: 30,icon_url: product_code: testing,ori_pr
5、ice: 9000000,quantity: 800,sku_id: 1075741873:1079742363,price: 30,icon_url: 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: deli
6、very_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填写至此，否则无法添加商品。图片分辨率推荐尺寸为640600)img必选商品图片列表(图片需调用图片上传接口获得图片Url填写至此，否则无法添加商品。图片分辨率推荐
7、尺寸为640600)detail必选商品详情列表，显示在客户端的商品详情页内text文字描述img图片(图片需调用图片上传接口获得图片Url填写至此，否则无法添加商品)property商品属性列表，属性列表请通过获取指定分类的所有属性获取id属性idvid属性值idsku_info商品sku定义，SKU列表请通过获取指定子分类的所有SKU获取idsku属性(SKU列表中id, 支持自定义SKU，格式为$xxx，xxx即为显示在客户端中的字符串)vidsku值(SKU列表中vid, 如需自定义SKU，格式为$xxx，xxx即为显示在客户端中的字符串)buy_limit用户商品限购数量sku_li
8、stsku信息列表(可为多个)，每个sku信息串即为一个确定的商品，比如白色的37码的鞋子sku_idsku信息, 参照上述sku_table的定义; 格式 : id1:vid1;id2:vid2规则 : id_info的组合个数必须与sku_table个数一致(若商品无sku信息, 即商品为统一规格，则此处赋值为空字符串即可)ori_pricesku原价(单位 : 分)pricesku微信价(单位 : 分, 微信价必须比原价小, 否则添加商品失败)icon_urlsku iconurl(图片需调用图片上传接口获得图片Url)quantitysku库存product_code商家商品编码att
9、rext商品其他属性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_i
10、d代表的邮费模板, 详见邮费模板相关API)template_id邮费模板IDexpressid快递IDprice运费(单位 : 分)1.1.4 返回数据说明数据示例： errcode: 0, errmsg: success, product_id: pDF3iYwktviE3BzU3BKiSWWi9Nkw字段说明errcode错误码errmsg错误信息product_id商品ID1.1.5 附：快递列表id说明10000027平邮10000028快递10000029EMS1.2 删除商品1.2.1 接口调用请求说明协议httpshttp请求方式POST请求UrlPOST数据格式json1.2
11、.2 请求参数说明参数是否必须说明access_token是调用接口凭证POST数据是商品信息1.2.3 POST数据数据示例： product_id: pDF3iYwktviE3BzU3BKiSWWi9Nkw字段说明product_id商品ID1.2.4 返回数据说明数据示例： errcode:0,errmsg:success字段说明errcode错误码errmsg错误信息1.3 修改商品1.3.1 接口调用请求说明协议httpshttp请求方式POST请求UrlPOST数据格式json1.3.2 请求参数说明参数是否必须说明access_token是调用接口凭证POST数据是商品详情信息1
12、.3.3 POST数据数据示例：product_id: pDF3iY6Kr_BV_CXaiYysoGqJhppQ, 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: img: ,detail: img:
13、,buy_limit: 3,sku_list: sku_id: 1075741873:1079742386,price: 30,icon_url: product_code: testing,ori_price: 9000000,quantity: 800,sku_id: 1075741873:1079742363,price: 30,icon_url: product_code: testingtesting,ori_price: 9000000,quantity: 800,attrext: location: country: 中国,province: 广东省,city: 广州市,addr
14、ess: 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备注： product_id表示要更新的商品的ID，其他字段说明请参考增加商品接口。 从未上架的商品所有信息均可修改，否则商品的名称(name)、商品分类(catego
15、ry)、商品属性(property)这三个字段不可修改。1.3.4 返回数据说明数据示例： errcode:0,errmsg:success字段说明errcode错误码errmsg错误信息1.4 查询商品1.4.1 接口调用请求说明协议httpshttp请求方式GET请求Url1.4.2 请求参数说明参数是否必须说明access_token是调用接口凭证1.4.3 POST数据数据示例： product_id: pDF3iYwktviE3BzU3BKiSWWi9Nkw字段说明product_id商品ID1.4.4 返回数据说明数据示例：errcode: 0,errmsg: success,pr
16、oduct_info: product_id: pDF3iY6Kr_BV_CXaiYysoGqJhppQ,product_base: name: testaddproduct,category_id: 537074298,img: ,property: id: 品牌,vid: Fujifilm/富士,id: 屏幕尺寸,vid: 1.8英寸,id: 防抖性能,vid: CCD防抖,sku_info: id: 1075741873,vid: 1079742386,1079742363,buy_limit: 10,main_img: detail_html: testtest again,sku_l
17、ist: sku_id: 1075741873:1079742386,price: 30,icon_url: quantity: 800,product_code: testing,ori_price: 9000000,sku_id: 1075741873:1079742363,price: 30,icon_url: quantity: 800,product_code: testingtesting,ori_price: 9000000,attrext: isPostFree: 0,isHasReceipt: 1,isUnderGuaranty: 0,isSupportReplace: 0,
18、location: country: 中国,province: 广东省,city: 广州市,address: T.I.T创意园, delivery_info: delivery_type: 1,template_id: 103312920字段说明errcode错误码errmsg错误信息product_info商品详情(字段说明详见增加商品)1.5 获取指定状态的所有商品1.5.1 接口调用请求说明协议httpshttp请求方式POST请求Url1.5.2 请求参数说明参数是否必须说明access_token是调用接口凭证POST数据是商品详情信息1.5.3 POST数据数据示例： status
19、: 0字段说明status商品状态(0-全部, 1-上架, 2-下架)1.5.4 返回数据说明数据示例： errcode: 0, errmsg: success, products_info: product_base: ., sku_list: ., attrext: ., delivery_info: ., product_id: pDF3iY-mql6CncpbVajaB_obC3Bk, status: 1 , product_base: ., sku_list: ., attrext: ., delivery_info: ., product_id: pDF3iY-mql6CncpbV
20、ajaB_obC321, status: 1 字段说明errcode错误码errmsg错误信息products_info指定状态下的所有商品集合1.6 商品上下架1.6.1 接口调用请求说明协议httpshttp请求方式POST请求Url1.6.2 请求参数说明参数是否必须说明access_token是调用接口凭证POST数据是商品详情信息1.6.3 POST数据数据示例： product_id: p0FfkjnSNm4NQj0_4a9l9MtRRxzA, status: 0字段说明product_id商品IDstatus商品上下架标识(0-下架, 1-上架)1.6.4 返回数据说明数据示例：
21、 errcode:0,errmsg:success字段说明errcode错误码errmsg错误信息1.7 获取指定分类的所有子分类1.7.1 接口调用请求说明协议httpshttp请求方式POST请求Url1.7.2 请求参数说明参数是否必须说明access_token是调用接口凭证POST数据是商品大分类信息1.7.3 POST数据数据示例： cate_id: 537874913字段说明cate_id大分类ID(根节点分类id为1)1.7.4 返回数据说明数据示例： errcode: 0, errmsg: success, cate_list: id: 537074292, name: 数码
22、相机 , id: 537074293, name: 家用摄像机 , id: 537074298, name: 单反相机 , id: 537082412, name: 镜头 , id: 537102001, name: 单电/微单 字段说明errcode错误码errmsg错误信息cate_list子分类列表id子分类IDname子分类名称1.8 获取指定子分类的所有SKU1.8.1 接口调用请求说明协议httpshttp请求方式POST请求Url1.8.2 请求参数说明参数是否必须说明access_token是调用接口凭证POST数据是商品子分类信息1.8.3 POST数据数据示例： cate_
23、id: 537074292字段说明cate_id商品子分类ID1.8.4 返回数据说明数据示例： errcode: 0, errmsg: success, sku_table: id: 1075741873, name: 颜色, value_list: id: 1079742375, name: 撞色 , id: 1079742376, name: 桔色 字段说明errcode错误码errmsg错误信息sku_tablesku列表idsku idnamesku 名称value_listsku vid列表idvidnamevid名称1.9 获取指定分类的所有属性1.9.1 接口调用请求说明协议h
24、ttpshttp请求方式POST请求Url1.9.2 请求参数说明参数是否必须说明access_token是调用接口凭证POST数据是商品分类信息1.9.3 POST数据数据示例： cate_id: 537072692字段说明cate_id分类ID1.9.4 返回数据说明数据示例： errcode: 0, errmsg: success, properties: id: 1075741879, name: 品牌, property_value: id: 200050867, name: VIC& , id: 200050868, name: Kate& , id: 20005097
25、1, name: M& , id: 200050972, name: Black& , id: 123456789, name: 颜色, property_value: . 字段说明errcode错误码errmsg错误信息properties属性列表id属性idname属性名称property_value属性值id属性值idname属性值名称2. 库存管理接口2.1 增加库存2.1.1 接口调用请求说明协议httpshttp请求方式POST请求UrlPOST数据格式json2.1.2 请求参数说明参数是否必须说明access_token是公众号的调用接口凭证POST数据是商品库存信息2.1.3 POST数据数据示例： product_id: pDF3iY5EYkMxs4-tF8xedyES5GQI, sku_info: 10000983:10000995;10001007:10001010, quantity: 20
