Trang này được dịch bởi Cloud Translation API.

Thông báo về khoảng không quảng cáo

Tổng quan

Thông báo Kho hàng (OTA_HotelInvCountNotifRQ) xác định số lượng kho hàng (số phòng thực) có thể đặt trước cho phòng cụ thể loại. Khi gửi thông báo Kho hàng, bạn cho biết có bao nhiêu phòng trong số đó loại có sẵn vào một ngày nhất định. Nếu không có phòng nào thuộc loại đó, những 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 bao gồm nguyên tắc chung, ví dụ cơ bản và 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 kho hàng.

Để xem ví dụ về nhiều tình huống 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 XML cung cấp thông tin mô tả về các phần tử bắt buộc và không bắt buộc. Để biết thông tin về các thuộc tính và các phần tử con, hãy xem Các phần tử khoảng không quảng cáo & .

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

Sử dụng thẻ Khoảng không quảng cáo dưới dạng một khi tạo thông báo Khoảng không quảng cáo để đảm bảo bạn đang tuân thủ đúng định dạng.

Bạn có thể sử dụng công cụ XML của bên thứ ba như xmllint để xác thực nguồn cấp dữ liệu với các giản đồ được xuất bản trước khi gửi cho Google. Đối với Khoảng không quảng cáo giản đồ thông báo, hãy xem Giản đồ 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 cho thông báo Kho hàng:

Khoảng không quảng cáo được khoá theo khách sạn, ngày và loại phòng.
Số lượng phòng phải lớn hơn 0 cho tất cả các đêm lưu trú để hiển thị giá của gói giá và số người lưu trú được liên kết.
Nếu số lượng phòng bằng 0, thì khách hàng sẽ không thể sử dụng phòng cho đặt trước cho Mã phòng và phạm vi ngày đã chỉ định.
CountType phải luôn có giá trị 2 để hợp lệ vì nó cho biết số lượng "lượng hàng có sẵn".
Gửi quỹ phòng đã cập nhật bất cứ khi nào đặt phòng hoặc huỷ đặt phòng xảy ra trong hệ thống của bạn.

Khoảng không quảng cáo so với tình trạng còn hàng

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

Có thể có trạng thái "không có sẵn" ngay cả khi có khoảng không quảng cáo kể từ khi và khả năng sử dụng độc lập với nhau.

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

Dữ liệu về phòng phải là số nguyên lớn hơn 0 cho phòng và tình trạng còn phòng bạn phải mở quy tắc hạn chế thì mới có thể hiển thị giá cho một sản phẩm.

Ví dụ:

Phần này cung cấp ví dụ cơ bản về thông báo Kho hàng 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_inv_count_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.

Đố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 <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 của mình cho các loại phòng. Sự 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ụ này cho biết cách thiết lập quỹ phòng cho 13 phòng có thể đặt trước cho 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>

Để xem thêm ví dụ, hãy xem bài viết Khoảng không quảng cáo ví dụ.

Hướng dẫn

Phần này đưa ra một tình huống mà bạn có thể gặp phải khi gửi một Thông báo kho hàng.

Tình huống: Cách chặn không cho đặ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 được loại phòng này vào một nhóm ngày cụ thể, thường là vì chúng đã 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 cụ thể (ví dụ: một vài tuần đầu tiên trong 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>