OTA_HotelInvCountNotifRQ (OTA_HotelInvCountNotifRQ)

Yêu cầu

Cú pháp

Thông báo OTA_HotelInvCountNotifRQ sử dụng cú pháp sau:

<?xml version="1.0" encoding="UTF-8"?>
<OTA_HotelInvCountNotifRQ xmlns="http://www.opentravel.org/OTA/2003/05"
                          EchoToken="message_ID"
                          TimeStamp="timestamp"
                          Version="3.0">
  <POS>
    <Source>
      <RequestorID ID="partner_key"/>
    </Source>
  </POS>
  <Inventories HotelCode="HotelID">
    <Inventory>
      <StatusApplicationControl Start="YYYY-MM-DD"
                                End="YYYY-MM-DD"
                                Mon="boolean_value"
                                Tue="boolean_value"
                                Weds="boolean_value"
                                Thur="boolean_value"
                                Fri="boolean_value"
                                Sat="boolean_value"
                                Sun="boolean_value"
                                InvTypeCode="RoomID"/>
      <InvCounts>
        <InvCount Count="integer" CountType="2"/>
      </InvCounts>
    </Inventory>
  </Inventories>
</OTA_HotelInvCountNotifRQ>

Phần tử và thuộc tính

Thông báo OTA_HotelInvCountNotifRQ có các thành phần sau và thuộc tính:

Phần tử / @Thuộc tính Số lần xuất hiện Loại Mô tả
OTA_HotelInvCountNotifRQ 1 Complex element Phần tử gốc của thông báo giúp xác định tình trạng phòng của giá phòng.
OTA_HotelInvCountNotifRQ / @xmlns 0..1 string (URI) Không gian tên XML.
OTA_HotelInvCountNotifRQ / @EchoToken 1 string Giá trị nhận dạng duy nhất cho thông báo yêu cầu này. Giá trị này được trả về trong tin nhắn phản hồi. Các ký tự được phép là a-z, A-Z, 0-9, _ (dấu gạch dưới) và - (dấu gạch ngang).
OTA_HotelInvCountNotifRQ / @TimeStamp 1 DateTime Ngày và giờ tạo thông báo này.
OTA_HotelInvCountNotifRQ / @Version 1 decimal Phiên bản của thông báo trên OpenTravel.
OTA_HotelInvCountNotifRQ / POS 0..1 POS Vùng chứa để chỉ định tài khoản đối tác cho thông báo này (thường được sử dụng nếu phần phụ trợ của bạn cung cấp nguồn cấp dữ liệu giá cho nhiều tài khoản đối tác).
OTA_HotelInvCountNotifRQ / POS/ Source 1 Source Bắt buộc nếu có <POS>. Vùng chứa cho <RequestorID>.
OTA_HotelInvCountNotifRQ / POS / RequestorID 1 RequestorID Bắt buộc nếu có <POS>. Xác định đối tác tài khoản.
OTA_HotelInvCountNotifRQ / POS / RequestorID / @ID 1 string Tài khoản đối tác dùng cho thư này. Giá trị chuỗi này là Giá trị khoá đối tác được liệt kê trên Trang Cài đặt tài khoản trong Hotel Center.

Lưu ý: Nếu bạn có phần phụ trợ cung cấp nguồn cấp dữ liệu cho nhiều tài khoản, giá trị này cần phải khớp với partner giá trị thuộc tính của thông báo Giao dịch (Dữ liệu của cơ sở lưu trú) và ID trong <RequestorID> phần tử của <OTA_HotelRateAmountNotifRQ> tin nhắn cho cùng một kết quả tài khoản.

OTA_HotelInvCountNotifRQ / Inventories 1 Inventories Vùng chứa một hoặc nhiều <Inventory> phần tử.
OTA_HotelInvCountNotifRQ / Inventories / @HotelCode 1 string Giá trị nhận dạng duy nhất của 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 <danh sách> của nguồn cấp dữ liệu Danh sách khách sạn. Mã khách sạn cũng có trong Hotel Center.
OTA_HotelInvCountNotifRQ / Inventories / Inventory 1..n Inventory Xác định số phòng còn trống trong nhiều khoảng thời gian cho một phòng đơn thuộc tính này.
OTA_HotelInvCountNotifRQ / Inventories / Inventory / StatusApplicationControl 1 StatusApplicationControl Xác định phạm vi ngày cũng như giá trị nhận dạng của loại phòng (InvTypeCode).
OTA_HotelInvCountNotifRQ / Inventories / Inventory / StatusApplicationControl / @Start 1 Date Ngày bắt đầu (dựa trên múi giờ của cơ sở lưu trú), tính cả ngày phạm vi ngày.
OTA_HotelInvCountNotifRQ / Inventories / Inventory / StatusApplicationControl / @End 1 Date Ngày kết thúc (dựa trên múi giờ của cơ sở lưu trú) kể cả ngày phạm vi ngày. Phải bằng hoặc lớn hơn giá trị start. Nếu startend bằng nhau, nội dung cập nhật sẽ được áp dụng cho đến ngày đó.
OTA_HotelInvCountNotifRQ / Inventories / Inventory / StatusApplicationControl / @Mon 0..1 boolean Được đặt là true hoặc 1 để cho biết rõ việc có bao gồm các ngày thứ Hai.

