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

taobao.xhotel.order.distribution.validate (飞猪酒店分销验价接口)

飞猪酒店分销验价接口

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
validate_req ValidateReq 必须 验价接口请求参数
  • └ rate_plan_id
  • Number
  • 必须
  • 32213123434
  • 售卖政策id
  • └ ext_params
  • String
  • 可选
  • {}
  • 扩展字段
  • └ number_of_rooms
  • Number
  • 必须
  • 2
  • 房间数
  • └ distributor
  • String
  • 必须
  • hello
  • 分销渠道
  • └ intention
  • String
  • 可选
  • render/create/change
  • 请求用途
  • └ number_of_adults_per_room
  • Number
  • 必须
  • 2
  • 每间房的成人数,默认写2人
  • └ item_id
  • Number
  • 必须
  • 433233252
  • 商品id
  • └ search_promotion_amount
  • Number
  • 可选
  • 1000
  • 报价接口的优惠金额(单位分)
  • └ check_in
  • Date
  • 必须
  • 2022-11-15 15:00:00
  • 入住日期
  • └ check_out
  • Date
  • 必须
  • 2022-11-16 14:00:00
  • 离店日期
  • └ search_room_price
  • Number
  • 可选
  • 10000
  • 报价接口的优惠前价格
  • └ user_uniq_key
  • Number
  • 可选
  • 123456
  • 外部渠道用户唯一标识
  • └ search_after_promotion_price
  • Number
  • 可选
  • 9000
  • 报价接口的优惠后价格(单位分)

响应参数

