> **應用場景**：
> 車場上傳訂單出場記錄至停車云和泊鏈，在停車云后臺可查看訂單出場記錄，在泊鏈平臺可查看訂單的交易記錄。
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 推送進場訂單