add store service

binarywang · binarywang · commit fcede8f6480f · 2016-09-26T09:25:47.000+08:00
diff --git a/weixin-java-mp/src/main/java/me/chanjar/weixin/mp/api/WxMpStoreService.java b/weixin-java-mp/src/main/java/me/chanjar/weixin/mp/api/WxMpStoreService.java
@@ -0,0 +1,26 @@
+package me.chanjar.weixin.mp.api;
+
+import me.chanjar.weixin.common.exception.WxErrorException;
+
+/**
+ * 门店管理的相关接口代码
+ * @author binarywang(https://github.com/binarywang)
+ *         Created by Binary Wang on 2016-09-23.
+ */
+public interface WxMpStoreService {
+  /**
+   * <pre>
+   * 创建门店
+   * 接口说明
+   * 创建门店接口是为商户提供创建自己门店数据的接口，门店数据字段越完整，商户页面展示越丰富，越能够吸引更多用户，并提高曝光度。
+   * 创建门店接口调用成功后会返回errcode 0、errmsg ok，但不会实时返回poi_id。
+   * 成功创建后，会生成poi_id，但该id不一定为最终id。门店信息会经过审核，审核通过后方可获取最终poi_id，该id为门店的唯一id，强烈建议自行存储审核通过后的最终poi_id，并为后续调用使用。
+   * 详情请见: <a href="https://mp.weixin.qq.com/wiki?t=resource/res_main&id=mp1444378120&token=&lang=zh_CN">微信门店接口</a>
+   * 接口格式： http://api.weixin.qq.com/cgi-bin/poi/addpoi?access_token=TOKEN
+   * </pre>
+   *
+   * @param scene_id       参数。
+   * @param expire_seconds 过期秒数，默认60秒，最小60秒，最大1800秒
+   */
+  void userUpdateRemark(String openid, String remark) throws WxErrorException;
+}
diff --git a/weixin-java-mp/src/main/java/me/chanjar/weixin/mp/bean/WxMpStoreBaseInfo.java b/weixin-java-mp/src/main/java/me/chanjar/weixin/mp/bean/WxMpStoreBaseInfo.java
@@ -0,0 +1,52 @@
+package me.chanjar.weixin.mp.bean;
+
+/**
+ * 门店基础信息
+ * @author binarywang(https://github.com/binarywang)
+ *         Created by Binary Wang on 2016-09-23.
+ */
+public class WxStoreBaseInfo {
+ /** sid
+  商户自己的id，用于后续审核通过收到poi_id 的通知时，做对应关系。请商户自己保证唯一识别性
+    否
+  business_name
+  门店名称（仅为商户名，如：国美、麦当劳，不应包含地区、地址、分店名等信息，错误示例：北京国美）
+  不能为空，15个汉字或30个英文字符内
+    是
+  branch_name
+  分店名称（不应包含地区信息，不应与门店名有重复，错误示例：北京王府井店）
+    10个字以内
+    是
+  province
+  门店所在的省份（直辖市填城市名,如：北京市）
+    10个字以内
+    是
+  city
+    门店所在的城市
+10个字以内
+    是
+  district
+    门店所在地区
+10个字以内
+    是
+  address
+  门店所在的详细街道地址（不要填写省市信息）
+  是
+（东莞等没有“区”行政区划的城市，该字段可不必填写。其余城市必填。）
+  telephone
+  门店的电话（纯数字，区号、分机号均由“-”隔开）
+  是
+    categories
+  门店的类型（不同级分类用“,”隔开，如：美食，川菜，火锅。详细分类参见附件：微信门店类目表）
+  是
+    offset_type
+  坐标类型，1 为火星坐标（目前只能选1）
+  是
+    longitude
+  门店所在地理位置的经度
+    是
+  latitude
+  门店所在地理位置的纬度（经纬度均为火星坐标，最好选用腾讯地图标记的坐标）
+  是
+  */
+}
