SDK停车收费系统对接协议(车场管理+支付)
停车收费系统对接协议(车场管理+支付)
更新记录
SDK开发包下载
一、系统集成
1.1
1.2车场初始化
1.2.1加密说明
1.2反初始化
1.3http退出登录接口
二、上行接口(收费系统调用SDK)
2.1车辆入场(停车云,泊链)
2.2车辆出场(泊链,停车云)
2.3完整订单记录上传(停车云,订单上传补充接口)
2.4车场收费员信息上传(停车云)
2.5员工上下班记录上传(停车云)
2.6日志上传(停车云)
2.8月卡套餐上传(停车云)
2.9价格上传(停车云)
2.10月卡会员上传(停车云)
2.11异常抬杆上传(停车云)
2.12车辆图片上传(停车云)
2.13月卡续费记录上传(停车云)
2.14通道数据上传停车云
2.15黑名单上传停车云
2.16车型数据上传停车云
2.17手动匹配订单上传停车云
2.18获取二维码地址泊链
2.19车场订单电子支付状态查询接口
2.20查询在场订单
2.21车场交易订单查询(返回h5url)
2.22岗亭交接班记录(泊链)
2.23云平台对账接口
2.24月卡信息查询
2.25储值卡上传(停车云)
2.26储值卡充值记录上传(停车云)
2.27储值卡扣除余额上传(停车云)
2.28储值卡余额查询(停车云)
2.29上传优惠券减免接口
2.30泊链电子支付对账接口
2.31电子发票上传接口
2.32上传收费系统日志
2.33分页查询月卡信息(停车云)
2.34充电减免信息上传(停车云)
2.35内部车上传
2.36平台转发接口
2.37ETC扣款
2.38逃单查询
2.39停车场停车业务纠正
2.40在停业务总数查询
2.41在停业务详情查询
2.42市级车入场判定
2.43获取车道屏幕二维码
离线订单(先走后付)
三、下行接口(SDK回调收费系统)
3.1查询订单价格(泊链)
3.2预付订单通知(泊链)
3.3无牌车入场请求(泊链)
3.4电子收费异步返回结果
3.5价格同步(停车云)
3.6月卡套餐同步(停车云)
3.7月卡会员同步(停车云)
3.8车场收费员信息同步(停车云)
3.9接收消息实现锁车-解锁
3.10月卡续费(泊链)
3.11查询月卡价格(停车云)
3.12优惠券信息同步(停车云)
3.13通道数据下发停车云
3.14黑名单下发停车云
3.15车型数据下发停车云
3.16月卡续费记录下发停车云
3.17手动匹配订单通知(停车云)
3.18抬杆-落杆通知(停车云)
3.19访客管理下发停车云
3.20储值卡同步(停车云)
3.21储值卡余额变更记录下发(停车云)
3.22云平台透传接口
3.23退款下发通知(泊链)
3.24找零支出下发通知(泊链)
3.25平台缴费通知(停车云)
3.27内部车同步(停车云)
3.28手动结算(停车云)
3.29积分电子券信息同步(泊链)
3.31车道监控抓拍下发(停车云)
3.32通知上传收费系统日志(泊链)
3.26查询车场停车位(停车云)
3.33收费系统升级(泊链)
3.34公众号购买月卡查询价格(停车云)
3.35车场有效期下发(停车云)
3.36充电桩充电通知(泊链)
3.37逃单补缴异步返回结果
3.39车辆包月账单信息查询
3.39修改道闸余位
3.40查询月卡车、特殊车
3.41通道识别健康码状态下发
3.42手动入场
3.43车牌校正
3.43固定收费
4.1获取当前车牌余额及是否支持电子支付
4.2获取当前车牌余额及是否支持无感支付(http)
5.1数据定义
5.1.1车型:car_type
5.1.2
5.1.3订单支付类型:pay_type
5.1.4锁车标记:islocked
5.1.5性别:sex
5.1.6操作类型:operate_type
5.1.7员工上下班类型:state
5.1.8数据上传位置:data_target
5.1.9异常抬杆原因:reason
5.1.10是否是泊涟会员:is_exist
5.1.11网络状态:net_status
5.1.12订单支付通道:pay_channel
5.2泊链常见问题答疑
六、专题文档
七、智慧屏应用
7.1获取智慧屏ip
7.2初始化连接智慧屏
7.3推送出场订单
7.4接收被扫数据(SDK回调收费系统)
7.5车场生成出口支付码
7.6推送语音播报
7.7推送进场订单
SUMMARY
文档云
-
+
首页
2.1车辆入场(停车云,泊链)
> **应用场景**: > 车场上传进场订单至停车云和泊链,在停车云后台可查看进场记录 Java 调用接口: UploadUtil.uploadInParkOrder(String jsonData),调用时,把所有参数按 json对象格式组成字符串,作为参数给 java 方法。 **注:单个SDK 上传订单频率必须限制低于每秒10条!** 部分数字型字段说明: **worksite_id** : 工作站在 parkingOS 系统中工作站管理有设置, 设置后才可以设置下面的通道 **in_channel_id**:通道 设置好工作站后,在 parkingOS 系统中通道管理有设置通道信息 **上述的字段只能传入已定义好的数字类型值,其它数据无效,收费系统自定义的枚举值,需要在停车云后台增加相应修改,否则数据不能展示。** 字段信息: | 名称 | 说明 | 类型 | 最大长度 | 示例 | 是否必传字段 | | --- | --- | --- | --- | --- | --- | | car_number | 车牌 | String| 8 | 京GH0093 | 是 | | in_time | 进场时间,unix时间戳格式,精确到秒 |Number| 16 | 1490875218 | 是 | | car_type | 车型 | String | 8 |大车 | 是 | | c_type | 进场类型 | String| 8 |通道扫牌 | 是 | | uid | 入场收费员id | String| 24 | 880099 | 是 | | order_id | 订单记录号(车辆在停车场停车唯一订单编号,支持数字 字母 _ ) |String| 48 | 325101 |是 | |empty_plot | 空闲车位数 | Number | 12 |20 |是 | | in_channel_id | 进场通道 | String| 24 | A1 | 是 | | work_station_uuid | 岗亭/工作站唯一标识,支持数字 字母 _ | String| 24 | qwrrw23534 | 否 | | remark | 备注 | String|24 |入场信息备注 | 否 | |force_update|是否强力删除云平台重复订单号的订单,1 强删,0 不强删|Number |1|0|否,默认0| |car_cost_type|车辆种类(在云的订单记录中显示)1临停车 2月卡车 3白名单车 4无牌车 5贵宾车 6VIP 7内部车 8、月卡多位多车 9、储值车|Number|1|1|否,不传则不显示 license\_color| 车牌颜色,0蓝色;1黄色;2白色;3黑色;4、新能源;5、黄绿色;6、蓝白渐变色;7、其他(SDK必须升级4.0.0.0版本,微信4.0无感不传则默认蓝色)| Number| 1| 0| 否| |is\_report|数据是否上传到平台,0 不上报,1 上报| Number|2|1|否 > #### (**SDK2.2.2.0及以上版本**安装包支持新增字段force_update) > 数据示例: > {"car_type":"大车","uid":"325101","car_number":"京GH0093", > "in_time": 1490875218,"order_id":"325101","in_channel_id":"A1","worksite_id":23, > "c_type": "通道扫牌","empty_plot": 20,"remark":"入场信息备注","force_update":1} * * * * * 车辆入场方法同步返回: | 名称 | 说明 | 类型 | 最大长度 |示例 | 是否必传字段 | | --- | --- | --- | --- | --- | --- | | state | 状态 | Number| 2 | 0失败1成功 | 是 | | order_id | 订单记录号(车辆在停车场停车唯一订单编号,对应入场订单编号) | String | 48|325101 | 是 | | service_name | 接口名称 | String | 64| in_park | 是 | | errmsg | 方法返回描述 | String | 64 |Init bolink and cloud success! | 是 | |park_id |车场编号| String|24 |test001| 否 |escapeOrder|逃单列表,包含下边字段的json字符串|json对象||{“park_id”:”21787”,”parkName”:”0.01”…}|否 |parkName|停车场名称|String|64|测试车场|是 |unionId|厂商编号|Number|24|200145|是 |orderId|逃单订单编号|String|48|244564527|是 |inParkPic| 进场图片| String |256| https://s.bolink.club/unionapi/getcarinparkimgunionid=123&parkid=123&orderid=123&type=0| 否 |outParkPic|出场图片| String |256|https://s.bolink.club/unionapi/getcarinparkimgunionid=123&parkid=123&orderid=123&type=0|否 |parkId |车场编号| String |24| 123| 是 |carNumber |车牌号 |String |8 |贵A88888 |是 |inTime |入场时间,unix时间戳格式,精确到秒| Number |15 |1490875218| 是 |outTime |逃单时间,unix时间戳格式,精确到秒| Number |15| 1490875218| 是 |money |逃单金额(元) |String| 15 |0.01| 是 |duration |停车时长|String |24| 0天0小时2分钟 |是 > 示例{"state":1,"order_id":" 325101","park_id":"test001","service_name":"in_park","errmsg":" send success!","escapeOrder":"[{"carNumber":"贵A88888","duration":"0天0小时4分钟钟","inParkPic":"","inTime":1624874174,"money":12.0,"orderId":"1624874174971","outParkPic":"","outTime":1624874381,"parkId":"1123","parkN ame":"123","unionId":200572}]"} ### **http入场字段信息:** | 名称 | 说明 | 类型 | 最大长度 |示例 | 是否必传字段 | | --- | --- | --- | --- | --- | --- | service_name| 服务| String| 64 |固定inpark |是 token| 令牌 |String | 64|def684dd3b1f4e37bd7b14a378847b0a |是 sign| 数据签名| String| 64 |EFB19B2ED7F78541F3AAF00432F696A5 |是 data |数据,下列字段组成的json对象 |Json|48 |{} |是 car_number |车牌 |String | 8 |苏DTTTT9 |是 in_time |进场时间unix时间戳格式| Number|15 |1490875218| 是 order_id| 订单记录号(车辆在停车场停车唯一订单编号) |String| 48|325101| 是 empty_plot| 空闲车位数| Number|10 |21| 是 示例 {"service_name":"inpark","token":"def684dd3b1f4e37bd7b14a378847b0a","sign":"CB649425CB5548A375099103AB04CC1E",data:{"car_number":"苏BBBEE1","in_time":1510821178,"order_id":"A1_2C1510821178","empty_plot":20}} ### **http车辆入场方法返回:** | 名称 | 说明 | 类型 | 最大长度 | 示例 | 是否必传字段 | | --- | --- | --- | --- | --- | --- | state |状态 | Number| 2 |0失败1成功 |是 order_id |订单记录号(车辆在停车场停车唯一订单编号,对应入场订单编号) |String| 48|325101 |是 service_name |接口名称 |String|64 |inpark |是 errmsg |方法返回描述| String|64 |订单上传成功 |否(有值时必填) > 示例: > {"state":1,"order_id":"A1_2C1510821178","errmsg":"订单上传成功","service_name":"inpark"}
admin
2023年12月8日 17:10
转发文档
收藏文档
上一篇
下一篇
手机扫码
复制链接
手机扫一扫转发分享
复制链接
Markdown文件
PDF文档
PDF文档(打印)
分享
链接
类型
密码
更新密码