Tổng quan
Thông báo Inventory (Kiểm kho) (OTA_HotelInvCountNotifRQ) xác định số lượng phòng trống (số phòng thực) có thể đặt trước cho các loại phòng cụ thể. Khi gửi thông báo Inventory (Kiểm kho), bạn cho biết có bao nhiêu 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 đó, các sản phẩm liên quan đến loại phòng và ngày đó sẽ không hiển thị.
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 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.
Để biết ví dụ về các trường hợp liên quan đến khoảng không quảng cáo, hãy xem Hướng dẫn.
Phần tử bắt buộc và phần tử không bắt buộc
Tài liệu tham khảo 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 bài viết Phần tử và thuộc tính của khoảng không quảng cáo.
Cú pháp và giản đồ
Hãy tham khảo ví dụ về Cú pháp khoảng không quảng cáo khi tạo thông báo Inventory (Kiểm kho) để đảm bảo bạn đang sử dụng đú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 của mình bằng giản đồ đã xuất bản trước khi gửi cho Google. Đối với giản đồ thông báo của Khoảng không quảng cáo, hãy xem Giản đồ quảng cáo khách sạn.
Nguyên tắc
Làm theo các nguyên tắc sau cho thông báo về Khoảng không quảng cáo:
Khoảng không quảng cáo phụ thuộc vào khách sạn, ngày và loại phòng.
Số lượng quỹ phòng phải lớn hơn
0cho tất cả các đêm lưu trú thì mới có thể hiển thị giá cho gói giá và số người lưu trú được liên kết.Nếu số lượng phòng trống bằng
0, thì bạn sẽ không thể đặt phòng cho Mã phòng và phạm vi ngày đã chỉ định.CountTypephải luôn có giá trị2để hợp lệ vì giá trị này cho biết số lượng "tình trạng rảnh/bận xác định".Gửi quỹ phòng đã cập nhật mỗi khi có một lượt đặt phòng hoặc huỷ phòng 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à tình trạng phòng cho biết liệu tổ hợp loại phòng và gói giá có được phép đặt trước hay không. Đối với ARI, cả tình trạng phòng và quỹ phòng có thể thay đổi tuỳ theo một nhóm ngày hoặc loại chỗ nghỉ, đồng thời cả hai đều có loại thông báo tương ứng. Khách sạn phụ thuộc vào quỹ phòng và tình trạng phòng theo khách sạn, ngày và loại phòng, cùng với việc bổ sung gói giá cho tình trạng phòng.
Có thể là trạng thái "không có sẵn" ngay cả khi có khoảng không quảng cáo vì khoảng không quảng cáo và tình trạng còn hàng độc lập với nhau.
Có hai khái niệm về tình trạng còn hàng. Thứ nhất, 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 sẽ chịu ảnh hưởng của các yếu tố như việc mỗi đêm có giá xác định hay không, quỹ phòng của loại phòng liên kết và giới hạn về tình trạng phòng có mở cửa hay không. Thứ hai, có quy định 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 kết thúc tình trạng còn hàng này được gọi là "ngừng bán".
Khoảng không quảng cáo phải là một số nguyên lớn hơn 0 cho phòng và giới hạn về tình trạng phòng phải được mở để hiển thị giá của sản phẩm.
Ví dụ:
Phần này đưa ra ví dụ cơ bản về thông báo Inventory (Kiểm kho) 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_inv_count_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> 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 đã sử dụng trong hệ thống cho các loại phòng. 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ụ này cho biết cách đặt quỹ phòng cho 13 phòng có thể đặt 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 bài viết Ví dụ về khoảng không quảng cáo.
Hướng dẫn
Phần này cung cấp tình huống bạn có thể gặp phải trong khi gửi thông báo Inventory (Kiểm kho).
Tình huống: Cách chặn không cho đặt phòng
Nội dung 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 nhóm ngày cụ thể, thường là nhất là vì đã hết phòng.
Giải pháp
Bạn đặt <InvCount Count> thành giá trị 0 và thêm phạm vi ngày mà bạn 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à các 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>