要求
語法
OTA_HotelAvailNotifRQ
訊息使用以下語法:
<?xml version="1.0" encoding="UTF-8"?>
<OTA_HotelAvailNotifRQ xmlns="http://www.opentravel.org/OTA/2003/05"
EchoToken="message_ID"
TimeStamp="timestamp"
Version="3.0">
<POS>
<Source>
<RequestorID ID="partner_key"/>
</Source>
</POS>
<AvailStatusMessages HotelCode="HotelID">
<AvailStatusMessage BookingLimit="integer">
<StatusApplicationControl Start="YYYY-MM-DD"
End="YYYY-MM-DD"
Mon="boolean"
Tue="boolean"
Weds="boolean"
Thur="boolean"
Fri="boolean"
Sat="boolean"
Sun="boolean"
InvTypeCode="RoomID"/>
</AvailStatusMessage>
<AvailStatusMessage>
<StatusApplicationControl Start="YYYY-MM-DD"
End="YYYY-MM-DD"
Mon="boolean"
Tue="boolean"
Weds="boolean"
Thur="boolean"
Fri="boolean"
Sat="boolean"
Sun="boolean"
InvTypeCode="RoomID"
RatePlanCode="PackageID"/>
<LengthsOfStay FixedPatternLength="integer">
<LengthOfStay Time="integer"
TimeUnit="[Day]"
MinMaxMessageType="[SetMaxLOS|SetMinLOS|SetForwardMaxStay|
SetForwardMinStay|FullPatternLOS]">
<LOS_Pattern FullPatternLOS="pattern"/>
</LengthOfStay>
</LengthsOfStay>
<RestrictionStatus Status="[Close|Open]"
Restriction="[Arrival|Departure|Master]"
MaxAdvancedBookingOffset="integer_or_duration"
MinAdvancedBookingOffset="integer_or_duration"/>
</AvailStatusMessage>
</AvailStatusMessages>
</OTA_HotelAvailNotifRQ>
系統會將每則 <OTA_HotelAvailNotifRQ>
訊息視為差異更新。針對 <StatusApplicationControl>
中指定的每個房源、日期、房間和套裝行程,對先前定義的任何限制進行更新,只會取代相同限制的值,新增限制不會影響先前定義的其他限制。舉例來說,如果先前已定義最短住宿天數為 2 天,接著更新的新訊息只包含最長住宿天數為 7 天,那麼這項操作就不會清除先前的最短住宿天數值。
元素和屬性
OTA_HotelAvailNotifRQ
訊息包含下列元素和屬性:
注意:每種停留天數限制都會個別設定。舉例來說,設定 SetMaxLOS
的訊息不會覆寫先前定義的 SetForwardMaxStay
值。
元素 / @Attribute | 發生次數 | 類型 | 說明 |
---|---|---|---|
OTA_HotelAvailNotifRQ | 1 | Complex element | 定義房價供應情形的訊息根元素。 |
OTA_HotelAvailNotifRQ / @xmlns | 0..1 | string (URI) | XML 命名空間。 |
OTA_HotelAvailNotifRQ / @EchoToken | 1 | string | 此要求訊息的專屬 ID。這個值會在回應訊息中傳回。允許的字元為 a-z 、A-Z 、0-9 、_ (底線) 和 - (連字號)。 |
OTA_HotelAvailNotifRQ / @TimeStamp | 1 | DateTime | 這則訊息的建立日期和時間。 |
OTA_HotelAvailNotifRQ / @Version | 1 | decimal | OpenTravel 訊息版本。 |
OTA_HotelAvailNotifRQ / POS | 0..1 | POS | 用來指定此訊息的合作夥伴帳戶的容器。通常會在後端提供多個合作夥伴帳戶的價格動態饋給時使用。 |
OTA_HotelAvailNotifRQ / POS/ Source | 1 | Source | 如果 <POS> 存在,則為必要欄位。<RequestorID> 的容器。 |
OTA_HotelAvailNotifRQ / POS / RequestorID | 1 | RequestorID | 如果 <POS> 存在,則為必要欄位。定義合作夥伴帳戶。 |
OTA_HotelAvailNotifRQ / POS / RequestorID / @ID | 1 | string | 這封郵件的合作夥伴帳戶。這個字串值是 Hotel Center
帳戶設定頁面中列出的 Partner key 值。注意:如果您有提供多個帳戶動態饋給的後端,這個值必須與交易 (資源資料) 訊息的 |
OTA_HotelAvailNotifRQ / AvailStatusMessages | 1 | AvailStatusMessages | 一或多個 <AvailStatusMessage> 元素的容器。 |
OTA_HotelAvailNotifRQ / AvailStatusMessages / @HotelCode | 1 | string | 房源的專屬 ID。這個值必須與飯店清單動態饋給中 <listing> 元素中使用 <id> 指定的飯店 ID 相符。Hotel Center 也會列出飯店 ID。 |
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage | 1..n | AvailStatusMessage | 定義單一房源的不同時間範圍,以及房價供應情形和限制。 |
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / @BookingLimit | 1 | integer |
注意:建議使用
OTA_HotelInvCountNotifRQ 訊息,而非設定這個屬性。 在 必須等於或大於 0。如果為負值或未提供,則預設為 0。 注意:如要為特定 |
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / StatusApplicationControl | 1 | StatusApplicationControl | 定義日期範圍,以及房型 (InvTypeCode ) 和房價方案 (RatePlanCode ) 的 ID。 |
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / StatusApplicationControl / @Start | 1 | Date | 根據資源所在時區計算的開始日期,包含日期範圍。 |
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / StatusApplicationControl / @End | 1 | Date | 結束日期 (以資源的時區為準),包括日期範圍。必須等於或大於 start 值。
如果 start 和 end 相等,更新會套用至該日期。 |
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / StatusApplicationControl / @Mon | 0..1 | boolean | 設為 true 或 1 ,即可明確納入星期一。如果設為 |
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / StatusApplicationControl / @Tue | 0..1 | boolean | 設為 true 或 1 ,即可明確納入星期二。如果設為 |
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / StatusApplicationControl / @Weds | 0..1 | boolean | 設為 true 或 1 ,即可明確納入星期三。如果設為 |
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / StatusApplicationControl / @Thur | 0..1 | boolean | 設為 true 或 1 ,即可明確納入星期四。如果設為 |
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / StatusApplicationControl / @Fri | 0..1 | boolean | 設為 true 或 1 ,即可明確納入週五。如果設為 |
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / StatusApplicationControl / @Sat | 0..1 | boolean | 設為 true 或 1 ,即可明確納入週六。如果設為 |
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / StatusApplicationControl / @Sun | 0..1 | boolean | 設為 true 或 1 ,即可明確納入週日。如果設為 |
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / StatusApplicationControl / @InvTypeCode | 1 | string | 房源 (房型) 的專屬 ID。這個值會對應至 交易 (資源資料) 訊息中的 <RoomID> 。 |
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / StatusApplicationControl / @RatePlanCode | 0..1 | string | 費率方案的專屬 ID。這個 ID 會對應至交易 (資源資料) 訊息中的 <PackageID> 值。在 <OTA_HotelRateAmountNotifRQ> 和 <OTA_HotelAvailNotifRQ> 訊息中,費率方案會進一步定義並在 <StatusApplicationControl> 中參照。如果 |
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / LengthsOfStay | 0..1 | LengthsOfStay | 用於定義 LOS 限制的容器。如果 <AvailStatusMessage> 包含 BookingLimit 屬性,則不得出現此屬性。 |
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / LengthsOfStay / @FixedPatternLength | 0..1 | integer | FullPatternLOS 中定義的模式長度。注意:使用 |
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / LengthsOfStay / LengthOfStay | 1..n | LengthOfStay | 定義住宿天數限制。使用多個 <LengthOfStay> 元素時,每個元素都必須指定不同的 MinMaxMessageType 值。 |
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / LengthsOfStay / LengthOfStay / @Time | 0..1 | integer | 入住天數度量單位的值。請注意,系統會將值為零視為未設限制。例如,<LengthOfStay
Time="0" MinMaxMessageType="SetMaxLOS"> 表示沒有住宿天數上限。注意:除非使用 |
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / LengthsOfStay / LengthOfStay / @TimeUnit | 0..1 | enum | 時間單位。如果沒有提供,則預設值為 "Day" 。有效值如下:
"Day" 單位等於 1 晚住宿。
|
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / LengthsOfStay / LengthOfStay / @MinMaxMessageType | 1 | enum | 各種入住天數限制。SetMaxLOS 、SetMinLOS 和 FullPatternLOS 是根據抵達時間。SetForwardMinStay 和
SetForwardMaxStay 是根據停留時間計算。最大值必須大於或等於最小值。 |
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / LengthsOfStay / LengthOfStay / LOS_Pattern | 0..1 | LOS_Pattern | 定義入住天數限制模式。 注意:使用 |
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / LengthsOfStay / LengthOfStay / LOS_Pattern / @FullPatternLOS | 1 | string | 一系列 Y 和 N 字元,用於指出是否允許每個住宿天數,從一晚到 FixedPatternLength 中的值。任何長度大於
FixedPatternLength 的住宿天數都會繼承最終位置的值。舉例來說,FixedPatternLength="4" 和
FullPatternLOS="YNYN" 只允許停留天數 1 和 3。 |
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / RestrictionStatus | 0..1 | RestrictionStatus | 定義行程限制。如果 <AvailStatusMessage> 包含 BookingLimit 屬性,則不得出現此屬性。 |
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / RestrictionStatus / @Status | 0..1 | enum | 指出 Restriction 屬性指定的限制類型是開放還是封閉。有效值如下:
Open 和 Close 與 Arrival :
這個組合會指定行程中可供入住的日期Open 和 Close 與 Departure :
這個組合會指定行程中可供退房的日期
舉例來說,如果預訂期間為 4 月 1 日至 4 日,且 4 月 2 日至 4 日無法入住,仍可預訂。 注意:
|
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / RestrictionStatus / @Restriction | 0..1 | enum | 如果提供 有效值如下:
舉例來說,如果入住日期為 4 月 1 日,且住宿天數為三晚,完整行程日期為 4 月 1 日至 4 日。 注意:如果未指定 |
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / RestrictionStatus / @MinAdvancedBookingOffset | 0..1 | integer or duration | 在抵達日期前 (以住宿地點當地時間計算),最晚可預訂此房價的時間長度。 有效的值類型包括:
|
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / RestrictionStatus / @MaxAdvancedBookingOffset | 0..1 | integer or duration | 這個房價方案可預訂的到達日期前 (以飯店當地時間計算) 最長天數。 有效的值類型包括:
|
範例
LoS 抵達日期
設定最短和最長入住天數 (以抵達日期為準)。
<?xml version="1.0" encoding="UTF-8"?>
<OTA_HotelAvailNotifRQ xmlns="http://www.opentravel.org/OTA/2003/05"
EchoToken="12345678"
TimeStamp="2023-07-21T20:50:37-05:00"
Version="3.0">
<AvailStatusMessages HotelCode="Property_1">
<AvailStatusMessage>
<StatusApplicationControl Start="2023-07-26"
End="2023-07-31"
InvTypeCode="RoomID_1"
RatePlanCode="PackageID_1"/>
<LengthsOfStay>
<LengthOfStay Time="5" MinMaxMessageType="SetMaxLOS"/>
<LengthOfStay Time="2" MinMaxMessageType="SetMinLOS"/>
</LengthsOfStay>
</AvailStatusMessage>
</AvailStatusMessages>
</OTA_HotelAvailNotifRQ>
LoS 時間長度
設定最短和最長入住天數 (以住宿天數為準)。
<?xml version="1.0" encoding="UTF-8"?>
<OTA_HotelAvailNotifRQ xmlns="http://www.opentravel.org/OTA/2003/05"
EchoToken="12345678"
TimeStamp="2023-07-21T20:50:37-05:00"
Version="3.0">
<AvailStatusMessages HotelCode="Property_1">
<AvailStatusMessage>
<StatusApplicationControl Start="2023-07-26"
End="2023-07-31"
InvTypeCode="RoomID_1"
RatePlanCode="PackageID_1"/>
<LengthsOfStay>
<LengthOfStay Time="5" MinMaxMessageType="SetForwardMaxStay"/>
<LengthOfStay Time="2" MinMaxMessageType="SetForwardMinStay"/>
</LengthsOfStay>
</AvailStatusMessage>
</AvailStatusMessages>
</OTA_HotelAvailNotifRQ>
移除 LoS 限制
在 <LengthOfStay>
上將 Time="0" 表示指定入住天數沒有限制。例如,<LengthOfStay Time="0" MinMaxMessageType="SetMaxLOS"/>
表示沒有入住天數上限限制。
<?xml version="1.0" encoding="UTF-8"?>
<OTA_HotelAvailNotifRQ xmlns="http://www.opentravel.org/OTA/2003/05"
EchoToken="12345678"
TimeStamp="2024-07-21T20:50:37-05:00"
Version="3.0">
<AvailStatusMessages HotelCode="Property_1">
<AvailStatusMessage>
<StatusApplicationControl Start="2024-07-26"
End="2024-07-31"
InvTypeCode="RoomID_1"
RatePlanCode="PackageID_1"/>
<LengthsOfStay>
<LengthOfStay Time="0" MinMaxMessageType="SetMaxLOS"/>
</LengthsOfStay>
</AvailStatusMessage>
</AvailStatusMessages>
</OTA_HotelAvailNotifRQ>
出境限制
設定關閉至出發時間的限制。(這樣可避免行程中包含指定日期的退房時間)。
<?xml version="1.0" encoding="UTF-8"?>
<OTA_HotelAvailNotifRQ xmlns="http://www.opentravel.org/OTA/2003/05"
EchoToken="12345678"
TimeStamp="2023-07-21T20:50:37-05:00"
Version="3.0">
<AvailStatusMessages HotelCode="Property_1">
<AvailStatusMessage>
<StatusApplicationControl Start="2023-07-26"
End="2023-07-31"
InvTypeCode="RoomID_1"
RatePlanCode="PackageID_1"/>
<RestrictionStatus Status="Close" Restriction="Departure"/>
</AvailStatusMessage>
</AvailStatusMessages>
</OTA_HotelAvailNotifRQ>
抵達限制
設定「不接受到達」限制。(這可避免行程中包含指定日期的入住時間)。
<?xml version="1.0" encoding="UTF-8"?>
<OTA_HotelAvailNotifRQ xmlns="http://www.opentravel.org/OTA/2003/05"
EchoToken="12345678"
TimeStamp="2023-07-21T20:50:37-05:00"
Version="3.0">
<AvailStatusMessages HotelCode="Property_1">
<AvailStatusMessage>
<StatusApplicationControl Start="2023-07-26"
End="2023-07-31"
InvTypeCode="RoomID_1"
RatePlanCode="PackageID_1"/>
<RestrictionStatus Status="Close" Restriction="Arrival"/>
</AvailStatusMessage>
</AvailStatusMessages>
</OTA_HotelAvailNotifRQ>
開放預訂日期
在指定日期開放房型和房價方案的預訂。
注意:你必須提供每晚房價,並確保房型庫存數量大於 0,系統才能完全顯示價格。
<?xml version="1.0" encoding="UTF-8"?>
<OTA_HotelAvailNotifRQ xmlns="http://www.opentravel.org/OTA/2003/05"
EchoToken="12345678"
TimeStamp="2023-07-21T20:50:37-05:00"
Version="3.0">
<AvailStatusMessages HotelCode="Property_1">
<AvailStatusMessage>
<StatusApplicationControl Start="2023-07-26"
End="2023-07-31"
InvTypeCode="RoomID_1"
RatePlanCode="PackageID_1"/>
<RestrictionStatus Status="Open" Restriction="Master"/>
</AvailStatusMessage>
</AvailStatusMessages>
</OTA_HotelAvailNotifRQ>
關閉可訂日期
在指定日期關閉某個房型和房價方案的可訂房數。(這也稱為「停止銷售」)。
<?xml version="1.0" encoding="UTF-8"?>
<OTA_HotelAvailNotifRQ xmlns="http://www.opentravel.org/OTA/2003/05"
EchoToken="12345678"
TimeStamp="2023-07-21T20:50:37-05:00"
Version="3.0">
<AvailStatusMessages HotelCode="Property_1">
<AvailStatusMessage>
<StatusApplicationControl Start="2023-07-26"
End="2023-07-31"
InvTypeCode="RoomID_1"
RatePlanCode="PackageID_1"/>
<RestrictionStatus Status="Close" Restriction="Master"/>
</AvailStatusMessage>
</AvailStatusMessages>
</OTA_HotelAvailNotifRQ>
提前預訂限制
設定最短和最長的提前預訂期限制,僅適用於週末。
<?xml version="1.0" encoding="UTF-8"?>
<OTA_HotelAvailNotifRQ xmlns="http://www.opentravel.org/OTA/2003/05"
EchoToken="12345678"
TimeStamp="2023-07-21T20:50:37-05:00"
Version="3.0">
<AvailStatusMessages HotelCode="Property_1">
<AvailStatusMessage>
<StatusApplicationControl Start="2023-01-01"
End="2023-06-30"
Mon=”false”
Tue=”false”
Weds=”false”
Thur=”false”
Fri=”false”
Sat=”true”
Sun=”true”
InvTypeCode="RoomID_1"
RatePlanCode="PackageID_1"/>
<RestrictionStatus MaxAdvancedBookingOffset="30"
MinAdvancedBookingOffset="2"/>
</AvailStatusMessage>
</AvailStatusMessages>
</OTA_HotelAvailNotifRQ>
預訂截止時間
在抵達當天,以飯店當地時間 18:00 為基準,套用訂房截止時間。
<?xml version="1.0" encoding="UTF-8"?>
<OTA_HotelAvailNotifRQ xmlns="http://www.opentravel.org/OTA/2003/05"
EchoToken="12345678"
TimeStamp="2023-07-21T20:50:37-05:00"
Version="3.0">
<AvailStatusMessages HotelCode="Property_1">
<AvailStatusMessage>
<StatusApplicationControl Start="2023-01-01"
End="2023-06-30"
InvTypeCode="RoomID_1"
RatePlanCode="PackageID_1"/>
<RestrictionStatus MinAdvancedBookingOffset="P0DT6H0M"/>
</AvailStatusMessage>
</AvailStatusMessages>
</OTA_HotelAvailNotifRQ>
多項限制
針對房型和費率方案,在相同日期設定多個限制。
<?xml version="1.0" encoding="UTF-8"?>
<OTA_HotelAvailNotifRQ xmlns="http://www.opentravel.org/OTA/2003/05"
EchoToken="12345678"
TimeStamp="2023-07-21T20:50:37-05:00"
Version="3.0">
<AvailStatusMessages HotelCode="Property_1">
<AvailStatusMessage>
<StatusApplicationControl Start="2023-07-26"
End="2023-07-31"
InvTypeCode="RoomID_1"
RatePlanCode="PackageID_1"/>
<RestrictionStatus Status="Open" Restriction="Master"/>
</AvailStatusMessage>
<AvailStatusMessage>
<StatusApplicationControl Start="2023-07-26"
End="2023-07-31"
InvTypeCode="RoomID_1"
RatePlanCode="PackageID_1"/>
<RestrictionStatus Status="Close" Restriction="Arrival"/>
</AvailStatusMessage>
<AvailStatusMessage>
<StatusApplicationControl Start="2023-07-26"
End="2023-07-31"
InvTypeCode="RoomID_1"
RatePlanCode="PackageID_1"/>
<RestrictionStatus Status="Close" Restriction="Departure"/>
</AvailStatusMessage>
</AvailStatusMessages>
</OTA_HotelAvailNotifRQ>
預訂上限
設定房型在指定日期的房源數量。
注意:建議使用 OTA_HotelInvCountNotifRQ 訊息,而非設定這項屬性。
<?xml version="1.0" encoding="UTF-8"?>
<OTA_HotelAvailNotifRQ xmlns="http://www.opentravel.org/OTA/2003/05"
EchoToken="12345678"
TimeStamp="2023-07-21T20:50:37-05:00"
Version="3.0">
<AvailStatusMessages HotelCode="Property_1">
<AvailStatusMessage BookingLimit="5">
<!-- Note: RatePlanCode must not be specified here when setting inventory counts. -->
<StatusApplicationControl Start="2023-07-26"
End="2023-07-31"
InvTypeCode="RoomID_1"/>
</AvailStatusMessage>
</AvailStatusMessages>
</OTA_HotelAvailNotifRQ>
FullPatternLoS
設定完整的住宿天數限制。
如果入住日期為 2023 年 7 月 26 日,則只允許 2、4 和 6 天的入住天數。無法選擇 1、3、5 和 7 天以上的入住天數。
<?xml version="1.0" encoding="UTF-8"?>
<OTA_HotelAvailNotifRQ xmlns="http://www.opentravel.org/OTA/2003/05"
EchoToken="12345678"
TimeStamp="2023-07-21T20:50:37-05:00"
Version="3.0">
<AvailStatusMessages HotelCode="Property_1">
<AvailStatusMessage>
<StatusApplicationControl Start="2023-07-26"
End="2023-07-26"
InvTypeCode="RoomID_1"
RatePlanCode="PackageID_1"/>
<LengthsOfStay FixedPatternLength="7">
<LengthOfStay MinMaxMessageType="FullPatternLOS">
<LOS_Pattern FullPatternLOS="NYNYNYN"/>
</LengthOfStay>
</LengthsOfStay>
</AvailStatusMessage>
</AvailStatusMessages>
</OTA_HotelAvailNotifRQ>
回應
語法
OTA_HotelAvailNotifRS
訊息使用以下語法:
<?xml version="1.0" encoding="UTF-8"?>
<OTA_HotelAvailNotifRS 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_HotelAvailNotifRS>
元素和屬性
OTA_HotelAvailNotifRS
訊息包含下列元素和屬性:
元素 / @Attribute | 發生次數 | 類型 | 說明 |
---|---|---|---|
OTA_HotelAvailNotifRS | 1 | Complex element | 回應可用性訊息的根元素。 |
OTA_HotelAvailNotifRS / @TimeStamp | 1 | DateTime | 這則訊息的建立日期和時間。 |
OTA_HotelAvailNotifRS / @EchoToken | 1 | string | 相關聯 OTA_HotelAvailNotifRQ 訊息的專屬 ID。 |
OTA_HotelAvailNotifRS / Success | 0..1 | Success | 表示 OTA_HotelAvailNotifRQ 訊息已順利處理。每則訊息都會提供 |
OTA_HotelAvailNotifRS / Errors | 0..1 | Errors | 處理 OTA_HotelAvailNotifRQ 訊息時遇到一或多個問題的容器。每則訊息都會提供 |
OTA_HotelAvailNotifRS / Errors / Error | 1..n | Error | 處理 OTA_HotelAvailNotifRQ 訊息時發生錯誤的說明。如要瞭解這些錯誤的詳細資訊,請參閱「
動態饋給狀態錯誤訊息」。 |
OTA_HotelAvailNotifRS / Errors / Error / @Type | 1 | integer | 與錯誤相關聯的 OpenTravel Alliance EWT (錯誤警告類型)。只會使用 12 (Processing exception) 值。 |
OTA_HotelAvailNotifRS / Errors / Error / @Code | 1 | integer | 與錯誤相關的 OpenTravel Alliance ERR (錯誤代碼)。
只會使用 450 (Unable to process) 值。 |
OTA_HotelAvailNotifRS / Errors / Error / @Code | 1 | enum | 原始要求的狀態。只會使用 NotProcessed 的值。 |
OTA_HotelAvailNotifRS / Errors / Error / @ShortText | 1 | string | 問題的 Google 識別碼。如要瞭解這些錯誤的詳細資訊,請參閱「 動態饋給狀態錯誤訊息」。 |
範例
成功
以下是已成功處理的 OTA_HotelAvailNotifRQ 訊息回應。
<?xml version="1.0" encoding="UTF-8"?>
<OTA_HotelAvailNotifRS xmlns="http://www.opentravel.org/OTA/2003/05"
TimeStamp="2023-07-21T20:50:37-05:00"
Version="3.0">
<Success/>
</OTA_HotelAvailNotifRS>
錯誤
以下是 OTA_HotelAvailNotifRQ 訊息因錯誤而未處理的回應。
<?xml version="1.0" encoding="UTF-8"?>
<OTA_HotelAvailNotifRS xmlns="http://www.opentravel.org/OTA/2003/05"
TimeStamp="2023-07-21T20:50:37-05:00"
Version="3.0">
<Errors>
<Error Type="12" Code="450" Status="NotProcessed" ShortText="8001">Example</Error>
</Errors>
</OTA_HotelAvailNotifRS>