GB T 37976-2019 物联网 智慧酒店应用 平台接口通用技术要求.pdf

《GB T 37976-2019 物联网 智慧酒店应用 平台接口通用技术要求.pdf》由会员分享，可在线阅读，更多相关《GB T 37976-2019 物联网 智慧酒店应用 平台接口通用技术要求.pdf（152页珍藏版）》请在麦多课文档分享上搜索。

1、 书书书 目 次 前言 范围 规范性引用文件 术语和定义 缩略语 概述 平台接口 应用技术要求 接口定义方式和数据类型说明 数据接口定义方式 接口数据类型 接口 基础代码获取接口 客房管理 客房订单 前台业务 会员服务 酒店其他管理系统接口 门锁服务 客房控制服务 客房娱乐服务 公安数据接入 接口安全要求 结构安全 访问控制 安全审计 边界完整性检查 入侵防范 网络设备防护 犌犅 犜 前 言 本标准按照 给出的规则起草。 请注意本文件的某些内容可能涉及专利。本文件的发布机构不承担识别这些专利的责任。 本标准由全国信息技术标准化技术委员会（ ）提出并归口。 本标准起草单位：中国电子技术标准化研究

2、院、新新人类（北京）科技有限公司、智慧壹号（北京）酒 店管理有限公司、杭州绿云软件有限公司、深圳赛西信息技术有限公司、公安部第三研究所、山东比特智 能科技股份有限公司、快住智能科技（苏州）有限公司、上海别样红信息技术有限公司、上海逸邻网络科 技有限公司、广东必达保安系统有限公司、惠州市尊宝智能控制股份有限公司、深圳市盛阳科技股份有 限公司、杭州云柚科技有限公司、 王牌电器（惠州）有限公司、深圳欢旅科技有限公司、常州市邦威 电子科技有限公司。 本标准起草人：张晖、郭迪胜、耿力、李孟良、杨宏、信宏业、赵焕焱、荀亮亮、路小北、谷慧敏、曹现贵、 朱彤、黄华、杨铭魁、陈海滨、郭迎光、冯震维、陈伟禧、黄晓

3、凌、张勇、吕坡、张敬宇、曾文涛、刘乃钢、 王建青、余晖、陈雪明、唐建国、陈妙强、黄俭、杨枫、穆林、张华、李翔、邹子平、裘永强、沈伟明、李桂琴、 朱家川、王加梁、李广飞、闫宏河、闻涛、李云鹏、刘卫东、田彩云、李东升、周山、王烨、王浩、王G21涛、 汤铭、孟周俊、俞海钟、刘宗科、邹宇航、杨诗兵、李俱顺。 犌犅 犜 物联网 智慧酒店应用 平台接口通用技术要求 范围 本标准规定了基于物联网技术的智慧酒店应用平台接口通用技术要求。 本标准适用于基于物联网技术的智慧酒店应用平台接口设计。 规范性引用文件 下列文件对于本文件的应用是必不可少的。凡是注日期的引用文件，仅注日期的版本适用于本文 件。凡是不注日期

4、的引用文件，其最新版本（包括所有的修改单）适用于本文件。 物联网 术语 术语和定义 界定的以及下列术语和定义适用于本文件。 智慧酒店 狊犿犪狉狋犺狅狋犲犾 通过应用先进的信息和通信技术，实现管理数字化、网络化和智能化的酒店。 综合信息管理平台 犻狀狋犲犵狉犪狋犲犱犻狀犳狅狉犿犪狋犻狅狀犿犪狀犪犵犲犿犲狀狋狆犾犪狋犳狅狉犿 将酒店的客户管理、客房管理、接待管理、账务管理、审核管理、销售管理等多个管理模块或系统汇 集并形成的管理平台。 平台接口 狆犾犪狋犳狅狉犿犻狀狋犲狉犳犪犮犲 平台内部子系统、子模块之间，以及该平台与外部平台、系统之间的相互连接与交互的接口。 缩略语 下列缩略语适用于本文件。

