Thông báo về tình trạng rảnh/bận

Tổng quan

Thông báo về tình trạng còn hàng (OTA_HotelAvailNotifRQ) xác định liệu sản phẩm có (loại phòng kết hợp với gói giá) của một hành trình cụ thể có thể được bán với giá ngày áp dụng. Khi gửi thông báo Tình trạng rảnh/bận, bạn cho biết liệu tình trạng còn hàng hoặc quy định hạn chế của một sản phẩm đã thay đổi.

Lưu ý quan trọng: Bạn cũng có thể cập nhật khoảng không quảng cáo bằng cách sử dụng loại thông báo về Tình trạng còn hàng, nhưng loại thông báo Kho hàng (OTA_HotelInvCountNotifRQ) là loại được ưu tiên .

Các phần sau bao gồm nguyên tắc chung, ví dụ cơ bản và hướng dẫn để bắt đầu thêm và cập nhật tình trạng còn hàng bằng Thông báo về tình trạng rảnh/bận.

Quy định hạn chế về tình trạng phòng vào ban đêm

Thông báo về Tính khả dụng cho phép bạn xác định các hạn chế kiểm soát việc tình trạng còn hàng của một lượt đặt trước. Một loại quy định hạn chế đáng chú ý là "khả năng bán hàng vào ban đêm": liệu sản phẩm có thể được bán vào một ngày cụ thể hay không. Để có thể đặt phòng (từ lúc nhận phòng đến trả phòng), bạn phải có thời gian lưu trú hằng đêm tình trạng phòng vào tất cả các ngày, cũng như mọi quy định hạn chế khác về việc đặt phòng và lưu trú đáp ứng.

Lưu ý: Để biết thêm thông tin về khái niệm Phạm vi cung cấp và sự khác biệt giữa Khoảng không quảng cáo và Tình trạng còn hàng, hãy xem Khoảng không quảng cáo so với tình trạng còn hàng.

Chế độ cài đặt hạn chế

Theo mặc định, RestrictionStatus cho Restriction="Master" bị đóng. Nói cách khác, theo mặc định, sẽ có một "ngừng bán" vào mỗi đêm.

Để có thể bán được, một sản phẩm phải có <RestrictionStatus Restriction="Master" Status="Open"> cho tất cả tổ hợp sản phẩm vào tất cả các đêm lưu trú. Bạn phải gửi cho Google một Open rõ ràng cho từng sản phẩm hoặc thay đổi mặc định trong Hotel Center. Bạn có thể thực hiện việc này bằng cách điều hướng đến Định giá > trang Cài đặt trong Hotel Center rồi chỉnh sửa chế độ cài đặt "mặc định" tình trạng còn hàng" .

Quy định hạn chế khác

Đến/khởi hành

Ngăn việc bán một hành trình đến hoặc đi vào ngày được chỉ định. Thuộc tính này là Open theo mặc định.

Mức bù trừ đặt phòng tối thiểu và tối đa

Yêu cầu hành trình phải mua ít nhất hoặc tối đa một số lượng nhất định ngày trước khi đến nơi.

Thời gian lưu trú tối thiểu và tối đa

Hạn chế thời gian lưu trú đối với những hành trình có ngày đến này.

Thời gian lưu trú tối thiểu và tối đa (hay "thời gian lưu trú")

Giới hạn thời gian lưu trú đối với những hành trình có chứa ngày lưu trú này.

Khoảng thời gian lưu trú

Cung cấp quyền kiểm soát chính xác thời gian lưu trú được phép cho ngày đến này.

Nguyên tắc chung

• Các quy định hạn chế về tình trạng phòng sẽ phụ thuộc vào khách sạn, ngày, loại phòng và gói giá.

• Bạn chỉ có thể đặt trước một sản phẩm nếu không có quy định hạn chế nào được áp dụng vào thời gian lưu trú (từ nhận phòng đến trả phòng) hoặc khi người dùng có thể đặt phòng.

