文档中心 > API类目 > 酒店交易API

taobao.xhotel.order.distribution.detail (飞猪酒店分销订单详请接口)

飞猪酒店分销订单详请接口

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
order_base_req OrderBaseReq 必须 订单详情请求参数
  • └ dis_order_id
  • String
  • 可选
  • 1564651
  • 外部订单id,飞猪订单号与外部订单号不能都为空
  • └ distributor
  • String
  • 必须
  • hello
  • 分销渠道
  • └ fliggy_order_id
  • Number
  • 可选
  • 3037649439744395500
  • 飞猪订单id,飞猪订单号与外部订单号不能都为空

响应参数

名称 类型 示例值 描述
error_msg String 订单查询失败 错误信息
result OrderInfoDetail 订单详情数据
  • order_base_info
  • OrderBaseInfo
  • 订单基础信息
  • └ fliggy_order_id
  • Number
  • 3037649439744395500
  • 飞猪订单号
  • └ dis_order_id
  • String
  • 456123156
  • 分销渠道的外部订单号
  • └ order_status
  • Number
  • 1
  • 订单状态
  • └ order_status_desc
  • String
  • 未付款
  • 订单状态描述
  • └ order_create_date
  • Date
  • 2020-01-01 00:00:00
  • 订单创建时间
  • └ contact_name
  • String
  • 言五
  • 订单联系人姓名
  • └ contact_phone
  • String
  • 13000000000
  • 订单联系人电话
  • daily_info_list
  • DailyInfo []
  • 每日价格信息
  • └ date
  • Date
  • 2022-11-17 00:00:00
  • 日期
  • └ price
  • Number
  • 82000
  • 房费(包含税费)
  • └ foreign_price
  • Number
  • 245
  • 外币价格
  • └ cny_price
  • Number
  • 82000
  • 房费价格,不区分币种
  • └ discount_fee
  • Number
  • 1000
  • 卖家优惠的金额,单位:分
  • └ platform_promotion_amt
  • Number
  • 1000
  • 平台优惠的金额,单位:分
  • └ total_actual_price
  • Number
  • 80000
  • 实际支付金额,单位:分
  • └ total_room_price
  • Number
  • 82000
  • 总房费,单位:分
  • └ currency_rate
  • String
  • 6.23
  • 商品币种汇率
  • └ settle_currency_code
  • String
  • 6.23
  • 结算币种
  • └ buyer_real_refund
  • Number
  • 82000
  • 买家实退金额,当退款未成功时,为空,单位:分
  • └ hour_room
  • Boolean
  • false
  • 是否小时房
  • └ supplier
  • String
  • taobao
  • 供应商
  • └ is_checked_in
  • Boolean
  • false
  • 是否已入住
  • └ free_cancel_time_in_n_min
  • Date
  • 2020-01-01 00:00:00
  • 免费退时间,不命中N分钟免费退时为空
  • order_fulfill_info
  • OrderFulfillInfo
  • 订单履约信息
  • └ late_arrive_time
  • Date
  • 2022-11-17 00:00:00
  • 最晚到店时间,可能为空
  • └ check_in
  • Date
  • 2022-11-17 00:00:00
  • 入住时间
  • └ check_out
  • Date
  • 2022-11-18 00:00:00
  • 离店时间
  • order_guest_list
  • HotelOrderGuest []
  • 入住人信息
  • └ name
  • String
  • 言五
  • 入住人姓名
  • └ room_number
  • Number
  • 1
  • 房间数
  • └ nights
  • Number
  • 1
  • 晚数
  • └ invoice_status
  • Number
  • 1
  • 发票状态
  • └ invoice_status_desc
  • String
  • 待开票
  • 发票状态描述
  • └ check_in_time
  • String
  • 15:00
  • 小时房 已选入住时间
  • └ check_out_time
  • String
  • 18:00
  • 小时房 已选离店时间
  • └ hourage
  • String
  • 3
  • 连住时长
  • └ out_confirm_code
  • String
  • 165416
  • 外部确认号
  • member_right_do
  • MemberRightDO
  • 会员权益信息
  • └ fzlm_compensate_for_expensiveness
  • Boolean
  • false
  • 能否享受菲住联盟贵必赔权益
  • room_info
  • OrderFulfillInfo
  • 房间信息
  • └ room_name
  • String
  • 大床房
  • 房型名称
  • └ room_facility
  • String []
  • 酒店房间设施,Example:["含双早","双床1.35米","有窗"]
  • hotel_info
  • RoomInfo
  • 酒店信息
  • └ hotel_name
  • String
  • 酒店名称
  • 测试酒店
  • └ shid
  • Number
  • 156465
  • 飞猪标准酒店id
  • └ seller_id
  • Number
  • 156165
  • 酒店卖家id
  • └ hotel_address
  • String
  • 酒店测试地址
  • 酒店地址
  • └ hotel_tel
  • String
  • +86-566-2083333
  • 酒店联系电话
  • └ longitude
  • String
  • 11.11
  • 经度
  • └ latitude
  • String
  • 11.11
  • 纬度
  • └ order_xitem_info
  • String
  • 酒+X
  • 酒+X信息