5、待修房（ ） 酒店管理系统（ ） 概述 智慧酒店应用一般通过基于物联网技术的智慧酒店综合信息管理平台实现，平台架构如图 所示， 由 和酒店其他管理系统组成。物联网传感单元信息通过事务处理系统及其他系统与 进行 数据交换，智慧酒店通过该平台提供应用服务。 犌犅 犜 图 基于物联网的智慧酒店综合信息管理平台架构 智慧酒店综合信息管理平台接口包括 接口和酒店其他管理系统接口。 接口包括：基础 代码接口、客房管理接口、客房订单接口、前台业务接口和会员服务接口等。酒店其他管理系统接口包 括：门锁服务接口、客房控制接口、人工智能机器人服务接口、智能消防控制接口、客房娱乐接口和公安 传输数据接口等。 智慧酒

6、店综合信息管理平台的各接口之间可进行相互调用，也可以供外部应用服务调用，以满足具 体业务服务需求。 平台接口 应用技术要求 智慧酒店应围绕物联网六域模型体系建立包括 及相关联的应用技术内容。智慧酒店建设应 用技术体系架构如图 所示。 犌犅 犜 图 智慧酒店建设应用技术体系架构 接口定义方式和数据类型说明 数据接口定义方式 规定如下： ） 数据接口分类 按 接口和酒店其他管理系统接口归纳各子类数据接口，并在各类数据接口进一步划分为细 类数据接口。 犌犅 犜 ） 接口格式描述 ） 各个接口定义按以下格式描述： 条款号接口名（说明：使用中文和原语给出接口名） 功能说明 （说明：简要陈述该接口的功能）

7、 请求参数（说明：用以下列表形式给出所请求的参数） 字段中文名称数据类型数量说明 用原语给出该字段 包含的参数名 该参数的中文名 用于描述该参数的 数据类型 所请求的该参数的 数量 对前面栏目的 补充说明 响应数据（说明：用以下列表形式给出响应数据） 字段中文名称数据类型数量说明 用原语给出该字段 包含的数据名 该参数据的中文名 用于描述该数据的 数据类型 所请求的该数据的 数量 对前面栏目的 补充说明 （说明： 表示数据传输对象； “ ”前的“ ”，对于基础代码获取接口，用接口原语名中 “ ”后面的部分取代；对于 接口或酒店其他管理系统接口，用接口原语名取代； 个别接口包含 不止一个此项）

8、字段中文名称数据类型数量说明 用原语给出该字段 包含的数据名 该字段的中文名 用于描述该字段的 数据类型 所请求的该字段的 数量 对前面栏目的 补充说明 请求示例（说明：下面给出具体请求示例） ） 关于接口定义中的“数量”，说明如下： ：表示有且仅有一个。 狀 ：表示可以没有，也可以为多个，数量没有上限。 狀 ：表示最少一个，可以为多个，数量没有上限。 ） 关于接口定义中的“示例”，本标准主要采用国际通行的数据交换数据格式 来说明。 接口数据类型 包括如下几种类型： ） 字符型数据，用 表示； ） 整数型数据，用 表示； ） 小数型数据，用 表示； ） 对象型数据（用后缀 的字符串表示），自定

9、义数据传输对象，该类型的数据应进行单独 说明。 犌犅 犜 犘犕犛 接口 基础代码获取接口 获取国家信息 犵犲狋犆狅狌狀狋狉犻犲狊 功能说明 获取国家信息。 请求参数 字段中文名称数据类型数量说明 酒店集团代码 响应数据 字段中文名称数据类型数量说明 结果代码 字段操作结果 结果信息 返回提示信息 结果对象 狀 返回数据对象 字段中文名称数据类型数量说明 代码 名称 请求示例 ： 返回示例 ： ， ： 查询成功 ， ： ： ， ： 中国 ， ： ， ： 美国 犌犅 犜 获取城市信息 犵犲狋犆犻狋犻犲狊 功能说明 获取指定酒店集团的城市信息。 请求参数 字段中文名称数据类型数量说明 酒店集团代码

