> **应用场景**:
1、正常订单调用2.1接口入场,调用2.2接口支付离场,如果遇到异常订单没有入场记录,而且需要停车云平台展示完整收入记录的需要调用2.3接口传完整订单信息到云平台。例如:出场车牌京888888出场时无入场记录,临时收费5元,出场收费系统收费后,调用sdk接口的uploadData(String jsonData)方法,把下列字段组成json数据格式上传,在云平台就会有完整记录,以便于停车云的统计分析功能完整统计。
2、使用扫码枪支付出场的订单,收到支付结果后,调用该接口上传完整订单信息到云平台。
3、使用ETC扣费车场,调用2.37接口进行扣费,扣费成功后,调用该接口上传完整订单信息到云平台。
**注:单个SDK上传订单频率必须限制低于每秒10条!**
字段信息:
| 名称 | 说明 | 类型|最大长度 | 示例 | 是否必传字段 |
| --- | --- | --- | --- | --- | --- |
|service_name| 接口名称| String| 64|固定为upload_order| 是|
|data_target| 数据上传位置| String| 10 | 固定为 cloud |是|
|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| 支付类型,枚举值具体参考5.1.3的定义| String|12 |cash |是|
|auth_code |授权码,支付类型是sweepcode时必传| String| 64|微信或支付宝支付码| 否|
|empty_plot| 空闲车位数 |Number| 15|20| 是|
|total| 实时订单金额(不包含已预付、已减免的部分)| String|15 |6.5| 是|
|order_id |订单记录号(车辆在停车场停车唯一订单编号,对应入场订单编号) |String|48 |9009 |是|
|freereasons |免费原因| String| 2 |1 |否|
|out_channel_id |出场通道 |String| 16 |A1 |否|
|in_channel_id| 进场通道| String| 16 |B1 |否|
|work_station_uuid |岗亭/工作站唯一标识| String|16 |qwrrw23534 |否|
|ticket_id| 减免券ID |String | 64 |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| 15 |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|否|
> 示例:
> {"electronic_prepay":"0.01","empty_plot":30,"car_type":"小型车","duration":0,"uid":"880099","total":"8.77","out_uid":"880099","pay_type":"cash","out_time":1491875218,"service_name":"upload_order","data_target":"cloud","cash_pay":"8.77","in_channel_id":"A11","in_time":1490875218,"c_type":"普通入场","car_number":"苏DTTTTT3","amount_receivable":"8.78","out_channel_id":"A11","order_id":"A1_2C1491875218","derate_duration":30}
方法调用异步返回:
| 名称 | 说明 | 类型 |最大长度 | 示例 | 是否必传字段 |
| --- | --- | --- | --- | --- | --- |
|state |状态 | Number|- |0失败1成功 |是|
|errmsg |方法返回描述| String|-| upload data success!| 是|
|service_name |接口名称| String|-| upload_order| 是|
|order_id| 订单记录号(车辆在停车场停车唯一订单编号,对应入场订单编号)| String|- |9009| 是|
|park_id |车场编号| String|24 |test001| 否
> 示例
> {"state":1,"service_name":"upload_order","park_id":"test001","order_id":"9009","errmsg":""}
- 停车收费系统对接协议(车场管理+支付)
- 修订记录
- 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 推送进场订单