> 车场SDK与停车收费系统集成时，收费系统调用SDK提供的初始化方法，初始化一些身份信息。
> Java版本的调用方法名为UploadUtil.init(String jsonData)，调用时，把所有参数按json对象格式组成字符串，作为参数给java方法。
字段信息：
| 名称 | 说明 | 类型 |最大长度 | 示例 | 是否必传字段 |
| --- | --- | --- | --- | --- | --- |
| union_id | 厂商平台账号 | String|15 | 200002 | 是 |
| ukey | 厂商平台密钥，泊链接口签名用 | String|24 | EA2D90FEEF1E9F8E | 是 |
| park_id | 车场编号 | String|24 | 3251 | 是 |
| ckey | 互联车场密钥，停车云接口签名用，每个车场**ckey唯一** | String|24 | WERRTTTTYY | 是 |
| cloud_addr | 停车云域名 | String|18 | 测试环境：ts.bolink.club；正式环境：1029.parkingos.club | 是 |
|cport | 停车云端口 | Number |10 | 测试环境：6791 ； 正式环境6789 | 是 |
| bolink_addr | 泊链服务器域名 | String|18 | 测试环境：beta.bolink.club；正式环境：s.bolink.club | 是 |
| bport |泊链端口 | Number | 10|6789 |是 |
| local_id | 收费系统编号，同一车场的收费系统编号不可重复，车场存在多个收费系统集成sdk时，必传,车场sdk初始化参数中的local_id，可以按规则包含通道信息，用关键字channels后加下划线加通道号（通道号可由数字、字母、中文组成），多个时用下划线分隔，结尾不要加下划线，如local_id=mac001，需要绑定A1、A2、A3三个通道，那就写为local_id=aaa001_channels_A1_A2_A3，那么这个sdk就管理了三个通道：A1,A2,A3。在泊链后台生成入场或出场二维码，输入的通道号在这个sdk管理中，车主扫带该通道号二维码时，泊链会把入场或出场消息发给这个sdk(在线),如果sdk不在线，则不发送。 | String|196 | 22AA | 否 |
log_show| sdk是否打印日志| number| 2|0不打印日志，1打印，默认0| 否
set_params| 设置参数，扩展参数，见下表说明| json|48 |{"prepay_send":"1"} |否
扩展参数
| 名称 | 说明 | 类型|最大长度| 示例 | 是否必传 |
| --- | --- | --- | --- | --- | --- |
| prepay_send |接收预付消息，0不收，1接收 | String |2 | 1 | 否 |
| month_send |接收公众号月卡续费消息，0不收，1接收 | String|2 | 1 | 否 |
|receive_cloud|接收云平台下行消息，0不收，默认1接收|string|2|1|否
| prepay_query | 是否接收预付查询，0不接收预付查询 ，其他设置不生效 | number | 2 | 0 | 否
| fast | 是否同步返回，设置true后上行接口除了2.1和2.2之外都是同步返回，不再异步，默认是false | bool | | true | 否
> jsonData数据示例
> {"union_id":"200002","ukey":"EA2D90FEEF1E9F8E","park_id":"3251","ckey": "9H3YD5U5T73GITSP","cloud_addr":"ts.bolink.club","cport":6791,"bolink_addr": "beta.bolink.club","bport":6789,”local_id”:"aaa001_channels_A1_A2_A3","set_params":{"prepay_send":"1","month_send":"1","receive_cloud":"1"}}
* * * * *
车场初始化同步返回：
| 名称 | 说明 | 类型| 最大长度|示例 | 是否必传 |
| --- | --- | --- | --- | --- | --- |
| state | 状态 | Number | 2|0失败1成功 | 是 |
| errmsg | 方法返回描述 | String|48 | Init bolink and cloud success! | 是 |
示例{"state":1,"errmsg":"Init bolink and cloud success! "}
### **http对接字段信息：**
| 名称 | 说明 | 类型|最大长度| 示例 | 是否必传 |
| --- | --- | --- | --- | --- |--- |
service_name |接口名称 |String|64 |“login” |是
sign |签名串 |String|64 |63ECB6FF63605A4092ADCA5EF796F580 |是
data |数据，下列字段组成的json对象 |Json|48 |{} |是
union_id |厂商平台账号| String|15 |200208 |是
park_id |车场编号| String| 24|21835| 是
local_id |收费系统编号，同一车场的收费系统编号不可重复，车场存在多个收费系统集成http时，必传,车场http初始化参数中的local_id，可以按规则包含通道信息，用关键字channels后加下划线加通道号，多个时用下划线分隔，结尾不要加下划线，如local_id=mac001，需要绑定A1、A2、A3三个通道，那就写为local_id=aaa001_channels_A1_A2_A3，那么这个http就管理了三个通道：A1,A2,A3。在泊链后台生成入场或出场二维码，输入的通道号在这个http管理中，车主扫带该通道号二维码时，泊链会把入场或出场消息发给这个http(在线),如果http不在线，则不发送。| String|196 |22AA| 否
如需支持公有云平台业务，初始化时需包含以下扩展参数
**扩展参数**
| 名称 | 说明 | 类型|最大长度| 示例 | 是否必传 |
| --- | --- | --- | --- | --- | --- |
| login_cloud|是否支持云平台业务，0不支持，1支持 | String|2 | 1 | 否 |
|receive_cloud|接收云平台下行消息，0不收，默认1接收|string|2|1|否
> 示例
{"service_name":"login","sign":"8C69577DD5567560210FD7D38A1AF160","data":{"union_id":"200000","park_id":"20000","local_id":"gg1_hhhhchannels_D1_D2","set_params":{"receive_cloud":"1","login_cloud":"1"}}}
### **http车场初始化返回：**
| 名称 | 说明 | 类型|最大长度| 示例 | 是否必传 |
| --- | --- | --- | --- | --- | --- |
state| 状态 | Number| 2|0失败1成功 |是
token |令牌 |String|64 |969652cbb1a146c1a3ab26bdda3c3d3d |否（state为1时必传）
service_name |接口名称 |String|64 |“login” |是
channel_id| 通道号 |String|16 |200208_21835_0071cc97102b_1001_qh321_GUYUE车场-atest1 |否
errmsg| 错误信息| String|48 |“登录成功” |否
示例
{"state":1,"token":"98a16a30df1e4ce488e1b1fcd7ac46c3","channel_id":"200000_20000_gg1_hhhhchannels_D1_D2","service_name":"login"}
- 停车收费系统对接协议（车场管理+支付）
- 修订记录
- SDK开发包下载
- 一、系统集成
- 1.1初始化（废弃版本）
- 1.2 车场初始化(SDK 4.2 及后续版本)
- 1.2.1 加密说明
- 1.3反初始化
- 1.4 http退出登录接口
- 二、上行接口（收费系统调用 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岗亭交易订单查询（泊链返回h5 url）
- 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.37 ETC扣费
- 2.38 逃单查询
- 2.39停车场停车业务纠正
- 2.40在停业务总数查询
- 2.41在停业务详情查询
- 2.42市级车入场判定
- 2.43获取车道屏幕文字
- 2.44离线订单（先走后付）
- 三、下行接口（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.26 查询车场停车位通知（停车云）
- 3.27 内部车同步（停车云）
- 3.28 手动结算（停车云）
- 3.29 追缴订单异步返回结果（泊链）
- 3.30 积分电子券信息同步（泊链）
- 3.31 车道监控抓拍下发（停车云）
- 3.32 通知上传收费系统日志（泊链）
- 3.33 下发收费系统升级通知（泊链）
- 3.34 公众号新建月卡查询价格（停车云）
- 3.35 车场有效期下发（停车云）
- 3.36 充电桩充电通知（泊链）
- 3.37 逃单补缴异步返回结果（泊链）
- 3.38 车辆包月账单信息查询
- 3.39 修改道闸余位
- 3.40 查询月卡车、特殊车
- 3.41 门禁读取的健康码状态下发(停车云)
- 3.42 补录订单手动入场
- 3.43 在场订单车牌校正
- 3.44 无在场订单固定收费
- 四、查询免密及电子支付（SDK提供）
- 4.1获取车牌是否支持免密和SDK心跳
- 4.2推送当前车牌余额及是否支持无感支付（http）
- 五、常见问题与数据定义
- 5.1 数据定义
- 5.1.1车型：car_type
- 5.1.2 入场/出场车型：c_type/out_type
- 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（收费系统调用SDK）
- 7.2 初始化连接智慧屏（收费系统调用SDK）
- 7.3 推送出场订单（收费系统调用SDK）
- 7.4 接收被扫数据（SDK回调收费系统）
- 7.5 车场生成出口支付码
- 7.6 推送语音播报
- 7.7 推送进场订单