10、响应数据 字段中文名称数据类型数量说明 结果代码 结果信息 返回信息 狀 字段中文名称数据类型数量说明 代码 名称 请求示例 ： 返回示例 ： ， ： 查询成功 ， ： ： ， ： 杭州 ， ： ， ： 上海 获取证件类型信息 犵犲狋犐犱犆狅犱犲狊 功能说明 获取证件类型信息。 犌犅 犜 请求参数 字段中文名称数据类型数量说明 酒店集团代码 酒店代码 响应数据 字段中文名称数据类型数量说明 结果代码 结果信息 返回信息 狀 字段中文名称数据类型数量说明 代码 名称 请求示例 ： ， ： 返回示例 ： ， ： 查询成功 ， ： ： ， ： 身份证 ， ： ， ： 其他证件 获取性别信息 犵犲狋犛

11、犲狓犆狅犱犲狊 功能说明 获取证件类型信息。 请求参数 犌犅 犜 字段中文名称数据类型数量说明 酒店集团代码 酒店代码 响应数据 字段中文名称数据类型数量说明 结果代码 结果信息 返回信息 狀 字段中文名称数据类型数量说明 代码 名称 请求示例 ： ， ： 返回示例 ： ， ： 查询成功 ， ： ： ， ： 男 ， ： ， ： 女 获取酒店信息 犵犲狋犎狅狋犲犾狊 功能说明 获取指定酒店集团相关条件下的酒店列表。 请求参数 犌犅 犜 字段中文名称数据类型数量说明 酒店集团代码 酒店代码 城市代码 品牌代码 狀 响应数据 字段中文名称数据类型数量说明 结果代码 结果信息 返回信息 狀 字段中文名

12、称数据类型数量说明 酒店代码 酒店状态 酒店名称 酒店所在国家代码 酒店所在城市 地址 电话 网址 电子邮箱 备注 酒店类型 度假、商务 酒店星级 酒店坐标 经纬度坐标 请求示例 ： 返回示例 ： ， ： 查询成功 ， ： ： ， 犌犅 犜 ： ， ： 黄山大酒店 ， ： ， ： ， ： 安徽省黄山市 ， ： ， ： ， ： ， ： ， ： 客房管理 获取房型信息 犵犲狋犚狅狅犿犜狔狆犲狊 功能说明 获取酒店的房型信息列表。 请求参数 字段中文名称数据类型数量说明 酒店集团代码 酒店代码 响应数据 字段中文名称数据类型数量说明 结果代码 结果信息 返回信息 狀 字段中文名称数据类型数量说明 房

13、型代码 房型描述 最大成人数 最大儿童数 请求示例 ： ， ： 犌犅 犜 返回示例 ： ， ： 查询成功 ， ： ： ， ： 豪华双床房 ， ， ： ， ： 豪华大床房 ， ， 获取楼层信息 犵犲狋犉犾狅狅狉狊 功能说明 获取酒店楼层信息。 请求参数 字段中文名称数据类型数量说明 酒店集团代码 酒店代码 响应数据 字段中文名称数据类型数量说明 结果代码 结果信息 返回信息 狀 字段中文名称数据类型数量说明 代码 名称 请求示例 ： 返回示例 犌犅 犜 ： ， ： 查询成功 ， ： ： ， ： 第一层 ， ： ， ： 第二层 获取客房特征信息 犵犲狋犉犲犪狋狌狉犲狊 功能说明 获取酒店客房特征信

14、息。 请求参数 字段中文名称数据类型数量说明 酒店集团代码 酒店代码 响应数据 字段中文名称数据类型数量说明 结果代码 结果信息 返回信息 狀 字段中文名称数据类型数量说明 代码 名称 请求示例 ： 返回示例 ： ， 犌犅 犜 ： 查询成功 ， ： ： ， ： 无烟房 ， ： ， ： 吸烟房 查询房间状态 犵犲狋犚狅狅犿犛狋犪 功能说明 查询房间状态。 请求参数 字段中文名称数据类型数量说明 酒店集团代码 酒店代码 状态 （空净）； （空） （住净）； （住脏） 是否返回入住人 针对在住的房间 当前页 分页数量 响应数据 字段中文名称数据类型数量说明 结果代码 结果信息 返回信息 狀 字段中文

