淘宝开放平台

登录
文档中心 > API类目 > 阿信-基础数据

阿信-基础数据

taobao.alitrip.travel.axin.hotel.price.batch.get (阿信酒店批量报价查询接口)

阿信酒店批量报价查询接口

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
hotel_list HotelDTO 可选 酒店列表
  • └ shid
  • Number
  • 可选
  • 11
  • 标准酒店id
  • └ city_code
  • Number
  • 可选
  • 33
  • 城市code
end_date Date 可选 2021-11-07 00:00:00 结束时间，不包含
distributor_tid Number 可选 1 分销商id
start_date Date 可选 2021-11-01 00:00:00 开始时间，包含
resource_channel String 可选 F_HOTEL 资源渠道

响应参数

名称 类型 示例值 描述
result BaseResultApiDTO 接口返回model
  • data
  • HotelPriceBatchResultDTO
  • 批量报价结果
  • hotel_price_dto_list
  • HotelPriceBatchDTO []
  • 酒店的报价结果列表
  • └ success
  • Boolean
  • true
  • 当前酒店查询是否成功
  • └ error_code
  • String
  • "timeout"
  • 当前酒店查询异常code
  • └ error_msg
  • String
  • "查询超时"
  • 当前酒店查询异常信息
  • └ shid
  • Number
  • 13434
  • 当前酒店id
  • room_list
  • RoomPriceDTO []
  • 房型列表，里面包含了rate信息列有
  • std_room_info
  • StdRoomType
  • 房型信息
  • └ srid
  • String
  • 11
  • 房型id
  • └ name
  • String
  • 标准房
  • 房型名称
  • └ floor
  • String
  • 5
  • 楼层
  • └ network_service
  • String
  • 0
  • 宽带服务"0","有线上网(免费), "1","有线上网(无)", "2","有线上网(收费)", "3","有线上网(部分有且免费)", "4","有线上网(部分有且收费)"
  • └ facility
  • String
  • 无
  • 设施
  • └ max_occupancy
  • Number
  • 1
  • 最大入住人数
  • └ area
  • String
  • 12平米
  • 面积
  • └ window_type
  • String
  • 1
  • 窗型0, 无窗,1, 有窗;
  • └ bed_type
  • String
  • 双人床
  • 床型
  • └ bed_type_desc
  • String
  • 1张双人床
  • 床型描述
  • rate_list
  • RateDTO []
  • rate信息列表
  • └ modified_time
  • Number
  • 1640275200000
  • 当前rate修改时间，精确到毫秒
  • price_stock_dto_list
  • PriceStockDTO []
  • 价库日历
  • └ date
  • Number
  • 1640275200000
  • 当前价库日期
  • └ price
  • Number
  • 3000
  • 价格(单位分)
  • └ quota
  • Number
  • 1
  • 库存
  • └ promotion_price
  • Number
  • 1000
  • 优惠金额（单位分）
  • └ rate_switch
  • Number
  • 0
  • 当前房态是否正常,0-关房,1-正常；1的情况下要看下库存是否足够
  • └ start_date
  • Number
  • 1640275200000
  • 入住日期
  • └ end_date
  • Number
  • 1640275200000
  • 离店日期
  • └ cny_price
  • Number
  • 100
  • 人民币金额（国际外币场景使用）
  • break_fast_list
  • BreakfastDTO []
  • 早餐信息列表
  • └ breakfast
  • String
  • 双早
  • 是否含早餐
  • └ breakfast_count
  • Number
  • 1
  • 早餐数量
  • └ start_date
  • Number
  • 1640275200000
  • 规则生效开始时间
  • └ end_date
  • Number
  • 1640361600000
  • 规则生效结束时间(不包含)
  • cancel_rule_list
  • CancelPolicyRuleDTO []
  • 取消规则列表
  • └ cancel_policy_desc
  • String
  • 免费取消
  • 取消政策描述
  • └ cancel_type
  • Number
  • 4
  • 取消政策类型
  • cancel_policy_detail_list
  • CancelPolicyDetailDTO []
  • 取消政策明细列表
  • └ deduct_fee_rate
  • Number
  • 30
  • 扣除值
  • └ ahead_cancel_hours
  • Number
  • 1
  • 往前推几小时能取消
  • └ start_date
  • Number
  • 1640275200000
  • 规则生效开始时间
  • └ end_date
  • Number
  • 1640361600000
  • 规则生效结束时间
  • └ currency_code
  • String
  • CNY
  • 币种
  • └ rate_id
  • Number
  • 11
  • rateId
  • └ item_id
  • Number
  • 1
  • 商品id
  • └ rate_plan_id
  • Number
  • 1
  • 售卖政策id
  • └ rate_plan_name
  • String
  • 含早可取消
  • 售卖政策名称
  • └ resource_tag
  • String
  • A
  • 资源标签
  • └ commission_fee_rate
  • String
  • 0
  • 佣金费率
  • └ seller_id
  • Number
  • 1
  • 卖家id
  • └ end_time_daily
  • String
  • 16:00
  • 每日截止时间
  • └ instant_confirm
  • String
  • true
  • 是否即时确认
  • └ min_adv_hours
  • Number
  • 2
  • 最小提前小时数
  • └ multiple_price
  • Boolean
  • false
  • 是否复杂价格
  • └ rate_plan_name_en
  • String
  • 价格计划英文名
  • 价格计划英文名
  • └ start_time_daily
  • String
  • 18:00
  • 每日开始时间
  • └ max_adv_hours
  • Number
  • 8
  • 最大提前小时数
  • └ min_stay
  • Number
  • 1
  • 最小入住天数
  • └ max_stay
  • Number
  • 2
  • 最大入住天数
  • └ min_book_count
  • Number
  • 1
  • 最小预订间数
  • └ max_book_count
  • Number
  • 1
  • 最大预订间数
  • └ nod
  • Number
  • 1
  • 连住天数,适用于复杂价格
  • └ nop
  • Number
  • 1
  • 入住人数,适用于复杂价格
  • └ max_occupancy
  • Number
  • 2
  • 最大入住人数
  • └ distribute_mode
  • String
  • FP
  • 分销模式 FP-底价模式 SP-卖家模式
  • └ max_days
  • Number
  • 2
  • 最大连住天数
  • dawn_booking_dto
  • DawnBookingDTO
  • 凌晨房信息
  • └ can_dawn_book
  • Boolean
  • true
  • 是否支持凌晨房
  • └ dawn_book_start_time
  • String
  • 00:00:00
  • 凌晨房预订开始时间
  • └ dawn_book_end_time
  • String
  • 06:00:00
  • 凌晨房预订结束时间
  • └ min_days
  • Number
  • 1
  • 最小连住天数
  • └ hour_room
  • Boolean
  • false
  • 是否小时房,不为空且为true时标识小时房，否则全日房
  • hour_room_info
  • HourRoomInfo
  • 小时房信息
  • └ hourage
  • Number
  • 4
  • 小时房入住时长，单位小时
  • └ hour_room_check_in_start
  • String
  • 08:00
  • 小时房可入住开始时间，HH:mm格式
  • └ hour_room_check_in_end
  • String
  • 22:00
  • 小时房可入住结束时间，HH:mm格式
  • hour_room_info_dto
  • HourRoomInfoDTO
  • 小时房信息
  • └ hourage
  • Number
  • 4
  • 小时房入住时长，单位小时
  • └ hour_room_check_in_start
  • String
  • 08:00
  • 小时房可入住开始时间，HH:mm格式
  • └ hour_room_check_in_end
  • String
  • 22:00
  • 小时房可入住结束时间，HH:mm格式
  • └ invoicing_mode
  • Number
  • 1
  • 1-订单金额酒店开票，分销商开返佣发票 2-订单金额阿信开票，分销商不开票 3-订单金额无票，分销商开返佣发票
  • └ success
  • Boolean
  • true
  • 是否成功,true正常,false异常
  • └ error_code
  • String
  • "isv.invalid-parameter"
  • 错误code
  • └ error_msg
  • String
  • "参数错误"
  • 错误信息

