文档中心 > API类目 > 飞猪推广平台

alibaba.fliggy.promote.hotel.online (四海推广者查询酒店实时价格)

四海推广者查询酒店实时价格

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
query_hotel_price_details_request QueryHotelPriceDetailsRequest 必须 数据包装类
  • └ activity_id
  • String
  • 必须
  • sht_zb_travel
  • 活动ID
  • └ promotion_position_id
  • Number
  • 必须
  • 2219172258770
  • 推广位ID
  • └ open_id
  • String
  • 必须
  • 000001
  • 开放ID
  • └ hotel_id
  • String
  • 必须
  • 78816219
  • 酒店ID
  • └ departure_date
  • String
  • 必须
  • 2025-05-13 23:59:59
  • 离店日期
  • └ promote_app_key
  • Number
  • 必须
  • 1000028
  • promoteAppKey | 媒体id | 推广平台自己生成给到渠道的
  • └ arrival_date
  • String
  • 必须
  • 2025-05-12 00:00:00
  • 住店日期

响应参数

名称 类型 示例值 描述
is_success Boolean true 是否成功
result_code String SHT_CHANNEL_SUPPLY_PARAMS_ERROR 结果码
model QueryHotelPriceDetailsResponse 数据实体返回包装类
  • └ hotel_id
  • String
  • 78816219
  • 酒店ID
  • rate_plans
  • RatePlan []
  • 价格计划列表
  • └ rate_plan_id
  • String
  • 1
  • 计划ID=产品的编号
  • └ rate_plan_name
  • String
  • 产品的名字
  • 产品名称
  • └ status
  • Boolean
  • true
  • 销售状态 true:在售 false:失效
  • └ room_id
  • String
  • 1
  • ratePlan对应的房间id
  • └ identification
  • Number
  • 1
  • 1
  • └ identification_type
  • String []
  • 1
  • 需要的证件类型,多个值标识任意一种证件类型都可以,枚举值见下: IDENTITY_CARD: 身份证 PASSPORT:护照 枚举值 身份证: IDENTITY_CARD 护照: PASSPORT
  • └ customer_type
  • String
  • DOMESTIC
  • 客人类型 All:统一价 DOMESTIC:内宾 FOREIGNER:外宾 枚举值 统一价: All 内宾: DOMESTIC 外宾: FOREIGNER
  • └ instant_confirmation
  • Boolean
  • false
  • 是否即时确定
  • └ pay_type
  • String
  • PREPAY
  • 付款类型 SELFPAY-前台现付, PREPAY-预付 枚举值 前台现付: SELFPAY 预付: PREPAY
  • └ booking_rule_ids
  • String []
  • 1
  • 对应的预订规则编号列表 多个同时满足条件默认选第一个规则
  • └ refund_rule_id
  • String []
  • 1
  • 对应退款规则编号
  • nightly_rates
  • NightlyRate []
  • 1
  • 每日价格列表
  • └ date
  • String
  • 2023-12-27
  • 当天日期
  • └ member
  • String
  • 400
  • 会员价(BigDecimal)(元) 已经通过DRR的计算可以直接显示给客人。价格为-1表示不能销售
  • └ cost
  • String
  • -1
  • 结算价 (BigDecimal)(元) 仅用于结算价模式下的预付产品可用,非结算价模式下返回-1
  • └ status
  • Boolean
  • true
  • 库存状态 表示当天库存是否可用
  • └ add_bed
  • String
  • -1
  • 加床价 (BigDecimal)(元) -1表示不能加床
  • └ basis
  • String
  • 500.0
  • 划线价 (BigDecimal)(元)
  • └ price_discount_value
  • String
  • 100.0
  • 优惠金额 (BigDecimal)(元)
  • └ breakfast
  • Number
  • 2
  • 早餐份数
  • └ promotion_type
  • Number
  • 0
  • 促销类型 0:未定义, 1:天天特价, 2:门店新客
  • └ promotion_tag
  • String
  • 促销活动名
  • 促销活动名
  • └ ota_url
  • String
  • 小程序链接
  • 小程序链接
  • └ confirm_minutes
  • Number
  • 10
  • 平均确认时长分钟数,IsInstantConfirm 为false时需传该值
  • └ supplier_source
  • String
  • 华住会
  • 供应商信息
  • invoice
  • HotelInvoice
  • 1
  • 发票类型
  • └ invoice_mode
  • Number
  • 1
  • 发票模式 1=酒店开票 2=Ota提供发票
  • └ invoice_type
  • String []
  • 支 持的发票类型列表(英文逗号分割): 1:增值税普通发票(纸质), 2:增值税专用发票(纸质), 3:增值税普通发票(电子) 枚举值 增值税普通发票(纸质): 1 增值税专用发票(纸质): 2 增值税普通发票(电子): 3
  • └ postage_provider
  • String
  • 1
  • 邮费提供方 0:未设置 1:卖家承担, 2:买家承担(邮费到付), 3:卖家承担(邮费¥XX)
  • └ invoice_purpose
  • String
  • 差旅费
  • 发票用途:中间用逗号分隔,代订房费,旅游费,差旅费,其他
  • └ refund_rule_ids
  • String []
  • 1
  • 新退款规则Ids
  • └ refund_rule_text
  • String
  • 1
  • 退改规则文本
  • rate_plan_labels
  • RatePlanLabel []
  • 1
  • 营销优惠标签({ "F2F3F4专享": "[{\"labelCategory\":\"优惠\",\"labelDesc\":\"无\",\"labelName\":\"飞猪会员价\",\"labelPriority\":1}]", "F2专享": "[{\"labelCategory\":\"优惠\",\"labelDesc\":\"无\",\"labelName\":\"飞猪会员价\",\"labelPriority\":1}]", "F3专享": "[{\"labelCategory\":\"优惠\",\"labelDesc\":\"无\",\"labelName\":\"飞猪会员价\",\"labelPriority\":1}]", "F3至F6专享": "[{\"labelCategory\":\"优惠\",\"labelDesc\":\"无\",\"labelName\":\"飞猪会员价\",\"labelPriority\":1}]", "F4专享": "[{\"labelCategory\":\"优惠\",\"labelDesc\":\"无\",\"labelName\":\"飞猪会员价\",\"labelPriority\":1}]", "F4会员体验卡": "[{\"labelCategory\":\"优惠\",\"labelDesc\":\"无\",\"labelName\":\"飞猪会员价\",\"labelPriority\":1}]", "乐享锦江价": "[{\"labelCategory\":\"优惠\",\"labelDesc\":\"无\",\"labelName\":\"飞猪会员价\",\"labelPriority\":1}]", "今夜特惠": "[{\"labelCategory\":\"优惠\",\"labelDesc\":\"无\",\"labelName\":\"今夜特惠\",\"labelPriority\":6}]", "今日特惠": "[{\"labelCategory\":\"优惠\",\"labelDesc\":\"无\",\"labelName\":\"飞猪特惠\",\"labelPriority\":4}]", "出行特惠": "[{\"labelCategory\":\"优惠\",\"labelDesc\":\"无\",\"labelName\":\"飞猪补贴\",\"labelPriority\":2}]", "千岛湖年俗节": "[{\"labelCategory\":\"优惠\",\"labelDesc\":\"无\",\"labelName\":\"飞猪补贴\",\"labelPriority\":2}]", "品牌优选": "[{\"labelCategory\":\"优惠\",\"labelDesc\":\"无\",\"labelName\":\"飞猪会员价\",\"labelPriority\":1}]", "商家优惠券": "[{\"labelCategory\":\"优惠\",\"labelDesc\":\"无\",\"labelName\":\"飞猪特惠\",\"labelPriority\":4}]", "天天特惠": "[{\"labelCategory\":\"优惠\",\"labelDesc\":\"无\",\"labelName\":\"飞猪特惠\",\"labelPriority\":4}]", "提前订更优": "[{\"labelCategory\":\"优惠\",\"labelDesc\":\"无\",\"labelName\":\"飞猪补贴\",\"labelPriority\":2}]", "提前订特惠": "[{\"labelCategory\":\"优惠\",\"labelDesc\":\"无\",\"labelName\":\"飞猪补贴\",\"labelPriority\":2}]", "提早预订享优惠价": "[{\"labelCategory\":\"优惠\",\"labelDesc\":\"无\",\"labelName\":\"飞猪补贴\",\"labelPriority\":2}]", "百亿补贴": "[{\"labelCategory\":\"优惠\",\"labelDesc\":\"无\",\"labelName\":\"飞猪补贴\",\"labelPriority\":2},{\"labelCategory\":\"优惠\",\"labelDesc\":\"无\",\"labelName\":\"百亿补贴\",\"labelPriority\":5}]", "立减": "[{\"labelCategory\":\"优惠\",\"labelDesc\":\"无\",\"labelName\":\"飞猪补贴\",\"labelPriority\":2}]", "立减10元": "[{\"labelCategory\":\"优惠\",\"labelDesc\":\"无\",\"labelName\":\"飞猪补贴\",\"labelPriority\":2}]", "立减15元券": "[{\"labelCategory\":\"优惠\",\"labelDesc\":\"无\",\"labelName\":\"飞猪补贴\",\"labelPriority\":2}]", "立减5元": "[{\"labelCategory\":\"优惠\",\"labelDesc\":\"无\",\"labelName\":\"飞猪补贴\",\"labelPriority\":2}]", "立减特惠": "[{\"labelCategory\":\"优惠\",\"labelDesc\":\"无\",\"labelName\":\"飞猪补贴\",\"labelPriority\":2}]", "粉丝优惠": "[{\"labelCategory\":\"优惠\",\"labelDesc\":\"无\",\"labelName\":\"飞猪会员价\",\"labelPriority\":1}]", "菲住体验折扣": "[{\"labelCategory\":\"优惠\",\"labelDesc\":\"无\",\"labelName\":\"飞猪会员价\",\"labelPriority\":1}]", "菲住折扣体验": "[{\"labelCategory\":\"优惠\",\"labelDesc\":\"无\",\"labelName\":\"飞猪会员价\",\"labelPriority\":1}]", "超级闪促价": "[{\"labelCategory\":\"优惠\",\"labelDesc\":\"无\",\"labelName\":\"飞猪补贴\",\"labelPriority\":2}]", "连住更优": "[{\"labelCategory\":\"优惠\",\"labelDesc\":\"无\",\"labelName\":\"飞猪补贴\",\"labelPriority\":2}]", "连住特惠": "[{\"labelCategory\":\"优惠\",\"labelDesc\":\"无\",\"labelName\":\"飞猪补贴\",\"labelPriority\":2}]", "门店新客": "[{\"labelCategory\":\"优惠\",\"labelDesc\":\"无\",\"labelName\":\"飞猪门店首单\",\"labelPriority\":3}]", "限时特惠": "[{\"labelCategory\":\"优惠\",\"labelDesc\":\"无\",\"labelName\":\"飞猪补贴\",\"labelPriority\":2}]", "限时立减": "[{\"labelCategory\":\"优惠\",\"labelDesc\":\"无\",\"labelName\":\"飞猪补贴\",\"labelPriority\":2}]", "飞猪特惠": "[{\"labelCategory\":\"优惠\",\"labelDesc\":\"无\",\"labelName\":\"飞猪补贴\",\"labelPriority\":2}]", "飞猪立减": "[{\"labelCategory\":\"优惠\",\"labelDesc\":\"无\",\"labelName\":\"飞猪补贴\",\"labelPriority\":2}]", "飞猪立减特惠": "[{\"labelCategory\":\"优惠\",\"labelDesc\":\"无\",\"labelName\":\"飞猪补贴\",\"labelPriority\":2}]", "飞猪补贴券": "[{\"labelCategory\":\"优惠\",\"labelDesc\":\"无\",\"labelName\":\"飞猪补贴\",\"labelPriority\":2}]" })
  • └ label_name
  • String
  • 飞猪会员价
  • 标签名称
  • └ label_id
  • Number
  • 1
  • 标签ID
  • └ label_category
  • String
  • 优惠
  • 标签类目
  • └ label_priority
  • Number
  • 1
  • 标签排序优先级
  • └ label_desc
  • String
  • 标签描述
  • cancel_rules
  • CancelRule []
  • 1
  • 取消规则
  • └ rule_start_time
  • String
  • 2024-12-10 00:00:00
  • * yyyy-MM-dd HH:mm:ss格式,rule_end_time需晚于rule_start_time。 * 规则生效时间区间遵循[rule_start_time,rule_end_time),对于同一ratePlan节点下的多条规则: * 1、规则之间的开始时间和结束时间不允许出现重叠。 * 例如[1970-01-01 00:00:00,2024-12-10 00:00:00)与[2024-12-09 00:00:00,2099-12-31 00:00:00)这类数据是不被允许的。 * 2、规则的开始结束时间需要保证连续,例如[1970-01-01 00:00:00,2024-12-10 00:00:00)与[2024-12-10 00:00:00,2099-12-31 00:00:00)为连续的时间区间。 * 注意事项 未按要求返回数据会导致取消规则失效。
  • └ rule_end_time
  • String
  • 2024-12-11 00:00:00
  • * yyyy-MM-dd HH:mm:ss格式,rule_end_time需晚于rule_start_time,最晚一段规则的rule_end_time需要晚于2099-12-31 00:00:00。 * 规则生效时间区间遵循[rule_start_time,rule_end_time),对于同一rateplan节点下的多条规则: * 1、规则之间的开始时间和结束时间不允许出现重叠。 例如[1970-01-01 00:00:00,2024-12-10 00:00:00)与[2024-12-09 00:00:00,2099-12-31 00:00:00)这类数据是不被允许的。 * 2、规则的开始结束时间需要保证连续,例如[1970-01-01 00:00:00,2024-12-10 00:00:00)与[2024-12-10 00:00:00,2099-12-31 00:00:00)为连续的时间区间。 * 注意事项 * 未按要求返回数据会导致取消规则失效。
  • └ penalty_type
  • String
  • PERCENTAGE
  • * 罚金类型 * 枚举值 * 固定罚金: FIXED * 百分比罚金: PERCENTAGE
  • penalty_amounts
  • PenaltyAmount []
  • * 当罚金类型penalty_type为固定罚金类型FIXED时,该字段必填。 * 限制同一币种只能传1条固定罚金,当前仅支持CNY。
  • └ currency
  • String
  • CNY
  • * 币种类型 * 枚举值 * 人民币: CNY
  • └ amount
  • String
  • 100
  • 当前币种下的罚金金额
  • penalty_percent
  • PenaltyPercent
  • * 当罚金类型penalty_type为百分比罚金类型PERCENTAGE时,该字段必填。
  • └ percent
  • String
  • 10%
  • 罚金百分比
  • └ nights
  • String
  • 1
  • 罚金晚数
  • booking_rules
  • BookingRule []
  • 1
  • 预定规则列表
  • └ booking_rule_id
  • String
  • 1
  • 预订规则编号
  • └ start_date
  • String
  • 2023-12-27 12:00:00
  • 报价生效开始日期。当前日期不在日期段内则无法下单 yyyy-mm-dd hh:mm:ss
  • └ end_date
  • String
  • 2023-12-27 12:00:00
  • 报价生效的结束日期。 yyyy-mm-dd hh:mm:ss
  • └ start_hour
  • String
  • 14:00:00
  • 每天开始时间(当前时间不在时间段内无法下单)
  • └ end_hour
  • String
  • 23:59:59
  • 每天结束时间(次日使用+24小时的模式,例如次日3点,表示为27)
  • └ week_set
  • String
  • 0,1,2,3,4,5,6
  • 有效星期。以逗号分割 0表示星期日, 1表示星期一, 剩余的以此类推。当天不在星期范围内则无法下单
  • └ min_amount
  • Number
  • 1
  • 最少预定房间数量
  • └ max_amount
  • Number
  • 10
  • 最大预定房间数量
  • └ min_days
  • Number
  • 1
  • 最少入住天数
  • └ max_days
  • Number
  • 10
  • 最多入住天数
  • └ min_adv_hours
  • Number
  • 24
  • 最少提前预定时间(以用户选择的入住日期的23:59:59计算)
  • └ max_adv_hours
  • Number
  • 24
  • 最大提前预定时间(以用户选择的入住日期的23:59:59计算)
  • └ description
  • String
  • 预定说明
  • 预定说明
  • refund_rules
  • RefundRule []
  • 1
  • 退款规则列表
  • └ refund_rule_id
  • String
  • 1
  • 退款规则id
  • └ refund_rule_type
  • String
  • CAN_REFUND
  • 取消类型 枚举值 免费取消: FREE_REFUND 不可取消: NO_REFUND 限时取消: CAN_REFUND
  • └ start_date
  • String
  • 2023-12-27 12:00:00
  • 时间戳,规则生效起始时间 yyyy-mm-dd hh:mm:ss
  • └ end_date
  • String
  • 2023-12-31 12:00:00
  • 时间戳,规则生效截止时间 yyyy-mm-dd hh:mm:ss
  • refund_rule_details
  • RefundRuleDetail []
  • 限时取消细节 CAN_REFUND时候有该结构
  • └ relative_date_type
  • String
  • ABSOLUTE
  • 相对日期类别 枚举值 入 住日: CHECK_IN 固定日期: ABSOLUTE
  • └ relative_minute
  • Number
  • 1439
  • 对入住日提前分钟数 相对入住日提前的分钟数,当relativeDateType为CHECK_IN时这个字段有值,相对的是CHECK_IN日期的24点提前的分钟数。如入住日是2015-12-22号,则可取消时间是 2015-12-22 23:59:59 - relativeMinute 点之前可退
  • └ absolute_date
  • String
  • 2023-12-27 12:00:00
  • 固定日期 当relativeDateType为ABSOLUTE时这个字段有值
  • └ deduct_base_type
  • String
  • FULL_NIGHT_PRICE
  • 取消时扣款金额计算基数 取消时扣款金额基数(首晚价格:FIRST_NIGHT_PRICE;订单总价:FULL_NIGHT_PRICE), 实际扣款金额为 deductBaseType*decuctPercent 枚举值 首 晚价格: FIRST_NIGHT_PRICE 订单总价: FULL_NIGHT_PRICE
  • └ deduct_percent
  • String
  • 10
  • 取消时扣款比例(0.01-100.00),实际扣款金额为 deductBaseType*deductPercent
