Envanter Mesajı

Genel Bakış

Envanter mesajı (OTA_HotelInvCountNotifRQ), belirli oda türleri için rezervasyon yapılabilecek envanter sayılarını (fiziksel oda sayısı) tanımlar. Envanter mesajı gönderdiğinizde, belirli bir tarihte söz konusu türden kaç odanın mevcut olduğunu belirtirsiniz. Bu türde oda yoksa söz konusu oda türünü ve tarihi içeren ürünler gösterilmez.

Aşağıdaki bölümlerde, envanter ekleme ve güncelleme ile envanter mesajları göndermeye başlamanıza yardımcı olacak genel yönergeler, temel bir örnek ve nasıl yapılır senaryoları yer almaktadır.

Çeşitli envanterle ilgili senaryo örnekleri için Nasıl yapılır? bölümüne bakın.

Zorunlu ve isteğe bağlı öğeler

XML referansı, zorunlu ve isteğe bağlı öğelerin açıklamalarını içerir. Özellikler ve alt öğelerle ilgili ayrıntılar için Envanter öğeleri ve özellikleri başlıklı makaleyi inceleyin.

Söz dizimi ve şemalar

Doğru biçimi kullandığınızdan emin olmak için Envanter mesajını oluştururken Envanter söz dizimi örneğini referans olarak kullanın.

Feed'lerinizi Google'a göndermeden önce yayınlanan şemalarla doğrulamak için xmllint gibi bir üçüncü taraf XML aracı kullanabilirsiniz. Envanter mesajı şeması için Otel reklamları şemaları başlıklı makaleyi inceleyin.

Yönergeler

Envanter mesajı için aşağıdaki yönergeleri kullanın:

  • Envanter, otel, tarih ve oda türüne göre anahtarlanır.

  • İlişkili fiyat planı ve doluluk için fiyatın gösterilebilmesi amacıyla, konaklamanın tüm gecelerinde envanter sayısı 0 değerinden büyük olmalıdır.

  • Envanter sayısı 0 değerine eşitse odalar, belirtilen oda kimliği ve tarih aralığı için rezerve edilemez.

  • "Kesin stok durumu" sayısını gösterdiğinden CountType her zaman 2 değerine sahip olmalıdır.

  • Sisteminizde bir oda için rezervasyon yapıldığında veya rezervasyon iptal edildiğinde güncellenmiş envanteri gönderin.

Envanter ve kullanılabilirlik

Envanter, fiziksel sayıya göre rezervasyon yapılabilir oda sayısıdır. Müsaitlik ise oda türü ve ücret planı kombinasyonunun rezervasyonuna izin verilip verilmediğini gösterir. ARI için hem kullanılabilirlik hem de envanter, bir dizi tarihe veya konaklama türüne göre değişiklik gösterebilir ve her ikisinin de karşılık gelen mesaj türleri vardır. Envanter ve müsaitlik durumu; otel, tarih ve oda türüne göre belirlenir. Müsaitlik durumu için ücret planı da eklenir.

Envanter ve stok durumu birbirinden bağımsız olduğundan envanter olsa bile "stok durumu yok" olabilir.

İki kullanılabilirlik kavramı vardır. İlk olarak, belirli bir konaklama için ürünün genel stok durumu vardır. Bu durum, her gece için tanımlanmış bir fiyat olup olmadığı, ilişkili oda türünün envanteri ve stok durumu kısıtlamasının açık olup olmadığı gibi faktörlerden etkilenir. İkincisi, belirli bir tarihte bir ürünle ilgili özel kısıtlama vardır. Bu kısıtlama, OTA_HotelAvailNotifRQ içinde <RestrictionStatus Restriction="Master" Status="Open"/> ile gösterilir ve bu stok durumunun kapatılması "satış durdurma" olarak bilinir.

Bir ürünün fiyatının gösterilmesi için envanter, oda için 0 değerinden büyük bir tam sayı olmalı ve kullanılabilirlik kısıtlaması açık olmalıdır.

Örnek

Bu bölümde, zorunlu ve isteğe bağlı öğelerin kullanıldığı bir envanter mesajına ilişkin temel bir örnek verilmektedir. Dosyanızı hazırladıktan sonra, bu uç noktaya bir POST mesajı göndererek Google'a iletmeniz gerekir:

https://www.google.com/travel/hotels/uploads/ota/hotel_inv_count_notif

Mesajı nasıl göndereceğiniz/POST edeceğiniz hakkında daha fazla bilgi edinmek için Mesaj gönderme başlıklı makaleyi inceleyin.

HotelCode için, tesisi tanımlamak üzere sisteminizde kullandığınız benzersiz otel kimliğini kullanın. Bu değer, Otel Listesi feed'indeki <listing> öğesinde <id> kullanılarak belirtilen otel kimliğiyle eşleşmelidir. <RoomID> için sisteminizde oda türleri için kullandığınız kimliği kullanın. Google'ın verilerinizi doğru şekilde göstermesini sağlamak için sisteminizle tutarlılık önemlidir.

Bu örnekte, Aralık ayı için 13 rezerve edilebilir odanın envanterinin nasıl ayarlanacağı gösterilmektedir:

<?xml version="1.0" encoding="UTF-8"?>
<OTA_HotelInvCountNotifRQ xmlns="http://www.opentravel.org/OTA/2003/05"
                          EchoToken="12345678"
                          TimeStamp="2022-02-25T20:50:37-05:00"
                          Version="3.0">
  <POS><Source><RequestorID ID="partner_key" /></Source></POS>
  <Inventories HotelCode="HotelID">
    <Inventory>
      <StatusApplicationControl Start="2022-12-01"
                                End="2022-12-31"
                                InvTypeCode="RoomID"/>
      <InvCounts>
        <InvCount Count="13" CountType="2"/>
      </InvCounts>
    </Inventory>
  </Inventories>
</OTA_HotelInvCountNotifRQ>

Daha fazla örnek için Envanter örnekleri sayfasına bakın.

"Nasıl yapılır" kılavuzları

Bu bölümde, envanter mesajı gönderirken karşılaşabileceğiniz bir senaryo açıklanmaktadır.

Senaryo: Odaların rezerve edilmesini engelleme

Açıklama

Belirli bir tarih aralığında bu oda türü için rezervasyon yapılabilecek oda kalmadığını belirtmeniz gerekir. Bu durumun en yaygın nedeni, odaların tükenmiş olmasıdır.

Çözüm

<InvCount Count> değerini 0 olarak ayarlarsınız ve istediğiniz tarih aralığını eklersiniz.

Örnek

Bu örnekte, belirtilen oda ve tarihler (ör. Ocak ayının ilk birkaç haftası) için envanterin 0 olarak ayarlanmasında InvCount öğesinin nasıl kullanılacağı gösterilmektedir.

<?xml version="1.0" encoding="UTF-8"?>
<OTA_HotelInvCountNotifRQ xmlns="http://www.opentravel.org/OTA/2003/05"
                          EchoToken="12345678"
                          TimeStamp="2022-02-25T20:50:37-05:00"
                          Version="3.0">
  <POS><Source><RequestorID ID="partner_key" /></Source></POS>
  <Inventories HotelCode="Property_1">
    <Inventory>
      <StatusApplicationControl Start="2023-01-01"
                                End="2023-01-15"
                                InvTypeCode="ROOMID"/>
      <InvCounts>
        <InvCount Count="0" CountType="2"/>
      </InvCounts>
    </Inventory>
  </Inventories>
</OTA_HotelInvCountNotifRQ>