alitrip.btrip.corpop.hotel.billsettlement.query (酒店结算记账查询接口)

酒店结算记账查询接口

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
rq OpenIsvBillSettlementSearchRq 可选 请求入参
  • └ corp_id
  • String
  • 可选
  • corp1
  • 第三方企业id
  • └ page_size
  • Number
  • 可选
  • 100
  • 每页数据量,默认100,最高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
  • aliba1423432423
  • 第三方企业id
  • └ total_num
  • Number
  • 1402
  • 总数据量
  • data_list
  • OpenIsvBillSettlementHotelRs []
  • dataList
  • 数据集合
  • └ traveler_name
  • String
  • 张三
  • 出行人名称
  • └ order_type
  • String
  • 预付
  • 订单类型
  • └ fees
  • String
  • 0
  • 杂费
  • └ order_id
  • String
  • 223423423432422
  • 订单id
  • └ department_id
  • String
  • 3454352343
  • 部门id
  • └ primary_id
  • Number
  • 5038018
  • 主键id,遇到相同id,已最新为准(数据会更新)
  • └ over_apply_id
  • String
  • 4234324
  • 超标审批id
  • └ apply_id
  • String
  • 103208648
  • 审批id
  • └ booker_id
  • String
  • al_ch.oyc
  • 预定人use id
  • └ cost_center_number
  • String
  • 8b7f3cd-24324-097
  • 成本中心编码
  • └ invoice_title
  • String
  • 张三有限公司
  • 发票抬头
  • └ room_type
  • String
  • 零压高级大床房-(提前1天预订)(限内宾)(大床)含双早
  • 房型
  • └ promotion_fee
  • String
  • 113.02
  • 优惠券
  • └ service_fee
  • String
  • 3465
  • 服务费,仅在 feeType 20111、20112中展示,枚举详见语雀
  • └ room_price
  • String
  • 1201.98
  • 房价
  • └ cost_center
  • String
  • 张三有限公司
  • 成本中心名称
  • └ person_refund_fee
  • String
  • 34
  • 个人退款金额
  • └ settlement_fee
  • String
  • 1000
  • 结算金额
  • └ index
  • String
  • 5038018
  • 序号
  • └ book_time
  • String
  • 2021-10-12 23:58:48
  • 预定时间
  • └ fee_type
  • String
  • 20101
  • 费用类型,枚举详见语雀
  • └ checkout_date
  • String
  • 2021-10-16 00:00:00
  • 离店时间
  • └ person_settle_price
  • String
  • 88.96
  • 个人结算费用
  • └ is_negotiation
  • String
  • 是否协议价
  • └ project_name
  • String
  • 张三生产-张三自制线-公共
  • 项目名称
  • └ total_nights
  • Number
  • 2
  • 总间夜数
  • └ status
  • Number
  • 1
  • 入账状态,枚举详见语雀
  • └ room_number
  • Number
  • 1
  • 房间号
  • └ city
  • String
  • 北京市
  • 入住城市
  • └ city_code
  • String
  • 110100
  • 入住城市编码,枚举详见语雀
  • └ traveler_job_no
  • String
  • 326246
  • 出行人工号
  • └ check_in_date
  • String
  • 2021-10-14 00:00:00
  • 入住时间
  • └ project_code
  • String
  • 223423432
  • 项目编码
  • └ cascade_department
  • String
  • 张三-营运部-北方营运大区
  • 级联部门
  • └ order_price
  • String
  • 1088.96
  • 订单金额
  • └ department
  • String
  • 张三大区
  • 末级部门
  • └ corp_total_fee
  • String
  • 1000
  • 企业支付金额
  • └ settlement_type
  • String
  • 4
  • 结算类型,枚举详见语雀
  • └ alipay_trade_no
  • String
  • 234432432
  • 支付流水号
  • └ corp_refund_fee
  • String
  • 12
  • 企业退款金额
  • └ fu_point_fee
  • String
  • 12
  • 福豆支付
  • └ booker_name
  • String
  • 张三
  • 预订人名称
  • └ hotel_name
  • String
  • 全季北京广渠路酒店(Season Beijing guangqu road branch)
  • 酒店名称
  • └ traveler_id
  • String
  • al_ch2343242g.oyc
  • 出行人use id
  • └ capital_direction
  • String
  • 1
  • 资金方向,枚举详见语雀
  • └ settlement_time
  • String
  • 2021-10-12 23:58:56
  • 结算时间
  • └ nights
  • Number
  • 2
  • 入住天数
  • └ booker_job_no
  • String
  • 326246
  • 预定人工号
  • └ is_share_str
  • String
  • 是否合住
  • └ voucher_type
  • Number
  • 11
  • 票据类型,枚举详见语雀
  • └ bill_record_time
  • Date
  • 2021-10-12 13:51:43
  • 入账时间
  • └ settlement_grant_fee
  • String
  • 3.12
  • 预存赠送金额消费
  • └ remark
  • String
  • 线下改签
  • 备注
  • └ apply_extend_field
  • String
  • {"cost_center":"成本中心"}
  • 审批自定义字段
  • └ category
  • Number
  • 2
  • 类目,枚举详见语雀
  • └ 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);