result_message String SHT_CHANNEL_SUPPLY_PARAMS_ERROR 结果消息

请求示例

  • JAVA
  • .NET
  • PHP
  • CURL
  • Python
  • C/C++
  • NodeJS
TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
AlibabaFliggyPromoteHotelOnlineRequest req = new AlibabaFliggyPromoteHotelOnlineRequest();
AlibabaFliggyPromoteHotelOnlineRequest.QueryHotelPriceDetailsRequest obj1 = new AlibabaFliggyPromoteHotelOnlineRequest.QueryHotelPriceDetailsRequest();
obj1.setActivityId("sht_zb_travel");
obj1.setPromotionPositionId(2219172258770L);
obj1.setOpenId("000001");
obj1.setHotelId("78816219");
obj1.setDepartureDate("2025-05-13 23:59:59");
obj1.setPromoteAppKey(1000028L);
obj1.setArrivalDate("2025-05-12 00:00:00");
req.setQueryHotelPriceDetailsRequest(obj1);
AlibabaFliggyPromoteHotelOnlineResponse rsp = client.execute(req);
System.out.println(rsp.getBody());

响应示例

  • XML示例
  • JSON示例
<alibaba_fliggy_promote_hotel_online_response>
    <is_success>true</is_success>
    <result_code>SHT_CHANNEL_SUPPLY_PARAMS_ERROR</result_code>
    <model>
        <hotel_id>78816219</hotel_id>
        <rate_plans>
            <rate_plan>
                <rate_plan_id>1</rate_plan_id>
                <rate_plan_name>产品的名字</rate_plan_name>
                <status>true</status>
                <room_id>1</room_id>
                <identification>1</identification>
                <identification_type>
                    <string>1</string>
                </identification_type>
                <customer_type>DOMESTIC</customer_type>
                <instant_confirmation>false</instant_confirmation>
                <pay_type>PREPAY</pay_type>
                <booking_rule_ids>
                    <string>1</string>
                </booking_rule_ids>
                <refund_rule_id>
                    <string>1</string>
                </refund_rule_id>
                <nightly_rates>
                    <nightly_rate>
                        <date>2023-12-27</date>
                        <member>400</member>
                        <cost>-1</cost>
                        <status>true</status>
                        <add_bed>-1</add_bed>
                        <basis>500.0</basis>
                        <price_discount_value>100.0</price_discount_value>
                        <breakfast>2</breakfast>
                        <promotion_type>0</promotion_type>
                        <promotion_tag>促销活动名</promotion_tag>
                    </nightly_rate>
                </nightly_rates>
                <ota_url>小程序链接</ota_url>
                <confirm_minutes>10</confirm_minutes>
                <supplier_source>华住会</supplier_source>
                <invoice>
                    <invoice_mode>1</invoice_mode>
                    <postage_provider>1</postage_provider>
                    <invoice_purpose>差旅费</invoice_purpose>
                </invoice>
                <refund_rule_ids>
                    <string>1</string>
                </refund_rule_ids>
                <refund_rule_text>1</refund_rule_text>
                <rate_plan_labels>
                    <rate_plan_label>
                        <label_name>飞猪会员价</label_name>
                        <label_id>1</label_id>
                        <label_category>优惠</label_category>
                        <label_priority>1</label_priority>
                        <label_desc>无</label_desc>
                    </rate_plan_label>
                </rate_plan_labels>
                <cancel_rules>
                    <cancel_rule>
                        <rule_start_time>2024-12-10 00:00:00</rule_start_time>
                        <rule_end_time>2024-12-11 00:00:00</rule_end_time>
                        <penalty_type>PERCENTAGE</penalty_type>
                        <penalty_amounts>
                            <penalty_amount>
                                <currency>CNY</currency>
                                <amount>100</amount>
                            </penalty_amount>
                        </penalty_amounts>
                        <penalty_percent>
                            <percent>10%</percent>
                            <nights>1</nights>
                        </penalty_percent>
                    </cancel_rule>
                </cancel_rules>
            </rate_plan>
        </rate_plans>
        <booking_rules>
            <booking_rule>
                <booking_rule_id>1</booking_rule_id>
                <start_date>2023-12-27 12:00:00</start_date>
                <end_date>2023-12-27 12:00:00</end_date>
                <start_hour>14:00:00</start_hour>
                <end_hour>23:59:59</end_hour>
                <week_set>0,1,2,3,4,5,6</week_set>
                <min_amount>1</min_amount>
                <max_amount>10</max_amount>
                <min_days>1</min_days>
                <max_days>10</max_days>
                <min_adv_hours>24</min_adv_hours>
                <max_adv_hours>24</max_adv_hours>
                <description>预定说明</description>
            </booking_rule>
        </booking_rules>
        <refund_rules>
            <refund_rule>
                <refund_rule_id>1</refund_rule_id>
                <refund_rule_type>CAN_REFUND</refund_rule_type>
                <start_date>2023-12-27 12:00:00</start_date>
                <end_date>2023-12-31 12:00:00</end_date>
                <refund_rule_details>
                    <refund_rule_detail>
                        <relative_date_type>ABSOLUTE</relative_date_type>
                        <relative_minute>1439</relative_minute>
                        <absolute_date>2023-12-27 12:00:00</absolute_date>
                        <deduct_base_type>FULL_NIGHT_PRICE</deduct_base_type>
                        <deduct_percent>10</deduct_percent>
                    </refund_rule_detail>
                </refund_rule_details>
            </refund_rule>
        </refund_rules>
    </model>
    <result_message>SHT_CHANNEL_SUPPLY_PARAMS_ERROR</result_message>
</alibaba_fliggy_promote_hotel_online_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

返回
顶部