15、名称数据类型数量说明 楼栋 楼层 是否将离 房型 住客信息 房号 犌犅 犜 字段中文名称数据类型数量说明 姓名 证件号码 预订类型 ：散客； ：团队 到达时间 ： ： 离开时间 ： ： 手机号码 请求示例 ： ， ： ， ： ， ： 返回示例 ： ， ： 查询成功 ， ： ： ， ： ， ： ， ： ， ： ， ： ， ： ： ， ： ， ： ， ： ： ： ， ： ， ： ： ： ， ： ， ： ， ： ， 犌犅 犜 ： ， ： ， ： ， ： ， ： ， ： ， ： ： ， ： ， ： ， ： ： ： ， ： ： ： ， ： ， ： 更新房间状态 狌狆犱犪狋犲犚狅狅犿犛狋犪 功能说明 更新

16、房间状态。 请求参数 字段中文名称数据类型数量说明 酒店集团代码 酒店代码 房号 状态 新的房态（ ：脏房； ：检查； ： ； ：干净； ：维修； ：锁定； ：临时态） 开始日期 格式 结束日期 格式 维修或锁定理由 仅针对维修、锁定、 临时态有效 响应数据 字段中文名称数据类型数量说明 结果代码 结果信息 请求示例 犌犅 犜 ： ， ： ， ： ， ： 返回示例 ： ， ： 成功 获取可用房量 犵犲狋犚狅狅犿犃狏犪犻犾 功能说明 获取酒店可用房量。 请求参数 字段中文名称数据类型数量说明 酒店集团代码 酒店代码 到达日期 格式 结束日期 格式 注：不含本日 房型 狀 多房型间使用逗号隔开；

17、不传递该参数表示所有 响应数据 字段中文名称数据类型数量说明 结果代码 结果信息 返回信息 狀 字段中文名称数据类型数量说明 酒店集团代码 酒店代码 房型 房型类别 日期 房型总房数 犌犅 犜 字段中文名称数据类型数量说明 维修房数 维护房数 可用房数 超预留数量 包含超预留可用房数 请求示例 ： ， ： ， ： ， ： ， ： 返回示例 ： ， ： 查询成功 ， ： ： ， ： ， ： ， ： ， ： ， ： ， ： ， ： ， ： ， ： ： ， 获取可卖房 犵犲狋犚狅狅犿犛犪犾犲犪犫犾犲 功能说明 获取酒店指定时间内的可卖房号。 请求参数 犌犅 犜 字段中文名称数据类型数量说明 酒店集团

18、代码 酒店代码 到达日期 格式 结束日期 格式 房型 狀 多房型逗号隔开 指定房号 狀 多房号逗号隔开 是否仅干净房 响应数据 字段中文名称数据类型数量说明 结果代码 结果信息 返回信息 狀 字段中文名称数据类型数量说明 房号 房型 床数 状态 ：脏房； ：检查； ：维修； ：干净； ：锁定； ： 占用状态 ：占用； ：空闲 特征代码 狀 楼层 获取酒店预订信息 犵犲狋犎狅狋犲犾犗狉犱犲狉犪犫犾犲 功能说明 获取酒店指定时间内的可卖房。 请求参数 字段中文名称数据类型数量说明 酒店集团代码 酒店代码 狀 多酒店逗号分隔 到达日期 格式 入住天数 城市代码 品牌代码 起始页数 犌犅 犜 字段中文

19、名称数据类型数量说明 分页数量 房价码 狀 渠道代码 响应数据 字段中文名称数据类型数量说明 结果代码 结果信息 返回信息 狀 字段中文名称数据类型数量说明 可订列表 总行数 字段中文名称数据类型数量说明 酒店代码 房价信息 狀 最小房价 房价代码 狀 房型代码 狀 字段中文名称数据类型数量说明 房价码 房型 首日房价 均价 来源码 市场 包价 最小提前天数 最大提前天数 最小入住天数 最大入住天数 可订房数 总数量 犌犅 犜 请求示例： ： ， ： ， ： ， ： ， ： ， ： ， ： 返回示例 ： ， ： 查询成功 ， ： ： ： ， ： ： ， ： ， ： ， ： ， ： ， ： ，

