OTA_HotelInvCountNotifRQ

İstekler

Söz dizimi

OTA_HotelInvCountNotifRQ mesajında şu 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 kullanılabilirliğini tanımlayan bir mesajın kök öğesidir.
OTA_HotelInvCountNotifRQ / @xmlns 0..1 string (URI) XML ad alanı.
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 saatidir.
OTA_HotelInvCountNotifRQ / @Version 1 decimal OpenTravel mesaj sürümüdür.
OTA_HotelInvCountNotifRQ / POS 0..1 POS Bu mesajdaki iş ortağı hesabını belirten kapsayıcıdır (genellikle arka ucunuz, birden fazla iş ortağı hesabı için fiyat feed'i 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 genelinde Transaction (Tesis Verileri) mesajınızın partner özellik değeriyle ve <OTA_HotelRateAmountNotifRQ> mesajınızın <RequestorID> öğesindeki ID özellik değeriyle eşleşmesi gerekir.
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ı. 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 tesiste 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ın (InvTypeCode) yanı sıra tarih aralığını da tanımlar.
OTA_HotelInvCountNotifRQ / Inventories / Inventory / StatusApplicationControl / @Start 1 Date Tarih aralığının (girilen tarihler dahil) başlangıç tarihidir (tesisin bulunduğu saat dilimine göre).
OTA_HotelInvCountNotifRQ / Inventories / Inventory / StatusApplicationControl / @End 1 Date Tarih aralığının (girilen tarihler dahil) bitiş tarihidir (tesisin bulunduğu saat dilimine göre). start değerine eşit veya değerden daha 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.

true olarak ayarlanırsa haftanın açıkça true olarak ayarlanmayan diğer günleri hariç tutulur (geçerli olduğunda Start ile End arasındaki tarihlerden filtrelenir).
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.

true olarak ayarlanırsa haftanın açıkça true olarak ayarlanmayan diğer günleri hariç tutulur (geçerli olduğunda Start ile End arasındaki tarihlerden filtrelenir).
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.

true olarak ayarlanırsa haftanın açıkça true olarak ayarlanmayan diğer günleri hariç tutulur (geçerli olduğunda Start ile End arasındaki tarihlerden filtrelenir).
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.

true olarak ayarlanırsa haftanın açıkça true olarak ayarlanmayan diğer günleri hariç tutulur (geçerli olduğunda Start ile End arasındaki tarihlerden filtrelenir).
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.

true olarak ayarlanırsa haftanın açıkça true olarak ayarlanmayan diğer günleri hariç tutulur (geçerli olduğunda Start ile End arasındaki tarihlerden filtrelenir).
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.

true olarak ayarlanırsa haftanın açıkça true olarak ayarlanmayan diğer günleri hariç tutulur (geçerli olduğunda Start ile End arasındaki tarihlerden filtrelenir).
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.

true olarak ayarlanırsa haftanın açıkça true olarak ayarlanmayan diğer günleri hariç tutulur (geçerli olduğunda Start ile End arasındaki tarihlerden filtrelenir).
OTA_HotelInvCountNotifRQ / Inventories / Inventory / StatusApplicationControl / @InvTypeCode 1 string Envanterin benzersiz tanımlayıcısıdır (oda türü). Bu değer, Transactions (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 rezervasyon yapılabilecek 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üdür. Geçerli değer:

  • 2: Kesin müsaitlik durumu.

Ö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ükendi envanteri

Belirtilen tarihlerde RoomID_1 odasını "tükendi" olarak işaretler.

<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 şu 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 saatidir.
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 <Success> veya <Errors> bulunur.
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 <Success> veya <Errors> bulunur.
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ı konusunda bulunabilir.
OTA_HotelInvCountNotifRS / Errors / Error / @Type 1 integer Hatayla ilişkili OpenTravel Alliance EWT (Hata Uyarı Türü) öğesidir. 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) öğesidir. Yalnızca 450 (Unable to process) değeri kullanılır.
OTA_HotelInvCountNotifRS / Errors / Error / @Code 1 enum Orijinal isteğin durumudur. Yalnızca NotProcessed değeri kullanılır.
OTA_HotelInvCountNotifRS / Errors / Error / @ShortText 1 string Sorunun Google tanımlayıcısıdır. Bu hatalarla ilgili ayrıntılar Feed Durumu Hata Mesajları konusunda 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şlenmemiş 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>