空闲状态消息

概览

“库存状况”消息 (OTA_HotelAvailNotifRQ) 用于定义特定行程的商品（客房类型与费率方案的组合）是否可在适用日期销售。发送“库存状况”消息时，您需要指明商品的库存状况或限制是否发生了变化。

以下部分介绍了常规指南、基本示例以及操作场景，可帮助您开始使用“空房情况”消息添加和更新空房情况。

夜间可用性限制

借助“Availability”消息，您可以定义限制条件来控制预订的总体可用性。一种值得注意的限制类型是“每晚可订状态”：商品是否可以在特定日期销售。 如需预订住宿（从入住到退房），所有日期都必须有每晚空房，并且必须满足所有其他预订和住宿限制。

限制设置

默认情况下，Restriction="Master" 的 RestrictionStatus 处于关闭状态。换句话说，默认情况下，每天晚上都会“停止销售”。

如需可供销售，商品必须在住宿期间的所有夜晚针对所有商品组合提供<RestrictionStatus Restriction="Master" Status="Open">。您必须为每件商品向 Google 发送明确的 Open，或者在酒店中心内更改默认设置。为此，您可以在 Hotel Center 中前往价格 > 设置页面，然后修改“默认空房情况”字段。

其他限制

到达/出发
防止出售在指定日期到达或出发的行程。 默认值为 Open。
预订偏移量下限和上限
要求行程必须在抵达日期之前至少或最多几天购买。
最短和最长住宿晚数
限制了具有此到达日期的行程的住宿时长。
最短和最长续住天数（或“续住”）
限制包含此住宿日期的行程的住宿时长。
住宿时长模式
可精确控制允许的入住时长（针对此到达日期）。

常规指南

  • 房源限制按酒店、日期、客房类型和费率方案进行键控。

  • 只有在住宿（从入住到退房）或用户可以预订住宿的时间没有施加任何限制的情况下，产品才能预订。

  • 每当商品在特定日期的供应情况限制发生变化时，都向 Google 发送“供应情况”消息更新。

示例

本部分提供了一个使用必需元素和可选元素的“房源状况”消息的基本示例。准备好文件后，您需要通过向以下端点发送 POST 消息来将文件发送给 Google：

https://www.google.com/travel/hotels/uploads/ota/hotel_avail_notif

如需详细了解如何推送/发布消息，请参阅推送消息。

对于 HotelCode，请使用您在系统中用于标识房源的唯一酒店 ID。此值必须与酒店列表 Feed 中 <listing> 元素的 <id> 中指定的酒店 ID 一致。与您的系统保持一致对于确保 Google 正确显示您的数据至关重要。

此示例展示了如何设置房源限制：

<?xml version="1.0" encoding="UTF-8"?>
<OTA_HotelAvailNotifRQ xmlns="http://www.opentravel.org/OTA/2003/05"
                       EchoToken="12345678"
                       TimeStamp="2022-03-20T20:50:37-05:00"
                       Version="3.0">
  <POS><Source><RequestorID ID="partner_key" /></Source></POS>
  <AvailStatusMessages HotelCode="HOTELID">
    </AvailStatusMessage>
    <AvailStatusMessage>
      <StatusApplicationControl Start="202X-03-20"
                                End="202X-03-25"
                                InvTypeCode="RoomID_1"
                                RatePlanCode="PackageID_1"/>
      <LengthsOfStay>
        <LengthOfStay MinMaxMessageType="SetMinLOS" Time="2" TimeUnit="Day" />
      </LengthsOfStay>
      <RestrictionStatus Restriction="Master" Status="Open" />
    </AvailStatusMessage>
</OTA_HotelAvailNotifRQ>

如需查看更多示例，请参阅可用性示例。

方法指南

本部分针对您在发送“房源状况”消息时可能会遇到的情形提供了解决方案，特别是有关夜间房源状况限制（也称为“停止销售”）的详细信息。

方案 1：如何在特定日期销售商品

说明

您希望在特定日期提供客房类型和房价方案组合（产品）。

解决方案

将 Master 限制设置为 Open，并指定日期。

示例

此示例展示了如何为商品在 3 月份的几个星期内开放夜间预订。

<?xml version="1.0" encoding="UTF-8"?>
<OTA_HotelAvailNotifRQ xmlns="http://www.opentravel.org/OTA/2003/05"
                       EchoToken="12345678"
                       TimeStamp="2022-03-20T20:50:37-05:00"
                       Version="3.0">
  <AvailStatusMessages HotelCode="Property_1">
    <AvailStatusMessage>
      <StatusApplicationControl Start="2022-03-20"
                                End="2022-03-30"
                                InvTypeCode="RoomID_1"
                                RatePlanCode="PackageID_1"/>
      <RestrictionStatus Status="Open" Restriction="Master"/>
    </AvailStatusMessage>
  </AvailStatusMessages>
</OTA_HotelAvailNotifRQ>

如需详细了解如何设置价格，请参阅排查价格缺失或不完整的问题。

场景 2：如何在特定日期停止销售商品

说明

您希望在特定日期明确停止销售商品（而不是因缺货而停止销售）。

解决方案

将 Master 限制设置为 Close，并指定日期。

示例

此示例展示了如何针对指定日期“停止销售”或关闭产品的每晚空房情况。

<?xml version="1.0" encoding="UTF-8"?>
<OTA_HotelAvailNotifRQ xmlns="http://www.opentravel.org/OTA/2003/05"
                       EchoToken="12345678"
                       TimeStamp="2022-03-20T20:50:37-05:00"
                       Version="3.0">
  <AvailStatusMessages HotelCode="Property_1">
    <AvailStatusMessage>
      <StatusApplicationControl Start="2022-04-20"
                                End="2022-04-30"
                                InvTypeCode="RoomID_1"
                                RatePlanCode="PackageID_1"/>
      <RestrictionStatus Status="Close" Restriction="Master"/>
    </AvailStatusMessage>
  </AvailStatusMessages>
</OTA_HotelAvailNotifRQ>