名称 类型 示例值 描述
error_msg String 系统异常,请稍后重试 错误信息
result ValidateResp 结果体,范型对象
  • └ create_key
  • String
  • 1668515755548_210451ea16685157543063960e2d5f_109eca19d39e4caa8464d2792e7d0cb8
  • 创单需要传入的参数
  • └ rate_plan_id
  • Number
  • 32213123434
  • 售卖政策id
  • └ seller_id
  • Number
  • 2204103009000
  • 卖家id
  • └ hid
  • Number
  • 306424009000
  • 卖家酒店id
  • rate_plan_info
  • RatePlanInfo
  • 售卖政策具体信息
  • └ display_name
  • String
  • 无早-任意退【测试测试】
  • rp展示名称
  • └ total_room_price
  • Number
  • 10000
  • 总房价(单位:分)
  • rate_units
  • RateUnit []
  • 每间房rate信息
  • └ rate_key
  • String
  • dfer34234234232
  • 最小售卖单元唯一key
  • daily_price_info_list
  • DailyPriceInfo []
  • 每日价格信息
  • └ date
  • String
  • 2022-11-15
  • 入住日期
  • └ cny_price
  • Number
  • 10000
  • 房间价格(单位:分)
  • board_do
  • BoardDO
  • 餐食信息
  • └ board_type
  • Number
  • 0
  • 早餐种类:0 无早;1 早餐;2 三餐
  • └ board_num
  • Number
  • 2
  • 餐食数量
  • └ max_booking_num
  • Number
  • 2
  • 最大可预订房间数
  • └ max_occupancy_num
  • Number
  • 2
  • 每间房最大可入住人数
  • └ max_inventory
  • Number
  • 15
  • 最大库存量
  • └ earliest_check_in_time
  • String
  • 12:00
  • 最早可以办理入住时间
  • └ latest_check_out_time
  • String
  • 14:00
  • 最晚离店时间
  • cancel_policy_do
  • CancelPolicyDO
  • 取消政策
  • └ cancel_policy_type
  • Number
  • 1
  • 取消政策类型:1.免费取消; 2.不可取消; 5.限时免费取消(从入住时间前推); 6.提前多少小时退款扣取几晚房费; 9.阶梯收费取消(从入住时间前推小时前退订扣款金额)
  • policy_info
  • CancelPolicyInfoDO []
  • 取消政策规则
  • └ hour
  • Number
  • 48
  • 提前x小时
  • └ value
  • Number
  • 1
  • 规则对应的值,可能是百分比、数值等
  • └ bed_desc
  • String
  • 双床
  • 床型描述
  • └ base_price_rate
  • Boolean
  • true
  • 是否底价商品
  • └ after_promotion_price
  • Number
  • 100
  • 优惠后金额 = 总房价 - 优惠总金额
  • hotel_promotion_do
  • HotelPromotionDO
  • 优惠具体信息
  • └ promotion_existed
  • Boolean
  • true
  • 是否存在优惠
  • └ promotion_total_price
  • Number
  • 1000
  • 优惠总金额
  • promotion_detail_do_list
  • HotelPromotionDetailDO []
  • 优惠明细
  • └ promotion_name
  • String
  • 百亿补贴
  • 优惠名称
  • └ promotion_price
  • Number
  • 1000
  • 优惠金额
  • └ promotion_type
  • Number
  • 1
  • 优惠类型, 1=百亿补贴, 2=贵必赔
  • └ promotion_id
  • String
  • 1
  • 优惠唯一标识
  • invoice_config_do
  • InvoiceConfigDO
  • 发票规则
  • └ can_invoice
  • Number
  • 1
  • 能否开发票,1:能、0:不能
  • └ invoice_provider
  • Number
  • 1
  • 发票提供方,1:酒店前台,2:卖家
  • └ postage_provider
  • Number
  • 0
  • 邮费提供方,0:未设置 1:卖家承担,2:买家承担(邮费到付),3:卖家承担(邮费¥XX)
  • └ invoice_type
  • String
  • 旅游费
  • 开票用途分类,中间用逗号分隔,代订房费,旅游费,差旅费,其他
  • └ invoice_other_desc
  • String
  • 其他类型
  • 发票描述,可开票类型选择"其他"时填写的内容
  • └ memo
  • String
  • 需发票的客户请联系客服告之开票信息。发票由杭州诗遥开具的代订房费增值税发票
  • 发票规则的补充说明
  • └ support_invoice_type
  • String []
  • 支持的发票类型列表:-1:未知,0:增值税普通发票(纸质),1:增值税专用发票(纸质),2:增值税普通发票(电子),3:海外收据,21:增值税普通发票(电子/商家自主开票)
  • └ order_xitem_info
  • String
  • [{"amount":1,"dimensionType":1,"entityId":11141830545007,"hid":21345033007,"status":1,"supplierId":263682007,"xProductDO":{"buffet":false,"category":{"ageLimit":0,"mainCategory":"60000_1","mainCategoryDesc":"娱乐休闲","priority":5,"showType":6,"subCategory":"60000_300","subCategoryDesc":"滑冰 / 滑雪"},"name":"核心元素滑雪套餐一份","playingRule":{"category":"休闲娱乐","linearDistance":"100","skiingAndSkating":{"freeDeposit":1,"freeSkiEquipment":"免费雪服","hasDiningRoom":1,"hasEvening":1,"hasSuperiorTrack":1,"indoorOrOutdoor":0}},"poi":"杭州市","priceValue":{"currencyCode":"CNY","price":"500","sellingPrice":"400","valueCertificatePic":[]},"saleType":1,"supplySubProductAmount":0,"useRule":{"acquireType":1,"additionalReminder":"这是一个滑雪项目测试测试测试这是一个滑雪项目测试测试测试这是一个滑雪项目测试测试测试这是一个滑雪项目测试测试测试这是一个滑雪项目测试测试测试这是一个滑雪项目测试测试测试这是一个滑雪项目测试测试测试这是一个滑雪项目测试测试测试","adultAmount":1,"bookingMinAmount":1,"bookingRule":1,"bookingUnit":"2","childAge":"16","childHeight":"150","contactNumber":"18336342376","effectiveType":0,"receptionTime":[{"endTime":"11:00","startTime":"09:00"},{"endTime":"14:00","startTime":"13:00"}]},"xSubProducts":[]},"xitemId":39001007},{"amount":1,"childAmount":1,"dimensionType":2,"entityId":11141830545007,"hid":21345033007,"status":1,"supplierId":263682007,"xProductDO":{"buffet":false,"category":{"ageLimit":1,"mainCategory":"10000_1","mainCategoryDesc":"餐饮","priority":4,"showType":1,"subCategory":"10000_300","subCategoryDesc":"下午茶"},"name":"核心测试下午茶","playingRule":{"category":"西餐"},"poi":"浙江名包","priceValue":{"currencyCode":"CNY","price":"1100","sellingPrice":"1100","valueCertificatePic":[]},"saleType":1,"supplySubProductAmount":0,"useRule":{"adultAmount":1,"bookingRule":0,"bookingUnit":"null","childAge":"1","childHeight":"80","effectiveType":0,"mealUsage":"0","receptionTime":[{"endTime":"03:03","startTime":"01:01"}]},"xSubProducts":[]},"xitemId":93455003007}]
  • 酒+X信息
error_resp_code Number 105 错误码
msg_for_dev String 奥创解析错误 开发查看的错误信息
is_success Boolean true 请求是否成功
attribute Json {} 用于获取trace,排查问题使用

请求示例

  • JAVA
  • .NET
  • PHP
  • CURL
  • Python
  • C/C++
  • NodeJS
TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
XhotelOrderDistributionValidateRequest req = new XhotelOrderDistributionValidateRequest();
XhotelOrderDistributionValidateRequest.ValidateReq obj1 = new XhotelOrderDistributionValidateRequest.ValidateReq();
obj1.setRatePlanId(32213123434L);
obj1.setExtParams("{}");
obj1.setNumberOfRooms(2L);
obj1.setDistributor("hello");
obj1.setIntention("render/create/change");
obj1.setNumberOfAdultsPerRoom(2L);
obj1.setItemId(433233252L);
obj1.setSearchPromotionAmount(1000L);
obj1.setCheckIn(StringUtils.parseDateTime("2022-11-15 15:00:00"));
obj1.setCheckOut(StringUtils.parseDateTime("2022-11-16 14:00:00"));
obj1.setSearchRoomPrice(10000L);
obj1.setUserUniqKey(123456L);
obj1.setSearchAfterPromotionPrice(9000L);
req.setValidateReq(obj1);
XhotelOrderDistributionValidateResponse rsp = client.execute(req);
System.out.println(rsp.getBody());

响应示例

  • XML示例
  • JSON示例
<xhotel_order_distribution_validate_response>
    <error_msg>系统异常,请稍后重试</error_msg>
    <result>
        <create_key>1668515755548_210451ea16685157543063960e2d5f_109eca19d39e4caa8464d2792e7d0cb8</create_key>
        <rate_plan_id>32213123434</rate_plan_id>
        <seller_id>2204103009000</seller_id>
        <hid>306424009000</hid>
        <rate_plan_info>
            <display_name>无早-任意退【测试测试】</display_name>
            <total_room_price>10000</total_room_price>
            <rate_units>
                <rate_unit>
                    <rate_key>dfer34234234232</rate_key>
                    <daily_price_info_list>
                        <daily_price_info>
                            <date>2022-11-15</date>
                            <cny_price>10000</cny_price>
                            <board_do>
                                <board_type>0</board_type>
                                <board_num>2</board_num>
                            </board_do>
                        </daily_price_info>
                    </daily_price_info_list>
                </rate_unit>
            </rate_units>
            <max_booking_num>2</max_booking_num>
            <max_occupancy_num>2</max_occupancy_num>
            <max_inventory>15</max_inventory>
            <earliest_check_in_time>12:00</earliest_check_in_time>
            <latest_check_out_time>14:00</latest_check_out_time>
            <cancel_policy_do>
                <cancel_policy_type>1</cancel_policy_type>
                <policy_info>
                    <cancel_policy_info_d_o>
                        <hour>48</hour>
                        <value>1</value>
                    </cancel_policy_info_d_o>
                </policy_info>
            </cancel_policy_do>
            <bed_desc>双床</bed_desc>
            <base_price_rate>true</base_price_rate>
            <after_promotion_price>100</after_promotion_price>
        </rate_plan_info>
        <hotel_promotion_do>
            <promotion_existed>true</promotion_existed>
            <promotion_total_price>1000</promotion_total_price>
            <promotion_detail_do_list>
                <hotel_promotion_detail_d_o>
                    <promotion_name>百亿补贴</promotion_name>
                    <promotion_price>1000</promotion_price>
                    <promotion_type>1</promotion_type>
                    <promotion_id>1</promotion_id>
                </hotel_promotion_detail_d_o>
            </promotion_detail_do_list>
        </hotel_promotion_do>
        <invoice_config_do>
            <can_invoice>1</can_invoice>
            <invoice_provider>1</invoice_provider>
            <postage_provider>0</postage_provider>
            <invoice_type>旅游费</invoice_type>
            <invoice_other_desc>其他类型</invoice_other_desc>
            <memo>需发票的客户请联系客服告之开票信息。发票由杭州诗遥开具的代订房费增值税发票</memo>
        </invoice_config_do>
        <order_xitem_info>[{&quot;amount&quot;:1,&quot;dimensionType&quot;:1,&quot;entityId&quot;:11141830545007,&quot;hid&quot;:21345033007,&quot;status&quot;:1,&quot;supplierId&quot;:263682007,&quot;xProductDO&quot;:{&quot;buffet&quot;:false,&quot;category&quot;:{&quot;ageLimit&quot;:0,&quot;mainCategory&quot;:&quot;60000_1&quot;,&quot;mainCategoryDesc&quot;:&quot;娱乐休闲&quot;,&quot;priority&quot;:5,&quot;showType&quot;:6,&quot;subCategory&quot;:&quot;60000_300&quot;,&quot;subCategoryDesc&quot;:&quot;滑冰 / 滑雪&quot;},&quot;name&quot;:&quot;核心元素滑雪套餐一份&quot;,&quot;playingRule&quot;:{&quot;category&quot;:&quot;休闲娱乐&quot;,&quot;linearDistance&quot;:&quot;100&quot;,&quot;skiingAndSkating&quot;:{&quot;freeDeposit&quot;:1,&quot;freeSkiEquipment&quot;:&quot;免费雪服&quot;,&quot;hasDiningRoom&quot;:1,&quot;hasEvening&quot;:1,&quot;hasSuperiorTrack&quot;:1,&quot;indoorOrOutdoor&quot;:0}},&quot;poi&quot;:&quot;杭州市&quot;,&quot;priceValue&quot;:{&quot;currencyCode&quot;:&quot;CNY&quot;,&quot;price&quot;:&quot;500&quot;,&quot;sellingPrice&quot;:&quot;400&quot;,&quot;valueCertificatePic&quot;:[]},&quot;saleType&quot;:1,&quot;supplySubProductAmount&quot;:0,&quot;useRule&quot;:{&quot;acquireType&quot;:1,&quot;additionalReminder&quot;:&quot;这是一个滑雪项目测试测试测试这是一个滑雪项目测试测试测试这是一个滑雪项目测试测试测试这是一个滑雪项目测试测试测试这是一个滑雪项目测试测试测试这是一个滑雪项目测试测试测试这是一个滑雪项目测试测试测试这是一个滑雪项目测试测试测试&quot;,&quot;adultAmount&quot;:1,&quot;bookingMinAmount&quot;:1,&quot;bookingRule&quot;:1,&quot;bookingUnit&quot;:&quot;2&quot;,&quot;childAge&quot;:&quot;16&quot;,&quot;childHeight&quot;:&quot;150&quot;,&quot;contactNumber&quot;:&quot;18336342376&quot;,&quot;effectiveType&quot;:0,&quot;receptionTime&quot;:[{&quot;endTime&quot;:&quot;11:00&quot;,&quot;startTime&quot;:&quot;09:00&quot;},{&quot;endTime&quot;:&quot;14:00&quot;,&quot;startTime&quot;:&quot;13:00&quot;}]},&quot;xSubProducts&quot;:[]},&quot;xitemId&quot;:39001007},{&quot;amount&quot;:1,&quot;childAmount&quot;:1,&quot;dimensionType&quot;:2,&quot;entityId&quot;:11141830545007,&quot;hid&quot;:21345033007,&quot;status&quot;:1,&quot;supplierId&quot;:263682007,&quot;xProductDO&quot;:{&quot;buffet&quot;:false,&quot;category&quot;:{&quot;ageLimit&quot;:1,&quot;mainCategory&quot;:&quot;10000_1&quot;,&quot;mainCategoryDesc&quot;:&quot;餐饮&quot;,&quot;priority&quot;:4,&quot;showType&quot;:1,&quot;subCategory&quot;:&quot;10000_300&quot;,&quot;subCategoryDesc&quot;:&quot;下午茶&quot;},&quot;name&quot;:&quot;核心测试下午茶&quot;,&quot;playingRule&quot;:{&quot;category&quot;:&quot;西餐&quot;},&quot;poi&quot;:&quot;浙江名包&quot;,&quot;priceValue&quot;:{&quot;currencyCode&quot;:&quot;CNY&quot;,&quot;price&quot;:&quot;1100&quot;,&quot;sellingPrice&quot;:&quot;1100&quot;,&quot;valueCertificatePic&quot;:[]},&quot;saleType&quot;:1,&quot;supplySubProductAmount&quot;:0,&quot;useRule&quot;:{&quot;adultAmount&quot;:1,&quot;bookingRule&quot;:0,&quot;bookingUnit&quot;:&quot;null&quot;,&quot;childAge&quot;:&quot;1&quot;,&quot;childHeight&quot;:&quot;80&quot;,&quot;effectiveType&quot;:0,&quot;mealUsage&quot;:&quot;0&quot;,&quot;receptionTime&quot;:[{&quot;endTime&quot;:&quot;03:03&quot;,&quot;startTime&quot;:&quot;01:01&quot;}]},&quot;xSubProducts&quot;:[]},&quot;xitemId&quot;:93455003007}]</order_xitem_info>
    </result>
    <error_resp_code>105</error_resp_code>
    <msg_for_dev>奥创解析错误</msg_for_dev>
    <is_success>true</is_success>
    <attribute>{}</attribute>
</xhotel_order_distribution_validate_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

返回
顶部