DB4403 T 315-2023 停车库（场）预约共享数据接口规范.pdf

《DB4403 T 315-2023 停车库（场）预约共享数据接口规范.pdf》由会员分享，可在线阅读，更多相关《DB4403 T 315-2023 停车库（场）预约共享数据接口规范.pdf（84页珍藏版）》请在麦多课文档分享上搜索。

1、 DB4403/T 3152023 停车库（场）预约共享数据接口规范 Specification for reservation and shared data interface of parking lots 2023-02-15 发布2023-03-01 实施深圳市市场监督管理局 发 布 深圳市地方标准 ICS 35.240.01 CCS L 67 DB4403DB4403/T 3152023 I 目 次 前言.II 1 范围.1 2 规范性引用文件.1 3 术语和定义.1 4 缩略语.2 5 总体要求.2 6 功能要求.3 7 数据接口要求.4 8 数据传输要求.38 附录 A（规范性

2、）具备预约共享业务功能的停车库（场）建设要求.40 附录 B（资料性）停车业务场景及流程.41 附录 C（规范性）编码定义.47 附录 D（资料性）签名和接口使用示例.49 参考文献.80 DB4403/T 3152023 II 前 言 本文件按照GB/T 1.12020标准化工作导则 第1部分：标准化文件的结构和起草规则的规定起草。本文件由深圳市公安局交通警察局提出并归口。本文件起草单位：深圳市信息基础设施投资发展有限公司、深圳市停车行业协会、深圳市顺易通信息科技有限公司、鹏城智慧共享科技（深圳）有限公司、深圳市博思高科技有限公司、深圳市凯达尔科技实业有限公司、深圳锦沃科技有限公司、深圳市道

3、尔智控科技股份有限公司、深圳市豪位科技有限公司、深圳智优停科技有限公司、深圳市安赛科技有限公司、深圳信路通智能技术有限公司、深圳市奇见科技有限公司、深圳市富士智能股份有限公司、深圳市红门智慧停车科技有限公司、深圳地铁物业管理发展有限公司、深圳市计通智能技术有限公司、深圳市皇驰科技有限公司、深圳市中安测标准技术有限公司。本文件主要起草人：陈显东、陈晓宁、王乐、徐伟剑、郑雷克、蔡志敏、张毅、高皓、何军、李民、吴曲曲、黄应辉、梁峰、董晓波、李静涛、黄钟洪、王桃、何宝华、杨纪刚、黄兰发、方明星、陈明春、李友斌、李志亮、徐纯梁、叶汉中、陈汉、曾北桂、蒋志文、朱志波、曲飞宇、童洪明、白国强、陈在杰、陈鑫、

4、吴金平。DB4403/T 3152023 1 停车库（场）预约共享数据接口规范 1 范围 本文件规定了停车库（场）预约共享停车业务的总体要求、功能要求、数据接口要求、数据传输要求。本文件适用于深圳市范围内停车库（场）管理系统或停车管理平台与预约共享停车平台之间的数据交换以及功能设计与开发。2 规范性引用文件 下列文件中的内容通过文中的规范性引用而构成本文件必不可少的条款。其中，注日期的引用文件，仅该日期对应的版本适用于本文件；不注日期的引用文件，其最新版本（包括所有的修改单）适用于本文件。GB/T 2260 中华人民共和国行政区划代码 GB 5768.2 道路交通标志和标线 第2部分：道路交通

5、标志 GB/T 10114 县级以下行政区划代码编制规则 GA/T 761 停车库（场）安全管理系统技术要求 DB4403/T 89 智慧停车 基础信息编码技术规范 SZJG 44 停车库（场）车辆视频图像和号牌信息采集与传输系统技术要求 3 术语和定义 下列术语和定义适用于本文件。3.1 车位提供方 parking space provider 具有车位产权或使用权，并在一段时间内提供车位的组织或个人。3.2 停车用户 parking space user 接受停车服务的组织或个人。3.3 预约停车 reserved parking 车位提供方（3.1）向停车用户（3.2）提供约定时间内预约

