# 统一返回格式 | 字段名称 | 类型 | 是否必填 |备注| | --- | --- | --- | --- | | code | int | 是| 返回码：\-1：异常，0：正常| | msg| String| 是| 返回信息| | data| Object| 否| 返回数据| # 1.创建发票 ## 接口描述 已支付订单申请发票 ## 接口地址 https://ip//api/bus/CreateInvoice ## 请求方式 restful-post ## 请求参数 | 字段名称 | 类型 | 是否必填 | 备注 | | --- | --- | --- | --- | |KPLX|String|是|开票类型，1.蓝票 2.红票 | |KPR|String|否|开票人 | |GMF_MC|String|否|购买方名称 | |FPQQLSH|String|否|流水号，对应车票电子票号 | |station|String|否|车站公司名称 | |JSHJ|String|否|加税合计（车票） | |DDH|String|是|订单号 | |ISFRUD|String|否|蓝票开票状态 | |BZ|String|否|备注， 格式：咸阳机场<->西安市区(通用)，购票日期：2019-01-08，乘车人：张杰| |GMF_NSRSBH|String|否|纳税人识别号 | |sign|String|否|请求签名，根据签名生成规则计算 | |GMF_SJH|String|否|购买方手机号 | |channel|String|否|售票渠道编号| ## 响应参数 | 字段名称 | 类型 | 是否必填 | 备注 | | --- | --- | --- | --- | |createInvoiceURL|String|是|开发票URL # 2.获取发票信息 ## 接口描述 获取发票信息 ## 接口地址 https://ip//api/bus/GetInvoiceInfo ## 请求方式 restful-get ## 请求参数 | 字段名称 | 类型 | 是否必填 | 备注 | | --- | --- | --- | --- | |ticketNo|String|是|发票编号(电子票号) | ## 响应参数 | 字段名称 | 类型 | 是否必填 | 备注 | | --- | --- | --- | --- | |queryInvoiceURL|String|是|发票详情URL # 1.查询线路 ## 接口描述 根据参数查询线路 ## 接口地址 https://ip//api/bus/queryLine ## 请求方式 restful-post ## 请求参数 | 字段名称 | 类型 | 是否必填 | 备注 | | --- | --- | --- | --- | | lineId | String | 否 | 线路编号 | | lineName | String | 否 | 线路名 可模糊匹配 | | stid| String | 否 | 站点编号 | | stname | String | 否 | 站点名 | | pageNum | int| 是 | 每页条数，1-200之间 | | pageSize | int| 是 | 页码 | ## 响应参数 | 字段名称 | 类型 | 是否必填 | 备注 | | --- | --- | --- | --- | | lineId | String | 是 | 线路编号 | | lineName | String | 是 | 线路名 | | linedate | String | 是 | 日期 | | linetype | String | 是 | 线路类型 1-上行、2-下行 | | stid | String | 是 | 终到站编号 | | stname | String | 是 | 终到站名称 | | price1 | Integer | 是 | 全票票价 终到站票价,途经站票价不返回 单位 分 | | price2 | Integer | 是 | 半票票价 终到站票价,途经站票价不返回单位 分 | | starttime | String | 是 | 首班时间 | | endtime | String | 是 | 末班时间 | # 2.创建订单 ## 接口描述 创建订单并支付 ## 接口地址 https://ip//api/bus/createOrder ## 请求方式 restful-post ## 请求参数 | 字段名称 | 类型 | 是否必填 | 备注 | | --- | --- | --- | --- | | busdate | String | 是 | 班次日期 | | cardInfo | List<CardInfo> | 是 | 旅客信息 | | lineid | String | 是 | 线路编号 | | linename | String | 是 | 线路名称 | | pricetype | String | 是 | 票型 1全票,2半票 | | stid | String | 是 | 到站编号 | | ticketcount | Integer | 是 | 票数不能为空 | | vendorId | Integer | 是 | 商户ID：长度32位 | | accountId | String | 是 | 账户ID：长度32位 | | vendorName | String | 是 | 商户名称：最长20位 | | appCode | String | 是 | 应用code | | tenantId | String | 是 | 租户ID：长度32位 | | goodsId | String | 是 | 商品ID：长度32位 | | goodsSpecItems | String | 是 | 商品规格项 | | actualPrice | BigDecimal | 是 | 订单实际付款价格 单位：分 | | reserve1 | String | 否 | 备用1：长度最大为200 | | reserve2 | String | 否 | 备用2：长度最大为200 | | reserve3 | String | 否 | 备用3：长度最大为200 | | remark | String | 否 | 备注：长度最大500 | | maintainer | String | 是 | 维护人 | | appId | String | 是 | appid | | openId | String | 是 | 微信openid | | signType | String | 是 | 签名方式：默认MD5 | | merReserved1 | String | 是 | 建行备注 | | CCBPay | boolean | 是 | 是否建行支付：不传默认为否 | ### CardInfo | 字段名称 | 类型 | 是否必填 | 备注 | | --- | --- | --- | --- | | passengername | String | 是 | 旅客姓名 | | cardtype | String | 是 | 证件类型 | | cardno | 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 | ### 支付宝支付响应参数 | 字段名称 | 类型 | 是否必填 | 备注 | | --- | --- | --- | --- | | id | String | 是 | 订单ID | | accountId | String | 是 | 账户ID | | orderNo | String | 是 | 订单编号（大巴） | | custcerNo | String | 是 | 取票人证件号 | | custcerType| String | 是 | 取票人证件类型 | | custcerName| String | 是 | 取票人姓名 | | custcerTel | String | 是 | 取票人电话 | | orderStatus | String | 是 | 订单状态 | | orderId | String | 是 | 中台主订单ID | | paysn | String | 是 | 支付单ID | | invoiceRecordId | String | 是 | 发票记录ID | | invoiceState | String | 是 | 开发票状态 | | busTicketDTOList | List<BusTicketDTO> | 是 | 票信息 | | amount | String | 是 | 订单金额 | #### BusTicketDTO | 字段名称 | 类型 | 是否必填 | 备注 | | --- | --- | --- | --- | | id | String | 是 | 子订单ID | | busOrderId | String | 是 | 大巴订单ID | | orderDetailId | String | 是 | 子订单ID | | busDate | String | 是 | 班次日期 | | certificateNo | String | 是 | 旅客证件号码 | | certificateType | String | 是 | 证件类型 | | eleticketNo | String | 是 | 电子票号 | | lineId | String | 是 | 线路编号 | | passengerName | String | 是 | 旅客姓名 | | state | String | 是 | 票状态 | | stName | String | 是 | 到站名称 | # 3.退票 ## 接口描述 退票并退款 ## 接口地址 https://ip//api/bus/ticketRefund ## 请求方式 restful-post ## 请求参数 | 字段名称 | 类型 | 是否必填 | 备注 | | --- | --- | --- | --- | | orderId | String | 是 | 主订单ID | | eleticketNo | String | 是 | 电子票号 | | amount | Double | 是 | 退款金额：单位：元 | | payType | int | 是 | 付款类型：1:支付宝，2建行 | ## 响应参数 统一返回 # 4.查询列表 ## 接口描述 根据账户ID查询订单列表 ## 接口地址 https://ip//api/bus/findMainOrderByAccountId ## 请求方式 restful-post ## 请求参数 | 字段名称 | 类型 | 是否必填 | 备注 | | --- | --- | --- | --- | | accountId | String | 是 | 账户ID | | pageNum | int | 是 | 页码：大于等于1 | | pageSize | int | 是 | 每页条数：范围1-200 | ## 响应参数 | 字段名称 | 类型 | 是否必填 | 备注 | | --- | --- | --- | --- | | createDate | String | 是 | 创建日期 | | busOrderListDTOS | List<BusOrderListDTO> | 是 | 订单列表 | ### BusOrderListDTO | 字段名称 | 类型 | 是否必填 | 备注 | | --- | --- | --- | --- | | id | String | 是 | 订单ID | | createTime | Date | 是 | 下单时间 | | actualPrice | BigDecimal | 是 | 订单价格 | | number | int | 是 | 购票数量 | | orderState | String | 是 | 订单状态 | | orderNo | String | 是 | 订单编号 | | lineName | String | 是 | 线路名称 | | days | String | 是 | 日期 | # 5.查询详情 ## 接口描述 根据主订单ID查询订单详情 ## 接口地址 https://ip//api/bus/findDetailByOrderId ## 请求方式 restful-get ## 请求参数 | 字段名称 | 类型 | 是否必填 | 备注 | | --- | --- | --- | --- | | orderId | String | 是 | 订单ID | ## 响应参数 | 字段名称 | 类型 | 是否必填 | 备注 | | --- | --- | --- | --- | | createTime | Date | 是 | 下单时间 | | paidTime | Date | 是 | 支付时间 | | orderNo | String | 是 | 订单编号 | | number | int | 是 | 购票数量 | | lineName | String | 是 | 线路名称 | | busTicketDetailCopyDTOS | List<BusTicketDetailCopyDTO> | 是 | 票信息 | ### BusTicketDetailCopyDTO | 字段名称 | 类型 | 是否必填 | 备注 | | --- | --- | --- | --- | | passengerName | String | 是 | 旅客姓名 | | cardNo | String | 是 | 证件号码 | | eleTicketNo | String | 是 | 票号 | | state | String | 是 | 票状态 | | QRcode | String | 是 | 票二维码 | | actualPrice | BigDecimal | 是 | 票价格 | # 6.获取未检票二维码列表 ## 接口描述 根据账户ID获取未检票二维码列表 ## 接口地址 https://ip//api/bus/findUncheckQRCode ## 请求方式 restful-get ## 请求参数 | 字段名称 | 类型 | 是否必填 | 备注 | | --- | --- | --- | --- | | accountId | String | 是 | 账户ID：长度32位 | ## 响应参数 | 字段名称 | 类型 | 是否必填 | 备注 | | --- | --- | --- | --- | | passengerName | String | 是 | 旅客姓名 | | cardNo | String | 是 | 证件号码 | | eleticketno| String | 是 | 票号 | | QRcode | String | 是 | 票二维码 | | createDate| Date | 是 | 购票时间 | # 7.获取历史购票人列表 ## 接口描述 根据账户ID获取历史购票人列表 ## 接口地址 https://ip//api/bus/findHisPassengers ## 请求方式 restful-get ## 请求参数 | 字段名称 | 类型 | 是否必填 | 备注 | | --- | --- | --- | --- | | accountId | String | 是 | 账户ID：长度32位 | ## 响应参数 | 字段名称 | 类型 | 是否必填 | 备注 | | --- | --- | --- | --- | | passengername | String | 是 | 旅客姓名 | | cardtype | String | 是 | 证件类型 | | cardno | String | 是 | 证件号 |