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 phòng (OTA_HotelAvailNotifRQ) cho biết liệu khách hàng có thể bán sản phẩm (loại phòng kết hợp với gói giá) trong một hành trình nhất định trong 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 sẽ cho biết tình trạng còn hàng hay quy định hạn chế của một sản phẩm đã thay đổi.

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 trường hợp hướng dẫn để giúp bạ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 phòng.

Quy định hạn chế về tình trạng phòng mỗi đêm

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

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

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

Để có thể bán, 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 "tình trạng phòng mặc định".

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

Đến/đến
Ngăn việc bán hành trình đến hoặc đi vào ngày đã định. Giá trị này là Open theo mặc định.
Mức bù trừ tối thiểu và tối đa của lượt đặt phòng
Yêu cầu khách hàng phải mua hành trình ít nhất hoặc nhiều nhất là 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
Giới hạn thời gian lưu trú đối với các hành trình có ngày đến này.
Thời gian lưu trú tối thiểu và tối đa cho ngày lưu trú (hay còn gọi là "lưu trú qua đêm")
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.
Mẫu thời gian lưu trú
Giú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 sẽ phụ thuộc vào khách sạn, ngày, loại phòng và gói giá.

  • Khách hàng chỉ có thể đặt phòng với sản phẩm nếu không có quy định hạn chế nào áp dụng cho lượt lưu trú (từ thời gian nhận phòng đến thời điểm 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ề thông báo về Tình trạng còn hàng bất cứ khi nào có sự thay đổi về quy định hạn chế 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 cung cấp một ví dụ cơ bản về thông báo về 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 qua thông báo POST đến điểm cuối sau:

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 Đẩy thông báo.

Đối với HotelCode, hãy sử dụng mã khách sạn duy nhất mà bạn đã sử 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 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ụ dưới đây minh hoạ cách đặt các quy định hạn chế 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>

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

Hướng dẫn

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

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

Nội dung mô tả

Bạn muốn cung cấp kiểu kết hợp loại phòng và gói giá (sản phẩm) vào những ngày cụ thể.

Giải pháp

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

Mẫu

Mẫu này cho biết cách mở tình trạng còn hàng mỗi đêm của một sản phẩm trong một 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>

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

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

Nội dung mô tả

Bạn rõ ràng 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ể.

Giải pháp

Đặt giới hạn Master thành Close rồi 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 còn hàng mỗi đêm đối với 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>