微信小店手册模板.doc

微信小店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获取全部邮费模板- 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 -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: ,property: id: ,vid: ,id: ,vid: ,id: ,vid: ,name: testaddproduct,sku_info: id: ,vid: ,main_img: , img: ,detail: text: test first,img: ,text: test again,buy_limit: 10,sku_list: sku_id: :,price: 30,icon_url: ,product_code: testing,ori_price: 9000000,quantity: 800,sku_id: :,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: 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填写至此，不然无法添加商品。图片分辨率推荐尺寸为640600)img必选商品图片列表(图片需调用图片上传接口取得图片Url填写至此，不然无法添加商品。图片分辨率推荐尺寸为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_listsku信息列表(可为多个)，每个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商家商品编码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邮费模板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.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.3.3 POST数据数据示例：product_id: pDF3iY6Kr_BV_CXaiYysoGqJhppQ, product_base: category_id: ,property: id: ,vid: ,id: ,vid: ,id: ,vid: ,name: testaddproduct,sku_info: id: ,vid: ,main_img: , img: ,detail: img: ,buy_limit: 3,sku_list: sku_id: :,price: 30,icon_url: ,product_code: testing,ori_price: 9000000,quantity: 800,sku_id: :,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: delivery_type: 0,template_id: 0, express: id: 10000027, price: 100, id: 10000028, price: 100, id: 10000029, price: 100备注： product_id表示要更新商品ID，其它字段说明请参考增加商品接口。 从未上架商品全部信息均可修改，不然商品名称(name)、商品分类(category)、商品属性(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,product_info: product_id: pDF3iY6Kr_BV_CXaiYysoGqJhppQ,product_base: name: testaddproduct,category_id: ,img: ,property: id: 品牌,vid: Fujifilm/富士,id: 屏幕尺寸,vid: 1.8英寸,id: 防抖性能,vid: CCD防抖,sku_info: id: ,vid: ,buy_limit: 10,main_img: ,detail_html: testtest again,sku_list: sku_id: :,price: 30,icon_url: ,quantity: 800,product_code: testing,ori_price: 9000000,sku_id: :,price: 30,icon_url: ,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: 字段说明errcode错误码errmsg错误信息product_info商品详情(字段说明详见增加商品)1.5 获取指定状态全部商品1.5.1 接口调用请求说明协议httpshttp请求方法POST请求Url1.5.2 请求参数说明参数是否必需说明access_token是调用接口凭证POST数据是商品详情信息1.5.3 POST数据数据示例： status: 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-mql6CncpbVajaB_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 返回数听说明数据示例： 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: 字段说明cate_id大分类ID(根节点分类id为1)1.7.4 返回数听说明数据示例： errcode: 0, errmsg: success, cate_list: id: , name: 数码相机 , id: , name: 家用摄像机 , id: , name: 单反相机 , id: , name: 镜头 , id: 53710, 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_id: 字段说明cate_id商品子分类ID1.8.4 返回数听说明数据示例： errcode: 0, errmsg: success, sku_table: id: , name: 颜色, value_list: id: , name: 撞色 , id: , name: 桔色 字段说明errcode错误码errmsg错误信息sku_tablesku列表idsku idnamesku 名称value_listsku vid列表idvidnamevid名称1.9 获取指定分类全部属性1.9.1 接口调用请求说明协议httpshttp请求方法POST请求Url1.9.2 请求参数说明参数是否必需说明access_token是调用接口凭证POST数据是商品分类信息1.9.3 POST数据数据示例： cate_id: 字段说明cate_id分类ID1.9.4 返回数听说明数据示例： errcode: 0, errmsg: success, properties: id: , name: 品牌, property_value: id: 50867, name: VIC& , id: 50868, name: Kate& , id: 50971, name: M& , id: 50972, name: Black& , id: , 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字段说明product_id商品IDsku_infosku信息,格式id1:vid1;id2:vid2,如商品为统一规格，则此处赋值为空字符串即可quantity增加库存数量2.1.4 返回数听说明数据示例： errcode:0,errmsg:success字段说明errcode错误码errmsg错误信息2.2 降低库存2.2.1 接口调用请求说明协议httpshttp请求方法POST请求UrlPOST数据格式json2.2.2 请求参数说明参数是否必需说明access_token是调用接口凭证POST数据是商品库存信息2.2.3 POST数据数据示例： product_id: pDF3iY5EYkMxs4-tF8xedyES5GQI, sku_info: 10000983:10000995;10001007:10001010, quantity: 20字段说明product_id商品IDsku_infosku信息, 格式id1:vid1;id2:vid2quantity降低库存数量2.2.4 返回数听说明数据示例： errcode:0,errmsg:success字段说明errcode错误码errmsg错误信息3. 邮费模板管理接口3.1 增加邮费模板3.1.1 接口调用请求说明协议httpshttp请求方法POST请求UrlPOST数据格式json3.1.2 请求参数说明参数是否必需说明access_token是公众号调用接口凭证POST数据是邮费信息3.1.3 POST数据数据示例：delivery_template: Name: testexpress, Assumer: 0, Valuation: 0, TopFee: Type: 10000027, Normal: StartStandards: 1, StartFees: 2, AddStandards: 3,AddFees: 1, Custom: StartStandards: 1, StartFees: 100, AddStandards: 1,AddFees: 3, DestCountry: 中国, DestProvince: 广东省, DestCity: 广州市, Type: 10000028, Normal: StartStandards: 1, StartFees: 3, AddStandards: 3,AddFees: 2, Custom: StartStandards: 1, StartFees: 10, AddStandards: 1,AddFees: 30, DestCountry: 中国, DestProvince: 广东省, DestCity: 广州市, Type: 10000029, Normal: StartStandards: 1, StartFees: 4, AddStandards: 3,AddFees: 3, Custom: StartStandards: 1, StartFees: 8, AddStandards: 2,AddFees: 11, DestCountry: 中国, DestProvince: 广东省, DestCity: 广州市字段说明Name邮费模板名称Assumer支付方法(0-买家负担运费, 1-卖家负担运费)Valuation计费单位(0-按件计费, 1-按重量计费, 2-按体积计费，现在只支持按件计费，默认为0)TopFee具体运费计算Type快递类型ID(参见增加商