Genel bakış
Müsaitlik durumu mesajı (OTA_HotelAvailNotifRQ
), belirli bir seyahat planındaki bir ürünün (ücret planıyla birlikte oda türü) geçerli tarihler için satılıp satılamayacağını tanımlar. Stok Durumu mesajı gönderdiğinizde, bir ürünün stok durumunun veya kısıtlamalarının değişip değişmediğini belirtirsiniz.
Aşağıdaki bölümlerde, Müsaitlik Durumu mesajını kullanarak stok durumu ekleyip güncellemeye başlamanız için genel yönergeler, temel bir örnek ve nasıl yapılır senaryoları ele alınmaktadır.
Gecelik müsaitlik durumu kısıtlaması
Müsaitlik durumu mesajı, bir rezervasyonun genel müsaitlik durumunu kontrol eden kısıtlamalar tanımlamanıza olanak tanır. Kayda değer bir kısıtlama türü "gecelik stok durumu"dur: Ürünün belirli bir tarihte satılıp satılamayacağını belirtir. Konaklama (giriş ve çıkış arası) işlemleri için tüm tarihlerde gecelik müsaitlik durumu bulunmalı ve diğer tüm rezervasyon ve konaklama kısıtlamalarına uyulmalıdır.
Kısıtlama ayarları
Varsayılan olarak, Restriction="Master"
için RestrictionStatus
kapalıdır. Diğer bir deyişle, varsayılan olarak her gece bir "satış durdurma" etkinliği yapılır.
Bir ürünün satılabilir olması için konaklamanın tüm gecelerinde tüm ürün kombinasyonlarında <RestrictionStatus Restriction="Master"
Status="Open">
özelliğinin olması gerekir. Google'a her ürün için açık bir Open
göndermeniz veya Hotel Center'da varsayılanı değiştirmeniz gerekir. Hotel Center'da Fiyatlandırma > Ayarlar sayfasına gidip "varsayılan müsaitlik durumu" alanını düzenleyerek bu işlemi gerçekleştirebilirsiniz.
Diğer kısıtlamalar
- Varış/Çıkış
- Belirtilen tarihte geliş veya gidiş geliş planının satışını engeller.
Varsayılan değer
Open
şeklindedir. - Minimum ve maksimum rezervasyon farkı
- Seyahat planının varış tarihinden en az veya en çok belirli sayıda gün önce satın alınması gerekir.
- Minimum ve maksimum konaklama süresi
- Bu varış tarihine sahip seyahat planlarında konaklama süresini kısıtlar.
- Minimum ve maksimum konaklama süresi (veya "konaklama")
- Bu konaklama tarihini içeren seyahat planlarında konaklama süresini kısıtlar.
- Konaklama süresi kalıbı
- Bu varış tarihinde izin verilen konaklama süreleri üzerinde tam kontrol olanağı sağlar.
Genel yönergeler
Müsaitlik durumu kısıtlamaları otel, tarih, oda türü ve ücret planına göre belirlenir.
Bir ürün yalnızca konaklama için geçerli kısıtlamaların olmadığı (girişten çıkışa) veya kullanıcının konaklama rezervasyonu yapabileceği zamanlarda rezervasyon yapılabilir.
Belirli tarihlerde ürünün stok durumu kısıtlamalarında değişiklik olduğunda Google'a Stok Durumu mesajı güncellemesi gönderin.
Örnek
Bu bölümde, zorunlu ve isteğe bağlı öğelerin kullanıldığı bir Müsaitlik Durumu 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_avail_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. Sisteminizle tutarlılık, Google'ın verilerinizi doğru bir şekilde görüntülemesini sağlamak için çok önemlidir.
Bu örnekte, kullanılabilirlik kısıtlamalarının nasıl ayarlanacağı gösterilmektedir:
<?xml version="1.0" encoding="UTF-8"?>
<OTA_HotelAvailNotifRQ xmlns="http://www.opentravel.org/OTA/2003/05"
EchoToken="12345678"
TimeStamp="2022-03-20T20:50:37-05:00"
Version="3.0">
<POS><Source><RequestorID ID="partner_key" /></Source></POS>
<AvailStatusMessages HotelCode="HOTELID">
</AvailStatusMessage>
<AvailStatusMessage>
<StatusApplicationControl Start="202X-03-20"
End="202X-03-25"
InvTypeCode="RoomID_1"
RatePlanCode="PackageID_1"/>
<LengthsOfStay>
<LengthOfStay MinMaxMessageType="SetMinLOS" Time="2" TimeUnit="Day" />
</LengthsOfStay>
<RestrictionStatus Restriction="Master" Status="Open" />
</AvailStatusMessage>
</OTA_HotelAvailNotifRQ>
Daha fazla örnek için Kullanılabilirlik örnekleri bölümüne bakın.
"Nasıl yapılır" kılavuzları
Bu bölümde, Müsaitlik Durumu mesajları gönderirken karşılaşabileceğiniz senaryolarla ilgili çözümler, özellikle gecelik kullanılabilirlik kısıtlamasıyla ("satışı durdurma" olarak da bilinir) ilgili ayrıntılar yer almaktadır.
1. Senaryo: Belirli tarihlerde ürün satma
Açıklama
Oda türü ve ücret planı kombinasyonunu (ürün) belirli tarihlerde kullanıma sunmak istiyorsunuz.
Çözüm
Master
kısıtlamasını Open
olarak ayarlayın ve tarihleri belirtin.
Örnek
Bu örnekte, bir ürün için gecelik stokun mart ayında birkaç haftalığına nasıl açılacağı gösterilmektedir.
<?xml version="1.0" encoding="UTF-8"?>
<OTA_HotelAvailNotifRQ xmlns="http://www.opentravel.org/OTA/2003/05"
EchoToken="12345678"
TimeStamp="2022-03-20T20:50:37-05:00"
Version="3.0">
<AvailStatusMessages HotelCode="Property_1">
<AvailStatusMessage>
<StatusApplicationControl Start="2022-03-20"
End="2022-03-30"
InvTypeCode="RoomID_1"
RatePlanCode="PackageID_1"/>
<RestrictionStatus Status="Open" Restriction="Master"/>
</AvailStatusMessage>
</AvailStatusMessages>
</OTA_HotelAvailNotifRQ>
Fiyatlandırmayı ayarlama hakkında daha fazla bilgi için Eksik veya eksik fiyatlandırmayla ilgili sorunları giderme bölümüne bakın.
2. Senaryo: Belirli tarihlerde ürün satışına son verme
Açıklama
Açık bir şekilde bir ürünün belirli tarihlerde satışını (envanterde kalmamak yerine) durdurmak istiyorsunuz.
Çözüm
Master
kısıtlamasını Close
olarak ayarlayın ve tarihleri belirtin.
Örnek
Bu örnekte, belirtilen tarihlerde bir ürün için "satışı durdurma" veya gecelik stok durumunun nasıl kapatılacağı gösterilmektedir.
<?xml version="1.0" encoding="UTF-8"?>
<OTA_HotelAvailNotifRQ xmlns="http://www.opentravel.org/OTA/2003/05"
EchoToken="12345678"
TimeStamp="2022-03-20T20:50:37-05:00"
Version="3.0">
<AvailStatusMessages HotelCode="Property_1">
<AvailStatusMessage>
<StatusApplicationControl Start="2022-04-20"
End="2022-04-30"
InvTypeCode="RoomID_1"
RatePlanCode="PackageID_1"/>
<RestrictionStatus Status="Close" Restriction="Master"/>
</AvailStatusMessage>
</AvailStatusMessages>
</OTA_HotelAvailNotifRQ>