Nếu bạn đặt thành true thì những ngày khác trong tuần sẽ không được đặt được đặt rõ ràng thành true sẽ bị loại trừ (trên thực tế, chúng sẽ được lọc khỏi các ngày trong phạm vi StartEnd).

OTA_HotelInvCountNotifRQ / Inventories / Inventory / StatusApplicationControl / @Tue 0..1 boolean Được đặt là true hoặc 1 để cho biết rõ việc có bao gồm các ngày thứ Ba.

Nếu bạn đặt thành true thì những ngày khác trong tuần sẽ không được đặt được đặt rõ ràng thành true sẽ bị loại trừ (trên thực tế, chúng sẽ được lọc khỏi các ngày trong phạm vi StartEnd).

OTA_HotelInvCountNotifRQ / Inventories / Inventory / StatusApplicationControl / @Weds 0..1 boolean Được đặt là true hoặc 1 để cho biết rõ việc có bao gồm các ngày thứ Tư.

Nếu bạn đặt thành true thì những ngày khác trong tuần sẽ không được đặt được đặt rõ ràng thành true sẽ bị loại trừ (trên thực tế, chúng sẽ được lọc khỏi các ngày trong phạm vi StartEnd).

OTA_HotelInvCountNotifRQ / Inventories / Inventory / StatusApplicationControl / @Thur 0..1 boolean Được đặt là true hoặc 1 để cho biết rõ việc có bao gồm các ngày thứ Năm.

Nếu bạn đặt thành true thì những ngày khác trong tuần sẽ không được đặt được đặt rõ ràng thành true sẽ bị loại trừ (trên thực tế, chúng sẽ được lọc khỏi các ngày trong phạm vi StartEnd).

OTA_HotelInvCountNotifRQ / Inventories / Inventory / StatusApplicationControl / @Fri 0..1 boolean Được đặt là true hoặc 1 để cho biết rõ việc có bao gồm các ngày thứ Sáu.

Nếu bạn đặt thành true thì những ngày khác trong tuần sẽ không được đặt được đặt rõ ràng thành true sẽ bị loại trừ (trên thực tế, chúng sẽ được lọc khỏi các ngày trong phạm vi StartEnd).

OTA_HotelInvCountNotifRQ / Inventories / Inventory / StatusApplicationControl / @Sat 0..1 boolean Được đặt là true hoặc 1 để cho biết rõ việc có bao gồm các ngày thứ Bảy.

Nếu bạn đặt thành true thì những ngày khác trong tuần sẽ không được đặt được đặt rõ ràng thành true sẽ bị loại trừ (trên thực tế, chúng sẽ được lọc khỏi các ngày trong phạm vi StartEnd).

OTA_HotelInvCountNotifRQ / Inventories / Inventory / StatusApplicationControl / @Sun 0..1 boolean Được đặt là true hoặc 1 để cho biết rõ việc có bao gồm các ngày Chủ Nhật.

Nếu bạn đặt thành true thì những ngày khác trong tuần sẽ không được đặt được đặt rõ ràng thành true sẽ bị loại trừ (trên thực tế, chúng sẽ được lọc khỏi các ngày trong phạm vi StartEnd).

OTA_HotelInvCountNotifRQ / Inventories / Inventory / StatusApplicationControl / @InvTypeCode 1 string Giá trị nhận dạng duy nhất của quỹ phòng (loại phòng). Giá trị này liên kết đến <RoomID> trong trang Giao dịch (Dữ liệu của cơ sở lưu trú).
OTA_HotelInvCountNotifRQ / Inventories / Inventory / InvCounts 1 InvCounts Vùng chứa để xác định một số lượng khoảng không quảng cáo duy nhất.
OTA_HotelInvCountNotifRQ / Inventories / Inventory / InvCounts / InvCount 1 InvCount Xác định số lượng phòng còn trống có thể đặt trước.
OTA_HotelInvCountNotifRQ / Inventories / Inventory / InvCounts / InvCount / @Count 1 integer Số phòng còn trống mà khách có thể đặt trước cho loại phòng đó. Giá trị 0 cho biết loại phòng đã hết chỗ. A - sẽ được coi là 0.
OTA_HotelInvCountNotifRQ / Inventories / Inventory / InvCounts / InvCount / @CountType 1 enum

Loại khoảng không quảng cáo đang được chỉ định. Giá trị hợp lệ là:

  • 2: Tình trạng còn hàng rõ ràng.

Ví dụ

Khoảng không quảng cáo còn lại

Đặt còn 5 phòng cho RoomID_1 vào những ngày cụ thể.

<OTA_HotelInvCountNotifRQ xmlns="http://www.opentravel.org/OTA/2003/05"
                          EchoToken="12345678"
                          TimeStamp="2023-07-13T20:50:37-05:00"
                          Version="3.0">
  <Inventories HotelCode="Property_1">
    <Inventory>
      <StatusApplicationControl Start="2023-07-18"
                                End="2023-07-23"
                                InvTypeCode="RoomID_1"/>
      <InvCounts>
        <InvCount Count="5" CountType="2"/>
      </InvCounts>
    </Inventory>
  </Inventories>