6、入场或预约到位的服务。注：停车用户提前申请、预约才可享受停车服务。3.4 共享停车 shared parking 车位提供方（3.1）在车位空闲时向停车用户（3.2）提供停车的服务。3.5 服务商 parking attendant 为停车库（场）提供预约共享能力解决方案和经营管理服务，协助停车库（场）接入预约共享停车平台的组织或个人。DB4403/T 3152023 2 注：服务商包括但不限于停车库（场）运营（承包）公司、平台厂商、城市停车运营服务平台运营方、物业管 理企业、工程商/集成商、设备厂商等。3.6 预约车辆 parking reservation vehicles 向具备预约停车

7、（3.3）的停车库（场）预约某个时段停车的车辆。3.7 停车库（场）管理系统 parking lots management system 对出入停车库（场）的车辆进行登记、出入认证，监控和管理，提供停车库（场）区内引导、寻找车辆等一系列功能的电子系统或网络。3.8 停车管理平台 parking management platform 用于对路内停车泊位或路外停车场进行统一运营、监控和运维管理的系统或平台。3.9 预约共享停车平台 reservation and shared parking platform 运用物联网、云计算、大数据等技术，通过与第三方停车、充电、机械车库等系统或平台的对接

8、，获取、处理停车库（场）停车信息，将各停车资源互联互通实现停车资源共享、一账通行等，对向社会大众提供目标区域范围内车位寻找、车位引导、预约停车（3.3）、共享停车（3.4）等服务的系统。3.10 流量管控 flow control 根据停车库（场）内剩余车位数，动态调整入场车辆的放行规则。3.11 饱和度 saturation 停车库（场）内停放车辆数与总车位数的比值。注：总车位数指可用于预约和非预约车辆停放的车位总数。4 缩略语 下列缩略语适用于本文件。APP：应用程序（Application）HMACSHA256：使用安全哈希算法256的消息认证码（Hash-based Message A

9、uthentication Code-Secure Hash Algorithm 256）HTTPS：安全套接字层的超文本传输协议（Hyper Text Transfer Protocol over Secure Socket Layer）ID：标识编码（Identification）MQTT：消息队列遥测传输（Message Queuing Telemetry Transport）NTP：网络时间协议（Network Time Protocol）QoS：服务质量（Quality of Service）5 总体要求 5.1 具备预约共享业务功能的停车库（场）建设应符合附录 A 的规定。DB44

10、03/T 3152023 3 5.2 预约共享停车平台与各停车库（场）管理系统或停车管理平台进行数据对接，预约共享停车业务示意图见图 1，具体接入方式如下：a)预约停车资源或共享停车资源通过停车管理平台接入预约共享停车平台进行数据交互；b)预约停车资源或共享停车资源通过停车库（场）管理系统接入预约共享停车平台进行数据交互。预约停车资源共享停车资源预约停车资源共享停车资源停车库（场）管理系统停车管理平台预约共享停车平台车位提供方服务商平台运营方停车用户用户端 注：实线框表示在本文件界定的范围。图1 预约共享停车业务示意图 5.3 当产生共享停车业务或预约停车业务时，停车业务场景及流程见附录 B。

11、6 功能要求 6.1 通用要求 接入预约共享停车平台的停车库（场）管理系统或停车管理平台应符合以下要求：a)支持向预约共享停车平台提供停车库（场）地理位置（如地址、出入口经纬度）、车位信息（如车位数量）、收费标准等信息，并符合以下要求：1)应保证登记的车位信息真实有效，若车位信息变更，应及时维护；2)应按照登记发布的车位信息提供停车服务，不随意变更。b)支持电子支付功能；c)支持发票开具功能；d)支持对车辆出入事件信息的记录、管理及查询等功能；e)支持向预约共享停车平台上传车辆的入场信息、出场信息、收费记录等功能；f)支持对出入停车库（场）的车辆和车位进行采集、记录、认证、监控及管理等功能；g

