《停车库（场）前端系统与预约停车平台之间的数据要求、编码》由会员分享，可在线阅读，更多相关《停车库（场）前端系统与预约停车平台之间的数据要求、编码（18页珍藏版）》请在金锄头文库上搜索。
1、T/SZPIA XXX20XX 6 AA 附录A （规范性） 前端系统与预约停车平台之间的数据要求 B A.1该部分适用于不同归属的前端系统与预约停车平台之间的数据交换。 A.2基础数据类型 基础数据类型应符合下列要求： a)未作特殊说明情况下： 本标准中涉及的金额统一采用数据类型 Decimal，单位为元，精度为小数点后 2 位； 本标准中数据定义未写明长度的数据类型的字符长度应符合表 A.1 要求。 b)本标准中使用的停车场编号、车位编号遵循深圳市地方标准智慧停车 基础信息编码技术规 范中的定义和要求。 表 A. 1 基础数据类型清单 类型名称长度基础类型（json）说明 StringNa
2、String字符串 Long8 字节Number长整型 Int4 字节Number整型 Boolean1 字节Boolean布尔型 Float4 字节Number浮点型 Double8 字节Number双精度浮点 Decimal16 字节Number高精度浮点 Date10 字符String日期，格式“yyyy-MM-dd” DateTime19 字符String日期时间，格式“yyyy-MM-dd HH:mm:ss” Time8 字符String时间，格式“HH:mm:ss” Timestamp4 字节Number时间戳，1970-01-01 00:00:00 起的秒数 Uuid32 字符S
3、tring全球唯一 ID ObjectNbObject对象 ListNbArray数组 Na 表示应根据各属性（名称）定义其字符长度； Nb 表示引用其他对象。 A.3停车数据要求 A.3.1停车场数据信息 停车场信息（parkInfo）如表 A.2 所示。 表 A. 2 停车场信息 属性名称数据类型字符长度必须说明 T/SZPIA XXX-20XX 7 parkCode停车场编号String20是 parkName停车场名称String255是 charging收费标准 chargingS tandard 是收费标准见表 A.3 roadName道路名称String10是 address停车
4、场详细地址String255否 reservableStalls总可预订车位数Int是 operatorId停车场运营方编号String10是由预约停车平台统一分配 serviceType服务属性Int是 1：商业； 2：住宅； 3：医院； 4：园区； 5：交通枢纽； 6：行政机关； 7：学校； 8：其它。 industAuthorInf o 业委会信息String50否 publicInfo经营信息String200是经营时间等 mapImage停车场电子平面图String否Base64 编码格式 A.3.2收费标准 收费标准（chargingStandard）如表 A.3 所示。 表 A.
5、 3 收费标准 属性名称数据类型字符长度必须说明 parkCode停车场编号String20是 permitNo停车许可证号String6是 charger收费单位String100是 princing定价方式Int是 1：政府定价； 2：政府指导价； 3：市场调节价。 region区域划分Int是 1：一类地区； 2：二类地区； 3：三类地区； 区域划分见深发改20171518 号 文件 complaintTel价格投诉电话String5是 remark补充说明String500否 pricingSign收费标价牌图片String否Base64 编码格式 items收费项目List 表 A.
6、 4 收费项目（chargedItem） 属性名称数据类型字符长度必须说明 chargeItem收费项目String20是例：小车临时停放 chargeDesc收费标准描述String100是 例：第一小时 XX 元（CNY） ，第二 小时起 XX 元/小时，每天最高收费 XX 元（CNY） A.3.3出入口信息 出入口信息（entranceInfo）如表 A.5 所示。 表 A. 5 出入口信息 属性名称数据类型字符长度必须说明 id出入口 IDUuid32是 name名称String10是 parkCode停车场编号String20是 roadName道路String10否 type出入口
7、类型Int是 1：入口； 2：出口； 3：出入口。 A.3.4车辆信息 车辆信息（parkCarInfo）如表 A.6 所示。 表 A. 6 车辆信息 属性名称数据类型字符长度必须说明 plateNo车牌号码String10是 plateColor车牌颜色String3否 carColor车辆颜色String3否 carModel车型Int否 1：大型车； 2：中型车； 3：小型车。 A.3.5停车信息 停车信息（parkRecordInfo）如表 A.7 所示。 表 A. 7 停车信息 属性名称数据类型字符长度必须说明 id停车记录 IDUuid32是 T/SZPIA XXX-20XX 9
8、parkCode停车场编号String20否路外停车应提供 stallNo车位编号String28否 carInfo车辆信息 parkCarIn fo 是车辆信息见表表 A.6 enterTime入场时间Datetime是 inEquipmentId入场设备 IDUuid32否 leaveTime出场时间Datetime否 outEquipmentId出场设备 IDUuid32否 chargeIdList缴费记录 List 否缴费记录见表 A.9 receivables应收汇总Decimal是不包括退费 discount优惠汇总Decimal是不包括退费 received实收汇总Decimal
9、是不包括退费 A.3.6停车订单信息 停车订单信息（parkOrder）如表 A.8 所示。 表 A. 8 停车订单 属性名称数据类型字符长度必须说明 orderNo订单编号String50是唯一订单编号 recordId停车记录 IDUuid32是 parkCode停车场编号String20是 stallNo车位编号String28否stallNo、 plateNo 应提供一个 plateNo车牌号码String10否stallNo、 plateNo 应提供一个 enterTime入场时间DateTime是 chargingStart开始计费时间DateTime是 chargingDurat
10、io n 停车计费时长Int是单位：秒（s） leaveTime出场时间DateTime否 paidAmount已缴费金额Decimal是 receivables停车应收Decimal是 otherFee其他费用Decimal是 discount优惠Decimal是 chargeType收费类型Int否 0：正常收费； 1：免费时间内免费； 2：免费； 3：超过最高收费而免费； 4：打折后免费； 5：其它。 freeMinute停车场免费时间Int否单位：分钟（m） T/SZPIA XXX20XX 10 surplusMinute出场免费时间Int否单位：分钟（m） A.3.7缴费记录 缴费记
11、录（parkChargeInfo）如表 A.9 所示。 表 A. 9 缴费记录 属性名称数据类型字符长度必须说明 id缴费记录 IDUuid32是 orderNo关联订单编号String50否 recordId停车记录 IDUuid32是 carInfo车辆信息 parkCarIn fo 是 车辆信息见表 A.6 payTime缴费时间DateTime是 receivables应收Decimal是 discount优惠Decimal是 received实收Decimal是 payType支付方式Int是 1：现金； 2：微信； 3：支付宝； 4：银联； 5：ETC； 6：其它。 payFrom
12、支付应用来源String10是 例如： 线下缴费、微信公众号、支付宝服 务窗、运营商 APP、电话及其它 listDiscounts优惠记录 List 否优惠记录见表 A.10 A.3.8优惠记录 优惠记录（discountRecord）如表 A.10 所示。 表 A. 10 优惠记录 属性名称数据类型字符长度必须说明 idIDUuid32是 couponNo优惠券编号String20否 couponType优惠类型Int是 0：无优惠； 1：减免金额； 2：减免时间； 3：打折； 4：全免 T/SZPIA XXX-20XX 11 couponValue优惠值Decimal是 1：优惠类型为金
13、额时，单位为元 （CNY） ； 2：优惠类型为时间时，单位为小时 （h） ； 3： 优惠类型为打折时， 指优惠折扣； 如 0.3 表示减免 30%； 4：优惠类型为全免时，值为 1，但 无直接意义。 discountChannel优惠渠道String100否如，停车场运营方等 channelOrgCode渠道商机构编码String18否统一社会信用代码 A.3.9车辆管控名单信息 车辆管控名单信息（blackWhiteGraySheet）如表 A.11 所示。 表 A. 11 车辆管控名单信息 属性名称数据类型字符长度必须说明 id名单 IDUuid32是 parkCode停车场编号Strin
14、g20是 carInfo车辆信息 parkCarIn fo 是车辆信息见表 A.6 strategyType控制策略类型Int是 1：禁止进； 2：允许进禁止出； 3：禁止进出； 4：给平台发送警告信息； 5：免费自动进出。 beginDate开始日期时间DateTime否不提供时，立即生效 endDate结束日期时间DateTime是 strategyFrom控制策略来源String50是 A.3.10场内车位数信息 场内车位数信息（parkSpaceInfo）如表 A.12 所示。 表 A. 12 场内车位数信息 属性名称数据类型字符长度必须说明 parkCode停车场编号String20
15、是 usedStalls已使用车位数量Int是全部实际已使用车位 unusedStalls剩余车位数量Int是 允许外来车辆停放的车位数量；此 数据应与对外发布的数据保持一致 reservedStalls已预订车位数Int否 A.4接口规范 T/SZPIA XXX20XX 12 A.4.1协议使用要求 A.4.1.1基本要求 应用此规范的接口时，应满足以下要求： a)传输格式要求：JSON； b)编码格式要求：UTF-8； c)属性命名规范要求：小驼峰形式(如：deviceId)； d)上行接口应使用 Https，下行接口优先使用 Https，条件不具备的，可使用 TCP 长连接； e)协议请
16、求满足表 A.13 的基本格式： 表 A. 13 请求数据基本格式 属性名称数据类型字符长度必须说明 timestamp时间戳Timestamp4是 特指发送同一份业务数据时的发送 时刻 sign签名String是 data请求数据 List 是根据接口不同请求数据数据不同 签名生成的通用步骤如下： 1)将传过来的参数中 data 部分的 json 按照参数名 ASCII 码从小到大排序（字典序） ，使用 json 格式拼接成字符串 stringA。 特别注意以下重要规则： 参数名 ASCII 码从小到大排序（字典序）； 如果参数的值为空，也参与签名； 参数名区分大小写。 2)对 stringA 进行 SHA1 运算，再将得到的字符串所有字符转换为小写，得到 sign 值 signValue。 示例： 假设传送的参数如下： userId:cadre01,password:205af3fa28810be321ef49d0993fee24,callback Server: 第一步：对参数按照参数名 ASCII 字