20、： ， ： ， ： ， ： ， ： ， ： ， ： ， ： ， ： ， ： ， ： ， ： ， ： ， ： ， ： ， 犌犅 犜 ： ， ： ， ： ， ： ， ： ， ： ， ： ， ， ： ， ， ： 客房订单 获取宾客市场分类信息 犵犲狋犕犪狉犽犲狋狊 功能说明 获取酒店市场分类代码信息。 请求参数 字段中文名称数据类型数量说明 酒店集团代码 酒店代码 响应数据 字段中文名称数据类型数量说明 结果代码 结果信息 返回信息 狀 字段中文名称数据类型数量说明 代码 名称 请求示例 ： 犌犅 犜 返回示例 ： ， ： 查询成功 ， ： ： ， ： 协议公司 ， ： ， ： 散客 获取宾客来源分

21、类信息 犵犲狋犛狅狌狉犮犲狊 功能说明 获取酒店来源分类代码信息。 请求参数 字段中文名称数据类型数量说明 酒店集团代码 酒店代码 响应数据 字段中文名称数据类型数量说明 结果代码 结果信息 返回信息 狀 字段中文名称数据类型数量说明 代码 名称 请求示例 ： 返回示例 犌犅 犜 ： ， ： 查询成功 ， ： ： ， ： 境外宾客 ， ： ， ： 本地客人 获取客房销售渠道信息 犵犲狋犆犺犪狀狀犲犾狊 功能说明 获取酒店客房销售渠道分类代码信息。 请求参数 字段中文名称数据类型数量说明 酒店集团代码 酒店代码 响应数据 字段中文名称数据类型数量说明 结果代码 结果信息 返回信息 狀 字段中文名

22、称数据类型数量说明 代码 名称 请求示例 ： 返回示例 ： ， ： 查询成功 ， 犌犅 犜 ： ： ， ： ， ： ， ： 获取宾客特殊要求信息 犵犲狋犛狆犲犮犻犪犾狊 功能说明 获取宾客特殊要求信息。 请求参数 字段中文名称数据类型数量说明 酒店集团代码 酒店代码 响应数据 字段中文名称数据类型数量说明 结果代码 结果信息 返回信息 狀 字段中文名称数据类型数量说明 代码 名称 请求示例 ： 返回示例 ： ， ： 查询成功 ， ： 犌犅 犜 ： ， ： 提前入住 获取客房销售包价信息 犵犲狋犘犪犮犽犪犵犲狊 功能说明 获取酒店包价信息。 请求参数 字段中文名称数据类型数量说明 酒店集团代码

23、酒店代码 响应数据 字段中文名称数据类型数量说明 结果代码 结果信息 返回信息 狀 字段中文名称数据类型数量说明 代码 名称 请求示例 ： 返回示例 ： ， ： 查询成功 ， ： ： ， ： 早餐 ， ： ， 犌犅 犜 ： 服务费 获取入账代码 犵犲狋犜狉犪狀狊犪犮狋犻狅狀犆狅犱犲狊 功能说明 获取证件类型信息。 请求参数 字段中文名称数据类型数量说明 酒店集团代码 酒店代码 响应数据 字段中文名称数据类型数量说明 结果代码 结果信息 返回信息 狀 字段中文名称数据类型数量说明 代码 是 名称 是 类别代码 否 适用范围 否 账单码 否 请求示例 ： ， ： 返回示例 ： ， ： 查询成功 ，

24、 ： ： ， ： 夜审房费 ， ： ， 犌犅 犜 ： ， ： ， ： ， ： 人民币现金 ， ： ， ： ， ： 步入散客 狑犪犾犽犻狀 功能说明 客人不经过预订，直接在酒店前台办理入住。 请求参数 字段中文名称数据类型数量说明 酒店集团代码 酒店代码 入住类型 ：散客； ：钟点 入住时间 格式 ： ： 退房时间 格式 ： ： 房型代码 房号 姓名 证件类型 证件号码 性别 生日 国籍 会员卡号 房价码 房价 包价代码 狀 市场代码 来源代码 渠道 犌犅 犜 响应数据 字段中文名称数据类型数量说明 结果代码 结果信息 返回信息 字段中文名称数据类型数量说明 登记单 请求示例 ： ， ： ， ：