12、)支持接收预约共享停车平台的车辆管控名单功能；h)支持预约车辆费用减免、打折优惠等功能。6.2 预约停车 6.2.1 停车库（场）管理系统或停车管理平台应支持接收预约共享停车平台下发的预约停车数据，包括：a)预约信息：车辆信息、预约时间等；b)预约时段变更信息：车辆信息、变更预约时段等；DB4403/T 3152023 4 c)限时取消预约信息：车辆信息、取消预约等；d)预约时段与停车时段信息：未按预约订单起始时间进入停车库（场）的处置规则。6.2.2 停车库（场）管理系统或停车管理平台宜支持将预约车辆入口临时调整成非预约车辆入口的功能。6.2.3 停车库（场）管理系统或停车管理平台宜支持设置

13、停放车辆饱和度的功能。6.2.4 停车库（场）管理系统或停车管理平台应支持开启或关闭预约车辆优先通行功能，并向预约共享停车平台通知其开启或关闭的状态信息。6.2.5 停车库（场）管理系统或停车管理平台宜支持根据饱和度动态调整流量管控规则保障预约车辆优先通行的功能。6.3 共享停车 6.3.1 停车库（场）管理系统或停车管理平台应向预约共享停车平台上报以下信息：a)共享方案信息：车位共享方案类型、车型限制、车位停放时段、有效期等；b)支付结果信息：共享方案订单编号、订单类型、支付结果状态、支付方式等；c)超时订单信息：共享方案订单编号、超时订单编号、车牌号码、入场时间、出场时间、超时时间等；d)

14、退款结果信息：退款流水号、共享方案订单编号、订单类型、退款状态等；e)订单信息变更信息：共享方案订单编号、订单状态、车牌号码、开始日期、结束日期等。6.3.2 停车库（场）管理系统或停车管理平台应接收预约共享停车平台下发以下信息：a)共享停车订单信息：车辆信息、共享时段等；b)共享停车时段变更信息：车辆信息、变更预约时段等；c)共享停车限时取消信息：车辆信息、取消预约等。7 数据接口要求 7.1 概述 停车库（场）管理系统或停车管理平台与预约共享停车平台对接前，服务商向预约共享停车平台运营方提出接入申请，并进行数据对接。7.2 基础数据类型 基础数据应符合表 1 的要求，其中停车库（场）编号、

15、车位编号应符合 DB4403/T 89 的要求。表1 基础数据类型清单 类型名称 长度 基础类（json）说明 String Na String 字符串 Long 8 字节 Number 长整型 Int 4 字节 Number 整型 Boolean 1 字节 Boolean 布尔型 Float 4 字节 Number 浮点型 DB4403/T 3152023 5 表 1 基础数据类型清单（续）类型名称 长度 基础类（json）说明 Double 8 字节 Number 双精度浮点 Decimal 16 字节 Number 高精度浮点 Date 10 字符 String 日期，格式“yyyy-M

16、M-dd”DateTime 19 字符 String 日期时间，格式“yyyy-MM-dd HH:mm:ss”Time 8 字符 String 时间，格式“HH:mm:ss”Timestamp 4 字节 Number 时间戳，1970-01-01 00:00:00：00 起的秒数 Uuid 32 字符 String 全球唯一 ID Object Nb Object 对象 List Nb Array 数组 注1：未作特殊说明情况下，本文件中涉及的金额统一采用数据类型Decimal，单位为元，精度为小数点后2位。注2：无特殊说明，本文件中的经纬度均为GCJ-02坐标系坐标。注3：后文的数据定义中未

17、写明长度的数据类型的字符长度以本表规定为准。注4：Na表示根据各属性（名称）定义其字符长度，Nb表示引用其他对象。7.3 接口要求 7.3.1 协议使用要求 7.3.1.1 对接要求 停车库（场）管理系统或停车管理平台在对接预约共享停车平台前，按预约共享停车平台的管理要求，准备信息包括但不限于：a)注册获取平台服务器地址、对接账号（HTTPS 对接的使用的 userId/clientId、password及盐值 salt）信息等；b)向预约共享停车平台提供服务器 IP 地址（可选）。7.3.1.2 基本要求 基本要求如下：a)传输格式：JSON；b)编码格式：UTF-8；c)属性命名规范：小驼

