微信小店API手册v168263.docx
微信商铺铺APII手册VV1.115目录1.商品品管理接接口- 1 -1.1增增加商品品- 11 -1.2删删除商品品- 66 -1.3修修改商品品- 77 -1.4查查询商品品- 110 -1.5获获取指定定状态的的所有商商品- 13 -1.6商商品上下下架- 14 -1.7获获取指定定分类的的所有子子分类- 155 -1.8获获取指定定子分类类的所有有SKU- 116 -1.9获获取指定定分类的的所有属属性- 18 -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获取取订单详详情- 63 -6.3根根据订单单状态/创建时时间获取取订单详详情- 65 -6.4设设置订单单发货信信息- 68 -6.5关关闭订单单- 669 -7.功能能接口- 711 -7.1上上传图片片- 771 -1. 商品管理理接口1.1 增加商品品1.1.1 接口调用用请求说说明协议httppshttpp请求方方式POSTT请求Urrlhttpps:/m/meerchhantt/crreatte?aacceess_tokken=ACCCESSS_TOOKENNPOSTT数据格格式jsonn1.1.2 请求参数数说明参数是否必须须说明acceess_tokken是公众号的的调用接接口凭证证，由aacceess_tokken生生成接口口获得POSTT数据是商品详细细信息1.1.3 POSTT数据数据示例例："prroduuct_basse": "ccateegorry_iid": ""537707442988","pproppertty": "idd": "1007577418879"","viid": "11079974999677","idd": "1007577541127"","viid": "11079979551988","idd": "1007577773334"","viid": "11079983774400","nnamee": "teestaaddpprodductt","ssku_inffo": "idd": "1007577418873"","viid": "1007977423386"","1007977423363"","mmainn_immg": "hhttpp:/mmbbiz.qpiic.ccn/mmmbiiz/44whppV1VVZl22icccsvYYbHvvnphhkyGGtnvvjD33ulEEKoggfsiiauaa49ppvLffUS88Ym00GSYYjViiaLiic0FFD3vvN0VV8PIILciibEGGb2ffPfEEOmww/0"", "iimg"": ""htttp:/,"ddetaail"": "teext"": ""tesst ffirsst","immg": "hhttpp:/mmbbiz.qpiic.ccn/mmmbiiz/44whppV1VVZl22icccsvYYbHvvnphhkyGGtnvvjD33ul11UcLLcwxxrFddwTKKYhHH9Q55YZooCfXX4Nccx6555ZKK6ibbnliibCCCErbbKQttReyySaVVA/00","teext"": ""tesst aagaiin","bbuy_limmit"": 110,"skku_llistt": ""skuu_idd": "1007577418873:1077974423886",""priice"": 330,""icoon_uurl"": ""htttp:/""prooducct_ccodee": "teestiing"",""orii_prricee": 900000000,""quaantiity"": 8800,""skuu_idd": "1007577418873:1077974423663",""priice"": 330,""icoon_uurl"": ""htttp:/""prooducct_ccodee": "teestiingttesttingg",""orii_prricee": 900000000,""quaantiity"": 8800,"atttreext"": "llocaatioon": "couuntrry": "中中国",""proovinnce"": ""广东省省",""citty": "广广州市"",""adddresss": "TT.I.T创意意园","iisPoostFFreee": 0,"iisHaasReeceiipt"": 11,"iisUnnderrGuaarannty"": 00,"iisSuuppoortRRepllacee": 0,"deelivveryy_innfo"": "ddeliiverry_ttypee": 0,"ttempplatte_iid": 0, "eexprresss": "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定义义，SKKU列表表请通过过获取取指定子子分类的的所有SSKU获获取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-否, 1-是是), 如果包包邮deelivveryy_innfo字字段可省省略isHaasReeceiipt是否提供供发票(0-否否, 11-是)isUnnderrGuaarannty是否保修修(0-否, 1-是是)isSuuppoortRRepllacee是否支持持退换货货(0-否, 1-是是)locaatioon商品所在在地地址址counntryy国家(详详见地地区列表表说明明)provvincce省份(详详见地地区列表表说明明)cityy城市(详详见地地区列表表说明明)addrresss地址deliiverry_iinfoo必选运费信息息deliiverry_ttypee运费类型型(0-使用下下面exxpreess字字段的默默认模板板, 11-使用用temmplaate_id代代表的邮邮费模板板, 详详见邮费费模板相相关APPI)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:/m/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:/m/meerchhantt/uppdatte?aacceess_tokken=ACCCESSS_TOOKENNPOSTT数据格格式jsonn1.3.2 请求参数数说明参数是否必须须说明acceess_tokken是调用接口口凭证POSTT数据是商品详情情信息1.3.3 POSTT数据数据示例例："prroduuct_id"": ""pDFF3iYY6Krr_BVV_CXXaiYYysooGqJJhpppQ", "prroduuct_basse": "ccateegorry_iid": ""537707442988","pproppertty": "idd": "1007577418879"","viid": "11079974999677","idd": "1007577541127"","viid": "11079979551988","idd": "1007577773334"","viid": "11079983774400","nnamee": "teestaaddpprodductt","ssku_inffo": "idd": "1007577418873"","viid": "1007977423386"","1007977423363"","mmainn_immg": "hhttpp:/mmbbiz.qpiic.ccn/mmmbiiz/44whppV1VVZl22icccsvYYbHvvnphhkyGGtnvvjD33ulEEKoggfsiiauaa49ppvLffUS88Ym00GSYYjViiaLiic0FFD3vvN0VV8PIILciibEGGb2ffPfEEOmww/0"", "iimg"": ""htttp:/,"ddetaail"": "immg": "hhttpp:/mmbbiz.qpiic.ccn/mmmbiiz/44whppV1VVZl22icccsvYYbHvvnphhkyGGtnvvjD33ul11UcLLcwxxrFddwTKKYhHH9Q55YZooCfXX4Nccx6555ZKK6ibbnliibCCCErbbKQttReyySaVVA/00","bbuy_limmit"": 33,"skku_llistt": ""skuu_idd": "1007577418873:1077974423886",""priice"": 330,""icoon_uurl"": ""htttp:/""prooducct_ccodee": "teestiing"",""orii_prricee": 900000000,""quaantiity"": 8800,""skuu_idd": "1007577418873:1077974423663",""priice"": 330,""icoon_uurl"": ""htttp:/""prooducct_ccodee": "teestiingttesttingg",""orii_prricee": 900000000,""quaantiity"": 8800,"atttreext"": "llocaatioon": "couuntrry": "中中国",""proovinnce"": ""广东省省",""citty": "广广州市"",""adddresss": "TT.I.T创意意园","iisPoostFFreee": 0,"iisHaasReeceiipt"": 11,"iisUnnderrGuaarannty"": 00,"iisSuuppoortRRepllacee": 0,"deelivveryy_innfo"": "ddeliiverry_ttypee": 0,"ttempplatte_iid": 0, "eexprresss": "idd": 1000000027, "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:/m/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": "pprodductt_idd": "pDDF3iiY6KKr_BBV_CCXaiiYyssoGqqJhpppQ"","pprodductt_baase"": ""namme": "ttesttadddprooducct",""cattegoory_id"": 537707442988,""imgg": "htttp:/n/mmmbizz/4wwhpVV1VZZl2iiccssvYbbHvnnphkkyGttnvjjD3uulEKKogffsiaaua449pvvLfUUS8YYm0GGSYjjViaaLicc0FDD3vNN0V88PILLcibbEGbb2fPPfEOOmw/0",""prooperrty"": "id"": ""品牌"","viid": "FFujiifillm/富富士","idd": "屏幕幕尺寸"","viid": "11.8英英寸","idd": "防抖抖性能"","viid": "CCCD防防抖",""skuu_innfo"": "idd": "1007577418873"","viid": "1007977423386"","1007977423363"",""buyy_liimitt": 10,""maiin_iimg"": ""htttp:/""dettaill_httml"": ""<diiv cclasss="ittem_picc_wrrp"" sttylee=""marrginn-boottoom:88px;fonnt-ssizee:0;">><immg cclasss="ittem_picc" styyle="wwidtth:1100%;"" allt=""" srrc="htttp:/n/mmmbizz/4wwhpVV1VZZl2iiccssvYbbHvnnphkkyGttnvjjD3uulEKKogffsiaaua449pvvLfUUS8YYm0GGSYjjViaaLicc0FDD3vNN0V88PILLcibbEGbb2fPPfEOOmw/0"" ><</diiv><<p sstylle="maargiin-bbotttom:11ppx;mmarggin-topp:111px;">>tesst</p><<divv cllasss=""iteem_ppic_wrpp" styyle="mmarggin-botttomm:8ppx;ffontt-siize:0;"><<imgg cllasss=""iteem_ppic" sstylle="wiidthh:1000%;" altt=""" srcc=""htttp:/ ><</diiv><<p sstylle="maargiin-bbotttom:11ppx;mmarggin-topp:111px;">>tesst aagaiin</p>"","ssku_lisst": "skku_iid": "11075574118733:1007977423386"","prricee": 30,"iccon_urll": "htttp:/n/mmmbizz/4wwhpVV1VZZl2iiccssvYbbHvnnphkkyGttnvjjD3uulEKKogffsiaaua449pvvLfUUS8YYm0GGSYjjViaaLicc0FDD3vNN0V88PILLcibbEGbb2fPPfEOOmw/0","quuanttityy": 8000,"prroduuct_codde": "ttesttingg","orri_ppricce": 900000000,"skku_iid": "11075574118733:1007977423363"","prricee": 30,"iccon_urll": "htttp:/n/mmmbizz/4wwhpVV1VZZl288bJjj62XXgfHHPibbY3OORKiicN11oJ44CcooIr44BMbbfA88LqyyyjzzOZzzqrOOGz33f5KKWq11QGPP3foo6TOOTSYYD3TTBQjjuw/0","quuanttityy": 8000,"prroduuct_codde": "ttesttinggtesstinng","orri_ppricce": 900000000,"aattrrextt": ""isPPosttFreee": 0,""isHHasRReceeiptt": 1,""isUUndeerGuuaraantyy": 0,""isSSuppporttRepplacce": 0,""loccatiion"": "coounttry"": ""中国"","prroviincee": "广东东省","ciity"": ""广州市市","adddreess"": ""T.II.T创创意园"", "ddeliiverry_iinfoo": ""delliveery_typpe": 1,""temmplaate_id"": 110333129920字段说明errccodee错误码errmmsg错误信息息prodductt_innfo商品详情情(字段段说明详详见增加加商品)1.5 获取指定定状态的的所有商商品1.5.1 接口调用用请求说说明协议httppshttpp请求方方式POSTT请求Urrlhttpps:/m/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:/m/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:/m/meerchhantt/caateggoryy/geetsuub?aacceess_tokken=ACCCESSS_TOOKENN1.7.2 请求参数数说明参数是否必须须说明acceess_tokken
