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

ICS35.110

L79

中华人民共和国国家标准

/—

GBT379762019

物联网智慧酒店应用

平台接口通用技术要求

——

InternetofthinsSmarthotelalication

gpp

Generaltechnicalreuirementsofthelatforminterface

qp

2019-08-30发布2020-03-01实施

国家市场监督管理总局

发布

中国国家标准化管理委员会

/—

GBT379762019

目次

前言…………………………Ⅲ

1范围………………………1

2规范性引用文件…………………………1

3术语和定义………………1

4缩略语……………………1

5概述………………………1

6平台接口…………………2

6.1应用技术要求………………………2

6.2接口定义方式和数据类型说明……………………3

6.2.1数据接口定义方式……………3

6.2.2接口数据类型…………………4

6.3PMS接口……………5

6.3.1基础代码获取接口……………5

6.3.2客房管理………………………10

6.3.3客房订单………………………21

6.3.4前台业务………………………46

6.3.5会员服务………………………86

6.4酒店其他管理系统接口…………110

6.4.1门锁服务……………………110

6.4.2客房控制服务………………131

6.4.3客房娱乐服务………………134

6.4.4公安数据接入………………146

7接口安全要求…………………………148

7.1结构安全…………………………148

7.2访问控制…………………………149

7.3安全审计…………………………149

7.4边界完整性检查…………………149

7.5入侵防范…………………………149

7.6网络设备防护……………………149

Ⅰ

/—

GBT379762019

前言

本标准按照/—给出的规则起草。

GBT1.12009

。。

请注意本文件的某些内容可能涉及专利本文件的发布机构不承担识别这些专利的责任

本标准由全国信息技术标准化技术委员会(/)提出并归口。

SACTC28

:、()、()

本标准起草单位中国电子技术标准化研究院新新人类北京科技有限公司智慧壹号北京酒

、、、、

店管理有限公司杭州绿云软件有限公司深圳赛西信息技术有限公司公安部第三研究所山东比特智

、()、、

能科技股份有限公司快住智能科技苏州有限公司上海别样红信息技术有限公司上海逸邻网络科

、、、

技有限公司广东必达保安系统有限公司惠州市尊宝智能控制股份有限公司深圳市盛阳科技股份有

、、()、、

限公司杭州云柚科技有限公司TCL王牌电器惠州有限公司深圳欢旅科技有限公司常州市邦威

电子科技有限公司。

:、、、、、、、、、、、

本标准起草人张晖郭迪胜耿力李孟良杨宏信宏业赵焕焱荀亮亮路小北谷慧敏曹现贵

、、、、、、、、、、、、、

朱彤黄华杨铭魁陈海滨郭迎光冯震维陈伟禧黄晓凌张勇吕坡张敬宇曾文涛刘乃钢

、、、、、、、、、、、、、、

王建青余晖陈雪明唐建国陈妙强黄俭杨枫穆林张华李翔邹子平裘永强沈伟明李桂琴

、、、、、、、、、、、、、

朱家川王加梁李广飞闫宏河闻涛李云鹏刘卫东田彩云李东升周山王烨王浩旻王袆涛

、、、、、、。

汤铭孟周俊俞海钟刘宗科邹宇航杨诗兵李俱顺

Ⅲ

/—

GBT379762019

物联网智慧酒店应用

平台接口通用技术要求

1范围

本标准规定了基于物联网技术的智慧酒店应用平台接口通用技术要求。

本标准适用于基于物联网技术的智慧酒店应用平台接口设计。

2规范性引用文件

。,

下列文件对于本文件的应用是必不可少的凡是注日期的引用文件仅注日期的版本适用于本文

。,()。

件凡是不注日期的引用文件其最新版本包括所有的修改单适用于本文件

/—物联网术语

GBT337452017

3术语和定义

/—界定的以及下列术语和定义适用于本文件。

GBT337452017

3.1

智慧酒店smarthotel

,、。

通过应用先进的信息和通信技术实现管理数字化网络化和智能化的酒店

3.2

综合信息管理平台interatedinformationmanaementlatform

ggp

、、、、、

将酒店的客户管理客房管理接待管理账务管理审核管理销售管理等多个管理模块或系统汇

集并形成的管理平台。

3.3

平台接口latforminterface

p

、,、。

平台内部子系统子模块之间以及该平台与外部平台系统之间的相互连接与交互的接口

4缩略语

下列缩略语适用于本文件。

待修房()

OOOOutofOrder

酒店管理系统()

