TCSPIA 010-2023 住宿業(yè)自助入住設(shè)備通用技術(shù)要求

T/CSPIA010-2023ICS13.310T/CSPIA010-2023CCSA91

CSPIA團 體 標 準T/CSPIA010-2023住宿業(yè)自助入住設(shè)備通用技術(shù)要求Generaltechnicalrequirementsforself-check-inequipmentintheaccommodationindustry2023-04-20發(fā)布 2023-04-20實施中國安全防范產(chǎn)品行業(yè)協(xié)會發(fā)布PAGE\*ROMANPAGE\*ROMANIIT/CSPIA010-2023目 次前 言 III范圍 1規(guī)范性引用文件 1術(shù)語、定義和縮略語 1術(shù)語和定義 1縮略語 2系統(tǒng)構(gòu)成及互聯(lián) 2設(shè)備分類 2系統(tǒng)構(gòu)成 3與其它系統(tǒng)的互聯(lián) 3功能要求 4系統(tǒng)接入功能 4人員信息采集與核驗功能 4房型選擇功能 4電子支付功能 4支付憑證打印功能 4發(fā)放房卡功能 4設(shè)備操作日志記錄功能 5數(shù)據(jù)傳輸及流程功能 5性能要求 5人臉圖像質(zhì)量 5光照適應(yīng)性 5人臉姿勢適應(yīng)性 5人臉識別準確率 5響應(yīng)時間 5安全要求 5安全防護 5數(shù)據(jù)安全 5硬件要求 6外觀 6機械結(jié)構(gòu) 6外殼防護等級 6T/CSPIA010-2023電源要求 6電氣安全要求 6電磁兼容性要求 6試驗方法 6功能試驗 6性能試驗 7安全試驗 8硬件試驗 9檢驗規(guī)則 10檢驗分類 10型式檢驗 10出廠檢驗 10檢驗項目 10抽樣與組批規(guī)則 10判定規(guī)則 11不合格品的處理 11不合格批的再檢驗 1111標志 1112隨機技術(shù)文件 1112.1概述 11使用說明書 11技術(shù)說明書 12附錄A（資料性）數(shù)據(jù)傳輸 13住宿業(yè)運營管理系統(tǒng)數(shù)據(jù)傳輸 13住宿人員信息采集系統(tǒng)數(shù)據(jù)傳輸 18門禁系統(tǒng)數(shù)據(jù)傳輸 19附錄B（資料性）流程 24業(yè)務(wù)流程 24數(shù)據(jù)流程 28IIIIIIT/CSPIA010-2023前 言GB/T1.1-20201請注意本文件某些內(nèi)容可能涉及專利。本文件發(fā)布機構(gòu)不承擔(dān)識別專利的責(zé)任。本文件由中國安全防范產(chǎn)品行業(yè)協(xié)會提出并歸口。（上海有限公司、PAGEPAGE2T/CSPIA010-2023住宿業(yè)自助入住設(shè)備通用技術(shù)要求范圍本文件適用于住宿業(yè)自助入住設(shè)備的研發(fā)、生產(chǎn)和檢驗等。規(guī)范性引用文件（包括所有的修改單）適用于本文件。GB/T2828.1計數(shù)抽樣檢驗程序第1檢索的逐批檢驗抽樣計劃GB/T2829周期檢驗計數(shù)抽樣程序及表（適用于對過程穩(wěn)定性的檢驗）GB/T35678-2017公共安全人臉識別應(yīng)用圖像技術(shù)要求GA/T1324-2017安全防范人臉識別應(yīng)用靜態(tài)人臉圖像采集規(guī)范GA/T1755-2020安全防范人臉識別應(yīng)用人證核驗設(shè)備通用技術(shù)要求術(shù)語、定義和縮略語術(shù)語和定義下列術(shù)語和定義適用于本文件。住宿業(yè)accommodation向消費者提供住宿及相關(guān)服務(wù)的行業(yè)。旅館 hotelindustry依法取得《旅館業(yè)特種行業(yè)許可證》,經(jīng)營接待消費者住宿的旅館、飯店、賓館、招待所、客貨棧、車馬店、浴池等，統(tǒng)稱旅館。自助入住設(shè)備self-check-infacilities住宿業(yè)為消費者提供自助辦理入住服務(wù)的終端設(shè)備。中央預(yù)訂系統(tǒng)centralreservationsystemT/CSPIA010-2023對住宿業(yè)的消費者提供訂房服務(wù)的計算機軟件和平臺系統(tǒng)，實現(xiàn)房間展示和訂房服務(wù)，例如房型展示、在線訂單支付、訂單查詢等功能。住宿業(yè)管理系統(tǒng)propertymanagementsystem對住宿業(yè)場所中產(chǎn)生的運營信息進行管理和處理的計算機軟件和平臺系統(tǒng),實現(xiàn)前臺管理功能，例如預(yù)訂、消費者入住/退房、客房分配、房費管理和開單等。房卡roomcard消費者在旅館入住時用來打開房門的磁條卡或IC卡。虛擬房卡virtualroomcard通過二維碼、數(shù)字密碼、人臉或指紋等生物特征識別等技術(shù)手段，代替房卡的方式統(tǒng)稱?？s略語下列縮略語適用于本文件。CRS：中央預(yù)訂系統(tǒng)（CentralReservationSystem）PMS：住宿業(yè)運營管理系統(tǒng)（PropertyManagementSystem）PSB：旅館業(yè)治安管理信息系統(tǒng)（PoliceStationBureau）系統(tǒng)構(gòu)成及互聯(lián)設(shè)備分類訂房和入住、續(xù)住及退房等多種功能，適用于旅館等住宿業(yè)單位。APP兩類設(shè)備的功能組成示意見圖1。PAGEPAGE4T/CSPIA010-2023圖1自助入住設(shè)備功能組成示意圖系統(tǒng)構(gòu)成2。圖2自助入住設(shè)備系統(tǒng)構(gòu)成示意框圖與其它系統(tǒng)的互聯(lián)訂房信息需要與中央預(yù)訂系統(tǒng)（CRS，CentralReservationSystem）互聯(lián)；消費者入住信息需要與住宿業(yè)運營管理系統(tǒng)（PMS，PropertyManagementSystem）互聯(lián)；Station互聯(lián)同步消費者入住信息；與房門控制設(shè)備互聯(lián)，實現(xiàn)房門權(quán)限的管理。3。T/CSPIA010-2023圖3自助入住設(shè)備與其它系統(tǒng)的互聯(lián)功能要求系統(tǒng)接入功能a）接入中央預(yù)訂系統(tǒng)的功能；b）接入住宿業(yè)管理系統(tǒng)的功能；c）接入旅館業(yè)治安管理信息系統(tǒng)的功能，并按照治安管理要求上傳相關(guān)信息；d）接入房門控制設(shè)備如智能門鎖的功能，實現(xiàn)對房門入住權(quán)限的管理。人員信息采集與核驗功能設(shè)備應(yīng)具備以下人員信息采集與核驗功能：讀取身份證件的功能；現(xiàn)場抓拍消費者人像照片的功能；c）人員身份核驗功能。房型選擇功能設(shè)備應(yīng)具備為消費者提供自主選擇房型的功能。電子支付功能設(shè)備應(yīng)具備為消費者提供電子貨幣支付房間費用的功能。支付憑證打印功能設(shè)備應(yīng)具備向消費者提供支付憑證的功能，支付憑證為紙質(zhì)憑證或電子憑證等形式。發(fā)放房卡功能設(shè)備應(yīng)具備向消費者提供房卡的功能，房卡可為實體房卡或虛擬房卡等形式。PAGEPAGE6T/CSPIA010-2023設(shè)備操作日志記錄功能設(shè)備應(yīng)具備保留消費者和維護人員操作設(shè)備的日志記錄功能。數(shù)據(jù)傳輸及流程功能AB。性能要求人臉圖像質(zhì)量設(shè)備采集的人臉圖像質(zhì)量應(yīng)符合GB/T35678-2017中4.2的相關(guān)技術(shù)要求。光照適應(yīng)性在均勻光照環(huán)境下，設(shè)備的最高人臉適應(yīng)光照大于等于30001x，最低人臉適應(yīng)光照小于等于501x。人臉姿勢適應(yīng)性3020°、傾斜角度小于45°的人臉進行人證核驗，當(dāng)人臉姿勢不符合上述要求時，設(shè)備宜給出提示。人臉識別準確率在滿足6.2、6.3的要求下，設(shè)備的人臉識別準確率不低于99%。響應(yīng)時間設(shè)備人臉讀取、檢測、傳輸、驗證及返回驗證結(jié)果的累計響應(yīng)時間宜不長于3s。安全要求安全防護設(shè)備應(yīng)符合以下物理安全要求：自身安全保護功能，在設(shè)備人機交互模塊、智能管理模塊、聯(lián)網(wǎng)通訊模塊等受到物理攻擊時能及時自動進行告警；在電源斷電或者更換電池時，設(shè)備日志信息不丟失；WIFI數(shù)據(jù)安全用戶登錄驗證設(shè)備應(yīng)對用戶進行登錄驗證，宜具有關(guān)閉遠程登錄和登錄失敗處理的功能。軟件更新安全設(shè)備宜支持在線更新應(yīng)用軟件和固件。T/CSPIA010-2023數(shù)據(jù)庫加密設(shè)備應(yīng)支持本地數(shù)據(jù)庫的加密訪問和存儲。安全角色管理設(shè)備應(yīng)支持不同角色實現(xiàn)設(shè)備的安全管理。個人數(shù)據(jù)保護個人數(shù)據(jù)顯示保護個人數(shù)據(jù)打印保護設(shè)備向消費者提供消費憑證打印時，應(yīng)對名字、手機號、證件號碼等個人數(shù)據(jù)脫敏打印。個人數(shù)據(jù)存儲保護設(shè)備存儲消費者操作日志應(yīng)對姓名、手機號、證件號碼、人臉圖像等個人數(shù)據(jù)加密保存。硬件要求外觀應(yīng)符合GA/T1755-2020中4.1.1的規(guī)定。機械結(jié)構(gòu)應(yīng)符合GA/T1755-2020中4.1.2的規(guī)定。外殼防護等級應(yīng)符合GA/T1755-2020中4.1.3的規(guī)定。電源要求應(yīng)符合GA/T1755-2020中4.5的規(guī)定。電氣安全要求應(yīng)符合GA/T1755-2020中4.6的規(guī)定。電磁兼容性要求應(yīng)符合GA/T1755-2020中4.7的規(guī)定。試驗方法功能試驗系統(tǒng)接入功能試驗PAGEPAGE8T/CSPIA010-2023設(shè)備系統(tǒng)接入功能試驗按照以下方法進行：測試人員預(yù)訂酒店客房，預(yù)訂后在該設(shè)備中進行自助入住操作，判定結(jié)果是否符合5.1中a）的要求；9.1.1a）5.1中b）的要求；9.1.15.1c）的要求；9.1.15.1中d）的要求。人員信息采集與核驗試驗設(shè)備人員信息采集與核驗試驗按照以下方法進行：5.2a）的要求；5.2b）的要求；9.1.2a）b）5.2c）的要求。房型選擇功能5.3電子支付功能5.4支付憑證打印功能9.1.45.5發(fā)放房卡在9.1.5試驗后，測試人員觀察設(shè)備提供房卡狀況,判定結(jié)果是否符合5.6的要求。設(shè)備操作日志記錄在9.1.2～9.1.6試驗后，查看設(shè)備操作日志，判定結(jié)果是否符合5.7的要求。性能試驗人臉圖像質(zhì)量試驗9.1.26.1光照適應(yīng)性試驗設(shè)備光照適應(yīng)性試驗應(yīng)按照以下方法進行：GA/T1324-2017A.1.23000lx9.1.2c）試驗，觀察人證核驗情況；T/CSPIx9.1.2c）試6.2GA/T1324-2017A.1.250lx9.1.210lx9.1.2c）試驗直6.2人臉姿態(tài)適應(yīng)性試驗測試人員按照人證核驗試驗方法依次進行不同人臉姿態(tài)試驗，確保測試人員出現(xiàn)正面、303020204545°至少七6.3人證識別準確率試驗測試人員進行9.1.2中c）試驗，記錄人證核驗準確率，重復(fù)10次，計算平均人證核驗準確率，判定結(jié)果是否符合6.4的要求。響應(yīng)時間試驗測試人員將身份證件放在設(shè)備證件讀取區(qū)域且測試人員的人臉置于設(shè)備人臉圖像采集區(qū)域開始計時，至設(shè)備給出核驗結(jié)果，結(jié)束計時，記錄人證核驗結(jié)果響應(yīng)時間，重復(fù)10次，計算每次平均響應(yīng)時間，判定結(jié)果是否符合6.5的要求。安全試驗安全防護試驗設(shè)備安全防護試驗應(yīng)按照以下方法進行：采用物理攻擊手段對設(shè)備組成模塊進行測試，檢查設(shè)備是否出現(xiàn)告警并檢查設(shè)備的7.1a）的要求；30min，之后重新加電7.1b）的要求；進入設(shè)備的操作系統(tǒng)，查看網(wǎng)絡(luò)資源訪問控制策略。按照策略進行配置是否開啟訪WIFI7.1c）的要求。數(shù)據(jù)安全試驗用戶登錄驗證試驗7.2.1軟件更新安全試驗對設(shè)備應(yīng)用軟件和固件進行更新，檢查設(shè)備是否能夠?qū)?yīng)用軟件和固件安裝包的完整性PAGEPAGE10T/CSPIA010-2023和合法性進行驗證，判定結(jié)果是否符合7.2.2的要求。數(shù)據(jù)庫加密試驗7.2.3安全角色管理試驗7.2.4個人數(shù)據(jù)保護試驗個人數(shù)據(jù)顯示保護試驗7.2.5.1個人數(shù)據(jù)打印保護試驗7.2.5.2個人數(shù)據(jù)存儲保護試驗在9.1.7測試后，測試人員導(dǎo)出操作日志規(guī)范，觀察操作日志并進行人臉圖像、身份信息等敏感信息的逆向解碼，判定結(jié)果是否符合7.2.5.3的要求。硬件試驗外觀試驗按照GA/T1755-2020中5.2.1規(guī)定的試驗方法進行試驗，判定結(jié)果是否符合8.1的要求。機械結(jié)構(gòu)試驗按照GA/T1755-2020中5.2.2規(guī)定的試驗方法進行試驗，判定結(jié)果是否符合8.2的要求。外殼防護等級試驗按照GA/T1755-2020中5.2.3規(guī)定的試驗方法進行試驗，判定結(jié)果是否符合8.3的要求。電源要求試驗GA/T1755-20205.68.4電氣安全試驗GA/T1755-20205.78.5電磁兼容性試驗T/CSPIA010-2023GA/T1755-20205.88.6檢驗規(guī)則檢驗分類設(shè)備檢驗分為型式檢驗和出廠檢驗兩種類型。型式檢驗有下列情況之一時應(yīng)進行型式檢驗：a）新老設(shè)備轉(zhuǎn)廠生產(chǎn)時；正式生產(chǎn)后，如結(jié)構(gòu)、材料、工藝、生產(chǎn)設(shè)備和管理有較大改變可能影響設(shè)備性能時；產(chǎn)品長期（1）停產(chǎn)后恢復(fù)生產(chǎn)時；國家有關(guān)產(chǎn)品質(zhì)量監(jiān)督機構(gòu)提出要求或合同規(guī)定等。出廠檢驗A組檢驗（逐批）：交收產(chǎn)品時，進行抽樣檢驗。B組檢驗（周期）：每半年進行一次，受試產(chǎn)品從交收產(chǎn)品中隨機抽取。檢驗項目各類檢驗的檢驗項目應(yīng)符合表1的規(guī)定。表1檢驗項目序號檢驗項目技術(shù)要求試驗方法不合格分類型式檢驗出廠檢驗檢驗編號組批1”2”3”AB1功能要求59.1B●●●●●2性能要求69.2B●●○●●3安全要求79.3A●○○○●4外觀8.19.4.1C○●●○●5機械結(jié)構(gòu)8.29.4.2B○●○○●6外殼防護等級8.39.4.3B○●○○●7電源要求8.49.4.4B●●○●●8電氣安全要求8.59.4.5B●○○●○9電磁兼容性要求8.69.4.6B●○○●○注：“●”表示必須進行檢驗的項目，“○”表示不需要檢驗的項目。抽樣與組批規(guī)則組批規(guī)則交付檢驗的批應(yīng)由同一生產(chǎn)批的產(chǎn)品構(gòu)成。PAGEPAGE12T/CSPIA010-2023抽樣規(guī)則3出廠檢驗分為：a）A組檢驗的樣品數(shù)量按GB/T2828.1的規(guī)定隨機抽??；b）B組檢驗的樣品數(shù)量按GB/T2829的規(guī)定隨機抽取。判定規(guī)則1AB類不合格，則判定為型式檢驗不合格。出廠檢驗抽樣檢測的樣品不合格品數(shù)小于或等于接受數(shù)（Ac），則判為批合格；不合格品數(shù)等于或大于拒收數(shù)（Re），則判為批不合格。ⅡA類不合格品的接收質(zhì)量限（AQL）為1.5，在B組檢驗中，不合格品的不合格質(zhì)量水平（RQL）為20。GB/T2828.1規(guī)定的轉(zhuǎn)移規(guī)則進行放寬檢查或加嚴檢查。不合格品的處理對判為合格批中的不合格品應(yīng)由廠方調(diào)換或修復(fù)成合格品。AB不合格批的再檢驗正常生產(chǎn)和交收檢驗。標志設(shè)備的外殼上應(yīng)有以下銘牌或標志：a）設(shè)備的名稱、商標、型號、廠商；b）執(zhí)行的產(chǎn)品標準號；c）產(chǎn)品的生產(chǎn)日期。隨機技術(shù)文件概述設(shè)備應(yīng)至少附有使用說明書、技術(shù)說明書和供用戶可查詢的地址等文件。使用說明書、技術(shù)說明書以及操作界面應(yīng)是中文編寫。隨機技術(shù)文件被視為設(shè)備的組成部分。使用說明書使用說明書應(yīng)提供使設(shè)備按其技術(shù)條件運行的全部資料。包括以下內(nèi)容：T/CSPIA010-2023a）基本工作原理和操作說明；b）設(shè)備各部件之間的連接；與附件或其他設(shè)備連接的說明；供電電壓范圍，供電頻率范圍，整機功耗；e）工作環(huán)境和儲存環(huán)境的溫度范圍；設(shè)備的外觀尺寸、重量；h）顯示和報警信息的說明；i）日常維護、檢查、保養(yǎng)和清潔。技術(shù)說明書a）設(shè)備組成的部分框圖；b）主要功能及其技術(shù)指標；c）各部件的功能描述；d）主要部件更換和調(diào)試方法；e）保障安全適應(yīng)需注意的事項；f）常見故障的處理；g）設(shè)備供電、信號以及接口連接圖；h）制造廠詳細名稱和地址；i）技術(shù)服務(wù)和維修部門的聯(lián)絡(luò)方式。PAGEPAGE14T/CSPIA010-2023附 錄 A（資料性）數(shù)據(jù)傳輸住宿業(yè)運營管理系統(tǒng)數(shù)據(jù)傳輸自助入住數(shù)據(jù)傳輸A.1A.2，預(yù)訂房間數(shù)據(jù)A.3A.4A.5。A.1參數(shù)名類型說明maxCardNumstring當(dāng)前最大流水號（門鎖同步相關(guān)）jobNumberstring前臺工號bookIdstringPMS預(yù)訂單bookNamestring預(yù)訂人姓名startTimestring入住時間(yyyy-MM-ddhh:mm:ss)endTimestring離店時間(yyyy-MM-ddhh:mm:ss)Daysstring入住總天數(shù)roomTypeListList預(yù)訂房型數(shù)據(jù)(List）見表A.1Phonestring預(yù)訂人電話bookNumstring總訂房數(shù)量Moneystring總價memberIdstring會員IDorderTypestring1日租2鐘點3長包4凌晨房5白天房PMSAgreementUnitIdstring協(xié)議單位IDBookingOrderRoomStatesstring排房狀態(tài)0-已排房1-未排房priceCodestring房價碼bookOrderTypestring訂單類型remarkstring備注A.2T/CSPIA010-2023參數(shù)名類型說明checkinTimestring入住時間(yyyy-MM-ddhh:mm:ss)checkoutTimestring離店時間(yyyy-MM-ddhh:mm:ss)roomTypeIdstring房型IdroomTypeNumstring房型數(shù)量Pricestring房型價格RoomsList預(yù)訂房間數(shù)據(jù)（List）見表A.2PMSRoomTypeIdstringPMS房型IdroomTypeDailyPriceList每日房價數(shù)據(jù)（List）表A.3預(yù)訂房間數(shù)據(jù)傳輸格式參數(shù)名類型說明roomTypeIdstring房型IdroomNumIdstring房間idroomNumstring房間號personListList入住人信息數(shù)據(jù)（List）見表A.3ItemsList每日房價數(shù)據(jù)（List）見表A.4PMSRoomTypeIdstringPMS房型Id表A.4入住人信息數(shù)據(jù)傳輸格式參數(shù)名類型說明idCodestring身份證號（可解析性別，出生日期等信息）personNamestring姓名isOtherstring0-主客1-隨客birthdaystringstring生日(yyyy-MM-dd)Sexstring性別（0-女1-男）addressstring地址idImagestring身份證照片（base64）Phonestring手機號nationstring國籍表A.5每日房價數(shù)據(jù)傳輸格式PAGEPAGE16T/CSPIA010-2023參數(shù)名類型說明roomTypeIdstring房型IddailyTimestring時間（例如20171120）Pricestring每日房價單位：分PMSRoomTypeIdstringPMS房型IdPMSDailyTimestringyyyy-mm-dd自助續(xù)住數(shù)據(jù)傳輸設(shè)備自助續(xù)住數(shù)據(jù)傳輸格式見表A.6。表A.6自助續(xù)住數(shù)據(jù)傳輸格式參數(shù)名類型說明bookIdstring訂單IDregistIdstring房單IDroomNostring房間號endTimestring離店時間(yyyy-MM-dd)dayNumstring續(xù)住天數(shù)Typestring訂單類型0-自助服務(wù)設(shè)備下單1-云營銷錄入預(yù)訂單2-PMS3-PMS4-APP5-小程序下單remarkstring續(xù)住備注自助退房數(shù)據(jù)傳輸設(shè)備自助退房數(shù)據(jù)傳輸格式見表A.7。表A.7自助退房數(shù)據(jù)傳輸格式參數(shù)名類型說明bookIdstring預(yù)訂單idregistIdstring房單idroomNumstring房間號財務(wù)數(shù)據(jù)傳輸設(shè)備財務(wù)數(shù)據(jù)傳輸中入住數(shù)據(jù)傳輸格式見表A.8,續(xù)住數(shù)據(jù)傳輸格式見表A.9,退房數(shù)據(jù)傳輸格式見表A.10。表A.8財務(wù)數(shù)據(jù)傳輸中入住數(shù)據(jù)傳輸格式T/CSPIA010-2023參數(shù)名必選類型說明bookId是string預(yù)訂單IdregistId是string房單IdroomNum是string房間號channel是string1微信2支付寶3預(yù)授權(quán)4銀行卡totalPrice是string支付總金額單位：分preferentialPrice是string優(yōu)惠金額單位：分payType是string支付用途（是否房單入?。﹎essage是string支付備注信息payCodeName是stringPMS付款名稱acountName是stringPMS掛賬名稱acountId是stringPMS掛賬IDpayCode是stringPMS付款碼Type是string訂單類型paymentId是string第三方支付IDcardNumber是string銀行卡號authorizeId是string授權(quán)號operationtype是string預(yù)授權(quán)操作0：添加1：完成2：取消sellerAccount是string收款人卡號sellerID是string收款人第三方平臺IDthirdAccount是string第三方訂單號Trace是string交易流水號tradeDate是string交易日期IP是string預(yù)授權(quán)交易終端IPeffectiveDays是string有效期天數(shù)(交易的有效天數(shù)，多數(shù)是預(yù)授權(quán)的有效期)flag是string0-普通支付1-銀行卡表A.9財務(wù)數(shù)據(jù)傳輸中續(xù)住數(shù)據(jù)傳輸格式參數(shù)名類型說明bookIdstring預(yù)訂單IdPAGEPAGE18T/CSPIA010-2023參數(shù)名類型說明registIdstring房單IdroomNumstring房間號channelstring1微信2支付寶3預(yù)授權(quán)4銀行卡totalPricestring支付總金額單位：分preferentialPricestring優(yōu)惠金額單位：分payTypestring支付用途messagestring支付備注信息payCodeNamestringPMS付款名稱acountNamestringPMS掛賬名稱acountIdstringPMS掛賬IDpayCodestringPMS付款碼typestring訂單類型paymentIdstring第三方支付IDcardNumberstring銀行卡號authorizeIdstring授權(quán)號operationtypestring預(yù)授權(quán)操作0：添加1：完成2：取消sellerAccountstring收款人卡號sellerIDstring收款人第三方平臺IDthirdAccountstring第三方訂單號tracestring交易流水號tradeDatestring交易日期IPstring預(yù)授權(quán)交易終端IPeffectiveDaysstring有效期天數(shù)(交易的有效天數(shù)，多數(shù)是預(yù)授權(quán)的有效期)flagstring0-普通支付1-銀行卡表A.10財務(wù)數(shù)據(jù)傳輸中退房數(shù)據(jù)傳輸格式參數(shù)名類型說明bookIdstring預(yù)訂單IdregistIdstring房單IdroomNumstring房間號T/CSPIA010-2023參數(shù)名類型說明channelstring1微信2支付寶3預(yù)授權(quán)4銀行卡totalPricestring支付總金額單位：分preferentialPricestring優(yōu)惠金額單位：分payTypestring支付用途messagestring支付備注信息payCodeNamestringPMS付款名稱acountNamestringPMS掛賬名稱acountIdstringPMS掛賬IDpayCodestringPMS付款碼typestring訂單類型paymentIdstring第三方支付IDcardNumberstring銀行卡號authorizeIdstring授權(quán)號operationtypestring預(yù)授權(quán)操作0：添加1：完成2：取消sellerAccountstring收款人卡號sellerIDstring收款人第三方平臺IDthirdAccountstring第三方訂單號tracestring交易流水號tradeDatestring交易日期IPstring預(yù)授權(quán)交易終端IPeffectiveDaysstring有效期天數(shù)(交易的有效天數(shù)，多數(shù)是預(yù)授權(quán)的有效期)flagstring0-普通支付1-銀行卡住宿人員信息采集系統(tǒng)數(shù)據(jù)傳輸自助入住數(shù)據(jù)傳輸設(shè)備自助入住數(shù)據(jù)傳輸格式見表A.11。表A.11自助入住數(shù)據(jù)傳輸格式參數(shù)名類型說明addressstring地址PAGEPAGE20T/CSPIA010-2023參數(shù)名類型說明nationint民族編碼nationNamestring民族名稱sexint性別personNamestring姓名idCodestring身份證號加密idImagestringbase64字符串idCodeValidStartstring身份證有效期開始時間hidint酒店編碼cjImagestringbase64字符串xsdstring相似度onepersonint是否為同一個人roomNumstring房間號idtypeint證件類型phonestring消費者手機號碼自助退房數(shù)據(jù)傳輸設(shè)備自助退房數(shù)據(jù)傳輸格式見表A.12。表A.12自助退房數(shù)據(jù)傳輸格式參數(shù)名類型說明greateidstring旅館業(yè)治安管理系統(tǒng)上傳返回的主鍵idconfigstringJson單家酒店的常規(guī)配置信息門禁系統(tǒng)數(shù)據(jù)傳輸實體卡門禁數(shù)據(jù)傳輸實體卡門禁數(shù)據(jù)傳輸中讀卡數(shù)據(jù)傳輸格式見表A.13,寫卡數(shù)據(jù)傳輸格式見表A.14,注銷卡數(shù)據(jù)傳輸格式見表A.15。表A.13實體卡門禁讀卡數(shù)據(jù)傳輸格式參數(shù)名類型說明comstring串口號ReaderTypestring卡類型T/CSPIA010-2023參數(shù)名類型說明SysCodestring系統(tǒng)編號HotelCodestring酒店編號Encoderstring預(yù)留TMEncoderstring預(yù)留表A.14實體卡門禁寫卡數(shù)據(jù)傳輸格式參數(shù)名類型說明comstring串口號ReaderTypestring卡類型SysCodestring系統(tǒng)編號HotelCodestring酒店編號Encoderstring預(yù)留TMEncoderstring預(yù)留BeginTimestring開始時間EndTimestring結(jié)束時間LockNostring鎖號GuestNostring消費者流水號（對應(yīng)PMS最大流水號）CardNostring卡號GuestNamestring消費者名稱IsChildrenstring是否隨行卡表A.15實體卡門禁注銷卡數(shù)據(jù)傳輸格式參數(shù)名類型說明comstring串口號ReaderTypestring卡類型SysCodestring系統(tǒng)編號HotelCodestring酒店編號Encoderstring預(yù)留TMEncoderstring預(yù)留BeginTimestring開始時間PAGEPAGE22T/CSPIA010-2023參數(shù)名類型說明EndTimestring結(jié)束時間LockNostring鎖號GuestNostring消費者流水號（對應(yīng)PMS最大流水號）CardNostring卡號GuestNamestring消費者名稱IsChildrenstring是否隨行卡虛擬卡門禁數(shù)據(jù)傳輸虛擬卡門禁入住數(shù)據(jù)傳輸格式見表A.16,續(xù)住數(shù)據(jù)傳輸格式見表A.17,退房數(shù)據(jù)傳輸格式見表A.18。表A.16虛擬卡門禁入住數(shù)據(jù)傳輸格式參數(shù)名類型名稱說明入?yún)onfigstring門鎖參數(shù)Json字符串，門鎖設(shè)備參數(shù)可自定義，示例：{"item":[{"name":"名稱1","param1":""},{"name":"名稱2","param2":""}]}personInfoListList入住人集合SendPersonInfo實體類集合appKeystringappKey項目KeyappSecretstringappSecret項目SecretappIdstringappId項目IdfirstCheckboolean是否第一個人入住用于判斷是否清除設(shè)備人員信息，主要區(qū)分入住和續(xù)住SendPersonInfo參數(shù)personNamestring姓名設(shè)備唯一編碼personSexstring性別男、女personNationstring民族名稱可空personBirthYearstring出生年yyyypersonBirthMonthstring出生月mmpersonBirthDaystring出生日ddT/CSPIA010-2023參數(shù)名類型名稱說明personBirthYYYYMMDDstring出生年月日yyyymmddpersonAddressstring地址personIdCardNostring身份證號personIdImgUrlstring證件照Bese64personCjImgUrlstring實時采集照Bese64personPhonestring消費者手機號checkOutTimestring離店時間可空checkOutTimeLongstring人員權(quán)限的有效期授權(quán)開始時間,授權(quán)結(jié)束時間1598673600000,1598760000000返參datastring返回參數(shù)Json字符串statusstring返回狀態(tài)成功:success失敗:errorerrorstring返回碼成功:0失敗:-1errorMsgstring錯誤信息注釋接口說明：消費者入住授權(quán)操作。將授權(quán)成功的人員編碼返回。通過firstCheck表A.1