18、峰形式（如：deviceId）；d)协议要求：HTTPS 或 MQTT；e)使用接口一次发送数据的大小不应超过 10M 字节；f)预约共享停车平台、停车管理平台采用如 NTP 时间同步技术和北京时间保持同步；g)接口请求超时时间限制：20 秒以内；h)请求数据基本格式见表 2，应答数据基本格式见表 3；i)编码定义应符合附录 C 的规定；j)签名和接口使用示例见附录 D。DB4403/T 3152023 6 表2 请求数据基本格式 属性 名称 数据类型 字符长度 必须 说明 timestamp 时间戳 Timestamp 4 是 sign 签名 String 是 签名算法 HMACSHA256

19、，key 值使用平台分配的盐值 salt，对 data 数据进行签名data 请求数据 List 是 根据接口不同请求数据不同 表3 应答数据基本格式 属性 名称 数据类型 字符长度 必须 说明 code 系统编码 Int 是 通用错误编码见表 C.1 message 系统消息 String 255 否 系统编码对应的消息 timestamp 时间戳 Timestamp 是 data 返回数据 List 是 根据接口不同返回数据不同 7.3.1.3 HTTPS 接口要求 HTTPS接口符合以下要求：a)采用 Token 机制实现身份认证；Token 放到 HTTPS header 的 Auth

20、orization 中；b)接口 URL 规则：https：/服务器地址/sys/版本号/event/接口编码/post。示例：https：/ MQTT 接口要求 MQTT接口符合以下要求：a)加密方式：传输加密采用 tls 证书加密方式；b)认证方式：使用预约共享停车平台分配的 MQTT 客户端 ID（clientId，标识每个 MQTT 连接需要唯一 ID）和密码登录消息中间件；c)服务质量（QoS）：使用默认的 QoS 等级 0；d)当使用 MQTT 协议传输数据时：1)上行符合以下要求：请求 Topic：/sys/版本号/event/接口编码/post；响应 Topic：/sys/版本

21、号/event/接口编码/post_reply。示例：请求 Topic：/sys/v1/event/login/post；响应 Topic：/sys/v1/event/login/post_reply。2)下行符合以下要求：请求 Topic：/sys/版本号/service/接口编码/post；响应 Topic：/sys/版本号/service/接口编码/post_reply。示例：请求 Topic：/sys/v1/service/requestBookStall/post；响应 Topic：/sys/v1/service/requestBookStall/post_reply。DB4403/

22、T 3152023 7 7.3.2 安全认证接口 7.3.2.1 登录 安全认证接口的登录应符合以下要求：a)接口编码：login；b)场景：停车库（场）管理系统或停车管理平台请求登录预约共享停车平台，平台验证用户标识，生成 Token 返回；c)数据属性：请求数据属性定义见表 4，应答数据属性定义见表 5。表4 请求数据属性定义 属性 名称 数据类型 字符长度 必须 说明 userId 用户唯一标识 String 32 是 password 用户密码 String 64 是 不使用明文，采用 SHA1 对原用户密码加上盐值 salt 签名后的值 表5 应答数据属性定义 属性 名称 数据类型

23、字符长度 必须 说明 code 消息码 Int 否 发生错误时为必填，编码见表 C.2 message 消息详细 String 255 否 业务异常信息 scope 范围 String 50 否 请求的业务范围，默认值 basic tokenType 鉴权 token 类型 String 50 是 默认值 bearer expiresIn 有效时间 Int 是 accessToken 的有效时间，单位：秒 accessToken 权限 Token String 255 是 Oauth 2.0 鉴权参数 refreshToken 刷新 Token String 255 是 Oauth 2.0 鉴

24、权参数 7.3.2.2 刷新 Token 安全认证接口的刷新应符合以下要求：a)接口编码：refreshToken；b)场景：accessToken 快过期时，停车库（场）管理系统或停车管理平台通过调用此接口，重新获取可用 token。accessToken 有效时间按照 7.3.2.1 返回字段 expiresIn 的值；c)数据属性：请求数据属性定义见表 6，应答数据属性定义见表 7。表6 请求数据属性定义 属性 名称 数据类型 字符长度 必须 说明 userId 用户唯一标识 String 32 是 预约共享停车平台分配 password 用户密码 String 64 是 不使用明文，采