PMSProertManaementSstem

pygy

5概述

,,

智慧酒店应用一般通过基于物联网技术的智慧酒店综合信息管理平台实现平台架构如图所示

1

。

由PMS和酒店其他管理系统组成物联网传感单元信息通过事务处理系统及其他系统与PMS进行

,。

数据交换智慧酒店通过该平台提供应用服务

1

/—

GBT379762019

图基于物联网的智慧酒店综合信息管理平台架构

1

。:

智慧酒店综合信息管理平台接口包括PMS接口和酒店其他管理系统接口PMS接口包括基础

、、、。

代码接口客房管理接口客房订单接口前台业务接口和会员服务接口等酒店其他管理系统接口包

:、、、、

括门锁服务接口客房控制接口人工智能机器人服务接口智能消防控制接口客房娱乐接口和公安

传输数据接口等。

,,

智慧酒店综合信息管理平台的各接口之间可进行相互调用也可以供外部应用服务调用以满足具

体业务服务需求。

6平台接口

6.1应用技术要求

。

智慧酒店应围绕物联网六域模型体系建立包括PMS及相关联的应用技术内容智慧酒店建设应

用技术体系架构如图所示。

2

2

/—

GBT379762019

图2智慧酒店建设应用技术体系架构

6.2接口定义方式和数据类型说明

6.2.1数据接口定义方式

规定如下:

)数据接口分类

a

,

按PMS接口和酒店其他管理系统接口归纳各子类数据接口并在各类数据接口进一步划分为细

类数据接口。

3

/—

GBT379762019

)接口格式描述

b

)各个接口定义按以下格式描述:

1

(:)

条款号接口名说明使用中文和原语给出接口名

[功能说明]

(:)

说明简要陈述该接口的功能

[](:)

请求参数说明用以下列表形式给出所请求的参数

字段中文名称数据类型数量说明

用原语给出该字段用于描述该参数的所请求的该参数的对前面栏目的

该参数的中文名

包含的参数名数据类型数量补充说明

—————

[](:)

响应数据说明用以下列表形式给出响应数据

字段中文名称数据类型数量说明

用原语给出该字段用于描述该数据的所请求的该数据的对前面栏目的

该参数据的中文名

包含的数据名数据类型数量补充说明

—————

XXXXDto

(:;“”“”,,

说明1.Dto表示数据传输对象2.Dto前的XXXX对于基础代码获取接口用接口原语名中

“”;,;

后面的部分取代对于接口或酒店其他管理系统接口用接口原语名取代个别接口包含

getPMS3.

不止一个此项)

字段中文名称数据类型数量说明

用原语给出该字段用于描述该字段的所请求的该字段的对前面栏目的

该字段的中文名

包含的数据名数据类型数量补充说明

—————

[](:)

请求示例说明下面给出具体请求示例

)“”,:

2关于接口定义中的数量说明如下

:。

1表示有且仅有一个

:,,。

0..n表示可以没有也可以为多个数量没有上限

:,,。

1..n表示最少一个可以为多个数量没有上限

)“”,。

3关于接口定义中的示例本标准主要采用国际通行的数据交换数据格式Json来说明

6.2.2接口数据类型

包括如下几种类型:

),;

a字符型数据用String表示

),;

b整数型数据用Number表示

),;

c小数型数据用Decimal表示

)([]),,

d对象型数据用后缀Dto的字符串表示自定义数据传输对象该类型的数据应进行单独

说明。

4

/—

GBT379762019

6.3PMS接口

6.3.1基础代码获取接口

获取国家信息etCountries

g

[功能说明]

获取国家信息。

[]

请求参数

字段中文名称数据类型数量说明

hotelGrouCode酒店集团代码Strin1—

pg

[响应数据]

字段中文名称数据类型数量说明

resultCode结果代码String1字段操作结果

resultMs结果信息Strin1返回提示信息

gg

resultOb结果对象CoutrDto[]0..n返回数据对象

jy

CoutrDto

y

字段中文名称数据类型数量说明

code代码String1—

descrit名称Strin1—

pg

[]

请求示例

{

:

"hotelGrouCode""HTLG"

p

}

[]

返回示例

{

:,

"resultCode"0

:查询成功,

"resultMs"""

g

"resultInfo":[

{

:,

"code""CHN"

:中国

"descrit"""

p

},

{

:,

"code""USA"

:美国

"descrit"""

p

}

]

}

5

/—

GBT379762019

获取城市信息etCities

g

[功能说明]