25、 ， ： ： ： ， ： ： ： ， ： ， ： ， ： 张三 ， ： ， ： ， ： ， ： ， ： ， ： ， ： ， ： ， ： ， ： ， ： ， ： 返回示例 ： ， ： 查询成功 ， ： ： 犌犅 犜 创建订单 犮狉犲犪狋犲犚犲狊犲狉狏犪狋犻狅狀 功能说明 创建订单。 请求参数 字段中文名称数据类型数量说明 酒店集团代码 酒店代码 到达日期 格式 ： ： 离开日期 格式 ： ： 房型 房价码 房数 预订人 性别 联系电话 证件类型 证件号码 邮箱 会员卡类别 会员卡号 人数 备注 优惠金额 销售渠道 特殊要求 付款状态 来源 市场 渠道 包价 狀 多选 每日房价 狀 房号 付款 结

26、账提醒 渠道 预订号 犌犅 犜 字段中文名称数据类型数量说明 其他预定号 第三方应用 第三方应用的用户 响应数据 字段中文名称数据类型数量说明 结果代码 结果信息 返回信息 字段中文名称数据类型数量说明 中央订单号 支付状态 定金 请求示例 ： ， ： ， ： ， ： ： ： ， ： ： ： ， ： ， ： ， ： ， ： ， ： ， ： ， ： ， ： ， ： ， ： ， ： ， ： ， ： ， ： ， ： ， ： ， 犌犅 犜 ： ， ： ， ： ， ： 返回示例 ： ， ： 成功 ， ： ： 排房 犪狊狊犻犵狀犚狅狅犿 功能说明 给预订单分配房间。 请求参数 字段中文名称数据类型数量说明

27、 酒店集团代码 酒店代码 中央订单号 与 最少一个有值 酒店订单号 与 最少一个有值 房型 房号 狀 多房号逗号分隔 响应数据 字段中文名称数据类型数量说明 结果代码 结果信息 请求示例 ： ， ： ， ： ， ： ， ： 返回示例 ： ， 犌犅 犜 ： 成功 其他说明 一般先调用“获取订单列表”接口查询到酒店预订单，然后再调用此接口排房。 获取订单列表 犵犲狋犚犲狊犲狉狏犪狋犻狅狀 功能说明 查询订单列表。 请求参数 字段中文名称数据类型数量说明 酒店集团代码 中央订单号 会员号 开始日期 结束日期 开始行 分页数量 响应数据 字段中文名称数据类型数量说明 结果代码 结果信息 返回信息 字段

28、中文名称数据类型数量说明 订单列表 狀 总数 字段中文名称数据类型数量说明 订单唯一标示 酒店代码 酒店描述 中央订单号 酒店订单号 状态 状态描述 支付状态 犌犅 犜 字段中文名称数据类型数量说明 定金 到达日期 离开日期 房型 房型描述 房价 请求示例 ： ， ： 返回示例 ： ， ： 成功 ， ： ： ： ， ： ， ： ， ： ， ： ， ： ， ： 标准版标准库 ， ： ， ： 预订 ， ： ， ： ， ： 行政双床 ， ： ， ： 支付 狆犪狔 功能说明 犌犅 犜 给订单支付款项。 请求参数 字段中文名称数据类型数量说明 酒店集团代码 中央订单号 金额 单据号 入账代码 入账备注

29、酒店代码 酒店订单付款时必填 订单 酒店订单付款时与 二选一 房号 酒店订单付款时与 二选一 响应数据 字段中文名称数据类型数量说明 结果代码 结果信息 请求示例 ： ， ： ， ： ， ： ， ： ， ： 返回示例 ： ， ： 成功 消费 犮犺犪狉犵犲 功能说明 录入订单费用。 请求参数 字段中文名称数据类型数量说明 酒店集团代码 中央订单号 犌犅 犜 字段中文名称数据类型数量说明 金额 单据号 入账代码 入账备注 酒店代码 酒店订单付款时必填 订单 酒店订单付款时与 二选一 房号 酒店订单付款时与 二选一 响应数据 字段中文名称数据类型数量说明 结果代码 结果信息 请求示例 ： ， ： ，

