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

taobao.xhotel.pms.guestbill.get.vtwo (客人PMS账单信息查询)

从pms获取客人账单信息

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
tax_num String 可选 122323 开票点税号
short_id_num String 可选 1234 身份证后4位
room_num String 可选 101 房间号
request_id String 可选 12134serweg 请求id (32位唯一值)
user_channel Number 可选 1
  • 默认值:0
  • 用户渠道(0:未知,1:淘宝)

    响应参数

    名称 类型 示例值 描述
    result ResultSet 查询结果集
    • results
    • OrderBillInfo []
    • 账单列表中涉及到的金额费用单位均为分
    • └ no_checkout_price
    • Number
    • 10000
    • 未结账房费
    • └ checkout_price
    • Number
    • 10000
    • 已结账房费
    • └ checkout_total_fee
    • Number
    • 10000
    • 已结账总费用
    • └ no_checkout_total_fee
    • Number
    • 10000
    • 未结账总费用
    • └ check_out_date
    • String
    • 2017-01-02
    • 离店日期
    • └ check_in_date
    • String
    • 2017-01-01
    • 入住日期
    • └ room_no
    • String
    • 101
    • 房间号
    • └ id_number
    • String
    • 12343454545
    • 完整的身份证号
    • └ guest_name
    • String
    • 张三
    • 客人姓名
    • └ hotel_code
    • String
    • HDASE
    • 外部酒店代码
    • └ out_order_id
    • String
    • F1213231
    • 外部订单号
    • └ tid
    • Number
    • 232434
    • 淘宝订单号
    • └ request_id
    • String
    • 12134serweg
    • 请求id (同入参)
    • └ no_checkout_other_fee
    • Number
    • 1000
    • 未结账杂费
    • └ checkout_other_fee
    • Number
    • 1000
    • 已结账杂费
    • └ remark
    • String
    • 备注
    • 备注
    • other_fee_detail
    • OtherFeeDetail
    • 杂费明细列表
    • other_fee_infos
    • OtherFeeInfo []
    • └ name
    • String
    • 张三
    • 杂费名称
    • └ price
    • Number
    • 5000
    • 杂费金额
    • └ checkout
    • Number
    • 1
    • 结账状态(1:结账,0:未结账)
    • daily_room_fee
    • DailyRoomFee
    • 每日房费类表
    • daily_prices
    • DailyPrice []
    • └ checkout
    • Number
    • 1
    • 结账状态(1:结账,0:未结账)
    • └ price
    • Number
    • 50000
    • 每日实际房费
    • └ date
    • Date
    • 2017-01-01 00:00:00
    • 日期
    • └ error_msg
    • String
    • 操作失败
    • 错误描述
    • └ error_code
    • String
    • 0
    • errorCode
    • └ success
    • Boolean
    • false
    • 是否成功标记

    请求示例

    • JAVA
    • .NET
    • PHP
    • CURL
    • Python
    • C/C++
    • NodeJS
    TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
    XhotelPmsGuestbillGetVtwoRequest req = new XhotelPmsGuestbillGetVtwoRequest();
    req.setTaxNum("122323");
    req.setShortIdNum("1234");
    req.setRoomNum("101");
    req.setRequestId("12134serweg");
    req.setUserChannel(1L);
    XhotelPmsGuestbillGetVtwoResponse rsp = client.execute(req, sessionKey);
    System.out.println(rsp.getBody());

    响应示例

    • XML示例
    • JSON示例
    <xhotel_pms_guestbill_get_vtwo_response>
        <result>
            <results>
                <order_bill_info>
                    <no_checkout_price>10000</no_checkout_price>
                    <checkout_price>10000</checkout_price>
                    <checkout_total_fee>10000</checkout_total_fee>
                    <no_checkout_total_fee>10000</no_checkout_total_fee>
                    <check_out_date>2017-01-02</check_out_date>
                    <check_in_date>2017-01-01</check_in_date>
                    <room_no>101</room_no>
                    <id_number>12343454545</id_number>
                    <guest_name>张三</guest_name>
                    <hotel_code>HDASE</hotel_code>
                    <out_order_id>F1213231</out_order_id>
                    <tid>232434</tid>
                    <request_id>12134serweg</request_id>
                    <no_checkout_other_fee>1000</no_checkout_other_fee>
                    <checkout_other_fee>1000</checkout_other_fee>
                    <remark>备注</remark>
                    <other_fee_detail>
                        <other_fee_infos>
                            <other_fee_info>
                                <name>张三</name>
                                <price>5000</price>
                                <checkout>1</checkout>
                            </other_fee_info>
                        </other_fee_infos>
                    </other_fee_detail>
                    <daily_room_fee>
                        <daily_prices>
                            <daily_price>
                                <checkout>1</checkout>
                                <price>50000</price>
                                <date>2017-01-01 00:00:00</date>
                            </daily_price>
                        </daily_prices>
                    </daily_room_fee>
                </order_bill_info>
            </results>
            <error_msg>操作失败</error_msg>
            <error_code>0</error_code>
            <success>false</success>
        </result>
    </xhotel_pms_guestbill_get_vtwo_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

    返回
    顶部