微信小店手册模板.doc
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、 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获取分组信息
3、 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 上传图片
4、 - 71 - 1. 商品管理接口 1.1 增加商品 1.1.1 接口调用请求说明 协议 https http请求方法 POST 请求Url POST数据格式 json 1.1.2 请求参数说明 参数 是否必需 说明 access_token 是 公众号调用接口凭证，由access_token生成接口取得 POST数据 是 商品具体信息 1.1.3 POST数据 数据示例： { "product_base": { "catego
5、ry_id": [ "" ], "property": [ { "id": "", "vid": "" }, { "id": "", "vid": "" }, { "id": "", "vid": "" } ], "name": "testaddproduct", "sku_info": [ { "id": "", "vid": [ "", "" ] } ], "mai
6、n_img": "", "img": [ "" ], "detail": [ { "text": "test first" }, { "img": "" }, { "text": "test again" } ], "buy_limit": 10 }, "sku_list": [ { "sku_id": ":", "price": 30, "icon_url": "", "product_code": "testing",
7、"ori_price": 9000000, "quantity": 800 }, { "sku_id": ":", "price": 30, "icon_url": "", "product_code": "testingtesting", "ori_price": 9000000, "quantity": 800 } ], "attrext": { "location": { "country": "中国", "province": "广东省", "city": "广州市",
8、 "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, "pri
9、ce": 100 }, { "id": 10000029, "price": 100 } ] } } 字段 是否必选 说明 base_attr 基础属性 name 必选 商品名称 category 必选 商品分类id，商品分类列表请经过《获取指定分类全部子分类》获取 main_img 必选 商品主图(图片需调用图片上传接口取得图片Url填写至此，不然无法添加商品。图片分辨率推荐尺寸为640×600) img 必选 商品图片列表(图片需调用图片上传接口取得图片Url填写至此，不然无法添加商品。图
10、片分辨率推荐尺寸为640×600) detail 必选 商品详情列表，显示在用户端商品详情页内 text 文字描述 img 图片(图片需调用图片上传接口取得图片Url填写至此，不然无法添加商品) property 商品属性列表，属性列表请经过《获取指定分类全部属性》获取 id 属性id vid 属性值id sku_info 商品sku定义，SKU列表请经过《获取指定子分类全部SKU》获取 id sku属性(SKU列表中id, 支持自定义SKU，格式为"$xxx"，xxx即为显示在用户端中字符串) vid sku值
11、SKU列表中vid, 如需自定义SKU，格式为"$xxx"，xxx即为显示在用户端中字符串) buy_limit 用户商品限购数量 sku_list sku信息列表(可为多个)，每个sku信息串即为一个确定商品，比如白色37码鞋子 sku_id sku信息, 参考上述sku_table定义; 格式 : "id1:vid1;id2:vid2" 规则 : id_info组合个数必需和sku_table个数一致(若商品无sku信息, 即商品为统一规格，则此处赋值为空字符串即可) ori_price sku原价(单位 : 分) price sku微信
12、价(单位 : 分, 微信价必需比原价小, 不然添加商品失败) icon_url sku iconurl(图片需调用图片上传接口取得图片Url) quantity sku库存 product_code 商家商品编码 attrext 商品其它属性 isPostFree 是否包邮(0-否, 1-是), 假如包邮delivery_info字段可省略 isHasReceipt 是否提供发票(0-否, 1-是) isUnderGuaranty 是否保修(0-否, 1-是) isSupportReplace 是否支持退换货(0-否, 1-是
13、) location 商品所在地地址 country 国家(详见《地域列表》说明) province 省份(详见《地域列表》说明) city 城市(详见《地域列表》说明) address 地址 delivery_info 必选 运费信息 delivery_type 运费类型(0-使用下面express字段默认模板, 1-使用template_id代表邮费模板, 详见邮费模板相关API) template_id 邮费模板ID express id 快递ID price 运费(单位 : 分) 1.
14、1.4 返回数听说明 数据示例： { "errcode": 0, "errmsg": "success", "product_id": "pDF3iYwktviE3BzU3BKiSWWi9Nkw" } 字段 说明 errcode 错误码 errmsg 错误信息 product_id 商品ID 1.1.5 附：快递列表 id 说明 10000027 平邮 10000028 快递 10000029 EMS 1.2 删除商品 1.2.1 接口调用请求说明 协议 https http请求方法 POST 请求Url
15、 POST数据格式 json 1.2.2 请求参数说明 参数 是否必需 说明 access_token 是 调用接口凭证 POST数据 是 商品信息 1.2.3 POST数据 数据示例： { "product_id": "pDF3iYwktviE3BzU3BKiSWWi9Nkw" } 字段 说明 product_id 商品ID 1.2.4 返回数听说明 数据示例： { "errcode":0, "errmsg":"success" } 字段 说明 errcode 错误码 errmsg 错误信息 1.3 修改商品
16、 1.3.1 接口调用请求说明 协议 https http请求方法 POST 请求Url POST数据格式 json 1.3.2 请求参数说明 参数 是否必需 说明 access_token 是 调用接口凭证 POST数据 是 商品详情信息 1.3.3 POST数据 数据示例： { "product_id": "pDF3iY6Kr_BV_CXaiYysoGqJhppQ", "product_base": { "category_id": [ "" ], "property": [ { "id":
17、"", "vid": "" }, { "id": "", "vid": "" }, { "id": "", "vid": "" } ], "name": "testaddproduct", "sku_info": [ { "id": "", "vid": [ "", "" ] } ], "main_img": "", "img": [ "" ], "detail": [
18、{ "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": "testin
19、gtesting", "ori_price": 9000000, "quantity": 800 } ], "attrext": { "location": { "country": "中国", "province": "广东省", "city": "广州市", "address": "T.I.T创意园" }, "isPostFree": 0, "isHasReceipt": 1, "isUnderGuaranty": 0, "isSupportReplace": 0 }, "delive
20、ry_info": { "delivery_type": 0, "template_id": 0, "express": [ { "id": 10000027, "price": 100 }, { "id": 10000028, "price": 100 }, { "id": 10000029, "price": 100 } ] } } 备注： product_id表示要更新商品ID，其它字段说明请参考增加商品接口。 从未上架商品全部信
21、息均可修改，不然商品名称(name)、商品分类(category)、商品属性(property)这三个字段不可修改。 1.3.4 返回数听说明 数据示例： { "errcode":0, "errmsg":"success" } 字段 说明 errcode 错误码 errmsg 错误信息 1.4 查询商品 1.4.1 接口调用请求说明 协议 https http请求方法 GET 请求Url 1.4.2 请求参数说明 参数 是否必需 说明 access_token 是 调用接口凭证 1.4.3 POST数据 数据示例： {
22、 "product_id": "pDF3iYwktviE3BzU3BKiSWWi9Nkw" } 字段 说明 product_id 商品ID 1.4.4 返回数听说明 数据示例： { "errcode": 0, "errmsg": "success", "product_info": { "product_id": "pDF3iY6Kr_BV_CXaiYysoGqJhppQ", "product_base": { "name": "testaddproduct", "category_id": [ ], "i
23、mg": [ "" ], "property": [ { "id": "品牌", "vid": "Fujifilm/富士" }, { "id": "屏幕尺寸", "vid": "1.8英寸" }, { "id": "防抖性能", "vid": "CCD防抖" } ], "sku_info": [ { "id": "", "vid": [ "", ""
test
test again
" }, "sku_list": [ { "sku_id": ":", "price": 30, "icon_url": "", "quantity": 800, "prod