AlitripBtripCorpopHotelBillsettlementQueryRequest req = new AlitripBtripCorpopHotelBillsettlementQueryRequest();
AlitripBtripCorpopHotelBillsettlementQueryRequest.OpenIsvBillSettlementSearchRq obj1 = new AlitripBtripCorpopHotelBillsettlementQueryRequest.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);
AlitripBtripCorpopHotelBillsettlementQueryResponse rsp = client.execute(req, sessionKey);
System.out.println(rsp.getBody());

响应示例

  • XML示例
  • JSON示例
<alitrip_btrip_corpop_hotel_billsettlement_query_response>
    <result>
        <success>true</success>
        <module>
            <corp_id>aliba1423432423</corp_id>
            <total_num>1402</total_num>
            <data_list>
                <open_isv_bill_settlement_hotel_rs>
                    <traveler_name>张三</traveler_name>
                    <order_type>预付</order_type>
                    <fees>0</fees>
                    <order_id>223423423432422</order_id>
                    <department_id>3454352343</department_id>
                    <primary_id>5038018</primary_id>
                    <over_apply_id>4234324</over_apply_id>
                    <apply_id>103208648</apply_id>
                    <booker_id>al_ch.oyc</booker_id>
                    <cost_center_number>8b7f3cd-24324-097</cost_center_number>
                    <invoice_title>张三有限公司</invoice_title>
                    <room_type>零压高级大床房-(提前1天预订)(限内宾)(大床)含双早</room_type>
                    <promotion_fee>113.02</promotion_fee>
                    <service_fee>3465</service_fee>
                    <room_price>1201.98</room_price>
                    <cost_center>张三有限公司</cost_center>
                    <person_refund_fee>34</person_refund_fee>
                    <settlement_fee>1000</settlement_fee>
                    <index>5038018</index>
                    <book_time>2021-10-12 23:58:48</book_time>
                    <fee_type>20101</fee_type>
                    <checkout_date>2021-10-16 00:00:00</checkout_date>
                    <person_settle_price>88.96</person_settle_price>
                    <is_negotiation>是</is_negotiation>
                    <project_name>张三生产-张三自制线-公共</project_name>
                    <total_nights>2</total_nights>
                    <status>1</status>
                    <room_number>1</room_number>
                    <city>北京市</city>
                    <city_code>110100</city_code>
                    <traveler_job_no>326246</traveler_job_no>
                    <check_in_date>2021-10-14 00:00:00</check_in_date>
                    <project_code>223423432</project_code>
                    <cascade_department>张三-营运部-北方营运大区</cascade_department>
                    <order_price>1088.96</order_price>
                    <department>张三大区</department>
                    <corp_total_fee>1000</corp_total_fee>
                    <settlement_type>4</settlement_type>
                    <alipay_trade_no>234432432</alipay_trade_no>
                    <corp_refund_fee>12</corp_refund_fee>
                    <fu_point_fee>12</fu_point_fee>
                    <booker_name>张三</booker_name>
                    <hotel_name>全季北京广渠路酒店(Season Beijing guangqu road branch)</hotel_name>
                    <traveler_id>al_ch2343242g.oyc</traveler_id>
                    <capital_direction>1</capital_direction>
                    <settlement_time>2021-10-12 23:58:56</settlement_time>
                    <nights>2</nights>
                    <booker_job_no>326246</booker_job_no>
                    <is_share_str>否</is_share_str>
                    <voucher_type>11</voucher_type>
                    <bill_record_time>2021-10-12 13:51:43</bill_record_time>
                    <settlement_grant_fee>3.12</settlement_grant_fee>
                    <remark>线下改签</remark>
                    <apply_extend_field>{&quot;cost_center&quot;:&quot;成本中心&quot;}</apply_extend_field>
                </open_isv_bill_settlement_hotel_rs>
            </data_list>
            <category>2</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_hotel_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

返回
顶部