Thông báo về tình trạng còn hàng

Tổng quan

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

Lưu ý quan trọng: Bạn cũng có thể cập nhật quỹ phòng bằng loại thông báo Lịch sử phòng trống, nhưng loại thông báo Quỹ phòng (OTA_HotelInvCountNotifRQ) là phương thức được ưu tiên.

Các phần sau đây trình bày các nguyên tắc chung, ví dụ cơ bản và các tình huống hướng dẫn để giúp bạn bắt đầu thêm và cập nhật tình trạng còn phòng bằng thông báo Tình trạng còn phòng.

Hạn chế về việc cung cấp vào ban đêm

Thông báo về tình trạng còn phòng cho phép bạn xác định các quy định hạn chế để kiểm soát tình trạng còn phòng tổng thể của một lượt đặt phòng. Một loại hạn chế đáng chú ý là "tình trạng còn hàng theo đê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 một lượt lưu trú (từ khi nhận phòng đến khi trả phòng), bạn phải có phòng trống mỗi đêm vào tất cả các ngày và đáp ứng mọi hạn chế khác về việc đặt phòng và lưu trú.

Lưu ý: Để biết thêm thông tin về khái niệm Tình trạng còn hàng và sự khác biệt giữa Kho hàng và Tình trạng còn hàng, hãy xem bài viết Kho hàng 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" sẽ đóng. Nói cách khác, theo mặc định, mỗi đêm đều có lệnh "ngừng bán".

Để có thể bán được, một sản phẩm phải có <RestrictionStatus Restriction="Master" Status="Open"> cho tất cả cá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 giá trị mặc định trong Hotel Center. Bạn có thể thực hiện việc này bằng cách chuyển đến trang Giá > Cài đặt trong Hotel Center rồi chỉnh sửa trường "lịch sử đặt phòng mặc định".

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

Thời gian đến/khởi hành

Ngăn việc bán một hành trình đến hoặc khởi hành vào ngày đã chỉ định. Theo mặc định, giá trị này là Open.

Khoảng thời gian đặt phòng tối thiểu và tối đa

Yêu cầu khách phải mua hành trình ít nhất hoặc nhiều nhất một số ngày nhất định trước khi đến.

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

Hạn chế thời gian lưu trú của 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 trong tương lai (hoặc "ngày ở")

Hạn chế thời gian lưu trú cho những lịch trình có ngày lưu trú này.

Kiểu lưu trú

Cho phép 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 được xác định theo khách sạn, ngày, loại phòng và gói giá.

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

• Gửi cho Google thông báo cập nhật về Tình trạng còn phòng bất cứ khi nào có thay đổi về các hạn chế đối với tình trạng còn phòng của sản phẩm vào những ngày cụ thể.

Ví dụ:

Phần này cung cấp một ví dụ cơ bản về thông báo kiểm tra tình trạng phòng bằng cách sử dụng các phần tử bắt buộc và không bắt buộc. Sau khi chuẩn bị tệp, bạn sẽ cần gửi tệp đó cho Google thông qua một thông báo POST đến đ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 truyền/ĐĂNG thông báo, hãy xem phần Truyền thông báo.

Điểm quan trọng: Gửi cho Google một thông báo mới bất cứ khi nào tình trạng còn hàng thay đổi.

Đối với HotelCode, hãy sử dụng Mã nhận dạng riêng biệt của khách sạn mà bạn đã dùng trong hệ thống để xác định cơ sở lưu trú. Giá trị này phải khớp với Mã khách sạn được chỉ định bằng <id> trong phần tử <listing> của 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 của bạn là yếu tố quan trọng để đảm bảo rằng Google đang hiển thị dữ liệu của bạn một cách chính xác.

Ví dụ này minh hoạ cách thiết lập các quy định hạn chế về phạm vi cung cấp:

<?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 Ví dụ về tình trạng còn hàng.

Hướng dẫn

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

Tình huống 1: Cách bán sản phẩm vào những 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) vào những ngày cụ thể.

Lưu ý: Theo mặc định, Google coi các sản phẩm là đã bật chế độ "ngừng bán" (tình trạng còn phòng mỗi đêm là đóng), nhưng bạn có thể định cấu hình xem chế độ hạn chế tình trạng còn phòng mỗi đêm là mở hay đóng theo mặc định. 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 giá trị mặc định trong Hotel Center.

Giải pháp

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

Mẫu

Ví dụ này cho thấy cách mở tình trạng còn phòng qua đêm của một sản phẩm trong vài tuần của 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 ý: Bạn phải đặt hạn chế về tình trạng còn phòng theo đêm là Open (và số lượng phòng trống phải là số nguyên lớn hơn 0) thì mới có thể hiển thị giá của một 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 vấn đề về giá bị thiếu hoặc không đầy đủ.

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

Mô tả

Bạn muốn ngừng bán một sản phẩm (thay vì hết hàng) vào những ngày cụ thể.

Lưu ý: Nếu sản phẩm bị vô hiệu hoá hoàn toàn vì loại phòng, gói giá hoặc tổ hợp của chúng bị vô hiệu hoá, thì bạn nên sử dụng thông báo Giao dịch (Dữ liệu cơ sở lưu trú) để 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

Ví dụ này cho biết cách "ngừng bán" hoặc đóng tình trạng còn phòng mỗi đêm cho một sản phẩm vào những 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>