多应用+插件架构,代码干净,二开方便,首家独创一键云编译技术,文档视频完善,免费商用码云13.8K 广告
> **应用场景**: >车场合作商家将优惠券发放给车主,车主扫描优惠券二维码关联订单后,优惠券的信息同步到车场收费系统。 字段信息: | 名称 | 说明 | 类型|最大长度 | 示例 | 是否必传字段 | | --- | --- | --- | --- | --- | --- | 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"}