25、用 SHA1 对原用户密码加上盐值 salt 签名后的值 refreshToken 刷新 Token String 是 DB4403/T 3152023 8 表7 应答数据属性定义 属性 名称 数据类型 字符长度 必须 说明 id 业务 ID Uuid 32 是 code 消息码 Int 否 发生错误时为必填，编码见表 C.2 message 消息详细 String 255 否 业务异常信息 tokenType 鉴权 token 类型 String 50 是 默认值 bearer expiresIn 有效时间 Int 是 accessToken 的有效时间，单位：秒 accessToken 权

26、限 Token String 50 是 Oauth 2.0 鉴权参数 refreshToken 刷新 Token String 50 是 Oauth 2.0 鉴权参数 7.3.2.3 登出 安全认证接口的登出应符合以下要求：a)接口编码：logout；b)场景：注销 Token；c)数据属性：请求数据属性定义见表 8，应答数据属性定义见表 9。表8 请求数据属性定义 属性 名称 数据类型 字符长度 必须 说明 accessToken 权限 Token String 50 是 表9 应答数据属性定义 属性 名称 数据类型 字符长度 必须 说明 code 消息码 Int 否 发生错误时为必填，编码

27、见表 C.2 message 消息详细 String 255 否 业务异常信息 7.3.3 基础数据接口 7.3.3.1 停车库（场）信息上报 基础数据接口的停车库（场）信息上报应符合以下要求：a)接口编码：parkInfo；b)场景：停车库（场）管理系统或停车管理平台调用接口主动推送停车库（场）信息；c)数据属性：请求数据属性定义见表 10，应答数据属性定义见表 11。表10 请求数据属性定义 属性 名称 数据类型 字符长度 必须 说明 parkCode 停车库（场）编号 String 20 是 预约共享停车平台提供 DB4403/T 3152023 9 表 10 请求数据属性定义（续）属性

28、 名称 数据类型 字符长度 必须 说明 parkName 停车库（场）名称 String 255 是 服务商提供 providerCode 服务商编号 String 100 否 由预约共享停车平台分配，涉及共享停车应提供 roadName 道路名称 String 10 否 parkType 停车库（场）类型 Int 是 0：路内停车区；1：室内停车场；2：室外停车场 isGarage 是否有机械车库 Int 否 0：否；1：是 address 停车库（场）详细地址 String 255 是 停车库（场）详细地址 longitude 经度 Double 是 经度，服务商上传时应说明数据来源 la

29、titude 纬度 Double 是 纬度，服务商上传时应说明数据来源 provinceCode 省编码 String 50 是 编码规则应符合 GB/T 2260、GB/T 10114 的要求 cityCode 城市编码 String 50 是 编码规则应符合 GB/T 2260、GB/T 10114 的要求 areaCode 区域编码 String 50 是 编码规则应符合 GB/T 2260、GB/T 10114 的要求 totalSpaces 总车位数 Int 是 总车位数 reservableSpaces 总可预约车位数 Int 否 涉及预约停车业务应提供 totalCharingS

30、paces 总充电车位数 Int 否 涉及充电业务应提供 totalReservableCharingSpaces 总可预约充电车位数 Int 否 涉及充电业务应提供 sharedSpaces 总共享停车车位数 Int 否 operatorId 停车库（场）运营方编号 String 10 否 由预约共享停车平台统一分配，涉及预约停车业务时应提供 committeeInfo 是否有业委会 Int 否 针对住宅类 0：是；1：否 DB4403/T 3152023 10 表 10 请求数据属性定义（续）属性名称数据类型字符长度必须说明publicInfo 经营信息 String 200 否 经营时间

31、（如 6:008:00）serviceType 服务属性 Int 否 1：商业；2：住宅；3：医院；4：园区；5：交通枢纽；6：行政机关；7：学校；8：其它 chargingStandardDesc 收费标准描述 String 255 是 示例：免费时长 30 分钟，首小时10 元，后每小时 5 元，每 24 小时封顶 60 元 imageUrl 停车库（场）收费牌图片 String 255 否 图片 URL 访问地址，见 7.3.4.1.7图片上传接口 mapImage 停车库（场）电子平面图 String 255 否 图片 URL 访问地址，见 7.3.4.1.7图片上传接口 parkin

