alitrip.btrip.corpop.flight.billsettlement.query (机票结算记账查询接口)

机票结算记账查询接口

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
rq OpenIsvBillSettlementSearchRq 可选 入参
  • └ corp_id
  • String
  • 可选
  • corp1
  • 第三方企业id
  • └ page_size
  • Number
  • 可选
  • 100
  • 每页数据量,默认10,最高100
  • └ version
  • Number
  • 可选
  • 2
  • 1、老版本2、isv对外版本
  • └ page_no
  • Number
  • 可选
  • 1
  • 页数,从1开始
  • └ category
  • Number
  • 可选
  • 1
  • 类目,1:机票;2:酒店;4:用车;6:新火车票;
  • └ period_start
  • String
  • 可选
  • 2021-10-01
  • 记账更新开始日期
  • └ period_end
  • String
  • 可选
  • 2021-10-02
  • 记账更新结束日期

响应参数

名称 类型 示例值 描述
result HisvResultSupport result 返回结果
  • └ success
  • Boolean
  • true
  • 是否成功
  • module
  • OpenIsvBillSettlementRs
  • module
  • module
  • └ corp_id
  • String
  • aliba2343232423
  • 第三方企业id
  • └ total_num
  • Number
  • 5180
  • 总数据量
  • data_list
  • OpenIsvBillSettlementFlightRs []
  • datalist
  • 数据集合
  • └ traveler_name
  • String
  • 张三
  • 出行人名称
  • └ cabin_class
  • String
  • 经济舱
  • 舱位
  • └ build_fee
  • String
  • 50
  • 基建费
  • └ refund_fee
  • String
  • 23.9
  • 退款手续费
  • └ arr_date
  • String
  • 2021-10-02
  • 到达日期
  • └ order_id
  • String
  • 234223423423
  • 订单号
  • └ department_id
  • String
  • 2342342
  • 部门id
  • └ discount
  • String
  • 51%
  • 折扣率
  • └ change_fee
  • String
  • 23.9
  • 改签手续费
  • └ primary_id
  • Number
  • 4564547
  • 主键id,遇到相同id,已最新为准(数据会更新)
  • └ upgrade_cost
  • String
  • 23.9
  • 改签差价
  • └ over_apply_id
  • String
  • 234324324423
  • 超标审批单号
  • └ apply_id
  • String
  • 103177854
  • 审批单号
  • └ booker_id
  • String
  • al_yxfdsg.fj
  • 预订人use id
  • └ most_difference_price
  • String
  • 23.9
  • 低价提醒(与最低价差额)
  • └ cost_center_number
  • String
  • 48b7f3cd-8a4f-4df9-ae2c-883e008cf097
  • 成本中心编码
  • └ itinerary_num
  • String
  • 5334916421
  • 行程单打印序号
  • └ invoice_title
  • String
  • 张三有限公司
  • 发票抬头
  • └ service_fee
  • String
  • 23.9
  • 服务费,仅在feeType 11001、11002中展示
  • └ itinerary_price
  • String
  • 460
  • 行程单金额
  • └ arr_station
  • String
  • 白云国际机场
  • 到达机场
  • └ cost_center
  • String
  • 张三有限公司
  • 成本中心名称
  • └ settlement_fee
  • String
  • 460
  • 结算金额
  • └ index
  • String
  • 4564547
  • 序号
  • └ book_time
  • String
  • 2021-10-01 00:17:05
  • 预定时间
  • └ fee_type
  • String
  • 10101
  • 费用类型,枚举详见语雀
  • └ flight_no
  • String
  • MU9684
  • 航班号
  • └ corp_pay_order_fee
  • String
  • 460
  • 订单金额
  • └ oil_fee
  • String
  • 0
  • 燃油费
  • └ btrip_coupon_fee
  • String
  • 23.9
  • 商旅价优惠金额
  • └ repeat_refund
  • String
  • 是否重复退
  • └ dept_city
  • String
  • 南昌
  • 起飞城市
  • └ project_name
  • String
  • 张三生产-张三自制线-公共
  • 项目名称
  • └ arr_airport_code
  • String
  • CAN
  • 到达机场航司三字码
  • └ ticket_id
  • String
  • 781-6586234234324
  • 行程单号
  • └ status
  • Number
  • 1
  • 入账状态,枚举详见语雀
  • └ airline_corp_code
  • String
  • MU
  • 航司二字码
  • └ dept_station
  • String
  • 昌北国际机场
  • 起飞机场
  • └ dept_time
  • String
  • 12:00:00
  • 起飞时间
  • └ most_price
  • String
  • 23.9
  • 低价航班价格
  • └ arr_city
  • String
  • 广州
  • 到达城市
  • └ cabin
  • String
  • R
  • 舱位代码
  • └ dep_airport_code
  • String
  • KHN
  • 起飞机场航司三字码
  • └ project_code
  • String
  • 45623234
  • 项目编码
  • └ cascade_department
  • String
  • 张三事业群-张三部-北方营运大区
  • 级联部门
  • └ advance_day
  • Number
  • 1
  • 提前预定天数
  • └ department
  • String
  • 北方营运大区
  • 末级部门
  • └ most_difference_discount
  • String
  • 23%
  • 低价提醒(折扣)
  • └ settlement_type
  • String
  • 2
  • 结算类型,枚举详见语雀
  • └ coupon
  • String
  • 1
  • 优惠券
  • └ alipay_trade_no
  • String
  • 2021100122001138061456080520
  • 支付流水号
  • └ airline_corp_name
  • String
  • 中国东方航空
  • 航司名称
  • └ most_difference_flight_no
  • String
  • MU9684
  • 低价提醒(航班号)
  • └ booker_name
  • String
  • 张三
  • 预订人名称
  • └ refund_upgrade_cost
  • String
  • 23.9
  • 改签退票手续费
  • └ traveler_id
  • String
  • al_y234324asdg.fj
  • 出行人use id
  • └ capital_direction
  • String
  • 1
  • 资金方向,枚举详见语雀
  • └ insurance_fee
  • String
  • 23.9
  • 保险费
  • └ seal_price
  • String
  • 410
  • 销售金额
  • └ settlement_time
  • String
  • 2021-10-01 00:17:13
  • 结算时间
  • └ most_difference_dept_time
  • String
  • 2021-10-01 00:17:13
  • 低价提醒(起飞时间)
  • └ most_difference_reason
  • String
  • 不选
  • 不选低价原因
  • └ negotiation_coupon_fee
  • String
  • 23.9
  • 协议价优惠金额
  • └ arr_time
  • String
  • 13:30:00
  • 到达时间
  • └ dept_date
  • String
  • 2021-10-02
  • 起飞日期
  • └ booker_job_no
  • String
  • 2342432
  • 预订人工号
  • └ traveler_job_no
  • String
  • 345345
  • 出行人工号
  • └ voucher_type
  • Number
  • 11
  • 票据类型,枚举详见语雀
  • └ bill_record_time
  • Date
  • 2021-10-12 13:51:43
  • 入账时间
  • └ settlement_grant_fee
  • String
  • 5.67
  • 预存赠送金额消费
  • └ remark
  • String
  • 线下改签
  • 备注
  • └ apply_extend_field
  • String
  • {"cost_center":"成本中心"}
  • 审批自定义字段
  • └ category
  • Number
  • 1
  • 类目,枚举详见语雀
  • └ period_start
  • String
  • 2021-10-13
  • 记账更新开始时间
  • └ period_end
  • String
  • 2021-10-14
  • 记账更新结束时间
  • └ result_code
  • Number
  • 0
  • 结果code
  • └ result_msg
  • String
  • 成功
  • 结果msg