30、 ： ， ： ， ： ， ： 返回示例 ： ， ： 成功 获取每日房价 犵犲狋犇犪犻犾狔犚犪狋犲 功能说明 获取指定日期、房型、房价代码的每日房价。 请求参数 字段中文名称数据类型数量说明 酒店集团代码 酒店代码 到达日期 格式 入住天数 格式 房型 房价码 犌犅 犜 响应数据 字段中文名称数据类型数量说明 结果代码 结果信息 返回信息 狀 字段中文名称数据类型数量说明 日期 价格 价格为空值，则表示不可用 房价码 房型 请求示例 ： ， ： ， ： ， ： ， ： ， ： 返回示例 ： ， ： 成功 ， ： ： ： ： ， ： ， ： ， ： 保存每日房价 狊犪狏犲犇犪犻犾狔犚犪狋犲 功能说

31、明 保存或更新订单的每日房价。 请求参数 犌犅 犜 字段中文名称数据类型数量说明 酒店集团代码 中央订单号 每日房价 狀 字段中文名称数据类型数量说明 日期 价格 响应数据 字段中文名称数据类型数量说明 结果代码 结果信息 请求示例 ： ， ： ， ： ： ， ： 返回示例 ： ， ： 成功 取消订单 犮犪狀犮犲犾犚犲狊犲狉狏犪狋犻狅狀 功能说明 取消订单。 请求参数 字段中文名称数据类型数量说明 酒店集团代码 中央订单号 备注 响应数据 字段中文名称数据类型数量说明 结果代码 犌犅 犜 字段中文名称数据类型数量说明 结果信息 请求示例 ： ， ： 其他原因 ， ： 返回示例 ： ， ： 成功

32、 查询订单详情 犵犲狋犚犲狊犲狉狏犪狋犻狅狀犇犲狋犪犻犾 功能说明 查询订单详情，包括中央预订和酒店预订的订单。 请求参数 字段中文名称数据类型数量说明 酒店集团代码 酒店代码 非接口产生的订单则此参数必填， 如：打电话到酒店预订的订单 酒店订单号 酒店预订单通过此参数查询 中央订单号 中央订单通过此参数查询 响应数据 字段中文名称数据类型数量说明 结果代码 结果信息 返回信息 字段中文名称数据类型数量说明 酒店代码 酒店描述 预订单唯一标示 预订类型 预订人 犌犅 犜 字段中文名称数据类型数量说明 手机 证件类型 证件号码 性别描述 性别代码 房型 房型描述 房价 房数 到达日期 离开日期

33、状态 状态描述 支付状态 ：无需支付； ：待支付； ：已支付； ：已退款 定金 房费合计 总消费 备注 城市 创建时间 修改时间 房间入住信息 狀 订单没排房的时候没有此信息 字段中文名称数据类型数量说明 登记单唯一标示 住客姓名 房号 请求示例 ： ， ： 返回示例 犌犅 犜 ： ， ： 成功 ， ： ： ： ， ： ， ： ， ： ， ： ， ： ， ： ， ： 标准版标准库 ， ： ， ： 预订 ， ： ， ： 男 ， ： ： ， ： 张三 ， ： ， ： ， ： ， ： ， ： ： ： ， ： ， ： 行政双床 ， ： ， ： ， ： ， ： ， ： ， ： ， ： ： ： ， ： ，

34、 ： 杭州 ， ： ， ： 查询入住订单详情 犵犲狋犚犲犵犻狊狋犲狉犇犲狋犪犻犾 功能说明 包括在住、结账、挂账的订单。 犌犅 犜 请求参数 字段中文名称数据类型数量说明 酒店集团代码 酒店代码 订单 以下参数最少包含一个 房号 证件号 手机 响应数据 字段中文名称数据类型数量说明 结果代码 结果信息 返回信息 狀 同住人以多条记录返回 字段中文名称数据类型数量说明 订单唯一标示 住客姓名 手机 证件类型 证件号码 性别描述 性别代码 房号 房型 房型描述 房价 到达时间 格式 ： ： 离开时间 格式 ： ： 状态 状态描述 定金 房费合计 总消费 备注 犌犅 犜 字段中文名称数据类型数量说明

