> **應用場景**:
>車場合作商家將優惠券發放給車主,車主掃描優惠券二維碼關聯訂單后,優惠券的信息同步到車場收費系統。
字段信息:
| 名稱 | 說明 | 類型|最大長度 | 示例 | 是否必傳字段 |
| --- | --- | --- | --- | --- | --- |
service_name |接口名稱| String|64 |deliver_ticket |是
ticket_id |優惠券編號| String| 15|10022 |是
create_time| 新建時間(unix時間戳格式) |Number|15| 1490879218 |否
limit_day| 失效日期(unix時間戳格式)| Number| 15|1490879218 |是
money| 優惠券金額| String|15 |5 |否(ticket_type為0時必傳)
duration |優惠券時長| Number| 15|5 |否(ticket_type為1時必傳)
car_number |車牌| String| 8|京GH0093| 是
ticket_unit| 時長劵單位:1表示分鐘,2表示小時,3表示天| Number|4| 1| 否(ticket_type為1時必傳)
discount| 折扣券額度|String|64 |7|是
ticket_type |減免類型:0表示減免停車金額,1表示減免停車時長,2 全免劵,3折扣券,4外部優惠券,5指定截止時間的全免券| 4|0 |是, ticket_type 為 4 時,ticket_id 字段攜帶掃描外部券獲取的優惠券信息,本地需確認返回該值
order_id |訂單編號 |String|48| 9880 |是,have_order 為0時,下發order_id 為空字符串
remark |備注| String|32 |兩小時內免3元| 否
shop_name|商戶名稱|String|24|1號商店|是
time_range|如果一張全免券或固定碼發出的優惠券支持多次使用,該字段為這張券可以減免的有效時長。此時有值。其它時候為0(當ticket_type為5時,該字段為時間戳,精確到秒)|int|12|0,單位為小時|是
have_order|云平臺是否有在場訂單|Number|1 |1 表示云平臺有該車牌的在場訂單;0 表示沒有,本地根據該字段進行業務處理;該字段原值返回。have_order值為0時 ,與car_number同時返回,可減免未上傳的訂單,否則記錄用券信息失敗。(have_order值為0時,與intime、order_id、car_number同時返回,可限制用券的張數(與有在場訂單的用券數一致))|是
|park_id |車場編號| String|24 |test001| 是
fix_code_name|固定碼名稱| String|24 |測試1固定碼| 否,使用固定碼時下發
starttime|券可用開始時間|String|15|00:00|否,使用固定碼時下發
endtime| 券可用結束時間|String|15|23:59|否,使用固定碼時下發
startdate| 券可用開始日期(unix時間戳格式)|Number|15|23:59|否,使用固定碼時下發
enddate| 券可用結束日期(unix時間戳格式)|Number|15|23:59|否,使用固定碼時下發
active_start_time| 券生效開始時間|String|15|00:00|否,使用固定碼時下發,由本地收費系統判斷
active_end_time| 券生效結束時間|String|15|23:59|否,使用固定碼時下發,由本地收費系統判斷
buy_money|車主買券支付金額(元)|String|15|1 |否,使用固定碼且設置車主支付的優惠券下發時必傳
pay_limit| 支付公司限制 |Number|15|0,不限制;1,農行APP |否,使用固定碼時下發(使用該功能時車場需開通農行支付通道,計費系統對此類優惠券做相應的減免)
shop_id|商戶編號|Number|24|234|是
> 示例:
> {"ticket_type":2,"create_time":1575687031,"limit_day":1575687331,"fix_code_name":"測試1固定碼","service_name":"deliver_ticket","have_order":1,"park_id":"12345","discount":"","endtime":"23:59","remark":"","starttime":"00:00","ticket_id":"26105715","shop_name":"不回收折扣券","startdate":1575686996,"active_end_time":"23:59","duration":0,"enddate":1575773396,"money":"","time_range":0,"car_number":"京123124","active_start_time":"00:00","order_id":"A1_2C1575686500","shop_id":234}
* * * * *
**返回:調用UploadUtil.uploadData(String jsonData)返回上傳結果,方法返回描述如下**
| 名稱 | 說明 | 類型|最大長度 | 示例 | 是否必傳字段 |
| --- | --- | --- | --- | --- | --- |
service_name |接口名稱 |String|64| deliver_ticket| 是
data_target| 傳輸位置|String|8| cloud|是
ticket_id| 優惠券編號| String|15| 10022| 是
order_id |訂單編號| String |48|9880 |否,have_order=1時必傳; have_order=0時,與intime、car_number同時返回,可限制用券的張數(與有在場訂單的用券數一致)| |
state| 狀態| Number|2| 0失敗1成功 |是
errmsg |方法返回描述| String|48| State=0時不能為空 |否(有值時必傳)
time_range|如果一張全免券支持多次使用,該字段為這張全免券可以減免的有效時長。此時有值。其它時候為0|int|12|0|是
ticket_type |減免類型:0表示減免停車金額,1表示減免停車時長,2 全免劵,3折扣券,4外部優惠券(為4時必傳)| Number| 4|0 |否
have_order|云平臺是否有在場訂單|number|1 | 1 表示云平臺有該車牌的在場訂單;0 表示沒有|否,下發的have_order 值為0時,與car_number同時返回,可減免未上傳的訂單
car_number |車牌| String| 8|京GH0093| 否,下發的have_order 值為0時,與have_order 同時返回,可減免未上傳的訂單
intime |進場時間unix時間戳格式| Number|15 |1490875218| 否, 下發的have_order值為0時,與order_id、car_number同時返回,可限制用券的張數(與有在場訂單的用券數一致)|
*****
### **http方式返回字段信息**
| 名稱 | 說明 | 類型|最大長度 | 示例 | 是否必傳字段 |
| --- | --- | --- | --- | --- | --- |
service_name| 服務 |String|64 |deliver_ticket| 是
token| 令牌| String|64 |b1ce1026cb794d8ca515159b4b5cecea |是
sign| 數據簽名| String|64 |50BE7B01F8531AE4346B1170BE8E90DA |是
data| 數據,下列字段組成的json對象| Json| 48|{} |是
**data_target**| **傳輸位置**|String|8| **cloud**|**是**
ticket_id| 優惠券編號| String|15| 10022| 是
order_id |訂單編號| String |48|9880 |是,**訂單號為空時無法限制疊加張數**
state| 狀態| Number|2| 0失敗1成功 |是
errmsg |方法返回描述| String|48| State=0時不能為空 |否(有值時必傳)
time_range|如果一張全免券支持多次使用,該字段為這張全免券可以減免的有效時長。此時有值。其它時候為0|int|12|0|是
have_order|云平臺是否有在場訂單|number|1 | 1 表示云平臺有該車牌的在場訂單;0 表示沒有|否,下發的have_order 值為0時,與car_number同時返回,可減免未上傳的訂單
car_number |車牌| String| 8|京GH0000| 否,下發的have_order 值為0時,與have_order 同時返回,可減免未上傳的訂單
> 示例:
>{"service_name":"deliver_ticket","have_order":0,"car_number":"京GH0000","errmsg":"已減免!!","data_target":"cloud","state":1,"ticket_id":"17561669","order_id":"a_12345670981"}
- 停車收費系統對接協議(車場管理+支付)
- 修訂記錄
- 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 推送進場訂單