微信小店API手册8262.docx
微信小店店APII手册V11.177目录1.商品品管理接接口- 1 -1.1增增加商品品- 11 -1.2删删除商品品- 66 -1.3修修改商品品- 77 -1.4查查询商品品- 110 -1.5获获取指定定状态的的所有商商品- 一三 -1.6商商品上下下架- 14 -1.7获获取指定定分类的的所有子子分类- 一五五 -1.8获获取指定定子分类类的所有有SKUU- 116 -1.9获获取指定定分类的的所有属属性- 一八 -2.库存存管理接接口- 21 -2.1增增加库存存- 221 -2.2减减少库存存- 222 -3.邮费费模板管管理接口口- 224 -3.1增增加邮费费模板- 244 -3.2删删除邮费费模板- 355 -3.3修修改邮费费模板- 366 -3.4获获取指定定ID的邮邮费模板板- 337 -3.5获获取所有有邮费模模板- 39 -4.分组组管理接接口- 41 -4.1增增加分组组- 441 -4.2删删除分组组- 442 -4.3修修改分组组属性- 433 -4.4修修改分组组商品- 444 -4.5获获取所有有分组- 455 -4.6根根据分组组ID获取取分组信信息- 46 -5.货架架管理接接口- 48 -5.1增增加货架架- 448 -5.2删删除货架架- 556 -5.3修修改货架架- 557 -5.4获获取所有有货架- 588 -5.5根根据货架架ID获取取货架信信息- 60 -5.6开开发者将自自己的页页面作为为货架- 611 -6.订单单管理接接口- 63 -6.1订订单付款款通知- 633 -6.2根根据订单单ID获取取订单详详情- 633 -6.3根根据订单单状态/创建时时间获取取订单详详情- 65 -6.4设设置订单单发货信信息- 68 -6.5关关闭订单单- 669 -7.功能能接口- 711 -7.1上上传图片片- 771 -1. 商品管理理接口1.1 增加商品品1.1.1 接口调用用请求说说明协议httppshttpp请求方方式POSTT请求Urrlhttpps:/appi.wweixxin.qqxx/meerchhantt/crreatte?aacceess_tokken=ACCCESSS_TOOKENNPOSTT数据格格式jsonn1.1.2 请求参数数说明参数是否必须须说明acceess_tokken是公众号的的调用接接口凭证证，由acccesss_ttokeen生成成接口获获得POSTT数据是商品详细细信息1.1.3 POSTT数据数据示例例："prroduuct_basse": "caateggoryy_idd": "533707742998","prooperrty"": "idd": "10075774一八八79"","viid": "11079974999677","idd": "1007577541127"","viid": "11079979551988","idd": "1007577773334"","viid": "11079983774400","naame"": ""tesstadddprroduuct"","skku_iinfoo": "id"": ""10775744一八733","viid": "1007977423386"","1007977423363"","maain_imgg": "xmmmbiiz.qqpiccx/mmmbiiz/44whppV1VVZl22icccsvYYbHvvnphhkyGGtnvvjD33ulEEKoggfsiiauaa49ppvLffUS88Ym00GSYYjViiaLiic0FFD3vvN0VV8PIILciibEGGb2ffPfEEOmww/0"", "immg": "xmmmbiiz.qqpiccx/mmmbiiz/44whppV1VVZl22icccsvYYbHvvnphhkyGGtnvvjD33ulEEKoggfsiiauaa49ppvLffUS88Ym00GSYYjViiaLiic0FFD3vvN0VV8PIILciibEGGb2ffPfEEOmww/0"","deetaiil": "teext"": ""tesst ffirsst","immg": "xxmmbbiz.qpiicx/mmbbiz/4whhpV11VZll2icccsvvYbHHvnpphkyyGtnnvjDD3ull1UccLcwwxrFFdwTTKYhhH9QQ5YZZoCffX4NNcx6655ZZK6iibnllibCCCErrbKQQtReeySaaVA/0","teext"": ""tesst aagaiin","buuy_llimiit": 100,"skku_llistt": "skku_iid": "11075574一一八733:1007977423386"","prricee": 30,"iccon_urll": "xmmmbiiz.qqpiccx/mmmbiiz/44whppV1VVZl228bJJj622XgffHPiibY33ORKKicNN1oJJ4CccoIrr4BMMbfAA8LqqyyjjzOZZzqrrOGzz3f55KWqq1QGGP3ffo6TTOTSSYD33TBQQjuww/0"","prroduuct_codde": "ttesttingg","orri_ppricce": 900000000,"quuanttityy": 8000,"skku_iid": "11075574一一八733:1007977423363"","prricee": 30,"iccon_urll": "xmmmbiiz.qqpiccx/mmmbiiz/44whppV1VVZl228bJJj622XgffHPiibY33ORKKicNN1oJJ4CccoIrr4BMMbfAA8LqqyyjjzOZZzqrrOGzz3f55KWqq1QGGP3ffo6TTOTSSYD33TBQQjuww/0"","prroduuct_codde": "ttesttinggtesstinng","orri_ppricce": 900000000,"quuanttityy": 8000,"atttreext"": "loocattionn": "coounttry"": ""中国","prroviincee": "广东东省","ciity"": ""广州市市","adddreess"": ""T.II.T创创意园"","issPosstFrree"": 00,"issHassRecceippt": 1,"issUndderGGuarrantty": 0,"issSuppporrtReeplaace"": 00,"deelivveryy_innfo"": "delliveery_typpe": 0,"teempllatee_idd": 0, "exxpreess"": "idd": 1000000027, "prricee": 1000, "idd": 1000000028, "prricee": 1000, "idd": 1000000029, "prricee": 1000字段是否必选选说明basee_atttr基本属性性namee必选商品名称称cateegorry必选商品分类类id，商品分分类列表表请通过过获取取指定分分类的所所有子分分类获获取mainn_immg必选商品主图图(图片需需调用图图片上传传接口获获得图片片Urll填写至至此，否否则无法法添加商商品。图图片分辨辨率推荐荐尺寸为为6400×6000)img必选商品图片片列表(图片需需调用图图片上传传接口获获得图片片Urll填写至至此，否否则无法法添加商商品。图图片分辨辨率推荐荐尺寸为为6400×6000)detaail必选商品详情情列表，显显示在客客户端的的商品详详情页内内textt文字描述述img图片(图图片需调调用图片片上传接接口获得得图片UUrl填填写至此此，否则则无法添添加商品品)proppertty商品属性性列表，属属性列表表请通过过获取取指定分分类的所所有属性性获取取id属性iddvid属性值iidsku_inffo商品skku定义义，SKUU列表请请通过获取指定子分类的所有SKU获取idsku属属性(SSKU列列表中iid, 支持自自定义SSKU，格格式为""$xxxx"，xxxx即为显显示在客客户端中中的字符符串)vidsku值值(SKKU列表表中viid, 如需自自定义SSKU，格格式为""$xxxx"，xxxx即为显显示在客客户端中中的字符符串)buy_limmit用户商品品限购数数量sku_lisstsku信信息列表表(可为多个个)，每个个skuu信息串串即为一一个确定定的商品品，比如如白色的的37码的的鞋子sku_idsku信信息, 参照上上述skku_ttablle的定定义; 格式 : "iid1:vidd1;iid2:vidd2"规则 : idd_innfo的的组合个个数必须须与skku_ttablle个数数一致(若商品品无skku信息息, 即商商品为统统一规格格，则此此处赋值值为空字字符串即即可)ori_priicesku原原价(单位 : 分)priccesku微微信价(单位 : 分, 微信信价必须须比原价价小, 否则添添加商品品失败)iconn_urrlskuiiconnurll(图片需需调用图图片上传传接口获获得图片片Urll)quanntittysku库库存prodductt_coode商家商品品编码attrrextt商品其他他属性isPoostFFreee是否包邮邮(0-否, 11-是), 如果包包邮deelivveryy_innfo字字段可省省略isHaasReeceiipt是否提供供发票(0-否否, 11-是)isUnnderrGuaarannty是否保修修(0-否, 11-是)isSuuppoortRRepllacee是否支持持退换货货(0-否, 11-是)locaatioon商品所在在地地址址counntryy国家(详详见地地区列表表说明明)provvincce省份(详详见地地区列表表说明明)cityy城市(详详见地地区列表表说明明)addrresss地址deliiverry_iinfoo必选运费信息息deliiverry_ttypee运费类型型(0-使用下下面exxpreess字字段的默默认模板板, 11-使用用temmplaate_id代代表的邮邮费模板板, 详见见邮费模模板相关关APII)tempplatte_iid邮费模板板IDexprresssid快递IDDpricce运费(单单位 : 分)1.1.4 返回数据据说明数据示例例： "errrcoode"": 00, "errrmssg": "ssucccesss", "prroduuct_id"": ""pDFF3iYYwkttviEE3BzzU3BBKiSSWWii9Nkkw"字段说明errccodee错误码errmmsg错误信息息prodductt_idd商品IDD1.1.5 附：快递递列表id说明1000000227平邮1000000228快递1000000229EMS1.2 删除商品品1.2.1 接口调用用请求说说明协议httppshttpp请求方方式POSTT请求Urrlhttpps:/appi.wweixxin.qqxx/meerchhantt/deel?aacceess_tokken=ACCCESSS_TOOKENNPOSTT数据格格式jsonn1.2.2 请求参数数说明参数是否必须须说明acceess_tokken是调用接口口凭证POSTT数据是商品信息息1.2.3 POSTT数据数据示例例： "prroduuct_id"": ""pDFF3iYYwkttviEE3BzzU3BBKiSSWWii9Nkkw"字段说明prodductt_idd商品IDD1.2.4 返回数据据说明数据示例例： "errrcoode"":0,"errrmsgg":""succcesss"字段说明errccodee错误码errmmsg错误信息息1.3 修改商品品1.3.1 接口调用用请求说说明协议httppshttpp请求方方式POSTT请求Urrlhttpps:/appi.wweixxin.qqxx/meerchhantt/uppdatte?aacceess_tokken=ACCCESSS_TOOKENNPOSTT数据格格式jsonn1.3.2 请求参数数说明参数是否必须须说明acceess_tokken是调用接口口凭证POSTT数据是商品详情情信息1.3.3 POSTT数据数据示例例："prooducct_iid": "ppDF33iY66Kr_BV_CXaaiYyysoGGqJhhppQQ", "prroduuct_basse": "caateggoryy_idd": "533707742998","prropeertyy": "idd": "10075774一八八79"","viid": "11079974999677","idd": "1007577541127"","viid": "11079979551988","id"": ""1077577773334","viid": "11079983774400","naame"": ""tesstadddprroduuct"","skku_iinfoo": "idd": "10075774一八八73"","viid": "1007977423386"","1007977423363"","maiin_iimg"": ""xmmmbizz.qppicxx/mmmbizz/4wwhpVV1VZZl2iiccssvYbbHvnnphkkyGttnvjjD3uulEKKogffsiaaua449pvvLfUUS8YYm0GGSYjjViaaLicc0FDD3vNN0V88PILLcibbEGbb2fPPfEOOmw/0", "immg": "xmmmbiiz.qqpiccx/mmmbiiz/44whppV1VVZl22icccsvYYbHvvnphhkyGGtnvvjD33ulEEKoggfsiiauaa49ppvLffUS88Ym00GSYYjViiaLiic0FFD3vvN0VV8PIILciibEGGb2ffPfEEOmww/0"","deetaiil": "immg": "xxmmbbiz.qpiicx/mmbbiz/4whhpV11VZll2icccsvvYbHHvnpphkyyGtnnvjDD3ull1UccLcwwxrFFdwTTKYhhH9QQ5YZZoCffX4NNcx6655ZZK6iibnllibCCCErrbKQQtReeySaaVA/0","buuy_llimiit": 3,"skku_llistt": "skku_iid": "11075574一一八733:1007977423386"","prricee": 30,"iccon_urll": "xmmmbiiz.qqpiccx/mmmbiiz/44whppV1VVZl22icccsvYYbHvvnphhkyGGtnvvjD33ulEEKoggfsiiauaa49ppvLffUS88Ym00GSYYjViiaLiic0FFD3vvN0VV8PIILciibEGGb2ffPfEEOmww/0"","prroduuct_codde": "ttesttingg","orri_ppricce": 900000000,"quuanttityy": 8000,"skku_iid": "11075574一一八733:1007977423363"","prricee": 30,"iccon_urll": "xmmmbiiz.qqpiccx/mmmbiiz/44whppV1VVZl228bJJj622XgffHPiibY33ORKKicNN1oJJ4CccoIrr4BMMbfAA8LqqyyjjzOZZzqrrOGzz3f55KWqq1QGGP3ffo6TTOTSSYD33TBQQjuww/0"","prroduuct_codde": "ttesttinggtesstinng","orri_ppricce": 900000000,"quuanttityy": 8000,"atttreext"": "loocattionn": "coounttry"": ""中国","prroviincee": "广东东省","ciity"": ""广州市市","adddreess"": ""T.II.T创创意园"","issPosstFrree"": 00,"issHassRecceippt": 1,"issUndderGGuarrantty": 0,"issSuppporrtReeplaace"": 00,"deelivveryy_innfo"": "deelivveryy_tyype"": 00,"teempllatee_idd": 0, "exxpreess"": "id"": 11000000227, "prricee": 1000, "idd": 1000000028, "prricee": 1000, "idd": 1000000029, "prricee": 1000备注： prroduuct_id表表示要更更新的商商品的IID，其其他字段段说明请请参考增增加商品品接口。从未上上架的商商品所有有信息均均可修改改，否则则商品的的名称(namme)、商商品分类类(caateggoryy)、商商品属性性(prropeertyy)这三三个字段段不可修修改。1.3.4 返回数据据说明数据示例例： "errrcoode"":0,"errrmsgg":""succcesss"字段说明errccodee错误码errmmsg错误信息息1.4 查询商品品1.4.1 接口调用用请求说说明协议httppshttpp请求方方式GET请求Urrlhttpps:/appi.wweixxin.qqxx/meerchhantt/geet?aacceess_tokken=ACCCESSS_TOOKENN1.4.2 请求参数数说明参数是否必须须说明acceess_tokken是调用接口口凭证1.4.3 POSTT数据数据示例例： "prroduuct_id"": ""pDFF3iYYwkttviEE3BzzU3BBKiSSWWii9Nkkw"字段说明prodductt_idd商品IDD1.4.4 返回数据据说明数据示例例："errrcoode"": 00,"errrmssg": "ssucccesss","prroduuct_inffo": "prroduuct_id"": ""pDFF3iYY6Krr_BVV_CXXaiYYysooGqJJhpppQ","prroduuct_basse": "naame"": ""tesstadddprroduuct"","caateggoryy_idd": 537707442988,"immg": "xmmmbiiz.qqpiccx/mmmbiiz/44whppV1VVZl22icccsvYYbHvvnphhkyGGtnvvjD33ulEEKoggfsiiauaa49ppvLffUS88Ym00GSYYjViiaLiic0FFD3vvN0VV8PIILciibEGGb2ffPfEEOmww/0"","prropeertyy": "idd": "品牌牌","viid": "FFujiifillm/富士","idd": "屏幕幕尺寸"","viid": "11.8英英寸","idd": "防抖抖性能"","viid": "CCCD防防抖","skku_iinfoo": "idd": "10075774一八八73"","viid": "1007977423386"","1007977423363"","buyy_liimitt": 10,"maain_imgg": "xmmmbiiz.qqpiccx/mmmbiiz/44whppV1VVZl22icccsvYYbHvvnphhkyGGtnvvjD33ulEEKoggfsiiauaa49ppvLffUS88Ym00GSYYjViiaLiic0FFD3vvN0VV8PIILciibEGGb2ffPfEEOmww/0"","deetaiil_hhtmll": "<ddiv claass="iitemm_piic_wwrp" sstylle="maargiin-bbotttom:8pxx;foont-sizze:00;""><iimg claass="iitemm_piic"" sttylee=""widdth:1000%;" aalt="" ssrc="xxmmbbiz.qpiicx/mmbbiz/4whhpV11VZll2icccsvvYbHHvnpphkyyGtnnvjDD3ullEKoogfssiauua499pvLLfUSS8Ymm0GSSYjVViaLLic00FD33vN00V8PPILccibEEGb22fPffEOmmw/00" ></divv><pp sttylee=""marrginn-boottoom:111pxx;maargiin-ttop:11ppx;">ttestt</pp><ddiv claass="iitemm_piic_wwrp" sstylle="maargiin-bbotttom:8pxx;foont-sizze:00;""><iimg claass="iitemm_piic"" sttylee=""widdth:1000%;" aalt="" ssrc="xxmmbbiz.qpiicx/mmbbiz/4whhpV11VZll2icccsvvYbHHvnpphkyyGtnnvjDD3ull1UccLcwwxrFFdwTTKYhhH9QQ5YZZoCffX4NNcx6655ZZK6iibnllibCCCErrbKQQtReeySaaVA/0"" ><</diiv><<p sstylle="maargiin-bbotttom:11ppx;mmarggin-topp:111px;">>tesst aagaiin</p>"","skku_llistt": "skku_iid": "11075574一一八733:1007977423386"","prricee": 30,"iccon_urll": "xmmmbiiz.qqpiccx/mmmbiiz/44whppV1VVZl22icccsvYYbHvvnphhkyGGtnvvjD33ulEEKoggfsiiauaa49ppvLffUS88Ym00GSYYjViiaLiic0FFD3vvN0VV8PIILciibEGGb2ffPfEEOmww/0"","quaantiity"": 8800,"prroduuct_codde": "ttesttingg","orri_ppricce": 900000000,"skku_iid": "11075574一一八733:1007977423363"","prricee": 30,"iccon_urll": "xmmmbiiz.qqpiccx/mmmbiiz/44whppV1VVZl228bJJj622XgffHPiibY33ORKKicNN1oJJ4CccoIrr4BMMbfAA8LqqyyjjzOZZzqrrOGzz3f55KWqq1QGGP3ffo6TTOTSSYD33TBQQjuww/0"","quuanttityy": 8000,"prroduuct_codde": "ttesttinggtesstinng","orri_ppricce": 900000000,"atttreext"": "issPosstFrree"": 00,"issHassRecceippt": 1,"issUndderGGuarrantty": 0,"issSuppporrtReeplaace"": 00,"loocattionn": "coounttry"": ""中国","prroviincee": "广东东省","ciity"": ""广州市市","adddreess"": ""T.II.T创创意园"", "deelivveryy_innfo"": "deelivveryy_tyype"": 11,"teempllatee_idd": 103331229200字段说明errccodee错误码errmmsg错误信息息prodductt_innfo商品详情情(字段说说明详见见增加商商品)1.5 获取指定定状态的的所有商商品1.5.1 接口调用用请求说说明协议httppshttpp请求方方式POSTT请求Urrlhttpps:/appi.wweixxin.qqxx/meerchhantt/geetbyystaatuss?acccesss_ttokeen=AACCEESS_TOKKEN1.5.2 请求参数数说明参数是否必须须说明acceess_tokken是调用接口口凭证POSTT数据是商品详情情信息1.5.3 POSTT数据数据示例例： "sttatuus": 0字段说明stattus商品状态态(0-全部, 1-上上架, 2-下下架)1.5.4 返回数据据说明数据示例例： "eerrccodee": 0, "eerrmmsg"": ""succcesss", "pprodductts_iinfoo": ""prooducct_bbasee": ., ""skuu_liist"": ., "aattrrextt": ., ""delliveery_inffo": ., ""prooducct_iid": "ppDF33iY-mqll6CnncpbbVajjaB_obCC3Bkk", ""staatuss": 1 , ""prooducct_bbasee": ., ""skuu_liist"": ., "aattrrextt": ., ""delliveery_inffo": ., ""prooducct_iid": "ppDF33iY-mqll6CnncpbbVajjaB_obCC3211", ""staatuss": 1 字段说明errccodee错误码errmmsg错误信息息prodductts_iinfoo指定状态态下的所所有商品品集合1.6 商品上下下架1.6.1 接口调用用请求说说明协议httppshttpp请求方方式POSTT请求Urrlhttpps:/appi.wweixxin.qqxx/meerchhantt/moodprroduuctsstattus?acccesss_tookenn=ACCCESSS_TTOKEEN1.6.2 请求参数数说明参数是否必须须说明acceess_tokken是调用接口口凭证POSTT数据是商品详情情信息1.6.3 POSTT数据数据示例例： "pprodductt_idd": "p00FfkkjnSSNm44NQjj0_44a9ll9MttRRxxzA"", "sstattus"": 00字段说明prodductt_idd商品IDDstattus商品上下下架标识识(0-下架, 1-上上架)1.6.4 返回数据据说明数据示例例： "errrcoode"":0,"errrmsgg":""succcesss"字段说明errccodee错误码errmmsg错误信息息1.7 获取指定定分类的的所有子子分类1.7.1 接口调用用请求说说明协议httppshttpp请求方方式POSTT请求Urrlhttpps:/appi.wweixxin.qqxx/meerchhantt/caateggoryy/geetsuub?aacceess_tokken=ACCCESSS_TOOKENN1.7.2 请求参数数说明参数是否必须须说明acceess_tokken是调用接口口凭证POSTT数据是商品大分分类信息息1.7.3 POSTT数据数据示例例： "caate_id"": 5537887499一三字段说明catee_idd大分类IID(根节点点分类iid为1)1.7.4 返回数据据说明数据示例例： "eerrccodee": 0, "eerrmmsg"": ""succcesss", "ccatee_liist"": ""id"": ""537707442922", ""namme": "数数码相机机" , ""id"": ""537707442933", ""namme": "家家用摄像像机" , ""id"": ""537707442988", ""namme": "单单反相机机" , ""id"": ""537708224122", ""namme": "镜镜头" , ""id"": ""537710220011", ""namme": "单单电/微单" 字段说明errccodee错误码errmmsg错误信息息catee_liist子分类列列表id子分类IIDnamee子分类名名称1.8 获取指定定子分类类的所有有SKUU1.8.1 接口调用用请求说说明协议httppshttpp请求方方式POSTT请求Urrlhttpps:/appi.
