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 | 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 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 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 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 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 <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ư 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ó 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 phải khớp với giá trị thuộc tính |
| 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 các khoảng thời gian khác nhau của 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 (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 để cho biết rõ việc có bao gồm các ngày thứ Hai.
Nếu bạn đặt là |
| 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 là |
| 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à |
| 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 là |
| 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 là |
| 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à |
| 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 là |
| 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 để 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ỗ. Giá trị âm đượ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à:
|
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 hàng 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 | 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 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.
|
| 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.
|
| OTA_HotelInvCountNotifRS / Errors / Error | 1..n | Error | Nội dung mô tả về lỗi gặp phải trong quá trình xử lý thông báo OTA_HotelInvCountNotifRQ. Bạn có thể xem thông tin chi tiết về những 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 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ề những 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 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>