口碑店鋪資料-（回傳商戶操作行為資訊，回傳使用者操作行為資訊）

官方文檔

說明： 本帖是利用支付寶正式環境測試賬号測試口碑店鋪資料接口，請求中根據文檔傳入了必傳參數，大家可以配置自己的環境，根據自己的需求嚴格按照文檔要求添加相關的可選參數，此demo僅供參考       

測試環境：Eclipse+JDK1.6及以上+Tomcat6.0及以上        

為提升使用者使用口碑店鋪插件服務的體驗，各插件在為使用者提供服務的同時，需将相關的資料同步到口碑，口碑會通過更多的入口和統一的樣式展示給使用者。通過店鋪資料接口，可以豐富店鋪内容，提升商家店鋪曝光量，以及使用者使用體驗。

 接口示例代碼  

package com.alipay.koubei.ability; import java.text.DateFormat; import java.text.SimpleDateFormat; import java.util.Date; import java.util.Random; import com.alibaba.fastjson.JSONObject; import com.alipay.api.AlipayApiException; import com.alipay.api.AlipayClient; import com.alipay.api.DefaultAlipayClient; import com.alipay.api.domain.AlipayOfflineProviderShopactionRecordModel; import com.alipay.api.domain.AlipayOfflineProviderUseractionRecordModel; import com.alipay.api.domain.OuterShopDO; import com.alipay.api.request.AlipayOfflineProviderShopactionRecordRequest; import com.alipay.api.request.AlipayOfflineProviderUseractionRecordRequest; import com.alipay.api.response.AlipayOfflineProviderShopactionRecordResponse; import com.alipay.api.response.AlipayOfflineProviderUseractionRecordResponse; import com.alipay.constants.AlipayServiceEnvConstants; /** * * 歡迎通路論壇：https://openclub.alipay.com/index.php * 店鋪資料産品介紹 * 本測試demo僅供參考，以實際需求為準 * @author wb-lh269337 2018-3-28 * */ public class AlipayOfflineProviderShopactionAndUseraction { private static AlipayClient alipayClient; /** 年月日時分秒(無下劃線) yyyyMMddHHmmss */ private static final String dtLong = "yyyyMMddHHmmss"; public static void main(String[] args) { // alipayOfflineProviderShopactionRecord(); alipayOfflineProviderUseractionRecord(); } /** * 獲得API調用用戶端 * * @return */ public static AlipayClient getAlipayClient() { if (null == alipayClient) { alipayClient = new DefaultAlipayClient(AlipayServiceEnvConstants.ALIPAY_GATEWAY, AlipayServiceEnvConstants.APP_ID, AlipayServiceEnvConstants.PRIVATE_KEY, "json", AlipayServiceEnvConstants.CHARSET, AlipayServiceEnvConstants.ALIPAY_PUBLIC_KEY, AlipayServiceEnvConstants.SIGN_TYPE); } return alipayClient; } /** * 傳回系統目前時間(精确到毫秒),作為一個唯一的訂單編号 * * @return 以yyyyMMddHHmmss為格式的目前系統時間 */ private static String getOrderNum() { Date date = new Date(); DateFormat df = new SimpleDateFormat(dtLong); return df.format(date); } /** * 擷取系統目前日期(精确到毫秒)，格式：yyyy-MM-dd HH:mm:ss * * @return */ private static String getDateFormatter() { Date date = new Date(); SimpleDateFormat simpleDateFormat = new SimpleDateFormat("yyyy-MM-dd HH:MM:ss"); return simpleDateFormat.format(date); } /** * * alipay.offline.provider.shopaction.record 商戶操作行為接口 * 上傳商戶行為資料，現在包括的商戶行為（商戶營業狀态、菜品變更、餐桌變更） * */ public static void alipayOfflineProviderShopactionRecord() { AlipayClient alipayClient = getAlipayClient(); AlipayOfflineProviderShopactionRecordRequest request = new AlipayOfflineProviderShopactionRecordRequest(); AlipayOfflineProviderShopactionRecordModel model = new AlipayOfflineProviderShopactionRecordModel(); model.setActionType("insert_table"); model.setEntity("shop"); model.setDateTime(getDateFormatter()); model.setOuterShopDo(getShopOuterShopDo()); model.setActionDetail(getShopActionDetail()); model.setIndustry("REPAST"); model.setActionOuterId(getOrderNum()); request.setBizModel(model); AlipayOfflineProviderShopactionRecordResponse response; try { response = alipayClient.execute(request); if (response.isSuccess()) { System.out.println("調用成功"); System.out.println(response.getBody()); } else { System.out.println("調用失敗"); System.out.println(response.getBody()); } } catch (AlipayApiException e) { // TODO Auto-generated catch block e.printStackTrace(); } } /** * 詳情設定 * * @return */ private static String getShopActionDetail() { // 建構action_detail json，本次是店鋪插入餐桌 JSONObject detail = new JSONObject(); detail.put("tableId", getOrderNum()); detail.put("max", 10);// 最大人數 detail.put("min", 1);// 最小人數 detail.put("tableName", "神龍vip包廂"); detail.put("tableType", 0);// 0普通 1 包廂 detail.put("tableNum", "A01"); detail.put("status", 0);// 0空閑 1 占用 2 不可知 -1 删除 預設空閑 return detail.toJSONString(); } /** * 傳入店鋪關聯關系。标記目前接口涉及到的店鋪資訊，同時如果傳入的資料在口碑不存在， 口碑會建立一條shop_id+ outer_id+ * type的關聯資料 * * @return */ private static OuterShopDO getShopOuterShopDo() { OuterShopDO outerShopDO = new OuterShopDO();  //填寫自己的口碑店鋪ID outerShopDO.setShopId("2017031500077000000027299729");  //填寫ISV系統中與口碑店鋪shop_id關聯的ISV店鋪主鍵 outerShopDO.setOuterId("314232");   //傳入ISV的域名 outerShopDO.setType("_2dFire"); return outerShopDO; } //************************************************************************************** /** * * alipay.offline.provider.useraction.record 使用者操作行為接口 * 上傳使用者行為資料，現在包括的使用者行為(使用者點菜訂單、預定訂單、排号訂單) * */ public static void alipayOfflineProviderUseractionRecord() { AlipayClient alipayClient = getAlipayClient(); AlipayOfflineProviderUseractionRecordRequest request = new AlipayOfflineProviderUseractionRecordRequest(); AlipayOfflineProviderUseractionRecordModel model = new AlipayOfflineProviderUseractionRecordModel(); model.setActionType("order_num"); model.setIndustry("REPAST"); model.setDateTime(getDateFormatter()); model.setActionDetail(getUserActionDetail()); model.setOuterShopDo(getUserOuterShopDo()); model.setEntity("user"); model.setActionOuterId(getOrderNum()); request.setBizModel(model); AlipayOfflineProviderUseractionRecordResponse response; try { response = alipayClient.execute(request); if (response.isSuccess()) { System.out.println("調用成功"); System.out.println(response.getBody()); } else { System.out.println("調用失敗"); System.out.println(response.getBody()); } } catch (AlipayApiException e) { // TODO Auto-generated catch block e.printStackTrace(); } } /** * 傳入店鋪關聯關系。标記目前接口涉及到的店鋪資訊，同時如果傳入的資料在口碑不存在， 口碑會建立一條shop_id+ outer_id+ * type的關聯資料 * * @return */ private static OuterShopDO getUserOuterShopDo() { OuterShopDO outerShopDO = new OuterShopDO();  //填寫自己的口碑店鋪ID  outerShopDO.setShopId("2017031500077000000027299729"); //填寫ISV系統中與口碑店鋪shop_id關聯的ISV店鋪主鍵  outerShopDO.setOuterId("314232");  //傳入ISV的域名 outerShopDO.setType("_2dFire");  return outerShopDO;  }  /**  * 詳情設定  *   * @return  */  private static String getUserActionDetail() {  JSONObject detail = new JSONObject();  // detail.put("source ", "koube.com");  detail.put("outOrderId", getOrderNum());  detail.put("detailUrl", "www.baidu.com");  detail.put("qattr", "1-2人");  detail.put("people", 6);// 幾個人  detail.put("status", 2);// 狀态2 取号成功4 叫号 5 就餐 6 過号 7 取消  detail.put("desc", "變更内容");  detail.put("wait", new Random().nextInt(10));// 前面等待的人數  detail.put("passNumType", 1);// 過号後的處理類型（-1：不可知 0 順延 1：不可順延）  detail.put("passNumDesc", "過号順延");// 商家設定的過号後的處理文案  return detail.toJSONString();  } }      

 請求參數注意事項： 

 1、app_auth_token：ISV/開發者可以通過“

第三方應用授權

”得到商家授權令牌（app_auth_token）作為請求參數傳入，實作代商家發起請求的能力； 

 2、entity 對于回傳的商戶操作行為，固定為shop，代表店鋪行為 ，對于回傳的使用者操作行為，固定為user，代表使用者行為 

 3、outer_shop_do 标記目前接口涉及到的店鋪資訊，同時如果傳入的資料在口碑不存在，口碑會建立一條shop_id+ outer_id+ type的關聯資料，shop_id傳口碑店鋪ID，outer_id傳入ISV系統中與口碑店鋪shop_id關聯的ISV店鋪主鍵。type參數直接傳入ISV的域名，注意，一旦設定就不能再次變化。 

 4、action_outer_id 每次請求的唯一id 可以通過目前唯一id進行問題排查。   

調用成功傳回資訊：  

{"alipay_offline_provider_shopaction_record_response":{"code":"10000","msg":"Success"},"sign":"PK9mGX8uy3xfwRKygPxPCuf62YQU5JrdY4yDSn5dRhRcjtcTlzm8Gzv1yhnNXOhyITDzY6O8+rwPpSUqrQXT3VvS6dkMvEnoXsT5uKefRKX9PuvwbttN5Vc7Me57aPX9dReiBji4HgBVMI22gcugZ8mBTuNIecYNAAxiVcZjUFQ="}
{"alipay_offline_provider_useraction_record_response":{"code":"10000","msg":"Success"},"sign":"PK9mGX8uy3xfwRKygPxPCuf62YQU5JrdY4yDSn5dRhRcjtcTlzm8Gzv1yhnNXOhyITDzY6O8+rwPpSUqrQXT3VvS6dkMvEnoXsT5uKefRKX9PuvwbttN5Vc7Me57aPX9dReiBji4HgBVMI22gcugZ8mBTuNIecYNAAxiVcZjUFQ="}
      

 如有疑問歡迎跟帖提問，不足之處歡迎多多吐槽！！！