智能客房接口 · 連邊開放接口文檔

[TOC] ### 查詢入住人信息傳入參數說明： |序號|參數|類型|是否必填|備注| | -- | -- | -- | -- | -- | |1 | hotelId | string | Required | 酒店編號 | |2 | roomNo | string | Required | 房間號碼 | |3 | flag | int | Optional | 是否返回請求數量 1 OR 0 | 返回數據說明： | 序號 |參數|類型 |名稱 |備注 | | -- | -- | -- | -- | -- | | 1 | memberNo | string | 會員卡號 | | | 2 | roomNo | string | 房間號碼 | | | 3 | hotelId | string | 酒店編號 | | | 4 | orderSn | string | 訂單編號 | | | 5 | billSn | string | 賬單編號 | | | 6 | checkInSn | string | 入住單號 | | | 7 | status | string | 入住狀態 | | | 8 | actual_arrTime | integer | 實際入住時間 | | | 9 | actual_depTime | integer | 實際離店時間 | | | 10 | arrTime | integer | 計劃入住時間 | | | 11 | depTime | integer | 計劃離店時間 | | | 12 | customer_name | string | 入住人姓名 | | | 13 | customer_mobile | string | 入住人電話 | | | 14 | memo | string | 備注 | | | 15 | channel | string | 渠道 | | | 16 | queryCount | integer | 請求次數，不同會員會清空，第一次請求為 1 | | | 17 | customer_name_PY | array | 入住人姓名拼音為數組小寫 | | | 18 | customer_sex | integer | 入住人性別 0 未知 1男 2 女| | +++ get:smartservice/querycheckin *sting:hotelId#酒店編號 *sting:roomNo#房間號碼 integer:flag#標識 <<< success { "success": true, "code": 0, "data": { "memberNo": null, "roomNo": "9989", "hotelId": 2147483644, "orderSn": 503334751043745, "billSn": 503334801375607, "checkInSn": 503334801375436, "status": "I", "actual_arrTime": 1478660348, "actual_depTime": 0, "arrTime": null, "depTime": 1478750400, "customer_name": "4132545123", "customer_mobile": "21343141341", "memo": "SRM中入住失敗，請至SRM中辦理入住。", "channel": "Hotel" "queryCount": 1 } <<< error { "success": false, "code": -1, "data": "" } +++ ### 續住查詢次日房價傳入參數說明： |序號|參數|類型|是否必填|備注| | -- | -- | -- | -- | -- | |1 | hotelId | string | Required | 酒店編號 | |2 | roomNo | string | Required | 房間號碼 | 返回數據說明： | 序號 |參數|類型 |名稱 |備注 | | -- | -- | -- | -- | -- | | 1 | typecode | string | 房型代碼 | | | 2 | roomname | string | 房型名稱 | | | 3 | ratelist | array | 房價列表 | | +++ get:smartservice/querynextdayrate *sting:hotelId#酒店編號 *sting:roomNo#房間號碼 <<< success { "success": true, "code": 0, "data": { "typecode": ‘213’, "roomname": "單間", "ratelist": "", } } <<< error { "success": false, "code": -1, "data": "" } +++ ### 退房查詢賬單信息傳入參數說明： |序號|參數|類型|是否必填|備注| | -- | -- | -- | -- | -- | |1 | hotelId | string | Required | 酒店編號 | |2 | roomNo | string | Required | 房間號碼 | 返回數據說明： | 序號 |參數|類型 |名稱 |備注 | | -- | -- | -- | -- | -- | | 1 | memberNo | string | 會員編號 | | | 2 | roomNo | string | 房間號碼 | | | 3 | hotelId | string | 酒店編號 | | | 4 | orderSn | string | 訂單編號 | | | 5 | billSn | string | 賬單編號 | | | 6 | amount | integer | 總金額 | | | 7 | count | integer | 賬目總數 | | | 8 | roomTypeCode | string | 房型代碼 | | | 9 | roomTypeName | string | 房型名稱 | | | 9 | details | array | 賬目詳情 | | | 9-1 | price | array | 金額 | | | 9-2 | title | float | 賬目名稱 | | | 9-3 | date | integer | 發生日期 | | | 9-4 | remark | string | 備注 | | +++ get:smartservice/querybilldetails *sting:hotelId#酒店編號 *sting:roomNo#房間號碼 <<< success { "success": true, "code": 0, "data": { "memberNo": null, "roomNo": null, "hotelId": null, "orderSn": null, "billSn": null, "amount": 300, "count": 2, "roomTypeCode": "", "roomTypeName": "", "details": [ { "price": "100", "date": 1489852800, "title": "升級房費", "remark": [] }, { "price": "200", "date": 1489852800, "title": "客房用品", "remark": [] } ] } } <<< error { "success": false, "code": -1, "data": "" } +++ ### 提交打掃服務傳入參數說明： |序號|參數|類型|是否必填|備注| | -- | -- | -- | -- | -- | |1 | hotelId | string | Required | 酒店編號 | |2 | roomNo | string | Required | 房間號碼 | 返回數據說明： | 序號 |參數|類型 |名稱 |備注 | | -- | -- | -- | -- | -- | +++ post:smartservice/postcleanservice *sting:hotelId#酒店編號 *sting:roomNo#房間號碼 <<< success { "success": true, "code": 0, "data": “” } <<< error { "success": false, "code": -1, "data": "" } +++ ### 提交送物服務傳入參數說明： |序號|參數|類型|是否必填|備注| | -- | -- | -- | -- | -- | |1 | hotelId | string | Required | 酒店編號 | |2 | roomNo | string | Required | 房間號碼 | |3 | service | string | Required | 服務內容 | 返回數據說明： | 序號 |參數|類型 |名稱 |備注 | | -- | -- | -- | -- | -- | +++ post:smartservice/posttakeservice *sting:hotelId#酒店編號 *sting:roomNo#房間號碼 *sting:service#服務內容 <<< success { "success": true, "code": 0, "data": “” } <<< error { "success": false, "code": -1, "data": "" } +++ ### 提交退房服務傳入參數說明： |序號|參數|類型|是否必填|備注| | -- | -- | -- | -- | -- | |1 | hotelId | string | Required | 酒店編號 | |2 | roomNo | string | Required | 房間號碼 | |3| invoice | string | Optional | 發票信息字符串 | 返回數據說明： | 序號 |參數|類型 |名稱 |備注 | | -- | -- | -- | -- | -- | +++ post:smartservice/postcheckout *sting:hotelId#酒店編號 *sting:roomNo#房間號碼 sting:invoice#發票信息字符串 <<< success { "success": true, "code": 0, "data": “” } <<< error { "success": false, "code": -1, "data": "" } +++ ### 提交續住服務傳入參數說明： |序號|參數|類型|是否必填|備注| | -- | -- | -- | -- | -- | |1 | hotelId | string | Required | 酒店編號 | |2 | roomNo | string | Required | 房間號碼 | 返回數據說明： | 序號 |參數|類型 |名稱 |備注 | | -- | -- | -- | -- | -- | | 1 | orderSn | string | 訂單編號 | | | 2 | num | integer | 間數 | | | 3 | days | integer | 天數 | | +++ post:smartservice/postextendstay *sting:hotelId#酒店編號 *sting:roomNo#房間號碼 <<< success { "success": true, "code": 0, "data": { "orderSn": "F17C190054", "num": "1", "days": "1" } } <<< error { "success": false, "code": -1, "data": "" } +++ ### 獲取支付訂單二維碼傳入參數說明： |序號|參數|類型|是否必填|備注| | -- | -- | -- | -- | -- | |1 | hotelId | string | Required | 酒店編號 | |2 | roomNo | string | Required | 房間號碼 | |2 | orderSn | string | Required | 訂單號 | 返回數據說明： | 序號 |參數|類型 |名稱 |備注 | | -- | -- | -- | -- | -- | | 1 | data | string | 二維碼的鏈接 | | +++ post:smartservice/generatewxpay *sting:hotelId#酒店編號 *sting:roomNo#房間號碼 *sting:orderSn#訂單號 <<< success { "success": true, "code": 0, "data": "http://qr.liantu.com/api.php?text=weixin://wxpay/bizpayurl?pr=9HK6keW" } <<< error { "success": false, "code": -1, "data": "" } +++ ### 獲取訂單的支付狀態傳入參數說明： |序號|參數|類型|是否必填|備注| | -- | -- | -- | -- | -- | |1 | hotelId | string | Required | 酒店編號 | |2 | roomNo | string | Required | 房間號碼 | |3 | orderSn | string | Required | 訂單編號 | 返回數據說明： | 序號 |參數|類型 |名稱 |備注 | | -- | -- | -- | -- | -- | +++ get:smartservice/queryorderstatus *sting:hotelId#酒店編號 *sting:roomNo#房間號碼 *sting:orderSn#訂單編號 <<< 已經支付 { "success": true, "code": 0, "data": 1 } <<< 未支付 { "success": true, "code": 0, "data": -1 } +++ ### 預訂單取消傳入參數說明： |序號|參數|類型|是否必填|備注| | -- | -- | -- | -- | -- | |1 | hotelId | string | Required | 酒店編號 | |2 | roomNo | string | Required | 房間號碼 | |3 | orderSn | string | Required | 訂單編號 | 返回數據說明： | 序號 |參數|類型 |名稱 |備注 | | -- | -- | -- | -- | -- | +++ post:smartservice/postcancelorder *sting:hotelId#酒店編號 *sting:roomNo#房間號碼 *sting:orderSn#訂單編號 <<< success { "success": true, "code": 0, "data": 1 } <<< error { "success": false, "code": 0, "data": -1 } +++ ### 獲取客房的續住狀態傳入參數說明： |序號|參數|類型|是否必填|備注| | -- | -- | -- | -- | -- | |1 | hotelId | string | Required | 酒店編號 | |2 | roomNo | string | Required | 房間號碼 | 返回數據說明： | 序號 |參數|類型 |名稱 |備注 | | -- | -- | -- | -- | -- | +++ get:smartservice/queryextendstaystatus *sting:hotelId#酒店編號 *sting:roomNo#房間號碼 <<< 已成功續住 { "success": true, "code": 0, "data": } <<< 未續住 { "success": false, "code": -1, "data": } +++