文档中心 > API类目 > 酒店在线预订API

taobao.xhotel.order.statement.get (查询账单信息)

阿里根据此接口定义输出订单账务明细,结账状态发生变化时阿里需推送账单信息。系统商可实时调用该接口来查询订单的详情

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
order_tids String 可选 123,3434,4565 要查询的tid列表,逗号分隔,列表查询;当此值不为空时候,其余参数忽略。最多单次20条。
page_size Number 可选 500
  • 默认值:100
  • 查询条数,最大支持500条
    start Number 可选 0
  • 默认值:0
  • 数据查询开始下标
    date_type Number 可选 2
  • 默认值:0
  • 0:check_in, 1:check_out,2:分账时间
    to Date 可选 2015-09-09 22:22:22 查询结束时间
    from Date 可选 2015-09-09 22:22:22 查询开始时间
    tid Number 可选 122222 淘宝订单号
    hotel_code String 可选 333 外部酒店编码
    vendor String 可选 taobao
  • 默认值:taobao
  • 系统商vendor

    响应参数

    名称 类型 示例值 描述
    results StatementOrder [] 出参列表 系统自动生成
    • └ hotel_name
    • String
    • 君亭酒店
    • 酒店名称
    • └ account_type
    • String
    • 2
    • 门店收款账户(1:支付宝;2:银行卡)
    • └ commission_total
    • String
    • 1950
    • 扣除佣金后, 1. 集团入账=买家实际支付(房费+杂费-卖家优惠); 2. 门店实际入账=买
    • └ transaction_fee
    • String
    • 100
    • 交易手续费
    • └ hotel_commission
    • String
    • 50
    • 集团与门店佣金
    • └ taobao_commission
    • String
    • 550
    • 淘宝佣金
    • └ alipay_trade_no
    • String
    • 11921001001260207112229
    • 支付宝交易号
    • └ settle_date
    • String
    • 2015-11-19
    • 结算日期
    • └ promotion_detail
    • String
    • demo
    • 卖家优惠明细(暂无值)
    • └ seller_promotion
    • String
    • 2000
    • 卖家优惠(分)
    • └ other_fee
    • String
    • 10000
    • 杂费总额
    • └ payment
    • String
    • 2590
    • 总房费(分)
    • └ room_type_name
    • String
    • RFX151023000001
    • 实际的房型名称
    • └ room_sum_nights
    • Number
    • 9
    • 入住天数
    • └ check_out
    • String
    • 2015-11-19
    • 离店时间
    • └ check_in
    • String
    • 2015-11-19
    • 入住时间
    • └ trade_status
    • String
    • 2
    • 交易状态(暂无值)
    • └ pay_type
    • String
    • 1
    • 支付类型(1:预付;5:面付;7:在线预约;601:线上信用住;602:扫码信用住;603:身份证线下信用住;604:官网信用住)
    • └ out_id
    • String
    • (HKC)356754
    • 外部订单ID
    • └ tid
    • Number
    • 1383687622578743
    • 淘宝订单ID
    • └ settle_status
    • String
    • 2
    • 分账状态 (0, "未分账"),(1, "分账成功"),(3, "分账失败"), (2, "无需分账"),(4,"预处理成功");
    • └ tax_and_fee
    • String
    • 1200
    • 税和费,单位分

    请求示例

    • JAVA
    • .NET
    • PHP
    • CURL
    • Python
    • C/C++
    • NodeJS
    TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
    XhotelOrderStatementGetRequest req = new XhotelOrderStatementGetRequest();
    req.setOrderTids("123,3434,4565");
    req.setPageSize(500L);
    req.setStart(0L);
    req.setDateType(2L);
    req.setTo(StringUtils.parseDateTime("2015-09-09 22:22:22"));
    req.setFrom(StringUtils.parseDateTime("2015-09-09 22:22:22"));
    req.setTid(122222L);
    req.setHotelCode("333");
    req.setVendor("taobao");
    XhotelOrderStatementGetResponse rsp = client.execute(req, sessionKey);
    System.out.println(rsp.getBody());

    响应示例

    • XML示例
    • JSON示例
    <xhotel_order_statement_get_response>
        <results>
            <statement_order>
                <hotel_name>君亭酒店</hotel_name>
                <account_type>2</account_type>
                <commission_total>1950</commission_total>
                <transaction_fee>100</transaction_fee>
                <hotel_commission>50</hotel_commission>
                <taobao_commission>550</taobao_commission>
                <alipay_trade_no>11921001001260207112229</alipay_trade_no>
                <settle_date>2015-11-19</settle_date>
                <promotion_detail>demo</promotion_detail>
                <seller_promotion>2000</seller_promotion>
                <other_fee>10000</other_fee>
                <payment>2590</payment>
                <room_type_name>RFX151023000001</room_type_name>
                <room_sum_nights>9</room_sum_nights>
                <check_out>2015-11-19</check_out>
                <check_in>2015-11-19</check_in>
                <trade_status>2</trade_status>
                <pay_type>1</pay_type>
                <out_id>(HKC)356754</out_id>
                <tid>1383687622578743</tid>
                <settle_status>2</settle_status>
                <tax_and_fee>1200</tax_and_fee>
            </statement_order>
        </results>
    </xhotel_order_statement_get_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

    返回
    顶部