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

taobao.xhotel.order.invoice.settle.search (查询结账信息)

查询结账信息

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
to Date 可选 2017-07-24 00:00:00 查询结束时间
hid Number 可选 12121 酒店HID
page_size Number 可选 20 查询条数
from Date 可选 2017-07-24 00:00:00 查询开始时间
settle_status Number 可选 1 分账状态
date_type Number 可选 1 日期时间
page Number 可选 1 页码
hotel_name String 可选 淘宝酒店 酒店名称
account_type Number 可选 1 账号类型
pay_type Number 可选 1 付费类型
tid Number 可选 12121 订单号
hids String 可选 1,2,3,4 hid批量查询,逗号分隔

响应参数

名称 类型 示例值 描述
results TopSettleResult [] results 结果集列表
  • └ gmt_modified
  • String
  • 默认字符串
  • 更新时间
  • └ hotel_commission_value
  • Number
  • 12300
  • 酒店佣金
  • └ max_hotel_commission
  • String
  • 12300
  • 最大酒店佣金
  • └ hid
  • Number
  • 12300
  • 酒店hid
  • └ memo
  • String
  • 备注
  • 备注
  • └ hotel_sum_fee
  • String
  • 12300
  • 合计金额
  • └ out_hid
  • String
  • 1213123
  • 外部酒店编号
  • └ account_type_code
  • Number
  • 1
  • 银行卡,或支付宝(1:支付宝;2:银行卡) (如果accountType是银行卡,交易费TransactionFee强制返回100,支付宝返回0)
  • └ status_code
  • Number
  • 12300
  • statusCode
  • └ is_extra_settle
  • String
  • 1
  • 是否超额分账 1超额分账 0非超额分账
  • └ seller_nick
  • String
  • sandbox_sz_30
  • 卖家昵称
  • └ hotel_name
  • String
  • 杭州湾大酒店
  • 酒店名
  • └ tid
  • Number
  • 12300
  • 订单号
  • └ taobao_commission
  • String
  • 12300
  • 平台佣金
  • └ hotel_commission_type
  • String
  • 默认字符串
  • 酒店佣金类型
  • └ promotion_amount
  • Number
  • 12300
  • 优惠金额
  • └ launch_date
  • String
  • 2017-08-09
  • 直连时间
  • └ out_room_number
  • String
  • aaa
  • 外部房型编号
  • └ alipay_trade_no
  • String
  • 1232131231312
  • 支付宝交易流水号
  • └ payment_value
  • Number
  • 1
  • 支付类型
  • └ payment
  • String
  • 预付
  • 支付类型描述
  • └ gmt_create
  • String
  • 2017-08-09
  • 创建时间
  • └ vendor
  • String
  • taobao
  • vendor
  • └ commission_total
  • Number
  • 12300
  • 总佣金
  • └ out_id
  • String
  • aaaa
  • 外部编号
  • └ hotel_commission
  • String
  • 12344
  • 酒店佣金
  • └ commission_total_money
  • String
  • 12300
  • 佣金金额
  • └ other_fee
  • String
  • 12300
  • 其他费用
  • └ settle_date
  • String
  • 2017-08-09
  • 结账时间
  • └ room_sum_nights
  • Number
  • 123
  • 总间夜
  • └ other_fee_value
  • Number
  • 12300
  • 其他费用
  • └ settle_status_code
  • Number
  • 1
  • 结账状态
  • └ settle_status
  • String
  • 已结账
  • 结账状态
  • └ pay_type_code
  • Number
  • 1
  • 支付类型
  • └ check_in
  • String
  • 2017-08-09
  • 入住时间
  • └ tid_str
  • String
  • 11231231
  • 订单编号字符串
  • └ check_out
  • String
  • 2017-08-09
  • 离店时间
  • └ seller_id
  • Number
  • 12300
  • 卖家id
  • └ contact_name
  • String
  • 张三
  • 联系人名称
  • └ taobao_commission_value
  • Number
  • 12300
  • 总佣金金额
  • └ account_type
  • String
  • 1
  • 支付账户类型
  • └ pay_type
  • String
  • 1
  • 支付类型
  • └ out_rid
  • String
  • 1233
  • 外部房型编号
  • └ room_type_name
  • String
  • 海景大床房
  • 房型名称
  • └ decrease
  • String
  • 12312
  • 立减
  • └ account_no
  • String
  • 12123
  • 账户
  • └ around_code
  • String
  • a111
  • 全场景消费码
  • └ reverse_order
  • String
  • 11212
  • 拦截订单号
  • └ intercept_amount
  • String
  • 1212
  • 拦截的金额