32、gSpaceImage 车位分布图 String 255 否 图片 URL 访问地址，见 7.3.4.1.7图片上传接口 contacts 联系人 String 50 否 停车库（场）联系人 tel 联系电话 String 20 否 停车库（场）联系电话 bizStatus 状态 Int 否 停车库（场）使用状态：0：禁用；1：启用 remark 备注字段 String 255 否 备注字段 表11 应答数据属性定义 属性名称数据类型字符长度必须说明parkCode 停车库（场）编号 String 20 是 code 消息码 Int 否 发生错误时为必填，编码见表 C.2 message 消息

33、详细 String 255 否 业务异常信息 isvParkId 平台车场 ID String 50 是 预约共享停车平台生成 7.3.3.2 出入口信息上报 基础数据接口的出入口信息上报应符合以下要求：a)接口编码：entranceExitInfo；b)场景：停车库（场）管理系统或停车管理平台调用接口主动推送出入口信息；c)数据属性：请求数据属性定义见表 12，应答数据属性定义见表 13。DB4403/T 3152023 11 表12 请求数据属性定义 属性名称数据类型字符长度必须说明id 出入口 ID Uuid 32 是 停车库（场）的出入口 ID name 名称 String 10 是

34、parkCode 停车库（场）编号 String 20 是 roadName 道路名称 String 10 否 type 出入口类型 Int 是 1：入口；2：出口；3：出入口 longitude 经度 Double 是 经度，服务商上传时应说明数据来源 latitude 纬度 Double 是 纬度，服务商上传时应说明数据来源 status 状态 Int 是 1：正常；2：删除；3：临时封闭（故障、管制等）表13 应答数据属性定义 属性 名称 数据类型 字符长度 必须 说明 id 出入口 ID Uuid 32 是 停车库（场）的出入口 ID code 消息码 Int 否 发生错误时为必填，编

35、码见表 C.2 message 消息详细 String 255 否 业务异常信息 7.3.3.3 车位基础信息上报 基础数据接口的车位基础信息上报应符合以下要求：a)接口编码：spaceInfo；b)场景：停车库（场）管理系统或停车管理平台调用接口主动推送车位基础信息；c)数据属性：请求数据属性定义见表 14，应答数据属性定义见表 15。表14 请求数据属性定义 属性 名称 数据类型 字符长度 必须 说明 id ID String 是 spaceNo 车位编号 String 28 是 车位方格内的编号 parkCode 停车库（场）编号 String 20 是 DB4403/T 3152023

36、 12 表 14 请求数据属性定义（续）属性 名称 数据类型 字符长度 必须 说明 manageType 经营类型 Int 否 0：分时；1：长期包月；2：限时段包月；3：已售；4：专用车位（如消防）ownerType 产权类型 Int 否 1：个人；2：单位；3：其他 positionType 位置类型 Int 是 0：路内；1：停车库；2：停车场 sizeType 尺寸类型 Int 否 车位分类【长（毫米）宽（毫米）】：1：小型：40002200；2：中型：50002500；3：大型：156003250；4：子母车位：100002500 spaceSize 车位尺寸 String 否 长（

37、毫米）宽（毫米）高（毫米），不限高度车位，高度为0 serviceType 服务属性 Int 否 1：商业；2：住宅；3：医院；4：园区；5：交通枢纽；6：行政机关；7：学校；8：其它 visitType 出行性质 Int 否 0：居住车位；1：出行车位；2：居住和出行兼用；3：未知 floor 所属楼层 String 10 否 areaName 所属区域 String 50 否 isReservation 是否支持预约 Int 是 0：否；1：是 DB4403/T 3152023 13 表 14 请求数据属性定义（续）属性 名称 数据类型 字符长度 必须 说明 withLocker 配置车位

