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

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>

Các 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	Nội dung 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.
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 của 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 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 thông báo OpenTravel.
OTA_HotelInvCountNotifRQ / POS	0..1	POS	Vùng chứa để xác định tài khoản đối tác cho thông báo này (thường 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	Đây là trường bắt buộc nếu có `<POS>`. Vùng chứa cho `<RequestorID>`.
OTA_HotelInvCountNotifRQ / POS / RequestorID	1	RequestorID	Đây là trường 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ị 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ó 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 của 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 thẻ <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 nhiều khoảng thời gian cho một cơ sở lưu trú.
OTA_HotelInvCountNotifRQ / Inventories / Inventory / StatusApplicationControl	1	StatusApplicationControl	Xác định phạm vi ngày, cũng như giá trị nhận dạng 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ú) trong 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ú) 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	Được đặt là `true` hoặc `1` để thể hiện rõ việc 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 rõ ràng 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	Được đặt là `true` hoặc `1` để thể hiện 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 rõ ràng 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` để thể hiện 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 rõ ràng 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	Được đặt là `true` hoặc `1` để thể hiện rõ việc có bao gồm thứ Năm. Nếu bạn đặt là `true`, thì những ngày khác trong tuần không được đặt rõ ràng 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	Được đặt là `true` hoặc `1` để thể hiện 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 rõ ràng 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` để thể hiện 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 rõ ràng 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	Được đặt là `true` hoặc `1` để thể hiện 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 rõ ràng 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 số lượng khoảng không quảng cáo.
OTA_HotelInvCountNotifRQ / Inventories / Inventory / InvCounts / InvCount	1	InvCount	Xác định số lượng phòng còn trống mà khách 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ị bằng 0 cho biết loại phòng này đã được bán hết. Giá trị âm sẽ được coi là 0.
OTA_HotelInvCountNotifRQ / Inventories / Inventory / InvCounts / InvCount / @CountType	1	enum	Loại số lượng khoảng không quảng cáo được chỉ đị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 5rooms left forRoomID_1` vào các 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>

Đã bán hết kho hàng

Đánh dấu RoomID_1 là đã bán 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>

Các 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	Nội dung 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 của 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. `<Success>` hoặc `<Errors>` xuất hiện trong mỗi thông báo.
OTA_HotelInvCountNotifRS / Errors	0..1	Errors	Vùng chứa một hoặc nhiều sự cố gặp phải trong quá trình xử lý thông báo `OTA_HotelInvCountNotifRQ`. `<Success>` hoặc `<Errors>` xuất hiện trong mỗi thông báo.
OTA_HotelInvCountNotifRS / Errors / Error	1..n	Error	Nội dung mô tả lỗi xảy ra trong khi 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 bài viết 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 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 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 của Google cho vấn đề. Bạn có thể xem thông tin chi tiết về các lỗi này trong bài viết 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 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 thông báo OTA_HotelInvCountNotifRQ không được 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>