请求示例

  • JAVA
  • .NET
  • PHP
  • CURL
  • Python
  • C/C++
  • NodeJS
1
2
3
4
5
6
7
8
9
10
11
12
TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
AlitripTravelAxinHotelPriceBatchGetRequest req = new AlitripTravelAxinHotelPriceBatchGetRequest();
AlitripTravelAxinHotelPriceBatchGetRequest.HotelDTO obj1 = new AlitripTravelAxinHotelPriceBatchGetRequest.HotelDTO();
obj1.setShid(11L);
obj1.setCityCode(33L);
req.setHotelList(obj1);
req.setEndDate(StringUtils.parseDateTime("2021-11-07 00:00:00"));
req.setDistributorTid(1L);
req.setStartDate(StringUtils.parseDateTime("2021-11-01 00:00:00"));
req.setResourceChannel("F_HOTEL");
AlitripTravelAxinHotelPriceBatchGetResponse rsp = client.execute(req, sessionKey);
System.out.println(rsp.getBody());

响应示例

  • XML示例
  • JSON示例
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
<alitrip_travel_axin_hotel_price_batch_get_response>
    <result>
        <data>
            <hotel_price_dto_list>
                <hotel_price_batch_d_t_o>
                    <success>true</success>
                    <error_code>&quot;timeout&quot;</error_code>
                    <error_msg>&quot;查询超时&quot;</error_msg>
                    <shid>13434</shid>
                    <room_list>
                        <room_price_d_t_o>
                            <std_room_info>
                                <srid>11</srid>
                                <name>标准房</name>
                                <floor>5</floor>
                                <network_service>0</network_service>
                                <facility>无</facility>
                                <max_occupancy>1</max_occupancy>
                                <area>12平米</area>
                                <window_type>1</window_type>
                                <bed_type>双人床</bed_type>
                                <bed_type_desc>1张双人床</bed_type_desc>
                            </std_room_info>
                            <rate_list>
                                <rate_d_t_o>
                                    <modified_time>1640275200000</modified_time>
                                    <price_stock_dto_list>
                                        <price_stock_d_t_o>
                                            <date>1640275200000</date>
                                            <price>3000</price>
                                            <quota>1</quota>
                                            <promotion_price>1000</promotion_price>
                                            <rate_switch>0</rate_switch>
                                            <start_date>1640275200000</start_date>
                                            <end_date>1640275200000</end_date>
                                            <cny_price>100</cny_price>
                                        </price_stock_d_t_o>
                                    </price_stock_dto_list>
                                    <break_fast_list>
                                        <breakfast_d_t_o>
                                            <breakfast>双早</breakfast>
                                            <breakfast_count>1</breakfast_count>
                                            <start_date>1640275200000</start_date>
                                            <end_date>1640361600000</end_date>
                                        </breakfast_d_t_o>
                                    </break_fast_list>
                                    <cancel_rule_list>
                                        <cancel_policy_rule_d_t_o>
                                            <cancel_policy_desc>免费取消</cancel_policy_desc>
                                            <cancel_type>4</cancel_type>
                                            <cancel_policy_detail_list>
                                                <cancel_policy_detail_d_t_o>
                                                    <deduct_fee_rate>30</deduct_fee_rate>
                                                    <ahead_cancel_hours>1</ahead_cancel_hours>
                                                </cancel_policy_detail_d_t_o>
                                            </cancel_policy_detail_list>
                                            <start_date>1640275200000</start_date>
                                            <end_date>1640361600000</end_date>
                                        </cancel_policy_rule_d_t_o>
                                    </cancel_rule_list>
                                    <currency_code>CNY</currency_code>
                                    <rate_id>11</rate_id>
                                    <item_id>1</item_id>
                                    <rate_plan_id>1</rate_plan_id>
                                    <rate_plan_name>含早可取消</rate_plan_name>
                                    <resource_tag>A</resource_tag>
                                    <commission_fee_rate>0</commission_fee_rate>
                                    <seller_id>1</seller_id>
                                    <end_time_daily>16:00</end_time_daily>
                                    <instant_confirm>true</instant_confirm>
                                    <min_adv_hours>2</min_adv_hours>
                                    <multiple_price>false</multiple_price>
                                    <rate_plan_name_en>价格计划英文名</rate_plan_name_en>
                                    <start_time_daily>18:00</start_time_daily>
                                    <max_adv_hours>8</max_adv_hours>
                                    <min_stay>1</min_stay>
                                    <max_stay>2</max_stay>
                                    <min_book_count>1</min_book_count>
                                    <max_book_count>1</max_book_count>
                                    <nod>1</nod>
                                    <nop>1</nop>
                                    <max_occupancy>2</max_occupancy>
                                    <distribute_mode>FP</distribute_mode>
                                    <max_days>2</max_days>
                                    <dawn_booking_dto>
                                        <can_dawn_book>true</can_dawn_book>
                                        <dawn_book_start_time>00:00:00</dawn_book_start_time>
                                        <dawn_book_end_time>06:00:00</dawn_book_end_time>
                                    </dawn_booking_dto>
                                    <min_days>1</min_days>
                                    <hour_room>false</hour_room>
                                    <hour_room_info>
                                        <hourage>4</hourage>
                                        <hour_room_check_in_start>08:00</hour_room_check_in_start>
                                        <hour_room_check_in_end>22:00</hour_room_check_in_end>
                                    </hour_room_info>
                                    <hour_room_info_dto>
                                        <hourage>4</hourage>
                                        <hour_room_check_in_start>08:00</hour_room_check_in_start>
                                        <hour_room_check_in_end>22:00</hour_room_check_in_end>
                                    </hour_room_info_dto>
                                    <invoicing_mode>1</invoicing_mode>
                                </rate_d_t_o>
                            </rate_list>
                        </room_price_d_t_o>
                    </room_list>
                </hotel_price_batch_d_t_o>
            </hotel_price_dto_list>
        </data>
        <success>true</success>
        <error_code>&quot;isv.invalid-parameter&quot;</error_code>
        <error_msg>&quot;参数错误&quot;</error_msg>
    </result>
</alitrip_travel_axin_hotel_price_batch_get_response>

异常示例

  • XML示例
  • JSON示例
1
2
3
4
5
6
<error_response>
    <code>50</code>
    <msg>Remote service error</msg>
    <sub_code>isv.invalid-parameter</sub_code>
    <sub_msg>非法参数</sub_msg>
</error_response>

错误码解释

错误码 错误描述 解决方案
isp.SYS_ERROR 系统异常 重试

API工具

API测试工具 错误码查询工具 SDK下载

如何获得此API

FAQ

我要提问
返回
顶部