Envanter Mesajı

Genel bakış

Envanter mesajı (OTA_HotelInvCountNotifRQ), belirli oda türleri için rezerve edilebilecek envanter sayılarını (fiziksel oda sayısı) tanımlar. Bir Envanter mesajı gönderdiğinizde, belirli bir tarihte o türde kaç odanın kullanılabilir olduğunu belirtirsiniz. Bu türde oda yoksa o oda türünü ve tarihi içeren ürünler gösterilmez.

Aşağıdaki bölümlerde, envanter ekleyip güncellemeye ve Envanter mesajları göndermeye başlamanıza yardımcı olacak genel yönergeler, temel bir örnek ve nasıl yapılır senaryoları ele alınmaktadır.

Envanterle ilgili çeşitli senaryolara dair örnekler için "Nasıl Yapılır?" bölümüne göz atın.

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

XML referansı, gerekli ve isteğe bağlı öğelerin açıklamalarını sağlar. Özellikler ve alt öğelerle ilgili ayrıntılar için Envanter öğeleri ve özellikleri konusuna bakın.

Söz dizimi ve şemalar

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

Google'a göndermeden önce feed'lerinizi yayınlanmış şemalarla doğrulamak için xmllint gibi bir üçüncü taraf XML aracı kullanabilirsiniz. Envanter mesajı şeması için Otel reklamları şemaları konusuna bakın.

Yönergeler

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

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

  • İlişkili ücret planı ve dolulukla ilgili fiyatın gösterilebilmesi için konaklamanın tüm geceleri için envanter sayısının 0 değerinden fazla olması gerekir.

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

  • CountType "kesin kullanılabilirlik" sayısını belirttiğinden geçerli olması için her zaman 2 değerine sahip olmalıdır.

  • Sisteminizde bir oda için rezervasyon veya iptal gerçekleştiğinde güncellenmiş envanteri gönderin.

Envanter ve stok durumu

Envanter, fiziksel sayıya göre rezerve edilebilir oda sayısıdır ve müsaitlik durumu, oda türü ve ücret planı kombinasyonuna rezervasyona izin verilip verilmediğini gösterir. ARI için müsaitlik durumu ve envanter, belirli tarihlere veya konaklama türüne göre değişiklik gösterebilir ve her ikisinin de ilgili mesaj türleri vardır. Müsaitlik durumu için ücret planı eklenerek envanter ve müsaitlik durumu otel, tarih ve oda türüne göre belirlenir.

Envanter ve kullanılabilirlik birbirinden bağımsız olduğundan envanter olduğunda bile "kullanılabilirlik yok" olabilir.

İki kullanılabilirlik kavramı vardır. Öncelikle, her gece için belirli bir ücretin olup olmadığı, ilgili oda türü için envanter olup olmadığı ve müsaitlik durumu kısıtlamasının açık olup olmadığı gibi faktörlerden etkilenen ürünün belirli bir konaklama için genel müsaitlik durumu yer alır. İkinci olarak, bir ürün için belirli bir tarihte belirli bir kısıtlama vardır. OTA_HotelAvailNotifRQ bölgesinde <RestrictionStatus Restriction="Master" Status="Open"/> ile gösterilir ve bu stok durumunun kapatılması "satışı durdurma" olarak da bilinir.

Envanter, oda için 0 değerinden büyük bir tam sayı olmalıdır ve bir ürünün fiyatını göstermek için müsaitlik durumu kısıtlamasının açık olması gerekir.

Örnek

Bu bölümde, gerekli ve isteğe bağlı öğelerin kullanıldığı bir Envanter mesajının temel bir örneği verilmiştir. Dosyanızı hazırladıktan sonra bu uç noktaya POST mesajıyla Google'a göndermeniz gerekir:

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

Mesajı aktarma/POST gönderme hakkında daha fazla bilgi için Mesaj aktarma konusuna göz atın.

HotelCode alanında, tesisi tanımlamak için sisteminizde kullandığınız benzersiz Otel Kimliği'ni kullanın. Bu değer, Otel Listesi feed'indeki <listing> öğesinde <id> kullanılarak belirtilen Otel Kimliği ile eşleşmelidir. <RoomID> için, oda türleri için sisteminizde kullandığınız kimliği kullanın. Sisteminizle tutarlılık, Google'ın verilerinizi doğru bir şekilde görüntülemesini sağlamak için çok önemlidir.

Bu örnekte, Aralık ayı için 13 adet rezervasyon yapılabilir oda için envanterin 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 konusuna bakın.

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

Bu bölümde, Envanter mesajı gönderirken karşılaşabileceğiniz bir senaryo verilmektedir.

Senaryo: Odaların rezerve edilmesini engelleme

Açıklama

Belirli tarihlerde bu oda türü için rezerve edilebilecek oda kalmadığını (genellikle odaların tükendiği için) belirtmeniz gerekir.

Çözüm

<InvCount Count> için 0 değerini belirleyip istediğiniz tarih aralığını eklersiniz.

Örnek

Bu örnekte, belirtilen oda ve tarihler (ör. Ocak ayının ilk birkaç haftası) için envanteri 0 olarak ayarlamak üzere InvCount özelliğinin 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>