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 phần tử và thuộc tính sau:

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 có giá phòng hay không.
OTA_HotelInvCountNotifRQ / @xmlns 0..1 string (URI) Vùng chứa tên tệp 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 thông báo phản hồi. Các ký tự được phép sử dụng là a – z, A – Z, 0 – 9, _ (dấu gạch dưới) và - (dấu gạch nối).
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 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 tài khoản đối tác.
OTA_HotelInvCountNotifRQ / POS / RequestorID / @ID 1 string Tài khoản đối tác dùng cho thông báo này. Giá trị của chuỗi này là giá trị của 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ó một phần phụ trợ cung cấp nguồn cấp dữ liệu cho nhiều tài khoản, thì giá trị này cần phải khớp với giá trị thuộc tính partner của thông báo Giao dịch (Dữ liệu về cơ sở lưu trú) và giá trị thuộc tính ID trong phần tử <RequestorID> của thông báo <OTA_HotelRateAmountNotifRQ> cho cùng một tài khoản.
OTA_HotelInvCountNotifRQ / Inventories 1 Inventories Vùng chứa một hoặc nhiều phần tử <Inventory>.
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 phần tử <listing> 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ố lượng phòng còn trống trong những khoảng thời gian khác nhau tại một cơ sở lưu trú.
OTA_HotelInvCountNotifRQ / Inventories / Inventory / StatusApplicationControl 1 StatusApplicationControl Xác định phạm vi ngày và giá trị nhận dạng loại phòng (InvTypeCode).
OTA_HotelInvCountNotifRQ / Inventories / Inventory / StatusApplicationControl / @Start 1 Date Ngày bắt đầu (sử dụng múi giờ của cơ sở lưu trú) trong phạm vi ngày.
OTA_HotelInvCountNotifRQ / Inventories / Inventory / StatusApplicationControl / @End 1 Date Ngày kết thúc (sử dụng múi giờ của cơ sở lưu trú) trong phạm vi ngày. Phải bằng hoặc lớn hơn giá trị start. Nếu start và end bằng nhau, nội dung cập nhật sẽ áp dụng cho ngày đó.
OTA_HotelInvCountNotifRQ / Inventories / Inventory / StatusApplicationControl / @Mon 0..1 boolean Đặt là true hoặc 1 để thể hiện rõ là có bao gồm các ngày thứ Hai.

Nếu bạn đặt là true, thì những ngày khác trong tuần không được đặt là true sẽ bị loại trừ (thực tế, những ngày đó sẽ bị lọc ra khỏi những ngày trong khoảng thời gian từ Start đến End).
OTA_HotelInvCountNotifRQ / Inventories / Inventory / StatusApplicationControl / @Tue 0..1 boolean Đặt thành 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 là true, thì những ngày khác trong tuần không được đặt là true sẽ bị loại trừ (thực tế, những ngày đó sẽ bị lọc ra khỏi những ngày trong khoảng thời gian từ Start đến End).
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 là true, thì những ngày khác trong tuần không được đặt là true sẽ bị loại trừ (thực tế, những ngày đó sẽ bị lọc ra khỏi những ngày trong khoảng thời gian từ Start đến End).
OTA_HotelInvCountNotifRQ / Inventories / Inventory / StatusApplicationControl / @Thur 0..1 boolean Đặt thành 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 là true, thì những ngày khác trong tuần không được đặt là true sẽ bị loại trừ (thực tế, những ngày đó sẽ bị lọc ra khỏi những ngày trong khoảng thời gian từ Start đến End).
OTA_HotelInvCountNotifRQ / Inventories / Inventory / StatusApplicationControl / @Fri 0..1 boolean Đặt thành 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 là true, thì những ngày khác trong tuần không được đặt là true sẽ bị loại trừ (thực tế, những ngày đó sẽ bị lọc ra khỏi những ngày trong khoảng thời gian từ Start đến End).
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 là true, thì những ngày khác trong tuần không được đặt là true sẽ bị loại trừ (thực tế, những ngày đó sẽ bị lọc ra khỏi những ngày trong khoảng thời gian từ Start đến End).
OTA_HotelInvCountNotifRQ / Inventories / Inventory / StatusApplicationControl / @Sun 0..1 boolean Đặt thành 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 là true, thì những ngày khác trong tuần không được đặt là true sẽ bị loại trừ (thực tế, những ngày đó sẽ bị lọc ra khỏi những ngày trong khoảng thời gian từ Start đến End).
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 tương ứng với <RoomID> trong thông báo Giao dịch (Dữ liệu của cơ sở lưu trú).
OTA_HotelInvCountNotifRQ / Inventories / Inventory / InvCounts 1 InvCounts Vùng chứa dùng để xác định một quỹ phòng 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ố lượng phòng còn trống có thể đặt trước đối với loại phòng này. Giá trị là 0 có nghĩa là loại phòng này đã được đặt hết. Giá trị âm cũng được coi là 0.
OTA_HotelInvCountNotifRQ / Inventories / Inventory / InvCounts / InvCount / @CountType 1 enum

Loại của số quỹ phòng được xác định. Giá trị hợp lệ là:

  • 2: Chắc chắn còn trống.

Ví dụ

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

Đặt 5 phòng trống cho loại phòng 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>

Khoảng không quảng cáo đã bán hết

Đánh dấu loại phòng RoomID_1 là được đặt hết 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 phần tử và thuộc tính sau:

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 kiểm tra tình trạng phòng.
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 lấy từ thông báo OTA_HotelInvCountNotifRQ được liên kết.
OTA_HotelInvCountNotifRS / Success 0..1 Success Cho biết rằng thông báo OTA_HotelInvCountNotifRQ đã được xử lý thành công.

Mỗi thông báo có <Success> hoặc <Errors>.
OTA_HotelInvCountNotifRS / Errors 0..1 Errors Vùng chứa một hoặc nhiều vấn đề gặp phải trong quá trình xử lý thông báo OTA_HotelInvCountNotifRQ.

Mỗi thông báo có <Success> hoặc <Errors>.
OTA_HotelInvCountNotifRS / Errors / Error 1..n Error Thông tin mô tả về lỗi xảy ra trong quá trình xử lý thông báo OTA_HotelInvCountNotifRQ. 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 của 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 Hiệp hội OpenTravel Alliance tương ứng với lỗi. Chỉ sử dụng giá trị 12 (Processing exception).
OTA_HotelInvCountNotifRS / Errors / Error / @Code 1 integer Mã lỗi (ERR) của Hiệp hội 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ỉ sử dụng giá trị NotProcessed.
OTA_HotelInvCountNotifRS / Errors / Error / @ShortText 1 string Giá trị nhận dạng sự cố của Google. Bạn có thể xem chi tiết về các lỗi này trong Thông báo lỗi về trạng thái của nguồn cấp dữ liệu.

Ví dụ

Thành công

Dưới đây là phản hồi cho một thông báo OTA_HotelInvCountNotifRQ được xử lý thành công.

<?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 một thông báo OTA_HotelInvCountNotifRQ không được xử lý do gặp 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>