# 统一返回格式 | 字段名称 | 类型 | 是否必填 |备注| | --- | --- | --- | --- | | code | int | 是| 返回码：\-1：异常，0：正常| | msg| String| 是| 返回信息| | data| Object| 否| 返回数据| # 1.根据车牌号查询停车费 ## 接口描述 根据账户ID与车牌号查询停车费 ## 接口地址 https://ip//api/park/queryBill ## 请求方式 restful-get ## 请求参数 | 字段名称 | 类型 | 是否必填 | 备注 | | --- | --- | --- | --- | | accountId | String | 是 | 账户ID：长度32位 | | vplNumber | String | 是 | 车牌号 | ## 响应参数 | 字段名称 | 类型 | 描述 | 备注 | | --- | --- | --- | --- | bill_id | integer| 支付订单号| 查询一次生成一次 id |integer| 停车订单| 每次查询一致 number| Stirng| 车牌号 | state |integer |订单状态 |0：正常；1：未查到订单或抵扣异常 park |ParkEntry| 停车场信息| in |ParkInOut| 入场信息 | out |ParkInOut| 出场信息 | charge |ParkingCharge| 费用| ### ParkEntry | 字段名称 | 类型 | 描述 | 备注 | | --- | --- | --- | --- | name |String |停车场名称| code |String |停车场编号| address |String |停车场地址| Discount_info |String |本次支付停车场的优惠券信息 ### ParkInOut | 字段名称 | 类型 | 描述 | 备注 | | --- | --- | --- | --- | time| String| 时间| channel| String| 出入口名称| picture| String| 照片 | ### ParkingCharge | 字段名称 | 类型 | 描述 | 备注 | | --- | --- | --- | --- | due |int |应付 |单位：分 unpaid |int |未付 |单位：分 paid |int |已付 |单位：分 duration |int |停车时长 |单位：秒 prepaid |int |预付 |单位：分 # 2.查找车辆 ## 接口描述 根据账户ID查找该账户绑定车辆 ## 接口地址 https://ip//api/park/findByAccountId ## 请求方式 restful-get ## 请求参数 | 字段名称 | 类型 | 是否必填 | 备注 | | --- | --- | --- | --- | | accountId | String | 是 | 账户ID：长度32位 | ## 响应参数 | 字段名称 | 类型 | 描述 | 备注 | | --- | --- | --- | --- | id |String |车辆ID | accountId |String |账户ID | licensePlateNumber |String |车牌号 | ownerName |String |车主姓名 | colour |int |车辆颜色 | | type | String | 车辆类型 | | | reserve1 | String | 备用1|长度最大为200 | | reserve2 | String | 备用2|长度最大为200 | | reserve3 | String | 备用3|长度最大为200 | | remark | String | 备注|长度最大500 | | createTime | Date | 创建时间 | | updateTime | Date | 修改时间 | | maintainer | String | 维护人 | # 3.删除车辆 ## 接口描述 根据车辆ID删除绑定车辆 ## 接口地址 https://ip//api/park/deleteCar ## 请求方式 restful-get ## 请求参数 | 字段名称 | 类型 | 是否必填 | 备注 | | --- | --- | --- | --- | | carId | String | 是 | 车辆ID：长度32位 | ## 响应参数 统一返回参数 # 4.查询停车场信息 ## 接口描述 根据租户ID查询所有停车场信息（包含车位信息） ## 接口地址 https://ip//api/park/getParks ## 请求方式 restful-get ## 请求参数 | 字段名称 | 类型 | 是否必填 | 备注 | | --- | --- | --- | --- | | tenantId | String | 是 | 租户ID：长度32位 | ## 响应参数 | 字段名称 | 类型 | 描述 | 备注 | | --- | --- | --- | --- | id |String |停车场ID | tenantId |String | 租户Id | tenantName |String |租户名称 | encryptCode |String | 停车场加密编码 | code |String |停车场Id |与艾润一致 | name | String | 停车场名称 | | | address | String | 地址 | | | gps | String | GPS | | parkingType | int | 停车场类型 |0 经营性 1非经营性 2道边车场 | | openTime | int | 停车场开放时间 | | | chargeCriterion | String | 停车场收费标准网页URL地址 | | spaceTotal | int | 车位总数 | | spaceEmpty | int | 车位空位数 | | supportPament | int | 支持支付类型 | | updateTime | Date | 修改时间 | # 5.创建停车订单 ## 接口描述 创建停车订单并支付 ## 接口地址 https://ip//api/park/addOrderAndPay ## 请求方式 restful-post ## 请求参数 | 字段名称 | 类型 | 是否必填| 备注 | | --- | --- | --- | --- | | token | String | 是 | 登录令牌 | | accountId | String | 是 | 账户ID：长度32位 | | airunId | integer | 是 | 艾润停车记录Id | | airunBillId | integer | 是 | 艾润账单Id | | vplNumber | String | 是 | 车牌号 | | parkCode | String | 是 | 停车场code | | parkName | String | 是 | 停车场名称 | | armCode | int | 是 | 出口编号 | | duration | integer | 是 | 停车时长，单位：秒 | | vendorId | String | 是 | 商户ID ：长度32位 | | vendorName | String | 是 | 商户名称 | | appCode | String | 是 | 应用code | | tenantId | String | 是 | 租户ID：长度32位 | | goodsId | String | 是 | 商品ID：长度32位 | | amount | BigDecimal | 是 | 订单实际付款价格 单位：元 | | reserve1 | String | 否 | 备用1：长度最大为200 | | reserve2 | String | 否 | 备用2：长度最大为200 | | reserve3 | String | 否 | 备用3：长度最大为200 | | remark | String | 否 | 备注：长度最大500 | | appid | String | 是 | appid | | openid | String | 是 | 微信openid | | signType | String | 是 | 签名方式：默认MD5 | | merReserved1 | String | 是 | 建行备注 | ## 响应参数 | 字段名称 | 类型 | 描述 | 备注 | | --- | --- | --- | --- | | SUCCESS | String | 返回状态码 | | ERRCODE | String | 错误码 | | ERRMSG | String | 错误信息 | | TXCODE | String | 交易码 | | nonceStr | String | 随机字符串 | | packageStr | String | 支付参数 | | paySign | String | 密文 | | signType | String | 加密方式 | | timeStamp | String | 时间戳 | | orderNumber | String | 原订单号 | | payType | String | 支付类型 | | partnerid | String | 子商户的商户号 | | mweb_url | String | 微信H5支付中间页面URL | | prepayid | String | 预支付交易会话ID | # 6.查询待开票的停车订单 ## 接口描述 查询待开票的停车订单 ## 接口地址 https://ip//api/park/findNotInvoiceParkOrders ## 请求方式 restful-post ## 请求参数 | 字段名称 | 类型 | 是否必填 | 备注 | | --- | --- | --- | --- | | accountId | String | 是 | 账户ID：长度32位 | | pageNum | int | 是 | 每页条数，范围1-200 | | pageSize | int | 是 | 页码 | ## 响应参数 | 字段名称 | 类型 | 描述 | 备注 | | --- | --- | --- | --- | id |String | 订单ID | vplNumber |String | 车牌号 | parkName |String |停车场名称 | parkCode |String | 停车场编号 | actualPrice |BigDecimal | 价钱 | invoiceState |Integer |发票状态 |0-开票成功，1-开票中，2未开票 3 开票失败 | duration | Integer | 停车时长 | | | paidTime | Date | 支付时间 | | | invoiceRecordId | String | 发票记录ID | # 7.查询已完成开票的停车订单 ## 接口描述 查询已完成开票的停车订单 ## 接口地址 https://ip//api/park/findInvoiceParkOrders ## 请求方式 restful-post ## 请求参数 | 字段名称 | 类型 | 是否必填 | 备注 | | --- | --- | --- | --- | | accountId | String | 是 | 账户ID：长度32位 | | pageNum | int | 是 | 每页条数，范围1-200 | | pageSize | int | 是 | 页码 | ## 响应参数 | 字段名称 | 类型 | 描述 | 备注 | | --- | --- | --- | --- | id |String | 订单ID | vplNumber |String | 车牌号 | parkName |String |停车场名称 | parkCode |String | 停车场编号 | actualPrice |BigDecimal | 价钱 | invoiceState |Integer |发票状态 |0-开票成功，1-开票中，2未开票 3 开票失败 | duration | Integer | 停车时长 | | | paidTime | Date | 支付时间 | | | invoiceRecordId | String | 发票记录ID | # 8.支付通知接口 ## 接口描述 支付通知接口（支付成功后调用） ## 接口地址 https://ip//api/park/finishMiniProgramPay ## 请求方式 restful-get ## 请求参数 | 字段名称 | 类型 | 是否必填 | 备注 | | --- | --- | --- | --- | | orderNumber | String | 是 | 订单ID：长度32位 | | payType | String | 是 | 支付类型，固定值‘PARK’ | ## 响应参数 统一返回参数 # 9.开票 ## 接口描述 已完成支付订单开发票 ## 接口地址 https://ip//api/park/createInvoice ## 请求方式 restful-post ## 请求参数 | 字段名称 | 类型 | 是否必填 | 备注 | | --- | --- | --- | --- | | parkCode | String | 是 | 停车场编码 | | buyerName | String | 是 | 购买方名称 发票抬头 | | buyerTaxpayerNum | String | 是 | 纳税人识别号 | | buyerAddress | String | 否 | 购货方地址 | | buyerTel | String | 否 | 购货方电话 | | buyerBankName | String | 否 | 购买方开户行 | | buyerBankAccount | String | 否 | 购买方银行账号 | | takerEmail | String | 否 | 收票人邮箱 | | remark | String | 否 | 发票备注 | | orderIds | String | 是 | 停车订单Id,多条订单使用“,”分割 | ## 响应参数 # 10.查询发票 ## 接口描述 根据发票记录ID查询发票详情 ## 接口地址 https://ip//api/park/findInvoiceRecord ## 请求方式 restful-get ## 请求参数 | 字段名称 | 类型 | 是否必填 | 备注 | | --- | --- | --- | --- | | id| String | 是 | 发票记录ID | ## 响应参数 | 字段名称 | 类型 | 描述 | 备注 | | --- | --- | --- | --- | id |String | 发票ID | accountId |String | 账户ID | serialNo |String |发票流水号 | buyerName |String | 发票抬头 | buyerTaxpayerNum |String | 纳税人识别号 | buyerAddress |String |购货方地址 | | buyerTel | String | 购货方电话 | | | buyerBankName | String | 购买方开户行 | | | buyerBankAccount | String | 购买方银行帐号 | | takerEmail | String | 收票人邮箱 | | state | String | 开发票状态 | | | itemslist | String | 发票项 | | downloadUrl | String | 停车场收费标准网页URL地址 | | dzfUrl | String | 大帐房（票通）的特有连接 | | remark | String | 发票备注 | | amount | integer | 金额 | 单位：分 | orders | String | 订单列表 | 多条订单ID通过,分隔 | type | String | 类型 | | createTime | Date | 创建时间 |