Thông báo về kho hàng

Tổng quan

Thông báo Quỹ phòng (OTA_HotelInvCountNotifRQ) xác định số lượng quỹ phòng (số lượng phòng thực tế) có thể đặt trước cho các loại phòng cụ thể. Khi gửi thông báo Kho hàng, bạn cho biết số lượng phòng thuộc loại đó còn trống vào một ngày nhất định. Nếu không có phòng nào thuộc loại đó, thì các sản phẩm liên quan đến loại phòng và ngày đó sẽ không xuất hiện.

Các phần sau đây trình bày hướng dẫn 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 khoảng không quảng cáo, cũng như gửi thông báo về khoảng không quảng cáo.

Để xem ví dụ về nhiều trường hợp liên quan đến khoảng không quảng cáo, hãy xem phần Hướng dẫn.

Phần tử bắt buộc và không bắt buộc

Tài liệu tham khảo về XML cung cấp nội dung mô tả về các phần tử bắt buộc và không bắt buộc. Để biết thông tin chi tiết về các thuộc tính và phần tử con, hãy xem Các phần tử và thuộc tính của kho hàng.

Cú pháp và giản đồ

Hãy sử dụng ví dụ về cú pháp Kho hàng làm tài liệu tham khảo khi bạn tạo thông báo Kho hàng để đảm bảo bạn đang tuân theo đúng định dạng.

Bạn có thể sử dụng một công cụ XML của bên thứ ba như xmllint để xác thực nguồn cấp dữ liệu bằng các giản đồ đã xuất bản trước khi gửi cho Google. Để biết lược đồ thông báo Kho hàng, hãy xem Lược đồ quảng cáo khách sạn.

Nguyên tắc

Hãy làm theo các nguyên tắc sau đây đối với thông báo Kho hàng:

  • Quỹ phòng được khoá theo khách sạn, ngày và loại phòng.

  • Số lượng phòng còn trống phải lớn hơn 0 cho tất cả các đêm lưu trú thì bạn mới có thể hiển thị giá cho gói giá và số người lưu trú có liên quan.

  • Nếu số lượng phòng trống bằng 0, thì khách sẽ không đặt được phòng cho Mã phòng và phạm vi ngày đã chỉ định.

  • CountType phải luôn có giá trị là 2 để hợp lệ vì giá trị này cho biết số lượng "tình trạng còn hàng chắc chắn".

  • Gửi kho hàng mới cập nhật bất cứ khi nào có lượt đặt phòng hoặc huỷ phòng trong hệ thống của bạn.

Kho hàng so với tình trạng còn hàng

Kho hàng là số lượng phòng có thể đặt dựa trên số lượng thực tế và tình trạng còn phòng cho biết liệu khách có thể đặt loại phòng và gói giá kết hợp hay không. Đối với ARI, tình trạng phòng và quỹ phòng đều có thể thay đổi dựa trên một nhóm ngày hoặc loại hình lưu trú, đồng thời cả hai đều có các loại thông báo tương ứng. Quỹ phòng và tình trạng phòng được xác định theo khách sạn, ngày và loại phòng, cùng với gói giá cho tình trạng phòng.

Có thể "không có tình trạng còn hàng" ngay cả khi có kho hàng vì kho hàng và tình trạng còn hàng không phụ thuộc vào nhau.

Có hai khái niệm về tình trạng còn hàng. Trước tiên, đó là tình trạng phòng tổng thể của một sản phẩm cho một lượt lưu trú nhất định, chịu ảnh hưởng của các yếu tố như việc mỗi đêm có mức giá xác định, khoảng không quảng cáo cho loại phòng liên kết và hạn chế về tình trạng phòng là mở. Thứ hai, có hạn chế cụ thể đối với một sản phẩm vào một ngày nhất định, được biểu thị bằng <RestrictionStatus Restriction="Master" Status="Open"/> trong OTA_HotelAvailNotifRQ và việc đóng tình trạng còn hàng này được gọi là "ngừng bán".

Kho hàng phải là một số nguyên lớn hơn 0 đối với phòng và hạn chế về tình trạng còn phòng phải là không hạn chế thì giá của sản phẩm mới xuất hiện.

Ví dụ:

Phần này cung cấp một ví dụ cơ bản về thông báo Kho hà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_inv_count_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 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> trong nguồn cấp dữ liệu Danh sách khách sạn. Đối với <RoomID>, hãy sử dụng cùng một mã nhận dạng mà bạn đã dùng trong hệ thống cho các loại phòng. 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 cho biết cách đặt quỹ phòng cho 13 phòng có thể đặt trước trong tháng 12:

<?xml version="1.0" encoding="UTF-8"?>
<OTA_HotelInvCountNotifRQ xmlns="http://www.opentravel.org/OTA/2003/05"
                          EchoToken="12345678"
                          TimeStamp="2022-02-25T20:50:37-05:00"
                          Version="3.0">
  <POS><Source><RequestorID ID="partner_key" /></Source></POS>
  <Inventories HotelCode="HotelID">
    <Inventory>
      <StatusApplicationControl Start="2022-12-01"
                                End="2022-12-31"
                                InvTypeCode="RoomID"/>
      <InvCounts>
        <InvCount Count="13" CountType="2"/>
      </InvCounts>
    </Inventory>
  </Inventories>
</OTA_HotelInvCountNotifRQ>

Để biết thêm ví dụ, hãy xem Ví dụ về khoảng không quảng cáo.

Hướng dẫn

Phần này cung cấp một tình huống mà bạn có thể gặp phải khi gửi thông báo về Kho hàng.

Tình huống: Cách chặn đặt phòng

Mô tả

Bạn cần cho biết rằng không còn phòng nào có thể đặt trước cho loại phòng này vào một số ngày cụ thể, thường là do đã bán hết.

Giải pháp

Bạn đặt <InvCount Count> thành giá trị 0 và thêm phạm vi ngày mong muốn.

Mẫu

Mẫu này cho biết cách sử dụng InvCount để đặt khoảng không quảng cáo thành 0 cho phòng và ngày đã chỉ định (ví dụ: vài tuần đầu tiên của tháng 1).

<?xml version="1.0" encoding="UTF-8"?>
<OTA_HotelInvCountNotifRQ xmlns="http://www.opentravel.org/OTA/2003/05"
                          EchoToken="12345678"
                          TimeStamp="2022-02-25T20:50:37-05:00"
                          Version="3.0">
  <POS><Source><RequestorID ID="partner_key" /></Source></POS>
  <Inventories HotelCode="Property_1">
    <Inventory>
      <StatusApplicationControl Start="2023-01-01"
                                End="2023-01-15"
                                InvTypeCode="ROOMID"/>
      <InvCounts>
        <InvCount Count="0" CountType="2"/>
      </InvCounts>
    </Inventory>
  </Inventories>
</OTA_HotelInvCountNotifRQ>