error_resp_code Number 301 错误码
code4_dev String 301 提供给开发的错误码
msg_for_dev String Test error 提供给开发的错误信息
is_success Boolean true 是否请求成功

请求示例

  • JAVA
  • .NET
  • PHP
  • CURL
  • Python
  • C/C++
  • NodeJS
TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
XhotelOrderDistributionDetailRequest req = new XhotelOrderDistributionDetailRequest();
XhotelOrderDistributionDetailRequest.OrderBaseReq obj1 = new XhotelOrderDistributionDetailRequest.OrderBaseReq();
obj1.setDisOrderId("1564651");
obj1.setDistributor("hello");
obj1.setFliggyOrderId(3037649439744395500L);
req.setOrderBaseReq(obj1);
XhotelOrderDistributionDetailResponse rsp = client.execute(req);
System.out.println(rsp.getBody());

响应示例

  • XML示例
  • JSON示例
<xhotel_order_distribution_detail_response>
    <error_msg>订单查询失败</error_msg>
    <result>
        <order_base_info>
            <fliggy_order_id>3037649439744395500</fliggy_order_id>
            <dis_order_id>456123156</dis_order_id>
            <order_status>1</order_status>
            <order_status_desc>未付款</order_status_desc>
            <order_create_date>2020-01-01 00:00:00</order_create_date>
            <contact_name>言五</contact_name>
            <contact_phone>13000000000</contact_phone>
            <daily_info_list>
                <daily_info>
                    <date>2022-11-17 00:00:00</date>
                    <price>82000</price>
                    <foreign_price>245</foreign_price>
                    <cny_price>82000</cny_price>
                </daily_info>
            </daily_info_list>
            <discount_fee>1000</discount_fee>
            <platform_promotion_amt>1000</platform_promotion_amt>
            <total_actual_price>80000</total_actual_price>
            <total_room_price>82000</total_room_price>
            <currency_rate>6.23</currency_rate>
            <settle_currency_code>6.23</settle_currency_code>
            <buyer_real_refund>82000</buyer_real_refund>
            <hour_room>false</hour_room>
            <supplier>taobao</supplier>
            <is_checked_in>false</is_checked_in>
            <free_cancel_time_in_n_min>2020-01-01 00:00:00</free_cancel_time_in_n_min>
        </order_base_info>
        <order_fulfill_info>
            <late_arrive_time>2022-11-17 00:00:00</late_arrive_time>
            <check_in>2022-11-17 00:00:00</check_in>
            <check_out>2022-11-18 00:00:00</check_out>
            <order_guest_list>
                <hotel_order_guest>
                    <name>言五</name>
                </hotel_order_guest>
            </order_guest_list>
            <room_number>1</room_number>
            <nights>1</nights>
            <invoice_status>1</invoice_status>
            <invoice_status_desc>待开票</invoice_status_desc>
            <check_in_time>15:00</check_in_time>
            <check_out_time>18:00</check_out_time>
            <hourage>3</hourage>
            <out_confirm_code>165416</out_confirm_code>
            <member_right_do>
                <fzlm_compensate_for_expensiveness>false</fzlm_compensate_for_expensiveness>
            </member_right_do>
        </order_fulfill_info>
        <room_info>
            <room_name>大床房</room_name>
        </room_info>
        <hotel_info>
            <hotel_name>酒店名称</hotel_name>
            <shid>156465</shid>
            <seller_id>156165</seller_id>
            <hotel_address>酒店测试地址</hotel_address>
            <hotel_tel>+86-566-2083333</hotel_tel>
            <longitude>11.11</longitude>
            <latitude>11.11</latitude>
        </hotel_info>
        <order_xitem_info>酒+X</order_xitem_info>
    </result>
    <error_resp_code>301</error_resp_code>
    <code4_dev>301</code4_dev>
    <msg_for_dev>Test error</msg_for_dev>
    <is_success>true</is_success>
</xhotel_order_distribution_detail_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

返回
顶部