(高清版)GB∕T 37976-2019 物联网 智慧酒店应用 平台接口通 用技术要求

L79中华人民共和国国家标准物联网智慧酒店应用平台接口通用技术要求I——G2019-08-30发布2020-03-01实施国家市场监督管理总局GB／T37976—2019 1范围 2规范性引用文件 3术语和定义 4缩略语 5概述 6平台接口 6.1应用技术要求 6.2接口定义方式和数据类型说明 6.2.1数据接口定义方式 6.2.2接口数据类型 6.3PMS接口 6.3.1基础代码获取接口 6.4酒店其他管理系统接口 6.4.2客房控制服务 6.4.3客房娱乐服务 6.4.4公安数据接入 7接口安全要求 7.1结构安全 7.2访问控制 7.3安全审计 7.4边界完整性检查 7.5入侵防范 7.6网络设备防护 ⅠⅢGB／T37976—2019本标准按照GB/T1.1—2009给出的规则起草。请注意本文件的某些内容可能涉及专利。本文件的发布机构不承担识别这些专利的责任。本标准由全国信息技术标准化技术委员会(SAC/TC28)提出并归口。本标准起草单位：中国电子技术标准化研究院、新新人类（北京）科技有限公司、智慧壹号（北京）酒店管理有限公司、杭州绿云软件有限公司、深圳赛西信息技术有限公司、公安部第三研究所、山东比特智能科技股份有限公司、快住智能科技（苏州）有限公司、上海别样红信息技术有限公司、上海逸邻网络科技有限公司、广东必达保安系统有限公司、惠州市尊宝智能控制股份有限公司、深圳市盛阳科技股份有限公司、杭州云柚科技有限公司、TCL王牌电器（惠州）有限公司、深圳欢旅科技有限公司、常州市邦威电子科技有限公司。本标准起草人：张晖、郭迪胜、耿力、李孟良、杨宏、信宏业、赵焕焱、荀亮亮、路小北、谷慧敏、曹现贵、朱彤、黄华、杨铭魁、陈海滨、郭迎光、冯震维、陈伟禧、黄晓凌、张勇、吕坡、张敬宇、曾文涛、刘乃钢、王建青、余晖、陈雪明、唐建国、陈妙强、黄俭、杨枫、穆林、张华、李翔、邹子平、裘永强、沈伟明、李桂琴、朱家川、王加梁、李广飞、闫宏河、闻涛、李云鹏、刘卫东、田彩云、李东升、周山、王烨、王浩炅、王袆涛、汤铭、孟周俊、俞海钟、刘宗科、邹宇航、杨诗兵、李俱顺。1GB／T37976—2019物联网智慧酒店应用平台接口通用技术要求本标准规定了基于物联网技术的智慧酒店应用平台接口通用技术要求。本标准适用于基于物联网技术的智慧酒店应用平台接口设计。2规范性引用文件下列文件对于本文件的应用是必不可少的。凡是注日期的引用文件，仅注日期的版本适用于本文件。凡是不注日期的引用文件，其最新版本（包括所有的修改单）适用于本文件。GB/T33745—2017物联网术语3术语和定义GB/T33745—2017界定的以及下列术语和定义适用于本文件。3.1通过应用先进的信息和通信技术，实现管理数字化、网络化和智能化的酒店。3.2将酒店的客户管理、客房管理、接待管理、账务管理、审核管理、销售管理等多个管理模块或系统汇集并形成的管理平台。3.3平台内部子系统、子模块之间，以及该平台与外部平台、系统之间的相互连接与交互的接口。4缩略语下列缩略语适用于本文件。5概述智慧酒店应用一般通过基于物联网技术的智慧酒店综合信息管理平台实现，平台架构如图1所示，由PMS和酒店其他管理系统组成。物联网传感单元信息通过事务处理系统及其他系统与PMS进行数据交换，智慧酒店通过该平台提供应用服务。2GB／T37976—2019图1基于物联网的智慧酒店综合信息管理平台架构智慧酒店综合信息管理平台接口包括PMS接口和酒店其他管理系统接口。PMS接口包括：基础代码接口、客房管理接口、客房订单接口、前台业务接口和会员服务接口等。酒店其他管理系统接口包括：门锁服务接口、客房控制接口、人工智能机器人服务接口、智能消防控制接口、客房娱乐接口和公安传输数据接口等。智慧酒店综合信息管理平台的各接口之间可进行相互调用，也可以供外部应用服务调用，以满足具体业务服务需求。6平台接口6.1应用技术要求智慧酒店应围绕物联网六域模型体系建立包括PMS及相关联的应用技术内容。智慧酒店建设应用技术体系架构如图2所示。3GB／T37976—2019图2智慧酒店建设应用技术体系架构6.2接口定义方式和数据类型说明6.2.1数据接口定义方式规定如下：按PMS接口和酒店其他管理系统接口归纳各子类数据接口，并在各类数据接口进一步划分为细类数据接口。4GB／T37976—20191）各个接口定义按以下格式描述：条款号接口名（说明：使用中文和原语给出接口名）［功能说明］（说明：简要陈述该接口的功能）［请求参数说明：用以下列表形式给出所请求的参数）字段中文名称数据类型数量说明用原语给出该字段包含的参数名该参数的中文名用于描述该参数的数据类型所请求的该参数的数量对前面栏目的补充说明 ［响应数据说明：用以下列表形式给出响应数据）字段中文名称数据类型数量说明用原语给出该字段包含的数据名该参数据的中文名用于描述该数据的数据类型所请求的该数据的数量对前面栏目的补充说明 XXXXDto不止一个此项）字段中文名称数据类型数量说明用原语给出该字段包含的数据名该字段的中文名用于描述该字段的数据类型所请求的该字段的数量对前面栏目的补充说明—————［请求示例说明：下面给出具体请求示例）2）关于接口定义中的“数量”，说明如下：1：表示有且仅有一个。Json包括如下几种类型：b）整数型数据，用Number表示；c）小数型数据，用Decimal表示；说明。GB／T37976—20196.3PMS接口［功能说明］获取国家信息。［请求参数］字段中文名称数据类型数量说明酒店集团代码String1 ［响应数据］字段中文名称数据类型数量说明resultCode结果代码String1字段操作结果resultMsg结果信息String1返回提示信息结果对象n返回数据对象字段中文名称数据类型数量说明代码String1 descript名称String1 ［请求示例］{}［返回示例］{"resultCode":0,"resultInfo":[{"code":"CHN",{"code":"USA",]}56GB／T37976—2019［功能说明］获取指定酒店集团的城市信息。［请求参数］字段中文名称数据类型数量说明酒店集团代码String1—［响应数据］字段中文名称数据类型数量说明resultCode结果代码String1—resultMsg结果信息String1 resultInfo返回信息n 字段中文名称数据类型数量说明代码String1 descript名称String1 ［请求示例］{}［返回示例］{"resultCode":0,"resultInfo":[{{"code":"SH",}]}［功能说明］获取证件类型信息。7GB／T37976—2019［请求参数］字段中文名称数据类型数量说明酒店集团代码String1 hotelCode酒店代码String1 ［响应数据］字段中文名称数据类型数量说明resultCode结果代码String1—resultMsg结果信息String1—resultInfo返回信息IdCodeDto[]n—IdCodeDto字段中文名称数据类型数量说明代码String1 descript名称String1 ［请求示例］{"hotelCode":"GCBZ"}［返回示例］{"resultCode":0,"resultInfo":[{{}]}［功能说明］获取证件类型信息。［请求参数］8GB／T37976—2019字段中文名称数据类型数量说明酒店集团代码String1—hotelCode酒店代码String1 ［响应数据］字段中文名称数据类型数量说明resultCode结果代码String1 resultMsg结果信息String1 resultInfo返回信息SexDto[]n SexDto字段中文名称数据类型数量说明代码String1—descript名称String1—［请求示例］{"hotelCode":"GCBZ"}［返回示例］{"resultCode":0,"resultInfo":[{{}}［功能说明］获取指定酒店集团相关条件下的酒店列表。［请求参数］GB／T37976—2019字段中文名称数据类型数量说明酒店集团代码String1—hotelCode酒店代码String 城市代码String brandCodes品牌代码Stringn ［响应数据］字段中文名称数据类型数量说明resultCode结果代码String1—resultMsg结果信息String1—resultInfo返回信息HotelInfoDto[]n—HotelInfoDto字段中文名称数据类型数量说明酒店代码String1 status酒店状态String1 descript酒店名称String1 酒店所在国家代码String1 酒店所在城市String1—address地址String1—phone电话String1—website网址String1—email电子邮箱String1 remark备注String1 Type酒店类型String1度假、商务starLevel酒店星级String1 coordinates酒店坐标String1经纬度坐标［请求示例］{}［返回示例］{"resultCode":0,"resultInfo":[{"code":"HTL",9GB／T37976—2019"status":"I","address":"安徽省黄山市","fax":"","website":"","remark":""}]}［功能说明］获取酒店的房型信息列表。［请求参数］字段中文名称数据类型数量说明酒店集团代码String1 hotelCode酒店代码String1 ［响应数据］字段中文名称数据类型数量说明resultCode结果代码String1 resultMsg结果信息String1 resultInfo返回信息n RoomTypeDto字段中文名称数据类型数量说明房型代码String1—descript房型描述String1—maxAdults最大成人数number1—maxChildren最大儿童数number1—［请求示例］{"hotelCode":"HTL"}GB／T37976—2019［返回示例］{"resultCode":0,"resultInfo":[{"code":"HHSC",{"code":"HWDC",]}［功能说明］获取酒店楼层信息。［请求参数］字段中文名称数据类型数量说明酒店集团代码String1 HotelCode酒店代码String1—［响应数据］字段中文名称数据类型数量说明resultCode结果代码String1 resultMsg结果信息String1 resultInfo返回信息FloorDto[]n FloorDto字段中文名称数据类型数量说明代码String1—descript名称String1—［请求示例］{}［返回示例］{GB／T37976—2019"resultCode":0,"resultInfo":[{"{}]}［功能说明］获取酒店客房特征信息。［请求参数］字段中文名称数据类型数量说明酒店集团代码String1 hotelCode酒店代码String ［响应数据］字段中文名称数据类型数量说明resultCode结果代码String1 resultMsg结果信息String1—resultInfo返回信息FeatureDto[]n—FeatureDto字段中文名称数据类型数量说明代码String1 descript名称String1 ［请求示例］{}［返回示例］{"resultCode":0,GB／T37976—2019"resultInfo":[{"code":"NS",{"code":"SM",]}［功能说明］查询房间状态。［请求参数］字段中文名称数据类型数量说明酒店集团代码String1 hotelCode酒店代码String1 sta状态StringVR（空净VD（空）OR（住净OD（住脏）flag是否返回入住人String针对在住的房间currentPage当前页number—分页数量number—［响应数据］字段中文名称数据类型数量说明resultCode结果代码String1—resultMsg结果信息String1—resultInfo返回信息RoomDto[]n—RoomDto字段中文名称数据类型数量说明building楼栋String1 floor楼层String1—isDep是否将离String1—roomType房型String1—guests住客信息GuestDto[]—roomNo房号String1—GB／T37976—2019GuestDto字段中文名称数据类型数量说明name姓名String1 idNo证件号码String rsvClass预订类型StringarrDate到达时间String1depDate离开时间String1mobile手机号码String—［请求示例］{"hotelCode":"HTL","sta":"OR",}［返回示例］{"resultCode":1,"resultInfo":[{"sta":"OR","idNo":,"rsvClass":"F","arrDate":"2016-10-1315:53:23","mobile":"roomNo":"002"GB／T37976—2019"floor":"2","sta":"OR","idNo":,"rsvClass":"F","arrDate":"2016-10-1316:42:39","mobile":"roomNo":"08"}}［功能说明］更新房间状态。［请求参数］字段中文名称数据类型数量说明酒店集团代码String1 hotelCode酒店代码String1—roomNo房号String1—roomSta状态String1新的房态(D：脏房；I：检查；beginDate开始日期StringendDate结束日期Stringreason维修或锁定理由String仅针对维修、锁定、临时态有效［响应数据］字段中文名称数据类型数量说明resultCode结果代码String1 resultMsg结果信息String1 ［请求示例］{GB／T37976—2019"hotelCode":"HTL","roomNo":"201","roomSta":"R"}［返回示例］{"resultCode":0,}［功能说明］获取酒店可用房量。［请求参数］字段中文名称数据类型数量说明酒店集团代码String1—hotelCode酒店代码String1 arrDate到达日期String1depDate结束日期String1注：不含本日roomTypes房型Stringn多房型间使用逗号隔开；不传递该参数表示所有［响应数据］字段中文名称数据类型数量说明resultCode结果代码String1—resultMsg结果信息String1—resultInfo返回信息availDto[]n—availDto字段中文名称数据类型数量说明酒店集团代码String1—hotelCode酒店代码String1 roomType房型String1 roomClass房型类别String1—occDate日期String1—roomTypeNum房型总房数number1 GB／T37976—2019字段中文名称数据类型数量说明oooNum维修房数number1—osNum维护房数number1 avail可用房数number1 limitNum超预留数量number1—availWithLimit包含超预留可用房数number1—［请求示例］{"hotelCode":"HTL","arrDate":"2016-10-18",}［返回示例］{"resultCode":1,"resultInfo":[{"hotelCode":"HTL","roomClass":"A","occDate":"2016-10-18","oooNum":0,"osNum":0,"limitNum":0"availWithLimit":0,}]}［功能说明］获取酒店指定时间内的可卖房号。［请求参数］GB／T37976—2019字段中文名称数据类型数量说明酒店集团代码String1—hotelCode酒店代码String1—arrDate到达日期String1depDate结束日期String1roomTypes房型Stringn多房型逗号隔开roomsFilter指定房号Stringn多房号逗号隔开isClean是否仅干净房StringT/F［响应数据］字段中文名称数据类型数量说明resultCode结果代码String1 resultMsg结果信息String1 resultInfo返回信息RoomSaleableDto[]n RoomSaleableDto字段中文名称数据类型数量说明roomNo房号String1 roomTypeString1—bedNum床数number1—roomSta状态String1IoccSta占用状态String1featureCodes特征代码Stringn—floorCode楼层String1 ［功能说明］获取酒店指定时间内的可卖房。［请求参数］字段中文名称数据类型数量说明酒店集团代码String1 hotelCode酒店代码Stringn多酒店逗号分隔arrdate到达日期String1入住天数number1—城市代码String1—brandCode品牌代码String—firstPage起始页数number—GB／T37976—2019字段中文名称数据类型数量说明分页数量number—rateCodes房价码Stringn channelCode渠道代码String ［响应数据］字段中文名称数据类型数量说明resultCode结果代码String1—resultMsg结果信息String1—resultInfo返回信息HotelOrderableDto[]n HotelOrderableDto字段中文名称数据类型数量说明rateQueryList可订列表RateListDto[]1—totalRows总行数number1 RateListDto字段中文名称数据类型数量说明hotelCode酒店代码String1—rateList房价信息RateDto[]n—minRate最小房价decimal1—rateCodes房价代码n—roomTypes房型代码Stringn RateDto字段中文名称数据类型数量说明rateCode房价码String1—roomType房型String1 firstRate首日房价Decimal1 avgRate均价Decimal1 sourceCode来源码String1 marketCode市场String1 包价String advMin最小提前天数number advMax最大提前天数number—stayMin最小入住天数number—stayMax最大入住天数number—avail可订房数number1 bookingSum总数量number1—GB／T37976—2019［请求示例{"hotelCode":"HTL","arrdate":"2016-10-18","channelCode":"WEB","rateCodes":"GOV"}［返回示例］{"resultCode":0,"resultInfo":{{"hotelCode":"HTL","roomList":["ratecode":"GOV","firstRate":"275.00","sourceCode":"HDR","marketCode":"GOV","advMin":0,"advMax":0,"avail":99,"ratecode":"GOV","firstRate":"275.00","sourceCode":"HDR","marketCode":"GOV","advMin":0,GB／T37976—2019"advMax":0,"avail":28,],"minRate":"180.00","rateCodes":"GOV,SK",],"totalRows":1}}［功能说明］获取酒店市场分类代码信息。［请求参数］字段中文名称数据类型数量说明酒店集团代码String1 HotelCode酒店代码String ［响应数据］字段中文名称数据类型数量说明resultCode结果代码String1 resultMsg结果信息String1—resultInfo返回信息MarketDto[]n—MarkeDtot字段中文名称数据类型数量说明代码String1 descript名称String1 ［请求示例］{}GB／T37976—2019［返回示例］{"resultCode":0,"resultInfo":[{"code":"COR",{"code":"FIT",]}［功能说明］［请求参数］字段中文名称数据类型数量说明酒店集团代码String1 HotelCode酒店代码String ［响应数据］字段中文名称数据类型数量说明resultCode结果代码String1—resultMsg结果信息String1—resultInfo返回信息SourceDto[]n—SourceDto字段中文名称数据类型数量说明代码String1 descript名称String1—［请求示例］{}［返回示例］{GB／T37976—2019"resultCode":0,"resultInfo":[{"code":"INT",{"code":"LOCAL",}]}［功能说明］获取酒店客房销售渠道分类代码信息。［请求参数］字段中文名称数据类型数量说明酒店集团代码String1—HotelCode酒店代码String—［响应数据］字段中文名称数据类型数量说明resultCode结果代码String1 resultMsg结果信息String1 resultInfo返回信息ChannelDto[]n ChannelDto字段中文名称数据类型数量说明代码String1—descript名称String1—［请求示例］{}［返回示例］{"resultCode":0,GB／T37976—2019"resultInfo":[{"code":"CRS",{"code":"OTA",}]}［功能说明］获取宾客特殊要求信息。［请求参数］字段中文名称数据类型数量说明酒店集团代码String1 HotelCode酒店代码String ［响应数据］字段中文名称数据类型数量说明resultCode结果代码String1—resultMsg结果信息String1—resultInfo返回信息n—SpecialDto字段中文名称数据类型数量说明代码String1 descript名称String1 ［请求示例］{}［返回示例］{"resultCode":0,"resultInfo":[{GB／T37976—2019"code":"EARLYCI",]}［［请求参数］字段中文名称数据类型数量说明酒店集团代码String1—HotelCode酒店代码String—［响应数据］字段中文名称数据类型数量说明resultCode结果代码String1 resultMsg结果信息String1 resultInfo返回信息n PackageDto字段中文名称数据类型数量说明代码String1—descript名称String1 ［请求示例］{}［返回示例］{"resultCode":0,"resultInfo":[{"code":"BF",{"code":"SVC",GB／T37976—2019]}［功能说明］获取证件类型信息。［请求参数］字段中文名称数据类型数量说明酒店集团代码String1 hotelCode酒店代码String1 ［响应数据］字段中文名称数据类型数量说明resultCode结果代码String1—resultMsg结果信息String1—resultInfo返回信息TransactionDto[]n TransactionDto字段中文名称数据类型数量说明代码String是 descript名称String是—类别代码String否—appScope适用范围String否—账单码String否—［请求示例］{"hotelCode":"GCBZ"}［返回示例］{"resultCode":0,"resultInfo":[{GB／T37976—2019{}]}［功能说明］客人不经过预订，直接在酒店前台办理入住。［请求参数］字段中文名称数据类型数量说明酒店集团代码String1 hotelCode酒店代码String1 rsvClass入住类型String1arrDate入住时间String1depDate退房时间String1roomType房型代码String1—roomNo房号String1 name姓名String1 idCode证件类型String1 idNo证件号码String1 sex性别String1 birthday生日String nation国籍String—cardNo会员卡号String—rateCode房价码String—rate房价Decimal1—包价代码Stringn—marketCode市场代码String1 sourceCode来源代码String1 channelCode渠道String1 GB／T37976—2019［响应数据］字段中文名称数据类型数量说明resultCode结果代码String1—resultMsg结果信息String1—resultInfo返回信息—RegisterIdDto字段中文名称数据类型数量说明id登记单idString1 ［请求示例］{"hotelCode":"HTL","rsvClass":"F","roomNo":"201","name":"张三","idNo":"1234567","nation":"CN","rateCode":"RACK","marketCode":"WAK","sourceCode":"WIK","channelCode":"OTH"}［返回示例］{"resultCode":0,"resultInfo":{"id":"100362"}}GB／T37976—2019［功能说明］创建订单。［请求参数］字段中文名称数据类型数量说明酒店集团代码String1 hotelCode酒店代码String1 arrDate到达日期String1depDate离开日期String1roomType房型String1 rateCode房价码String1—roomNum房数number1—rsvPerson预订人String1—sexCode性别String1—mobile联系电话String1 idType证件类型String1 idNo证件号码String1 email邮箱String1 cardType会员卡类别String1 cardNo会员卡号String1 adultNum人数number1—remark备注String—discAmount优惠金额decimal—channelCode销售渠道String—特殊要求String paySta付款状态String sourceCode来源String marketCode市场String channelCode渠道String 包价Stringn多选dailyRate每日房价Stringn—rooms房号String—charge付款decimal—checkoutMsg结账提醒String—otaChannelOTA渠道String—otaRsvNoOTA预订号String GB／T37976—2019字段中文名称数据类型数量说明otherRsvNo其他预定号String—appid第三方应用idString openid第三方应用的用户idString unionid String ［响应数据］字段中文名称数据类型数量说明resultCode结果代码String1—resultMsg结果信息String1—resultInfo返回信息ResrvDto1—ResrvDto字段中文名称数据类型数量说明crsNo中央订单号String1—paySta支付状态String1—deposit定金Decimal——［请求示例］{"hotelCode":"HTL","arrDate":"2016-08-1518:00:00","rateCode":"BAR","roomNum":"1","rsvMan":"aabbcc","mobile":,"idNo":"","cardNo":"","remark":"","discAmount":"0","channel":"OTH",GB／T37976—2019"channelCode":"WEB","src":"WIK","market":"WAK","crsNo":"P201610180001"}［返回示例］{"resultCode":0,"resultInfo":{"crsNo":"W1610180001"}}［功能说明］给预订单分配房间。［请求参数］字段中文名称数据类型数量说明酒店集团代码String1 hotelCode酒店代码String1 crsNo中央订单号StringrsvNo酒店订单号StringroomType房型String1 roomNos房号Stringn多房号逗号分隔［响应数据］字段中文名称数据类型数量说明resultCode结果代码String1 resultMsg结果信息String1—［请求示例］{"hotelCode":"HTL","crsNo":"W1610180001","roomNos":"1007"}［返回示例］{"resultCode":0,GB／T37976—2019}［其他说明］一般先调用“获取订单列表”接口查询到酒店预订单，然后再调用此接口排房。［功能说明］查询订单列表。［请求参数］字段中文名称数据类型数量说明酒店集团代码String1 crsNo中央订单号String cardNo会员号String arrDate开始日期Stringyyyy-MM-dddepDate结束日期Stringyyyy-MM-ddfirstResult开始行number—分页数量number—［响应数据］字段中文名称数据类型数量说明resultCode结果代码String1 resultMsg结果信息String1 resultInfo返回信息ReservationDto[]1 ReservationDto字段中文名称数据类型数量说明resrvList订单列表ResrvDetailDto[]n—totalRows总数number1—ResrvDetailDto字段中文名称数据类型数量说明id订单唯一标示number1 酒店代码String1 hotelDescript酒店描述String1 crsNo中央订单号String1—rsvNo酒店订单号String1—sta状态String1—staDescript状态描述String1—paySta支付状态String1—GB／T37976—2019字段中文名称数据类型数量说明deposit定金Decimal1—arrDate到达日期String1yyyy-MM-dddepDate离开日期String1yyyy-MM-ddroomType房型String1 roomTypeDescript房型描述String1 rate房价Decimal1 ［请求示例］{"crsNo":"W1610180001"}［返回示例］{"resultCode":0,"resultInfo":{"resrvList":[{"crsNo":"W1610180001","sta":"R","arrDate":"2016-10-18","hotelCode":"HTL",],"totalRows":1}}［功能说明］GB／T37976—2019给订单支付款项。［请求参数］字段中文名称数据类型数量说明酒店集团代码String1 crsNo中央订单号String1 money金额Decimal1—VoucherNo单据号String1—TxnCode入账代码String1—TxnRemark入账备注String1—hotelCode酒店代码String酒店订单付款时必填registerId订单idStringroomNo房号String［响应数据］字段中文名称数据类型数量说明resultCode结果代码String1 resultMsg结果信息String1 ［请求示例］{"crsNo":"W1610180001","VoucherNo":"234000","TxnCode":"9000","TxnRemark":"test"}［返回示例］{"resultCode":0,}［功能说明］录入订单费用。［请求参数］字段中文名称数据类型数量说明酒店集团代码String1—crsNo中央订单号String1—GB／T37976—2019字段中文名称数据类型数量说明money金额Decimal1—VoucherNo单据号String1 TxnCode入账代码String1 TxnRemark入账备注String1 hotelCode酒店代码String酒店订单付款时必填registerId订单idStringroomNo房号String［响应数据］字段中文名称数据类型数量说明resultCode结果代码String1 resultMsg结果信息String1—［请求示例］{"crsNo":"W1610180001","VoucherNo":"234001","TxnCode":"4000","TxnRemark":"test"}［返回示例］{"resultCode":0,}［功能说明］获取指定日期、房型、房价代码的每日房价。［请求参数］字段中文名称数据类型数量说明酒店集团代码String1 hotelCode酒店代码String1—arrDate到达日期String1入住天数String1roomType房型String1—rateCode房价码String—GB／T37976—2019［响应数据］字段中文名称数据类型数量说明resultCode结果代码String1—resultMsg结果信息String1 resultInfo返回信息n DailyRateDto字段中文名称数据类型数量说明date日期String1—rate价格decimal1价格为空值，则表示不可用rateCode房价码String—roomType房型String1—［请求示例］{"hotelCode":"HTL","arrDate":"2016-10-18","rateCode":"RAC"}［返回示例］{"resultCode":0,"resultInfo":[{"rateCode":"RAC",]}［功能说明］保存或更新订单的每日房价。［请求参数］GB／T37976—2019字段中文名称数据类型数量说明酒店集团代码String1—crsNo中央订单号String1 dailyRate每日房价RsvRateWebDto[]n—RsvRateWebDto字段中文名称数据类型数量说明date日期String1yyyy-MM-ddrate价格Decimal1—［响应数据］字段中文名称数据类型数量说明resultCode结果代码String1 resultMsg结果信息String1 ［请求示例］{"crsNo":"W1610180001",}［返回示例］{"resultCode":0,}v［功能说明］取消订单。［请求参数］字段中文名称数据类型数量说明酒店集团代码String1 crsNo中央订单号String1 remark备注String1 ［响应数据］字段中文名称数据类型数量说明resultCode结果代码String1—GB／T37976—2019字段中文名称数据类型数量说明resultMsg结果信息String1—［请求示例］{"crsNo":"W1610180001",}［返回示例］{"resultCode":0,}［功能说明］查询订单详情，包括中央预订和酒店预订的订单。［请求参数］字段中文名称数据类型数量说明酒店集团代码String1 hotelCode酒店代码String非接口产生的订单则此参数必填，如：打电话到酒店预订的订单rsvNo酒店订单号String酒店预订单通过此参数查询crsNo中央订单号String中央订单通过此参数查询［响应数据］字段中文名称数据类型数量说明resultCode结果代码number1 resultMsg结果信息String1—ResultInfo返回信息GuestDto1—GuestDto字段中文名称数据类型数量说明hotelCode酒店代码String1—hotelDescript酒店描述String1—id预订单唯一标示number1—rsvType预订类型String1—rsvMan预订人String1—GB／T37976—2019字段中文名称数据类型数量说明mobile手机String—idType证件类型String idNo证件号码String sexDescript性别描述String1 sex性别代码String1 roomType房型String1 roomTypeDescript房型描述String1 rate房价Decimal1—rmNum房数number1—arrDate到达日期String1yyyy-MM-dddepDate离开日期String1yyyy-MM-ddsta状态String1 staDescript状态描述String1 paySta支付状态String10：无需支付；1：待支付；2：已支付；3：已退款deposit定金Decimal1 rateSum房费合计Decimal1 rateTotal总消费Decimal1 remark备注Decimal1—城市String—createDatetime创建时间String1—modifyDatetime修改时间String1—roomInfo房间入住信息RoomInfoDto[]n订单没排房的时候没有此信息RoomInfoDto字段中文名称数据类型数量说明id登记单唯一标示number1 name住客姓名String1 roomNo房号String1—［请求示例］{"crsNo":"W1610180001"}［返回示例］{GB／T37976—2019"resultCode":0,"resultInfo":{"rateTotal":722,"remark":"","rsvMan":"aabbcc","roomInfo":[{"id":1569021,"name":"张三","roomNo":"201"}],"hotelCode":"GCBZ","rate":720,"rmNum":1,"createDatetime":"2016-10-0920:22:31","idNo":"","crsNo":"W1610180001","sta":"R","arrDate":"2016-10-09","rateSum":720,"mobile":}}［功能说明］包括在住、结账、挂账的订单。GB／T37976—2019［请求参数］字段中文名称数据类型数量说明酒店集团代码String1 hotelCode酒店代码String1 registerId订单idnumber以下参数最少包含一个roomNo房号String—idNo证件号String—mobile手机String—［响应数据］字段中文名称数据类型数量说明resultCode结果代码number1 resultMsg结果信息String1 resultInfo返回信息Stringn同住人以多条记录返回resultInfo字段中文名称数据类型数量说明id订单唯一标示number1 name住客姓名String1 mobile手机String—idType证件类型String—idNo证件号码String—sexDescript性别描述String1—sex性别代码String1—roomNo房号String1 roomType房型String1 roomTypeDescript房型描述String1 rate房价Decimal1 arrDate到达时间String1HH:mm:ssdepDate离开时间String1HH:mm:sssta状态String1—staDescript状态描述String1—deposit定金Decimal1 rateSum房费合计Decimal1 rateTotal总消费Decimal1 remark备注Decimal1 GB／T37976—2019字段中文名称数据类型数量说明createDatetime创建时间String1—modifyDatetime修改时间String1 ［请求示例］{"hotelCode":"GCBZ","roomNo":"0520"}［返回示例］{"resultCode":"0","resultInfo":[{"id":16598,"name":"张三","mobile":,"idNo":"1234567","roomNo":"0520","rate":188,"arrDate":"2016-11-1014:16:46","sta":"I","rateSum":128,"rateTotal":158,"remark":"","createDatetime":"2016-11-0914:19:33",}]}GB／T37976—2019［功能说明］订单入住。［请求参数］字段中文名称数据类型数量说明酒店集团代码String1 hotelCode酒店代码String1 crsNo中央订单号String registerIds订单ID集合Stringn—roomNos房号Stringn—［响应数据］字段中文名称数据类型数量说明resultCode结果代码String1 resultMsg结果信息String1 ［请求示例］{"hotelCode":"HTL","crsNo":"W1610180001","roomNos":"301"}［返回示例］{"resultCode":0,}［功能说明］给订单支付款项。［请求参数］字段中文名称数量说明酒店集团代码String1 hotelCode酒店代码String1—registerIds订单ID集合Stringn—taType账目类别String1closeSta结账状态String1GB／T37976—2019［响应数据］字段中文名称数据类型数量说明resultCode结果代码String1 resultMsg结果信息String1 resultInfo返回结果Stringn—resultInfo字段中文名称数据类型数量说明registerId登记单IDnumber1 number账次编号number1—accountId账务编号number1—roomNo房号String—taCode账务代码String1—taDescript账务名称String1 amount金额Decimal1 taRemark账务备注String createUser创建人String1 createDatetime创建时间String1 ［请求示例］{"closeSta":"0"}［返回示例］{"resultCode":0,"resultInfo":[{"number":1,"accountId":10946,"roomNo":"0530","taCode":"0001","amount":100,"taRemark":"",GB／T37976—2019"createUser":"ADMIN","createDatetime":"2016-11-1011:41:20"}]}［功能说明］宾客延长离店日期。［请求参数］字段中文名称数据类型数量说明酒店集团代码String1 hotelCode酒店代码String1 registerId登记单idString与crsNo二选一必填crsNo中央订单号StringdepDate离店日期String1［响应数据］字段中文名称数据类型数量说明resultCode结果代码String1—resultMsg结果信息String1 ［请求示例］{"hotelCode":"HTL",}［返回示例］{"resultCode":0,}［功能说明］客人退房离店。GB／T37976—2019［请求参数］字段中文名称数据类型数量说明酒店集团代码String1 hotelCode酒店代码String1 registerIds登记单id集合Stringn与crsNo二选一必填crsNo中央订单号StringroomNos房号Stringn—departureSta离店状态String1［响应数据］字段中文名称数据类型数量说明resultCode结果代码String1 resultMsg结果信息String1 ［请求示例］{"hotelCode":"HTL","crsNo":"W1610180001","roomNos":"201",}［返回示例］{"resultCode":0,}［功能说明］获取协议单位信息。［请求参数］字段中文名称数据类型数量说明酒店集团代码String1 hotelCode酒店代码String1—companyId协议单位IDString—companyName协议单位名称String—GB／T37976—2019［响应数据］字段中文名称数据类型数量说明resultCode结果代码String1 resultMsg结果信息String1 resultInfo返回信息—字段中文名称数据类型数量说明companyId协议单位IDString1 comapnyName协议单位名称String1—linkman联系人String1—mobile手机号码String1—phone电话号码String1—sta状态String1 rateCode房价码String1 arno应收账户String1 R［功能说明］锁房。［请求参数］字段中文名称数据类型数量说明酒店集团代码String1—hotelCode酒店代码String1—registerId订单IDString—rmno房号Stringn可多个，逗号分隔operationType操作类型String［响应数据］字段中文名称数据类型数量说明resultCode结果代码String1 resultMsg结果信息String1 resultInfo返回信息Stringn Rc［功能说明］查询房卡数量。GB／T37976—2019［请求参数］字段中文名称数据类型数量说明酒店集团代码String1 hotelCode酒店代码String1 registerId订单IDString ［响应数据］字段中文名称数据类型数量说明resultCode结果代码String1—resultMsg结果信息String1—resultInfo返回信息1—Message字段中文名称数据类型数量说明num String1固定值：1roomCardNum房卡数量String1 ［功能说明］更新房卡数量。［请求参数］字段中文名称数据类型数量说明酒店集团代码String1—hotelCode酒店代码String1—registerId订单IDString—number房卡数量String—［响应数据］字段中文名称数据类型数量说明resultCode结果代码String1 resultMsg结果信息String1 resultInfo返回信息String1成功：1;失败：2R［功能说明］联房。GB／T37976—2019［请求参数］字段中文名称数据类型数量说明酒店集团代码String1 酒店代码String1 registerId订单IDString1—linkId联房IDStringn［响应数据］字段中文名称数据类型数量说明resultCode结果代码String1—resultMsg结果信息String1—resultInfo返回信息String1成功：1;失败：2o［功能说明］查找订单。［请求参数］字段中文名称数据类型数量说明酒店集团代码String1—酒店代码String1 searchType查询值类型String1码；3：预订人手机号码；4：营业员；姓名［响应数据］字段中文名称数据类型数量说明resultCode结果代码String1 resultMsg结果信息String1 resultInfo返回信息OrderInfo[]n订单信息OrderInfo字段中文名称数据类型数量说明registerId订单IDString1—姓名String1—电话号码String1 reserveTime预定时间String1 arr抵达日期String1 GB／T37976—2019字段中文名称数据类型数量说明离店日期String1—guaranteeType担保类型String1 已支付金额String1 rmtype房间类型String1 rmnum房间数量String1 rmno房号String1 arrDate入住日期String1 包价String1—memberNo会员号String1—memberType会员类型String1—companyName协议单位名称String1—companyId协议单位IDString1 sourceName渠道商名称String1 rsvno订单号String1 remark备注String1 rsvClass预定类型String1 支付方式String1 linkId联房IDString1—isMainMaster是否主单String1房价码String1—isSecretRate房价是否保密String1—rsvId预定IDString1 订单状态String1 rsvsrcId纯预留IDString1 ［功能说明］预定排房。［请求参数］字段中文名称数据类型数量说明酒店集团代码String1 酒店代码String1 registerId订单IDString1 rsvsrcId纯预留IDString1纯预留id与房型二选一房型代码String1纯预留id与房型二选一rmno房号StringnGB／T37976—2019［响应数据］字段中文名称数据类型数量说明resultCode结果代码String1 resultMsg结果信息String1—resultInfo返回信息String1 xo［功能说明］是否存在入住单。［请求参数］字段中文名称数据类型数量说明酒店集团代码String1—酒店代码String1 searchType查询类型String1searchValueType查询值匹配类型String11：模糊匹配；2：完全匹配searchValue查询值Stringn［响应数据］字段中文名称数据类型数量说明resultCode结果代码String1 resultMsg结果信息String1 resultInfo返回信息n 字段中文名称数据类型数量说明registerId订单IDString1 allowCheckOut是否允许结账String1Rc［功能说明］发房卡预处理。［请求参数］字段中文名称数据类型数量说明酒店集团代码String1—酒店代码String1—featureType特征类型String1卡操作类型String11：发新卡；2：发同住人房卡featureValue特殊值String1特殊值GB／T37976—2019［响应数据］字段中文名称数据类型数量说明resultCode结果代码String1 resultMsg结果信息String1—resultInfo返回信息String1 ［功能说明］查询订单付款情况。［请求参数］字段中文名称数据类型数量说明酒店集团代码String1—hotelCode酒店代码String1—registerId订单IDString1 rsvno预定号String1 ［响应数据］字段中文名称数据类型数量说明resultCode结果代码String1—resultMsg结果信息String1 resultInfo返回信息1 Message字段中文名称数据类型数量说明totalRmFee总房费String1 imprest预付款String1 registerId订单IDString1 allowCheckin是否允许自助机入住String1cR［功能说明］保存发卡记录。［请求参数］字段中文名称数据类型数量说明酒店集团代码String1 hotelCode酒店代码String1 GB／T37976—2019字段中文名称数据类型数量说明registerId订单IDString1—guestName客人姓名String cardNo卡号String ［响应数据］字段中文名称数据类型数量说明resultCode结果代码String1 resultMsg结果信息String1—resultInfo返回信息1—Message字段中文名称数据类型数量说明num String1固定值：0000001cR［功能说明］查询发卡记录。［请求参数］字段中文名称数据类型数量说明酒店集团代码String1—hotelCode酒店代码String1—registerId订单IDString1 cardNoString ［响应数据］字段中文名称数据类型数量说明resultCode结果代码String1—resultMsg结果信息String1—resultInfo返回信息—Message字段中文名称数据类型数量说明registerId订单IDString1 createDatetime发卡时间String1 ［功能说明］GB／T37976—2019升级订单房型。［请求参数］字段中文名称数据类型数量说明酒店集团代码String1—hotelCode酒店代码String1 registerId订单IDString1 rmType房型String1—certigier授权人String1—rmno房号String ［响应数据］字段中文名称数据类型数量说明resultCode结果代码String1 resultMsg结果信息String1—resultInfo返回信息String1固定值：1［功能说明］取消。［请求参数］字段中文名称数据类型数量说明酒店集团代码String1 hotelCode酒店代码String1 registerId订单IDString1 remark备注String ［响应数据］字段中文名称数据类型数量说明resultCode结果代码String1 resultMsg结果信息String1 resultInfo返回信息String1固定值：0000001［功能说明］修改订单备注信息。［请求参数］GB／T37976—2019字段中文名称数据类型数量说明酒店集团代码String1—酒店代码String1 registerId订单IDString1 remark备注String1—［响应数据］字段中文名称数据类型数量说明resultCode结果代码String1—resultMsg结果信息String1—resultInfo返回信息String1［功能说明］修改订单允许记账信息。［请求参数］字段中文名称数据类型数量说明酒店集团代码String1—酒店代码String1—registerId订单IDString1 允许记账信息String1.：全部关闭其他：指定项目允许记账，多个项的项目将关闭允许记账［响应数据］字段中文名称数据类型数量说明resultCode结果代码String1—resultMsg结果信息String1—resultInfo返回信息String1［功能说明］查询指定房号房态。GB／T37976—2019［请求参数］字段中文名称数据类型数量说明酒店集团代码String1—hotelCode酒店代码String1—beginDate开始日期String1endDate结束日期String1rmno房号String1 ［响应数据］字段中文名称数据类型数量说明resultCode结果代码String1 resultMsg结果信息String1 resultInfo返回信息RmStaInfo[]n RmStaInfo字段中文名称数据类型数量说明rmno房号String1 beginDate开始日期String1 registerId订单IDString1 roomSta房态String145xFL［功能说明］查询可用空房列表。［请求参数］字段中文名称数据类型数量说明酒店集团代码String1—hotelCode酒店代码String1—rmtype房类String—building楼宇String—floor楼层String—staOcc是否包含临时可用房String rmsta房态String rmno房号Stringn arrDate到达日期String depDate离店日期String maxResult最大数量String GB／T37976—2019［响应数据］字段中文名称数据类型数量说明resultCode结果代码String1 resultMsg结果信息String1—resultInfo返回信息RoomList[]n RoomList字段中文名称数据类型数量说明building楼宇String1 floor楼层String1—rmno房号String1 id主键String1房态表主键rmtype房型String1 ［功能说明］查询所有房态。［请求参数］字段中文名称数据类型数量说明酒店集团代码String1 hotelCode酒店代码String1 rmtype房类String—building楼宇String—floor楼层String ［响应数据］字段中文名称数据类型数量说明resultCode结果代码String1 resultMsg结果信息String1 resultInfo返回信息RoomStaList[]n—RoomStaList字段中文名称数据类型数量说明building楼宇String1—floor楼层String1—rmno房号String1—GB／T37976—2019字段中文名称数据类型数量说明id主键String1房态表主键rmtype房型String1 isDep是否本日离开String1［功能说明］当前房态统计。［请求参数］字段中文名称数据类型数量说明酒店集团代码String1 hotelCode酒店代码String1 rmtype房类String—building楼宇String rmsta房态String rmno房号Stringn—［响应数据］字段中文名称数据类型数量说明resultCode结果代码String1 resultMsg结果信息String1 resultInfo返回信息RoomStaCount[]n—RoomList字段中文名称数据类型数量说明rmtype房型String1 totalNum房间总数String1—cleanNum空净房数String1 dirtyNum空脏房数String1 maintainNum维修房数String1 tempp