> **应用场景**：
> 车场上传订单出场记录至停车云和泊链，在停车云后台可查看订单出场记录，在泊链平台可查看订单的交易记录。
Java调用接口：UploadUtil.uploadOutParkOrder(String jsonData)，调用时，把所有参数按json对象格式组成字符串，作为参数给java方法。
**注：单个SDK 上传订单频率必须限制低于每秒10条！**
注：车辆出场前，收费系统有电子支付业务需求时，需要先调用sdk提供的查询接口（4.1接口），来查询车主余额和泊链网络状态，收费系统需要根据返回数据来处理下一步的支付方式，接口说明见接口4.1，接口返回中net_status描述了SDK与泊链的网络状态（0不通，1通畅），balance是车主的余额，收费系统根据返回数据来判断车主余额是否充足以及目前到泊链的网络状态是否畅通，建议当网络状态通畅时，才需要调用此接口，余额充足时，pay_type=wallet，当余额不足或没有余额时，可以发起扫码枪支付，这时pay_type=sweepcode,同时auth_code为必传。出场结算业务可能会重复调用车辆出场接口，直到结算完成。
pay_type=sweepcode、wallet、cash、monthuser 、free 时需要调用此接口
### **pay_type=scancode**时如果只使用泊链支付功能无需调用2.2，如果同时需要云平台功能则调用2.3接口。
> pay_type 为 etc_pay (ETC 支付)时需调用2.37接口进行扣费
**部分数字型字段说明：**
in_channel_id，out_channel_id 与车场入场中的in_channel_id定义一致，worksite_id与车场入场中的worksite_id定义一致
freereasons：免费原因 可以在parkingOS系统中免费原因中设设置
ticket_id:减免券ID 可以在parkingOS系统中停车券管理中设置
**上述的字段只能传入已定义好的数字类型值，其它数据无效，收费系统自定义的枚举值，需要在停车云后台增加相应修改，否则数据不能展示。**
字段信息：
| 名称 | 说明 | 类型 |最大长度 | 示例 | 是否必传字段 |
| --- | --- | --- | --- | --- | --- |
| car_number | 车牌 | String| 8 | 京GH0093 | 是 |
| in_time | 进场时间（unix时间戳格式，精确到秒） | Number| 15 | 1490875218 | 是 |
| out_time | 出场时间（unix时间戳格式，精确到秒） | Number| 15 | 1490879218 | 是 |
| uid | 入场收费员编号(支持数字 字母 _ ) | String| 24 | 880099 | 是 |
| duration | 停车时长(分钟) | Number| 15 | 50 | 否 |
| car_type | 车型 | String| 12 | 小车 | 是 |
| c_type | 进场类型 | String| 12 | 通道扫牌 | 是 |
| out_type | 出场类型 | String| 12 | 通道扫牌 | 否 |
| pay_type|支付类型,cash:现金支付,wallet:余额支付,sweepcode:扫码支付,escape:逃单出场,etc_pay:ETC支付；free 和 无效值为免费放行 | String| 12 | cash,wallet,sweepcode,escape | 是 |
| auth_code | 授权码，支付类型是sweepcode时必传 | String| 48 | 微信或支付宝支付码 | 否 |
| empty_plot | 空闲车位数 | Number| 15 | 20 | 是 |
| total | 实时订单金额（不包含已预付、已减免的部分） | String| 15 | 6.5 | 是 |
| order_id | 订单记录号(车辆在停车场停车唯一订单编号，对应入场订单编号,支持数字 字母 _ ) | String| 48 | 9009 | 是 |
| freereasons | 免费原因 | String| 10 |1 | 否 |
| out_channel_id | 出场通道 | String| 12 | A1 | 否 |
| in_channel_id | 进场通道 | String| 12 |B1 | 否 |
| work_station_uuid | 岗亭/工作站唯一标识| String| 10 | qwrrw23534 | 否 |
| ticket_id |减免券ID | String | 15 | 34556677 | 否 |
| reduce_amount | 减免金额 | String| 15 | 6.0 | 否 |
| amount_receivable | 应收金额 | String| 15 | 10.0 | 是 |
| electronic_prepay | 电子预付 | String| 15| 2.0 | 否 |
| electronic_pay | 电子结算 | String|15 | 1.0 | 否 |
| cash_prepay | 现金预付 | String|15 | 2.0 | 否 |
| cash_pay | 现金结算 | String| 12 | 2.0 | 否 |
|etc_pay|etc结算|String|15|1.0|否
| out_uid |出场收费员编号 | String| 24 | 23456 | 是 |
| islocked | 锁车标记 | Number| 2| 0否1是 | 否 |
| lock_key | 锁车密码 |Number| 8 | 2345 | 否 |
|remark | 备注 | String| 32 | 出场信息备注 | 否 |
| derate_duration |减免时长（分钟）|Number| 15 |30|否
|license\_color| 车牌颜色，0蓝色；1黄色；2白色；3黑色；4、新能源；5、黄绿色；6、蓝白渐变色；7、其他（SDK必须升级4.0.0.0版本，微信4.0无感不传则默认蓝色）| Number| 1| 0| 否|
|is\_report|0是仅支付不上报数据到第三方平台； 1数据上报加支付 ；2仅上报数据到第三方平台，不调支付| Number|2|1|否
**车辆出场接口调用后，分为：方法返回结果（同步）和异步返回结果，pay_type为wallet或sweepcode时需要等待异步返回结果来处理业务（只是先返回state2再返回1异步结果等待时间较长）：**
调用同步返回结果：state是sdk收到数据后返回的状态，pay_type为wallet或sweepcode时的支付状态要从异步返回的state判断（只是先返回state2再返回1异步结果等待时间较长）。
* * * * *
车辆出场调用方法后同步返回结果：
| 名称 | 说明 | 类型|最大长度 | 示例 | 是否必传字段 |
| --- | --- | --- | --- | --- | --- |
|state |状态 | Number|2 |0失败,1成功，2支付中，在is_report为2时，固定返回 1 ，代表提交成功| 是|
|order_id |订单记录号(车辆在停车场停车唯一订单编号，对应入场订单编号)| String|48| 325101 |是|
|service_name| 接口名称| String|64 |out_park| 是|
|net_status| 泊链网络状态| Number|2| 0不通 1通 |是|
|pay_type|支付类型 |String| 12 | cash,wallet,sweepcode,free,monthuser |是|
|errmsg|方法返回描述| String|48 | 当net_status为0时：errmsg:“网络不通，请用现金支付!”;当net_status为1时：1.支付方式为wallet：（1）.余额充足，发送消息给泊链（准备扣费放行）；（2）.余额不足，errmsg:”余额不足，请选其他支付方式”；2.支付方式为sweepcode时发送消息到泊链请求支付停车费（准备支付放行）。使用特定第三方（宜昌智慧停车平台、福州大脑）无感时，返回对应平台业务参数。| 是|
| car_number | 车牌 | String| 8 | 京GH0093 | 否 |
| out_channel_id | 出场通道 | String| 12 | A1 | 否 |
|park_id |车场编号| String|24 |test001| 否
异步返回见3.4接口
### **http出场字段信息：**
| 名称 | 说明 | 类型 |最大长度 | 示例 | 是否必传字段 |
| --- | --- | --- | --- | --- | --- |
service_name |服务 |String|64 |固定outpark| 是
token |令牌 |String|64 |def684dd3b1f4e37bd7b14a378847b0a |是
sign |数据签名 |String| 64|EFB19B2ED7F78541F3AAF00432F696A5 |是
data |数据，下列字段组成的json对象| Json|48 |{} |是
car_number| 车牌 |String| 8|苏DTTTT9 |是
in_time |进场时间（unix时间戳格式，精确到秒） |Number| 15|1490875218 |是
out_time| 出场时间（unix时间戳格式，精确到秒）| Number| 15 |1490879218 |是
total |实时订单金额（不包含已预付、已减免的部分） |String| 15|6.5 |是
order_id| 订单记录号(车辆在停车场停车唯一订单编号，对应入场订单编号)| String|48 |9009 |是
empty_plot| 空闲车位数| Number|15 |20 |是
pay_type|支付类型 |String| 12|cash| 是
auth_code |授权码，支付类型是sweepcode时必传| String|64 |微信或支付宝支付码 |否
> {"service_name":"outpark","token":"def684dd3b1f4e37bd7b14a378847b0a","sign":"CB649425CB5548A375099103AB04CC1E",data:{"car_number":"苏DTTTTT","in_time":1510132659,"out_time":1510135875,"total":"0.54","order_id":"A1_2C1510828170","empty_plot":20,"pay_type":"cash","auth_code":""}}
### **http车辆出场调用方法后返回结果：**
| 名称 | 说明 | 类型 | 最大长度| 示例 | 是否必传字段 |
| --- | --- | --- | --- | --- | --- |
state| 状态 | Number|2 |0失败,1成功| 是
order_id |订单记录号(车辆在停车场停车唯一订单编号，对应入场订单编号) |String |48| 325101 |是
service_name |接口名称 |String |64| outpark| 是
pay_type| 支付类型 |String|12 |cash,wallet,sweepcode,free,monthuser |是
trade_no| 交易流水号(pay_type为wallet、scancode、sweepcode必传) |String|64 |2107110315352000| 否
errmsg |方法返回描述 |String|64| 提示信息| 是
> {"state":1,"trade_no":"","errmsg":"结算成功","order_id":"A1_2C1510828170","pay_type":"cash","service_name":"outpark"}
- 停车收费系统对接协议（车场管理+支付）
- 修订记录
- 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 推送进场订单