• Gửi cho Google thông tin cập nhật về tình trạng rảnh/bận mỗi khi có thay đổi giới hạn về tình trạng còn hàng đối với sản phẩm vào các ngày cụ thể.

Ví dụ:

Phần này đưa ra ví dụ cơ bản về thông báo về tình trạng rảnh/bận sử dụng thông báo bắt buộc và các phần tử không bắt buộc. Sau khi chuẩn bị tệp, bạn sẽ cần gửi tệp đến Google qua thông báo POST tới điểm cuối này:

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

Để tìm hiểu thêm về cách đẩy/POST thông báo, hãy xem phần Thông báo đẩy tin nhắn.

Lưu ý quan trọng: Gửi thông báo mới cho Google bất cứ khi nào tình trạng rảnh/bận thay đổi.

Đối với HotelCode, hãy sử dụng mã khách sạn duy nhất mà bạn đã dùng trong hệ thống của mình để xác định thuộc tính. Giá trị này phải khớp với Mã khách sạn được chỉ định sử dụng <id> trong phần tử <listing> trong Nguồn cấp dữ liệu Danh sách khách sạn. Tính nhất quán với hệ thống là rất quan trọng để đảm bảo rằng Google đang hiển thị chính xác dữ liệu của bạn.

Ví dụ sau cho biết cách đặt các giới hạn về tình trạng rảnh/bận:

<?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>

Để xem thêm ví dụ, hãy xem bài viết Tình trạng còn hàng ví dụ.

Hướng dẫn

Phần này cung cấp giải pháp cho các tình huống mà bạn có thể gặp phải khi gửi Thông báo về tình trạng phòng, cụ thể là thông tin chi tiết về tình trạng phòng mỗi đêm quy định hạn chế (còn được gọi là "ngừng bán").

Trường hợp 1: Cách bán sản phẩm vào các ngày cụ thể

Mô tả

Bạn muốn cung cấp tổ hợp loại phòng và gói giá (sản phẩm) trên ngày cụ thể.

Lưu ý: Theo mặc định, Google coi các sản phẩm là "ngừng bán" đã bật (mỗi đêm tình trạng phòng đã đóng), nhưng bạn có thể thiết lập xem tình trạng phòng trống mỗi đêm hay không quy định hạn chế này được mở hoặc đóng theo mặc định. Bạn phải gửi cho Google Open cho từng sản phẩm hoặc thay đổi giá trị mặc định trong Hotel Center.

Giải pháp

Đặt quy định hạn chế Master thành Open rồi chỉ định ngày.

Mẫu

Mẫu này cho thấy cách mở tình trạng còn phòng hằng đêm cho một sản phẩm trong vài tuần vào tháng 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>

Lưu ý: Giới hạn về tình trạng còn phòng theo đêm phải là Open (và khoảng không quảng cáo phải là số nguyên lớn hơn 0 đối với phòng) để hiển thị giá của sản phẩm.

Để biết thêm thông tin về cách đặt giá, hãy xem bài viết Khắc phục sự cố thiếu hoặc chưa đầy đủ thông tin về giá.

Tình huống 2: Cách ngừng bán sản phẩm vào một số ngày cụ thể

Mô tả

Bạn rõ ràng muốn ngừng bán sản phẩm (thay vì thoát ra khoảng không quảng cáo) vào các ngày cụ thể.

Lưu ý: Nếu sản phẩm đã huỷ kích hoạt hoàn toàn do loại phòng, giá hoặc tổ hợp của chúng bị vô hiệu hoá, thì bạn nên sử dụng Giao dịch (Dữ liệu của cơ sở lưu trú) nhắn tin tới huỷ liên kết sản phẩm vì sản phẩm không phụ thuộc vào ngày.

Giải pháp

Đặt quy định hạn chế Master thành Close và chỉ định ngày.

Mẫu

Mẫu này cho biết cách "ngừng bán" hoặc đóng tình trạng rảnh/bận vào ban đêm cho một sản phẩm vào các ngày cụ thể.

<?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>