</OTA_HotelInvCountNotifRQ>

Lượng hàng đã bán hết

Đánh dấu RoomID_1 là hết vé vào những ngày cụ thể.

<OTA_HotelInvCountNotifRQ xmlns="http://www.opentravel.org/OTA/2003/05"
                          EchoToken="12345678"
                          TimeStamp="2023-07-13T20:50:37-05:00"
                          Version="3.0">
  <Inventories HotelCode="Property_1">
    <Inventory>
      <StatusApplicationControl Start="2023-07-18"
                                End="2023-07-23"
                                InvTypeCode="RoomID_1"/>
      <InvCounts>
        <InvCount Count="0" CountType="2"/>
      </InvCounts>
    </Inventory>
  </Inventories>
</OTA_HotelInvCountNotifRQ>

Phản hồi

Cú pháp

Thông báo OTA_HotelInvCountNotifRS sử dụng cú pháp sau:

<?xml version="1.0" encoding="UTF-8"?>
<OTA_HotelInvCountNotifRS xmlns="http://www.opentravel.org/OTA/2003/05"
                          TimeStamp="timestamp"
                          EchoToken="echo_token"
                          Version="3.0">
  <!-- Either Success or Errors will be populated. -->
  <Success/>
  <Errors>
    <Error Type="12" Status="NotProcessed" ShortText="issue_code">issue_description</Error>
  </Errors>
</OTA_HotelInvCountNotifRS>

Phần tử và thuộc tính

Thông báo OTA_HotelInvCountNotifRS có các thành phần sau và thuộc tính:

Phần tử / @Thuộc tính Số lần xuất hiện Loại Mô tả
1 Complex element Phần tử gốc của phản hồi cho thông báo về tình trạng rảnh/bận.
OTA_HotelInvCountNotifRS / @TimeStamp 1 DateTime Ngày và giờ tạo thông báo này.
OTA_HotelInvCountNotifRS / @EchoToken 1 string Giá trị nhận dạng duy nhất từ OTA_HotelInvCountNotifRQ tin nhắn.
OTA_HotelInvCountNotifRS / Success 0..1 Success Cho biết thông báo OTA_HotelInvCountNotifRQ đã đã được xử lý thành công.

<Success> hoặc <Errors> là xuất hiện trong mỗi thông điệp.

OTA_HotelInvCountNotifRS / Errors 0..1 Errors Vùng chứa một hoặc nhiều vấn đề gặp phải trong khi xử lý OTA_HotelInvCountNotifRQ tin nhắn.

<Success> hoặc <Errors> là xuất hiện trong mỗi thông điệp.

OTA_HotelInvCountNotifRS / Errors / Error 1..n Error Mô tả lỗi gặp phải trong khi xử lý OTA_HotelInvCountNotifRQ tin nhắn. Bạn có thể xem thông tin chi tiết về các lỗi này trong Thông báo lỗi về trạng thái nguồn cấp dữ liệu.
OTA_HotelInvCountNotifRS / Errors / Error / @Type 1 integer Loại cảnh báo lỗi (EWT) của OpenTravel Alliance liên kết với . Chỉ sử dụng giá trị 12 (Processing exception).
OTA_HotelInvCountNotifRS / Errors / Error / @Code 1 integer Mã lỗi (ERR) của OpenTravel Alliance tương ứng với lỗi. Chỉ sử dụng giá trị 450 (Unable to process).
OTA_HotelInvCountNotifRS / Errors / Error / @Code 1 enum Trạng thái của yêu cầu ban đầu. Chỉ giá trị NotProcessed được dùng.
OTA_HotelInvCountNotifRS / Errors / Error / @ShortText 1 string Giá trị nhận dạng của Google cho vấn đề. Bạn có thể xem thông tin chi tiết về những lỗi này có trong Thông báo lỗi về trạng thái nguồn cấp dữ liệu.

Ví dụ

Thành công

Sau đây là phản hồi cho một sự kiện đã được xử lý thành công OTA_HotelInvCountNotifRQ tin nhắn.

<?xml version="1.0" encoding="UTF-8"?>
<OTA_HotelInvCountNotifRS xmlns="http://www.opentravel.org/OTA/2003/05"
                          TimeStamp="2023-07-23T20:50:37-05:00"
                          Version="3.0">
  <Success/>
</OTA_HotelInvCountNotifRS>

Lỗi

Dưới đây là phản hồi cho thông báo OTA_HotelInvCountNotifRQ không đã xử lý do lỗi.

<?xml version="1.0" encoding="UTF-8"?>
<OTA_HotelInvCountNotifRS xmlns="http://www.opentravel.org/OTA/2003/05"
                          TimeStamp="2023-07-23T20:50:37-05:00"
                          Version="3.0">
  <Errors>
    <Error Type="12" Code="450" Status="NotProcessed" ShortText="8001">Example</Error>
  </Errors>
</OTA_HotelInvCountNotifRS>