文档中心 > API类目 > 阿信-交易API

taobao.alitrip.travel.axin.hotel.order.validate (阿信酒店订单数据校验)

阿信酒店订单下单前的数据校验,包括酒店、房型、售卖政策、入离日期等参数的校验

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
distributor_tid Number 必须 123123123123 分销商id
check_in Date 必须 2021-06-02 19:17:21 入住日期
check_out Date 必须 2021-06-02 19:17:21 离店日期
shid Number 必须 100100 酒店id
srid Number 必须 101010010010 房型id
item_id Number 必须 61237812938 商品id
rate_plan_id Number 必须 10012030 rpid
room_number Number 必须 2 房间数
rate_id Number 可选 1 rate_id
total_fee Number 可选 1 总价
resource_channel String 可选 1 资源渠道
number_of_adults_per_room String 可选 1 每间房入住人数
invoke_scene String 可选 NORMAL
  • 默认值:NORMAL
  • NORMAL-正常场景,SPECIAL-特殊场景

    响应参数

    名称 类型 示例值 描述
    result BaseResultApiDTO 1 出参
    • └ error_msg
    • String
    • 参数错误
    • 错误信息
    • data
    • HotelOrderValidateRes
    • 1
    • 返回参数
    • rate_plan_info
    • RatePlanInfoApiDto
    • 1
    • 售卖政策
    • └ latest_check_out_time
    • String
    • 2021年06月03日
    • 最晚到店时间
    • └ max_booking_num
    • Number
    • 3
    • 最大订购数量
    • └ max_occupancy_num
    • Number
    • 3
    • 每间房最大可入住人数
    • rate_unit_list
    • RateUnitDto []
    • 1
    • 每间房rate信息
    • daily_price_info_list
    • DailyPriceInfoDto []
    • 1
    • 房间价格
    • └ date
    • String
    • 2021年06月03日
    • 日期
    • board
    • Board
    • 1
    • 餐食
    • └ board_type
    • Number
    • 10
    • 餐食类型
    • └ board_num
    • Number
    • 1
    • 餐食份数
    • └ cny_price
    • Number
    • 200
    • 房间价格(人民币元)
    • └ price
    • Number
    • 200
    • 原币种金额
    • cancel_policy
    • CancelPolicyDto
    • 1
    • 取消政策
    • └ cancel_policy_type
    • Number
    • 1
    • 取消政策类型
    • policy_info_list
    • CancelPolicyInfoDto []
    • 1
    • 详细规则
    • └ hour
    • Number
    • 30
    • 提前小时
    • └ value
    • Number
    • 2
    • 规则对应的值,可能是百分比、数值等
    • └ total_room_price
    • String
    • 200
    • 总房价
    • └ bed_type_desc
    • String
    • 大床
    • 床型描述
    • └ earliest_check_in_time
    • String
    • 2021年06月03日
    • 最早可以办理入住时间
    • └ max_inventory
    • Number
    • 12
    • 最大库存量
    • └ instant_confirm
    • Boolean
    • true
    • 是否即时确认
    • └ currency_code
    • String
    • CNY
    • 币种
    • └ cny_total_price
    • Number
    • 100
    • 人民币总金额
    • └ exchange_rate
    • BigDecimal
    • 0.8
    • 汇率
    • └ rp_type
    • Number
    • 1
    • 0-全日房, 1-小时房
    • arrival_time
    • ArrivalTimeDto
    • 小时房到店时间&连住时长
    • └ hourage
    • Number
    • 4
    • 连住时长
    • └ check_in_start
    • String
    • 08:00
    • 小时房可入住的最早时间
    • └ last_leave_time
    • String
    • 22:00
    • 小时房最晚离店时间
    • └ rate_plan_id
    • Number
    • 123
    • 售卖政策id
    • └ create_key
    • String
    • 123123_asodfjo
    • 创建订单需要的key
    • └ promotion_total_price
    • Number
    • 10
    • 优惠总金额,单位为分
    • └ commission_fee_rate
    • String
    • 5
    • 后返佣金费率
    • └ resource_tag
    • String
    • A
    • 资源标签
    • └ distribute_mode
    • String
    • FP
    • 分销模式 FP-底价模式 SP-卖家模式
    • └ invoicing_mode
    • Number
    • 1
    • 1-订单金额酒店开票,分销商开返佣发票 2-订单金额阿信开票,分销商不开票 3-订单金额无票,分销商开返佣发票
    • └ success
    • Boolean
    • false
    • 成功与否
    • └ error_code
    • String
    • isv.system-error
    • 错误码

    请求示例

    • JAVA
    • .NET
    • PHP
    • CURL
    • Python
    • C/C++
    • NodeJS
    TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
    AlitripTravelAxinHotelOrderValidateRequest req = new AlitripTravelAxinHotelOrderValidateRequest();
    req.setDistributorTid(123123123123L);
    req.setCheckIn(StringUtils.parseDateTime("2021-06-02 19:17:21"));
    req.setCheckOut(StringUtils.parseDateTime("2021-06-02 19:17:21"));
    req.setShid(100100L);
    req.setSrid(101010010010L);
    req.setItemId(61237812938L);
    req.setRatePlanId(10012030L);
    req.setRoomNumber(2L);
    req.setRateId(1L);
    req.setTotalFee(1L);
    req.setResourceChannel("1");
    req.setNumberOfAdultsPerRoom("1");
    req.setInvokeScene("NORMAL");
    AlitripTravelAxinHotelOrderValidateResponse rsp = client.execute(req, sessionKey);
    System.out.println(rsp.getBody());

    响应示例

    • XML示例
    • JSON示例
    <alitrip_travel_axin_hotel_order_validate_response>
        <result>
            <error_msg>参数错误</error_msg>
            <data>
                <rate_plan_info>
                    <latest_check_out_time>2021年06月03日</latest_check_out_time>
                    <max_booking_num>3</max_booking_num>
                    <max_occupancy_num>3</max_occupancy_num>
                    <rate_unit_list>
                        <rate_unit_dto>
                            <daily_price_info_list>
                                <daily_price_info_dto>
                                    <date>2021年06月03日</date>
                                    <board>
                                        <board_type>10</board_type>
                                        <board_num>1</board_num>
                                    </board>
                                    <cny_price>200</cny_price>
                                    <price>200</price>
                                </daily_price_info_dto>
                            </daily_price_info_list>
                        </rate_unit_dto>
                    </rate_unit_list>
                    <cancel_policy>
                        <cancel_policy_type>1</cancel_policy_type>
                        <policy_info_list>
                            <cancel_policy_info_dto>
                                <hour>30</hour>
                                <value>2</value>
                            </cancel_policy_info_dto>
                        </policy_info_list>
                    </cancel_policy>
                    <total_room_price>200</total_room_price>
                    <bed_type_desc>大床</bed_type_desc>
                    <earliest_check_in_time>2021年06月03日</earliest_check_in_time>
                    <max_inventory>12</max_inventory>
                    <instant_confirm>true</instant_confirm>
                    <currency_code>CNY</currency_code>
                    <cny_total_price>100</cny_total_price>
                    <exchange_rate>0.8</exchange_rate>
                    <rp_type>1</rp_type>
                    <arrival_time>
                        <hourage>4</hourage>
                        <check_in_start>08:00</check_in_start>
                        <last_leave_time>22:00</last_leave_time>
                    </arrival_time>
                </rate_plan_info>
                <rate_plan_id>123</rate_plan_id>
                <create_key>123123_asodfjo</create_key>
                <promotion_total_price>10</promotion_total_price>
                <commission_fee_rate>5</commission_fee_rate>
                <resource_tag>A</resource_tag>
                <distribute_mode>FP</distribute_mode>
                <invoicing_mode>1</invoicing_mode>
            </data>
            <success>false</success>
            <error_code>isv.system-error</error_code>
        </result>
    </alitrip_travel_axin_hotel_order_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

    返回
    顶部