聯合票務拉取產品 · 聯合票務系統文檔

# 拉取產品接口 * * * * * **V2.2更新：** * 請求參數新增： * system:產品來源默認為false, 只獲取系統自有產品，如果為字符串則表示查詢特定系統的產品 * 產品返回屬性新增： * fullRefund:是否僅支持整單退款。為1時，只能整單退。不可部分退 * * * * * * * * * * **V2.1更新：** * 請求參數新增： * simples:簡單模式默認為0, 為1時不再返回purchaseNote值，即各項圖文說明 * 產品返回屬性新增： * teamType:產品類型，默認normal ，subscribe類型產品下單時需提供出游日期 * beginTime:產品有效期開始時間，2015-12-28 00:00:00 格式要求：yyyy-MM-dd HH:mm:ss * expireTime:產品有效期結束時間，2015-12-28 00:00:00 格式要求：yyyy-MM-dd HH:mm:ss * servicePhone:服務電話設置，接待時間和服務電話的配置信息 * refundRule:退款規則，退款限制分鐘數，退款類型 * * * * * +++ post:/openapi/index.php?method=getTeam *int:partnerId#聯合分配的合作方ID。 *json:body#提交內容json格式數據，參考提交數據demo <<< 提交數據demo { "partnerId": 1985, "body": { "method": "page", "currentPage": 0, "pageSize": 20, "LHDealIds": [ "852" ] } } *號代表字段為必填項 body字段介紹 *string: method # 請求方法 page為分頁查詢，multi為指定id查詢（使用單個和指定多個產品信息） int : currentPage # 當前頁數，method為page是必填 int : pageSize # 每頁數量，method為page是必填 int : simples # 簡單模式默認為0 （不再返回purchaseNote 包含的各項說明） array : LHDealIds # 產品ID ，為multi時必填。array[string] <<< success { "code": 10000, "describe": "success", "partnerId": 3528, "totalSize": 40, "body": [ { "partnerId": 3528, "LHSupplierId": "string", "LHDealId": "string", "teamType": "string", "name": "string", "pics": ["string"], "startTime": "string", "endTime": "string", "beginTime": "string", "expireTime": "string", "marketPrice": 1.5, "sellPrice": 1, "buyPrice": 0.5, "stock": 990, "allowday": 0, "aftertime": 0, "canRefund": 1, "fullRefund":1, "refundRule": { "refundType": 1, "refundMinute": 0 }, "maxBuyCount": 0, "minBuyCount":1, "servicePhone": { "phone": "string", "startHour": "8", "startMin": "00", "endHour": "22", "endMin": "00" }, "purchaseNote": { "chargeIncludeNote": "string", "refundNote": "string", "useNote": "string", "importantNote": "string", "imageTextNote": "string" }, "visitorRequire": { "name": 1, "mobile": 1, "credentials": 0, "address": 0, "zipcode": 0, "email": 0 } } ] } <<< error { "code":20000, "describe":"iteam not found", "partnerId":3528, "totalSize": null, "body":null } <<< 返回參數說明：開頭為 '*' 表示必填項 *int : code # 交互碼取值請參考交互碼類型映射表 *string: describe # 交互描述 *int : partnerId # 合作方ID int : totalSize # 合作方產品總數量分頁查詢時必傳 *json : body # 返回body內容，有產品是必傳，字段說明如下↓ 返回body內容說明 *int : partnerId # 合作方ID string: LHSupplierId # 聯合接入的商家id *string: LHDealId # 產品ID string: teamType # 產品類型默認normal， subscribe：指定日期產品取值參考teamType說明 *string: name # 產品名稱 *array : pics # 產品圖片列表 array[string]類型 *time : startTime # 產品上架時間 2015-12-28 00:00:00 格式要求：yyyy-MM-dd HH:mm:ss *time : endTime # 產品下架時間 2015-12-28 00:00:00 格式要求：yyyy-MM-dd HH:mm:ss *time : beginTime # 開始驗票時間 2015-12-28 00:00:00 格式要求：yyyy-MM-dd HH:mm:ss *time : expireTime # 結束驗票時間 2015-12-28 00:00:00 格式要求：yyyy-MM-dd HH:mm:ss *number: marketPrice # 市場價 *number: sellPrice # 售價 *number: buyPrice # 成本價（雙方的結算價格） *int : stock # 庫存數量不限制 stock = 100000000 *int : allowday # 次日生效 1:次日可用 0：當日可用 int : aftertime # 延時生效時間單位小時，買票后X小時可驗票 int : maxBuyCount# 最大購買數量 0為不限 int : minBuyCount # 最小購買數量 *int : canRefund # 受否支持退款 0:不可退；1：可退 int : fullRefund # 整單退款 0:不限；1：只能整單退款（V2.2新增） *json : limitRule # 限購規則取值參考 limitRuleInfo說明,字段說明如下↓ *json : refundRule # 退款規則取值參考refundRuleInfo說明，字段說明如下↓ *json : servicePhone # 服務電話及時間設置，取值參考ServicePhoneInfo說明，字段說明如下↓ *json : purchaseNote # 各項說明，取值參考PurchaseNoteInfo說明，字段說明如下↓ *json : visitorRequire #用戶必填項說明，取值參考VisitorInfo說明，字段說明如下↓ limitRuleInfo各項說明(V2.2新增) ~~~ string : limit # phone:手機。idcard:身份證 int : limitType # 限購的類型，0:用門票張數,1:用訂單數 int : LimitDayType # 天數類型:0下單日,1出游日 int : limitDays # 幾天內限購 int : limitNumber # 限購的數量 ~~~ refundRuleInfo各項說明（V2.1新增） *int : refundType # 退款類型配合退款時間限制默認1 1.有效期內隨便退； 2:有效期結束前XX分鐘可退; 3:有效期結束后XX分鐘可退; 4:出游日期截至前XX分鐘可退; 5:出游日期截至后XX分鐘可退 6:出游日期開始前XX分鐘可退結束前的時間從當天的23:59:59開始往前計算。結束后的時間從次日00:00:00往后計算如有效期為2016-4-30日，提前312分鐘（5小時12分鐘），則實際截至時間為2016-4-30 18:47:59（23-5時59-12分59秒)前可退。開始前從當天的00:00開始往前算分鐘數 *int: refundMinute # 退款限制分鐘數默認為0 ServicePhoneInfo字段介紹 *為必填項（V2.1新增） *num:phone # 熱線電話 *num:startHour # 開始小時 *num:startMin # 開始分鐘 *num:endHour # 結束小時 *num:endMin # 結束分鐘 teamType說明 normal :正常票; subscribe:指定出行日期門票 PurchaseNoteInfo各項說明 *string: includeNote # 費用說明（對應后臺包含） *string: refundNote # 退款說明（對應后臺備注） *string: useNote # 使用說明（對應后臺簡介） *string: importantNote # 重要說明（對應后臺特別說明） *string: imageTextNote # 圖文詳情（對應后臺產品詳情） VisitorInfo字段介紹 *為必填項 *int:name # 用戶姓名聯合系統默認必填項 *int:mobile # 使用者手機號聯合系統默認必填項 int:credentials # 使用者身份證號可選 int:address# 地址可選 int:zipcode# 郵編可選 int:email # 郵箱可選 +++