获取指定酒店集团的城市信息。

[]

请求参数

字段中文名称数据类型数量说明

hotelGrouCode酒店集团代码Strin1—

pg

[响应数据]

字段中文名称数据类型数量说明

resultCode结果代码String1—

resultMs结果信息Strin1—

gg

resultInfo返回信息CitDto[]0..n—

y

CitDto

y

字段中文名称数据类型数量说明

code代码String1—

descrit名称Strin1—

pg

[]

请求示例

{

:

"hotelGrouCode""HTLG"

p

}

[]

返回示例

{

:,

"resultCode"0

:查询成功,

"resultMs"""

g

"resultInfo":[

{

:,

"code""HZ"

:杭州

"descrit"""

p

},

{

:,

"code""SH"

:上海

"descrit"""

p

}

]

}

获取证件类型信息etIdCodes

g

[功能说明]

获取证件类型信息。

6

/—

GBT379762019

[]

请求参数

字段中文名称数据类型数量说明

hotelGrouCode酒店集团代码Strin1—

pg

hotelCode酒店代码String1—

[响应数据]

字段中文名称数据类型数量说明

resultCode结果代码String1—

resultMs结果信息Strin1—

gg

resultInfo返回信息IdCodeDto[]0..n—

IdCodeDto

字段中文名称数据类型数量说明

code代码String1—

descrit名称Strin1—

pg

[]

请求示例

{

:,

"hotelGrouCode""HTLG"

p

:

"hotelCode""GCBZ"

}

[]

返回示例

{

:,

"resultCode"0

:查询成功,

"resultMs"""

g

"resultInfo":[

{

:,

"code""01"

:身份证

"descrit"""

p

},

{

:,

"code""99"

:其他证件

"descrit"""

p

}

]

}

获取性别信息etSexCodes

g

[功能说明]

获取证件类型信息。

[]

请求参数

7

/—

GBT379762019

字段中文名称数据类型数量说明

hotelGrouCode酒店集团代码Strin1—

pg

hotelCode酒店代码String1—

[响应数据]

字段中文名称数据类型数量说明

resultCode结果代码String1—

resultMs结果信息Strin1—

gg

resultInfo返回信息SexDto[]0..n—

SexDto

字段中文名称数据类型数量说明

code代码String1—

descrit名称Strin1—

pg

[]

请求示例

{

:,

"hotelGrouCode""HTLG"

p

:

"hotelCode""GCBZ"

}

[]

返回示例

{

:,

"resultCode"0

:查询成功,

"resultMs"""

g

"resultInfo":[

{

:,

"code""1"

:男

"descrit"""

p

},

{

:,

"code""2"

:女

"descrit"""

p

}

]

}

获取酒店信息etHotels

g

[功能说明]

获取指定酒店集团相关条件下的酒店列表。

[]

请求参数

8

/—

GBT379762019

字段中文名称数据类型数量说明

hotelGrouCode酒店集团代码Strin1—

pg

hotelCode酒店代码String0..1—

citCode城市代码Strin0..1—

yg

brandCodes品牌代码String0..n—

[响应数据]

字段中文名称数据类型数量说明

resultCode结果代码String1—

resultMs结果信息Strin1—

gg

resultInfo返回信息HotelInfoDto[]0..n—

HotelInfoDto

字段中文名称数据类型数量说明

code酒店代码String1—

status酒店状态String1—

descrit酒店名称Strin1—

pg

countrCode酒店所在国家代码Strin1—

yg

citCode酒店所在城市Strin1—

yg

address地址String1—

phone电话String1—

website网址String1—

email电子邮箱String1—

remark备注String1—

、

Te酒店类型Strin1度假商务

ypg

starLevel酒店星级String1—

coordinates酒店坐标String1经纬度坐标

[]

请求示例

{

:

"hotelGrouCode""HTLG"

p

}

[]

返回示例

{

:,

"resultCode"0

:查询成功,

"resultMs"""

g

"resultInfo":[

{

:,

"code""HTL"

9

/—

GBT379762019

:,

"status""I"

:黄山大酒店,

"descrit"""

p

:,

"countrCode""CHN"

y

:,

"citCode""HS"

y

:安徽省黄山市,

"address"""

:,

"hone"""

p

:,

"fax"""

:,

"website"""

:,

"email"""

:

"remark"""

}

]

}

6.3.2客房管理

获取房型信息etRoomTes

gyp

[功能说明]

获取酒店的房型信息列表。

[]

请求参数

字段中文名称