35、 创建时间 修改时间 请求示例 ： ， ： ， ： 返回示例 ： ， ： 成功 ， ： ： ， ： 张三 ， ： ， ： ， ： ， ： ， ： 男 ， ： ， ： ， ： 标间 ， ： ， ： ： ： ， ： ： ： ， ： ， ： 在住 ， ： ， ： ， ： ， ： ， ： ： ： ， ： ： ： 犌犅 犜 入住 犮犺犲犮犽犻狀 功能说明 订单入住。 请求参数 字段中文名称数据类型数量说明 酒店集团代码 酒店代码 中央订单号 订单 集合 狀 房号 狀 响应数据 字段中文名称数据类型数量说明 结果代码 结果信息 请求示例 ： ， ： ， ： ， ： 返回示例 ： ， ： 成功 查询账单 犵

36、犲狋犅犻犾犾 功能说明 给订单支付款项。 请求参数 字段中文名称数据类型数量说明 酒店集团代码 酒店代码 订单 集合 狀 账目类别 ：不限； ：消费项； ：支付项 结账状态 ：不限； ：未结账； ：已结账 犌犅 犜 响应数据 字段中文名称数据类型数量说明 结果代码 结果信息 返回结果 狀 字段中文名称数据类型数量说明 登记单 账次编号 账务编号 房号 账务代码 账务名称 金额 账务备注 创建人 创建时间 请求示例 ： ， ： ， ： ， ： 返回示例 ： ， ： 成功 ， ： ： ， ： ， ： ， ： ， ： ， ： 夜审房费 ， ： ， ： ， 犌犅 犜 ： ， ： ： ： 续住 犲狓狋犲

37、狀犱犛狋犪狔 功能说明 宾客延长离店日期。 请求参数 字段中文名称数据类型数量说明 酒店集团代码 酒店代码 登记单 与 二选一必填 中央订单号 与 二选一必填 离店日期 格式 ： ： 响应数据 字段中文名称数据类型数量说明 结果代码 结果信息 请求示例 ： ， ： ， ： ， ： ： ： 返回示例 ： ， ： 成功 退房 犮犺犲犮犽狅狌狋 功能说明 客人退房离店。 犌犅 犜 请求参数 字段中文名称数据类型数量说明 酒店集团代码 酒店代码 登记单 集合 狀 与 二选一必填 中央订单号 与 二选一必填 房号 狀 离店状态 ：结账； ：挂账 响应数据 字段中文名称数据类型数量说明 结果代码 结果信息

38、 请求示例 ： ， ： ， ： ， ： ， ： 返回示例 ： ， ： 成功 前台业务 查询协议单位 犵犲狋犆狅犿狆犪狀狔 功能说明 获取协议单位信息。 请求参数 字段中文名称数据类型数量说明 酒店集团代码 酒店代码 协议单位 协议单位名称 犌犅 犜 响应数据 字段中文名称数据类型数量说明 结果代码 结果信息 返回信息 字段中文名称数据类型数量说明 协议单位 协议单位名称 联系人 手机号码 电话号码 状态 房价码 应收账户 锁房 犾狅犮犽犚狅狅犿 功能说明 锁房。 请求参数 字段中文名称数据类型数量说明 酒店集团代码 酒店代码 订单 房号 狀 可多个，逗号分隔 操作类型 ：上锁； ：解锁 响应数据 字段中文名称数据类型数量说明 结果代码 结果信息 返回信息 狀 房卡数量查询 犳犻狀犱犚狅狅犿犆犪狉犱犖狌犿 功能说明 查询房卡数量。 犌犅 犜 请求参数 字段中文名称数据类型数量说明 酒店集团代码 酒店代码 订单 响应数据 字段中文名称数据类型数量说明 结果代码 结果信息 返回信息 字段中文名称数据类型数量说明 固定值： 房卡数量 更新房卡数量 狌狆犱犪狋犲犚狅狅犿犆犪狉犱犖狌犿 功能说明 更新房卡数量。 请求参数 字段中文名称数据类型数量说明 酒店集团代码 酒店代码 订单 房卡数量