38、锁标志 Int 是 0：否；1：是 withChargingPile 配置充电桩标志 Int 是 0：否；1：是 表15 应答数据属性定义 属性 名称 数据类型 字符长度 必须 说明 spaceNo 车位编号 String 28 是 code 消息码 Int 否 发生错误时为必填，编码见表 C.2 message 消息详细 String 255 否 业务异常信息 7.3.3.4 车场收费标准信息上报 基础数据接口的车场收费标准信息上报应符合以下要求：a)接口编码：chargeInfo；b)场景：停车库（场）管理系统或停车管理平台调用接口主动推送车场临时车收费标准信息；c)数据属性：请求数据属性

39、定义见表 16，应答数据属性定义见表 18。表16 请求数据属性定义 属性 名称 数据类型 字符长度 必须 说明 parkCode 停车库（场）编号 String 20 是 permitNo 停车许可证号 String 6 否 预约停车应提供 charger 收费单位 String 100 是 pricing 定价方式 Int 是 1：政府定价；2：政府指导价；3：市场调节价 region 区域划分 Int 是 1：一类地区；2：二类地区；3：三类地区 区域划分应符合深圳市发展和改革委员会关于完善我市机动车停放服务收费政策的通知 complaintTel 价格投诉电话 String 20 是

40、remark 补充说明 String 500 否 chargeItemstable 收费项目 List 是 收费项目见表 17 DB4403/T 3152023 14 表17 收费项目 属性 名称 数据类型 字符长度 必须 说明 chargeItemstable 收费项目 String 20 是 示例：小型车临时停放 chargeDesc 收费标准描述 String 255 是 示例：免费时长 30 分钟，首小时10 元，后每小时 5 元，每 24 小时封顶 60 元 表18 应答数据属性定义 属性 名称 数据类型 字符长度 必须 说明 permitNo 停车许可证号 String 6 是 与

41、停车库（场）经营许可证编号一致 code 消息码 Int 否 发生错误时为必填，编码见表 C.2 message 消息详细 String 255 否 业务异常信息 7.3.4 公共数据接口 7.3.4.1 数据上报接口 7.3.4.1.1 车辆驶入信息上报 数据上报接口的车辆驶入信息上报应符合以下要求：a)接口编码：enterRecord；b)场景：停车库（场）管理系统或停车管理平台调用接口主动推送车辆入场信息；c)数据属性：请求数据属性定义见表 19，应答数据属性定义见表 20。表19 请求数据属性定义 属性 名称 数据类型 字符长度 必须 说明 id 停车记录 ID Uuid 32 是 p

42、arkCode 停车库（场）编号 String 20 否 路外停车应提供 spaceNo 车位编号 String 28 否 plateNo 车牌号码 String 20 是 plateColor 车牌颜色 Int 否 0：蓝色；1：黄色；2：黑色；3：白色；4：绿色；5：其他 DB4403/T 3152023 15 表 19 请求数据属性定义（续）属性 名称 数据类型 字符长度 必须 说明 carColor 车辆颜色 Int 否 1：白色；2：灰色；3：黑色；4：红色；5：黄色；6：绿色；7：蓝色；8：其他 carModel 车型 Int 否 1：大型车；2：中型车；3：小型车；4：微型车 e

43、nterTime 入场时间 DateTime 是 entranceName 入口名称 String 50 否 表20 应答数据属性定义 属性名称数据类型字符长度必须说明id 停车记录 ID Uuid 32 是 code 消息码 Int 否 发生错误时为必填，编码见表 C.2 message 消息详细 String 255 否 业务异常信息 7.3.4.1.2 车辆驶离信息上报 数据上报接口的车辆驶离信息上报应符合以下要求：a)接口编码：exitRecord；b)场景：停车库（场）管理系统或停车管理平台调用接口主动推送车辆出场信息；c)数据属性：请求数据属性定义见表 21，应答数据属性定义见表

44、22。表21 请求数据属性定义 属性 名称 数据类型 字符长度 必须 说明 id 停车记录 ID Uuid 32 是 parkCode 停车库（场）编号 String 20 否 路外停车应提供 spaceNo 车位编号 String 28 否 plateNo 车牌号码 String 20 是 DB4403/T 3152023 16 表 21 请求数据属性定义（续）属性 名称 数据类型 字符长度 必须 说明 plateColor 车牌颜色 Int 否 0：蓝色；1：黄色；2：黑色；3：白色；4：绿色；5：其他 carColor 车辆颜色 Int 否 1：白色；2：灰色；3：黑色；4：红色；5：黄