total_count Number 123 总条数
error_msg String errorMsg errorMsg
error Boolean true error

请求示例

  • JAVA
  • .NET
  • PHP
  • CURL
  • Python
  • C/C++
  • NodeJS
TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
XhotelOrderInvoiceSettleSearchRequest req = new XhotelOrderInvoiceSettleSearchRequest();
req.setTo(StringUtils.parseDateTime("2017-07-24 00:00:00"));
req.setHid(12121L);
req.setPageSize(20L);
req.setFrom(StringUtils.parseDateTime("2017-07-24 00:00:00"));
req.setSettleStatus(1L);
req.setDateType(1L);
req.setPage(1L);
req.setHotelName("淘宝酒店");
req.setAccountType(1L);
req.setPayType(1L);
req.setTid(12121L);
req.setHids("1,2,3,4");
XhotelOrderInvoiceSettleSearchResponse rsp = client.execute(req, sessionKey);
System.out.println(rsp.getBody());

响应示例

  • XML示例
  • JSON示例
<xhotel_order_invoice_settle_search_response>
    <results>
        <top_settle_result>
            <gmt_modified>默认字符串</gmt_modified>
            <hotel_commission_value>12300</hotel_commission_value>
            <max_hotel_commission>12300</max_hotel_commission>
            <hid>12300</hid>
            <memo>备注</memo>
            <hotel_sum_fee>12300</hotel_sum_fee>
            <out_hid>1213123</out_hid>
            <account_type_code>1</account_type_code>
            <status_code>12300</status_code>
            <is_extra_settle>1</is_extra_settle>
            <seller_nick>sandbox_sz_30</seller_nick>
            <hotel_name>杭州湾大酒店</hotel_name>
            <tid>12300</tid>
            <taobao_commission>12300</taobao_commission>
            <hotel_commission_type>默认字符串</hotel_commission_type>
            <promotion_amount>12300</promotion_amount>
            <launch_date>2017-08-09</launch_date>
            <out_room_number>aaa</out_room_number>
            <alipay_trade_no>1232131231312</alipay_trade_no>
            <payment_value>1</payment_value>
            <payment>预付</payment>
            <gmt_create>2017-08-09</gmt_create>
            <vendor>taobao</vendor>
            <commission_total>12300</commission_total>
            <out_id>aaaa</out_id>
            <hotel_commission>12344</hotel_commission>
            <commission_total_money>12300</commission_total_money>
            <other_fee>12300</other_fee>
            <settle_date>2017-08-09</settle_date>
            <room_sum_nights>123</room_sum_nights>
            <other_fee_value>12300</other_fee_value>
            <settle_status_code>1</settle_status_code>
            <settle_status>已结账</settle_status>
            <pay_type_code>1</pay_type_code>
            <check_in>2017-08-09</check_in>
            <tid_str>11231231</tid_str>
            <check_out>2017-08-09</check_out>
            <seller_id>12300</seller_id>
            <contact_name>张三</contact_name>
            <taobao_commission_value>12300</taobao_commission_value>
            <account_type>1</account_type>
            <pay_type>1</pay_type>
            <out_rid>1233</out_rid>
            <room_type_name>海景大床房</room_type_name>
            <decrease>12312</decrease>
            <account_no>12123</account_no>
            <around_code>a111</around_code>
            <reverse_order>11212</reverse_order>
            <intercept_amount>1212</intercept_amount>
        </top_settle_result>
    </results>
    <total_count>123</total_count>
    <error_msg>errorMsg</error_msg>
    <error>true</error>
</xhotel_order_invoice_settle_search_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

返回
顶部