İstekler
Söz dizimi
OTA_HotelInvCountNotifRQ
mesajında aşağıdaki söz dizimi kullanılır:
<?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>
Öğeler ve özellikler
OTA_HotelInvCountNotifRQ
mesajında aşağıdaki öğeler ve özellikler bulunur:
Öğe / @Özellik | Yineleme sayısı | Tür | Açıklama |
---|---|---|---|
OTA_HotelInvCountNotifRQ | 1 | Complex element | Oda fiyatının müsaitlik durumunu tanımlayan bir mesajın kök öğesidir. |
OTA_HotelInvCountNotifRQ / @xmlns | 0..1 | string (URI) | XML ad alanıdır. |
OTA_HotelInvCountNotifRQ / @EchoToken | 1 | string | Bu istek mesajının benzersiz tanımlayıcısıdır. Bu değer, yanıt mesajında döndürülür. İzin verilen karakterler a-z, A-Z, 0-9, _ (alt çizgi) ve - (kısa çizgi) şeklindedir. |
OTA_HotelInvCountNotifRQ / @TimeStamp | 1 | DateTime | Bu mesajın oluşturulma tarihi ve saati. |
OTA_HotelInvCountNotifRQ / @Version | 1 | decimal | OpenTravel mesaj sürümüdür. |
OTA_HotelInvCountNotifRQ / POS | 0..1 | POS | Bu mesaj için iş ortağı hesabını belirten bir kapsayıcıdır (genellikle arka ucunuz birden fazla iş ortağı hesabı için fiyat feed'leri sağlıyorsa kullanılır). |
OTA_HotelInvCountNotifRQ / POS/ Source | 1 | Source | <POS> varsa gereklidir. <RequestorID> öğesinin kapsayıcısıdır. |
OTA_HotelInvCountNotifRQ / POS / RequestorID | 1 | RequestorID | <POS> varsa gereklidir. İş ortağı hesabını tanımlar. |
OTA_HotelInvCountNotifRQ / POS / RequestorID / @ID | 1 | string | Bu mesajın iş ortağı hesabıdır. Bu dize değeri, Hotel Center'ın
Hesap ayarları sayfasında listelenen İş ortağı anahtarı değeridir.
Not: Birden fazla hesap için feed sağlayan bir arka ucunuz varsa bu değerin, aynı hesap için |
OTA_HotelInvCountNotifRQ / Inventories | 1 | Inventories | Bir veya daha fazla <Inventory> öğesinin kapsayıcısıdır. |
OTA_HotelInvCountNotifRQ / Inventories / @HotelCode | 1 | string | Tesisin benzersiz tanımlayıcısıdır. Bu değer, Otel Listesi feed'inin <listing> öğesinde <id> kullanılarak belirtilen Otel Kimliği ile eşleşmelidir. Otel Kimliği, Hotel Center'da da listelenir. |
OTA_HotelInvCountNotifRQ / Inventories / Inventory | 1..n | Inventory | Tek bir tesisin farklı zaman aralıkları için müsait oda sayılarını tanımlar. |
OTA_HotelInvCountNotifRQ / Inventories / Inventory / StatusApplicationControl | 1 | StatusApplicationControl | Oda türü tanımlayıcısını (InvTypeCode ) ve tarih aralığını tanımlar. |
OTA_HotelInvCountNotifRQ / Inventories / Inventory / StatusApplicationControl / @Start | 1 | Date | Tarih aralığının (tesisin bulunduğu saat dilimine göre) başlangıç tarihidir. |
OTA_HotelInvCountNotifRQ / Inventories / Inventory / StatusApplicationControl / @End | 1 | Date | Tarih aralığının (tesisin bulunduğu saat dilimine göre) bitiş tarihidir. start değerine eşit veya değerden büyük olmalıdır.
start ve end eşitse güncelleme ilgili tarihe uygulanır. |
OTA_HotelInvCountNotifRQ / Inventories / Inventory / StatusApplicationControl / @Mon | 0..1 | boolean | Pazartesi günlerini açıkça dahil etmek için true veya 1 olarak ayarlayın.
|
OTA_HotelInvCountNotifRQ / Inventories / Inventory / StatusApplicationControl / @Tue | 0..1 | boolean | Salı günlerini açıkça dahil etmek için true veya 1 olarak ayarlayın.
|
OTA_HotelInvCountNotifRQ / Inventories / Inventory / StatusApplicationControl / @Weds | 0..1 | boolean | Çarşamba günlerini açıkça dahil etmek için true veya 1 olarak ayarlayın.
|
OTA_HotelInvCountNotifRQ / Inventories / Inventory / StatusApplicationControl / @Thur | 0..1 | boolean | Perşembe günlerini açıkça dahil etmek için true veya 1 olarak ayarlayın.
|
OTA_HotelInvCountNotifRQ / Inventories / Inventory / StatusApplicationControl / @Fri | 0..1 | boolean | Cuma günlerini açıkça dahil etmek için true veya 1 olarak ayarlayın.
|
OTA_HotelInvCountNotifRQ / Inventories / Inventory / StatusApplicationControl / @Sat | 0..1 | boolean | Cumartesi günlerini açıkça dahil etmek için true veya 1 olarak ayarlayın.
|
OTA_HotelInvCountNotifRQ / Inventories / Inventory / StatusApplicationControl / @Sun | 0..1 | boolean | Pazar günlerini açıkça dahil etmek için true veya 1 olarak ayarlayın.
|
OTA_HotelInvCountNotifRQ / Inventories / Inventory / StatusApplicationControl / @InvTypeCode | 1 | string | Envanterin benzersiz tanımlayıcısıdır (oda türü). Bu değer, Transaction (Tesis Verileri) mesajlarındaki <RoomID> ile eşlenir. |
OTA_HotelInvCountNotifRQ / Inventories / Inventory / InvCounts | 1 | InvCounts | Tek bir envanter sayısını tanımlayan kapsayıcıdır. |
OTA_HotelInvCountNotifRQ / Inventories / Inventory / InvCounts / InvCount | 1 | InvCount | Rezervasyon yapılabilecek müsait oda sayısını tanımlar. |
OTA_HotelInvCountNotifRQ / Inventories / Inventory / InvCounts / InvCount / @Count | 1 | integer | Oda türü için rezerve edilebilecek müsait oda sayısıdır. Sıfır değeri, oda türünün tükendiğini gösterir. Negatif değerler, sıfır olarak kabul edilir. |
OTA_HotelInvCountNotifRQ / Inventories / Inventory / InvCounts / InvCount / @CountType | 1 | enum | Belirtilen envanter sayısının türü. Geçerli değer:
|
Örnekler
Kalan envanter
Belirtilen tarihlerde RoomID_1
için kalan 5 odayı ayarlar.
<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>
Tükenmiş envanter
Belirtilen tarihlerde RoomID_1
adlı odayı "tükendi" olarak işaretleyin.
<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>
Yanıtlar
Söz dizimi
OTA_HotelInvCountNotifRS
mesajında aşağıdaki söz dizimi kullanılır:
<?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>
Öğeler ve özellikler
OTA_HotelInvCountNotifRS
mesajında aşağıdaki öğeler ve özellikler bulunur:
Öğe / @Özellik | Yineleme sayısı | Tür | Açıklama |
---|---|---|---|
1 | Complex element | Müsaitlik durumu mesajı yanıtının kök öğesidir. | |
OTA_HotelInvCountNotifRS / @TimeStamp | 1 | DateTime | Bu mesajın oluşturulma tarihi ve saati. |
OTA_HotelInvCountNotifRS / @EchoToken | 1 | string | İlişkilendirilmiş OTA_HotelInvCountNotifRQ mesajındaki benzersiz tanımlayıcıdır. |
OTA_HotelInvCountNotifRS / Success | 0..1 | Success | OTA_HotelInvCountNotifRQ mesajının başarıyla işlendiğini belirtir.
Her mesajda |
OTA_HotelInvCountNotifRS / Errors | 0..1 | Errors | OTA_HotelInvCountNotifRQ mesajı işlenirken karşılaşılan bir veya daha fazla sorun için kullanılan bir kapsayıcıdır.
Her mesajda |
OTA_HotelInvCountNotifRS / Errors / Error | 1..n | Error | OTA_HotelInvCountNotifRQ mesajı işlenirken karşılaşılan hatanın açıklamasıdır. Bu hatalarla ilgili ayrıntılar Feed Durumu Hata Mesajları bölümünde bulunabilir. |
OTA_HotelInvCountNotifRS / Errors / Error / @Type | 1 | integer | Hatayla ilişkili OpenTravel Alliance EWT (Hata Uyarı Türü). Yalnızca 12 (Processing exception) değeri kullanılır. |
OTA_HotelInvCountNotifRS / Errors / Error / @Code | 1 | integer | Hatayla ilişkili OpenTravel Alliance ERR (Hata Kodu).
Yalnızca 450 (Unable to process) değeri kullanılır. |
OTA_HotelInvCountNotifRS / Errors / Error / @Code | 1 | enum | Orijinal isteğin durumu. Yalnızca NotProcessed değeri kullanılır. |
OTA_HotelInvCountNotifRS / Errors / Error / @ShortText | 1 | string | Sorunun Google tanımlayıcısı. Bu hatalarla ilgili ayrıntılar Feed Durumu Hata Mesajları bölümünde bulunabilir. |
Örnekler
Başarılı
Aşağıda, başarıyla işlenmiş bir OTA_HotelInvCountNotifRQ
mesajına yanıt yer almaktadır.
<?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>
Hatalar
Aşağıda, hatalar nedeniyle işlenmeyen bir OTA_HotelInvCountNotifRQ
mesajına yanıt yer almaktadır.
<?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>