45、色；6：绿色；7：蓝色；8：其他 carModel 车型 Int 否 1：大型车；2：中型车；3：小型车；4：微型车 leaveTime 出场时间 DateTime 否 exitName 出口名称 String 50 否 chargeIdList 缴费记录 ID List 否 涉及预约停车应提供 receivables 应收汇总 Decimal 是 不包括退费 discount 优惠汇总 Decimal 是 不包括退费 received 实收汇总 Decimal 是 不包括退费 表22 应答数据属性定义 属性 名称 数据类型 字符长度 必须 说明 id 停车记录 ID Uuid 32 否 co

46、de 消息码 Int 否 发生错误时为必填，编码见表 C.2 message 消息详细 String 255 否 业务异常信息 7.3.4.1.3 车辆收费记录上报 数据上报接口的车辆收费记录上报应符合以下要求：a)接口编码：parkChargeInfo；b)场景：停车库（场）管理系统或停车管理平台调用接口主动推送车辆出场收费记录信息；c)数据属性：请求数据属性定义见表 23，应答数据属性定义见表 25。DB4403/T 3152023 17 表23 请求数据属性定义 属性 名称 数据类型 字符长度 必须 说明 id 缴费记录 ID Uuid 32 是 orderNo 共享方案订单编号 Str

47、ing 50 否 recordId 停车记录 ID Uuid 32 是 plateNo 车牌号码 String 20 是 plateColor 车牌颜色 Int 否 0：蓝色；1：黄色；2：黑色；3：白色；4：绿色；5：其他 carColor 车辆颜色 Int 否 1：白色；2：灰色；3：黑色；4：红色；5：黄色；6：绿色；7：蓝色；8：其他 carModel 车型 Int 否 1：大型车；2：中型车；3：小型车；4：微型车 payTime 支付时间 DateTime 是 receivables 应收汇总 Decimal 是 discount 优惠汇总 Decimal 是 received 实

48、收汇总 Decimal 是 payType 支付方式 Int 是 1：支付方式 1；2：支付方式 2；3：支付方式 3；4：支付方式 4；5：支付方式 5；6：其他 DB4403/T 3152023 18 表 23 请求数据属性定义（续）属性 名称 数据类型 字符长度 必须 说明 payFrom 支付应用来源 String 10 是 示例：线下缴费、运营商 APP、电话及其它 listDiscounts 优惠记录 List 否 优惠记录见表 24 表24 优惠记录 属性 名称 数据类型 字符长度 必须 说明 id 优惠记录 ID Uuid 32 是 couponNo 优惠券编号 String

49、20 否 couponType 优惠类型 Int 是 0：无优惠；1：减免金额；2：减免时间；3：打折；4：全免 couponValue 优惠值 Decimal 是 当优惠类型为无优惠时，值约定为0；当优惠类型为减免金额时，单位为元（CNY）；当优惠类型为减免时间时，单位为小时（h）；当优惠类型为打折时，指优惠折扣，如值为 0.3，表示减免 30；当优惠类型为全免时，值为 1，但无直接意义 discountChannel 优惠发起机构 String 100 否 如服务商 channelOrgCode 优惠发起机构编码 String 18 否 统一社会信用代码 表25 应答数据属性定义 属性 名

50、称 数据类型 字符长度 必须 说明 id 缴费记录 ID Uuid 32 是 code 消息码 Int 否 发生错误时为必填，编码见表 C.2 message 消息详细 String 255 否 业务异常信息 7.3.4.1.4 车位状态信息上报 数据上报接口的车位状态信息上报应符合以下要求：DB4403/T 3152023 19 a)接口编码：stallState；b)场景：停车库（场）管理系统或停车管理平台调用接口主动推送车位状态信息；c)数据属性：请求属性定义见表 26，应答属性定义见表 27。表26 请求数据属性定义 属性 名称 数据类型 字符长度 必须 说明 spaceNo 车位编号