请求示例

  • JAVA
  • .NET
  • PHP
  • CURL
  • Python
  • C/C++
  • NodeJS
TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
AlitripBtripCorpopFlightBillsettlementQueryRequest req = new AlitripBtripCorpopFlightBillsettlementQueryRequest();
AlitripBtripCorpopFlightBillsettlementQueryRequest.OpenIsvBillSettlementSearchRq obj1 = new AlitripBtripCorpopFlightBillsettlementQueryRequest.OpenIsvBillSettlementSearchRq();
obj1.setCorpId("corp1");
obj1.setPageSize(100L);
obj1.setVersion(2L);
obj1.setPageNo(1L);
obj1.setCategory(1L);
obj1.setPeriodStart("2021-10-01");
obj1.setPeriodEnd("2021-10-02");
req.setRq(obj1);
AlitripBtripCorpopFlightBillsettlementQueryResponse rsp = client.execute(req, sessionKey);
System.out.println(rsp.getBody());

响应示例

  • XML示例
  • JSON示例
<alitrip_btrip_corpop_flight_billsettlement_query_response>
    <result>
        <success>true</success>
        <module>
            <corp_id>aliba2343232423</corp_id>
            <total_num>5180</total_num>
            <data_list>
                <open_isv_bill_settlement_flight_rs>
                    <traveler_name>张三</traveler_name>
                    <cabin_class>经济舱</cabin_class>
                    <build_fee>50</build_fee>
                    <refund_fee>23.9</refund_fee>
                    <arr_date>2021-10-02</arr_date>
                    <order_id>234223423423</order_id>
                    <department_id>2342342</department_id>
                    <discount>51%</discount>
                    <change_fee>23.9</change_fee>
                    <primary_id>4564547</primary_id>
                    <upgrade_cost>23.9</upgrade_cost>
                    <over_apply_id>234324324423</over_apply_id>
                    <apply_id>103177854</apply_id>
                    <booker_id>al_yxfdsg.fj</booker_id>
                    <most_difference_price>23.9</most_difference_price>
                    <cost_center_number>48b7f3cd-8a4f-4df9-ae2c-883e008cf097</cost_center_number>
                    <itinerary_num>5334916421</itinerary_num>
                    <invoice_title>张三有限公司</invoice_title>
                    <service_fee>23.9</service_fee>
                    <itinerary_price>460</itinerary_price>
                    <arr_station>白云国际机场</arr_station>
                    <cost_center>张三有限公司</cost_center>
                    <settlement_fee>460</settlement_fee>
                    <index>4564547</index>
                    <book_time>2021-10-01 00:17:05</book_time>
                    <fee_type>10101</fee_type>
                    <flight_no>MU9684</flight_no>
                    <corp_pay_order_fee>460</corp_pay_order_fee>
                    <oil_fee>0</oil_fee>
                    <btrip_coupon_fee>23.9</btrip_coupon_fee>
                    <repeat_refund>是</repeat_refund>
                    <dept_city>南昌</dept_city>
                    <project_name>张三生产-张三自制线-公共</project_name>
                    <arr_airport_code>CAN</arr_airport_code>
                    <ticket_id>781-6586234234324</ticket_id>
                    <status>1</status>
                    <airline_corp_code>MU</airline_corp_code>
                    <dept_station>昌北国际机场</dept_station>
                    <dept_time>12:00:00</dept_time>
                    <most_price>23.9</most_price>
                    <arr_city>广州</arr_city>
                    <cabin>R</cabin>
                    <dep_airport_code>KHN</dep_airport_code>
                    <project_code>45623234</project_code>
                    <cascade_department>张三事业群-张三部-北方营运大区</cascade_department>
                    <advance_day>1</advance_day>
                    <department>北方营运大区</department>
                    <most_difference_discount>23%</most_difference_discount>
                    <settlement_type>2</settlement_type>
                    <coupon>1</coupon>
                    <alipay_trade_no>2021100122001138061456080520</alipay_trade_no>
                    <airline_corp_name>中国东方航空</airline_corp_name>
                    <most_difference_flight_no>MU9684</most_difference_flight_no>
                    <booker_name>张三</booker_name>
                    <refund_upgrade_cost>23.9</refund_upgrade_cost>
                    <traveler_id>al_y234324asdg.fj</traveler_id>
                    <capital_direction>1</capital_direction>
                    <insurance_fee>23.9</insurance_fee>
                    <seal_price>410</seal_price>
                    <settlement_time>2021-10-01 00:17:13</settlement_time>
                    <most_difference_dept_time>2021-10-01 00:17:13</most_difference_dept_time>
                    <most_difference_reason>不选</most_difference_reason>
                    <negotiation_coupon_fee>23.9</negotiation_coupon_fee>
                    <arr_time>13:30:00</arr_time>
                    <dept_date>2021-10-02</dept_date>
                    <booker_job_no>2342432</booker_job_no>
                    <traveler_job_no>345345</traveler_job_no>
                    <voucher_type>11</voucher_type>
                    <bill_record_time>2021-10-12 13:51:43</bill_record_time>
                    <settlement_grant_fee>5.67</settlement_grant_fee>
                    <remark>线下改签</remark>
                    <apply_extend_field>{&quot;cost_center&quot;:&quot;成本中心&quot;}</apply_extend_field>
                </open_isv_bill_settlement_flight_rs>
            </data_list>
            <category>1</category>
            <period_start>2021-10-13</period_start>
            <period_end>2021-10-14</period_end>
        </module>
        <result_code>0</result_code>
        <result_msg>成功</result_msg>
    </result>
</alitrip_btrip_corpop_flight_billsettlement_query_response>

异常示例

  • XML示例
  • JSON示例
<error_response>
    <code>50</code>
    <msg>Remote service error</msg>
    <sub_code>isv.invalid-parameter</sub_code>
    <sub_msg>非法参数</sub_msg>
</error_response>

错误码解释

错误码 错误描述 解决方案

API工具

如何获得此API

FAQ

返回
顶部