Söz dizimi
OTA_HotelAvailNotifRQ
mesajında şu söz dizimi kullanılır:
<?xml version="1.0" encoding="UTF-8"?> <OTA_HotelAvailNotifRQ xmlns="http://www.opentravel.org/OTA/2003/05" TimeStamp="timestamp" Version="3.0"> <POS> <Source> <RequestorID ID="partner_account_name"/> </Source> </POS> <AvailStatusMessages HotelCode="HotelID"> <AvailStatusMessage BookingLimit="integer"> <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"/> </AvailStatusMessage> <AvailStatusMessage> <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" RatePlanCode="PackageID"/> <LengthsOfStay> <LengthOfStay Time="integer" TimeUnit="[Day]" MinMaxMessageType="[SetMaxLOS|SetMinLOS|SetForwardMaxStay| SetForwardMinStay]"/> </LengthsOfStay> <RestrictionStatus Status="[Close|Open]" Restriction="[Arrival|Departure|Master]" MaxAdvancedBookingOffset="integer" MinAdvancedBookingOffset="integer"/> </AvailStatusMessage> </AvailStatusMessages> </OTA_HotelAvailNotifRQ>
Öğeler ve Özellikler
OTA_HotelAvailNotifRQ mesajında şu öğeler ve özellikler bulunur:Öğe / @Özellik | Geçtiği yer sayısı | Tür | Açıklama |
---|---|---|---|
OTA_HotelAvailNotifRQ | 1 | Karmaşık öğe | Oda fiyatının kullanılabilirliğini tanımlayan bir mesajın kök öğesidir. |
OTA_HotelAvailNotifRQ / AvailStatusMessages | 1 | AvailStatusMessages | Bir veya daha fazla <AvailStatusMessage> öğesinin kapsayıcısıdır. |
OTA_HotelAvailNotifRQ / AvailStatusMessages / @HotelCode | 1 | Dize | Tesisin benzersiz tanımlayıcısıdır. Bu değer, Otel Listesi Feed'indeki <listing> öğesinde <id> kullanılarak belirtilen Otel Kimliği ile eşleşmelidir. Otel Kimliği, Hotel Center'da da listelenir. |
OTA_HotelAvailNotifRQ / 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_HotelAvailNotifRQ / POS/ Source | 1 | Kaynak | <POS> varsa gereklidir. <RequestorID> öğesinin kapsayıcısıdır. |
OTA_HotelAvailNotifRQ / POS / RequestorID | 1 | RequestorID | <POS> varsa gereklidir. İş ortağı hesabını tanımlar. |
OTA_HotelAvailNotifRQ / POS / RequestorID / @ID | 1 | Dize | 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, Transaction (Tesis Verileri) mesajınızdaki |
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage | 1..n | AvailStatusMessage | Tek bir tesisin farklı zaman aralıklarındaki oda fiyatı kullanılabilirliğini ve kısıtlamalarını tanımlar. |
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / @BookingLimit | 1 | Int | <StatusApplicationControl> öğesindeki tarih aralığında rezervasyon yapılabilecek kalan oda sayısıdır. BooklingLimit belirtilirse <StatusApplicationControl> , InvTypeCode öğesini belirtmelidir. Ayrıca <AvailStatusMessage> , <LengthOfStay> veya <RestrictionStatus> öğesini içeremez. 0'a eşit veya 0'dan büyük olmalıdır. Sağlanmazsa varsayılan olarak 0'dır.
Not: Belirli bir |
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / StatusApplicationControl | 1 | StatusApplicationControl | Oda türü (InvTypeCode ) ve ücret planı (RatePlanCode ) tanımlayıcılarının yanı sıra tarih aralığını tanımlar. |
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / StatusApplicationControl / @Start | 1 | Tarih | Tarih aralığının başlangıç tarihidir. |
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / StatusApplicationControl / @End | 1 | Tarih | Tarih aralığının bitiş tarihidir. 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_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / StatusApplicationControl / @Mon | 0..1 | Boole | Pazartesi günlerini açıkça dahil etmek için true veya 1 olarak ayarlayın.
|
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / StatusApplicationControl / @Tue | 0..1 | Boole | Salı günlerini açıkça dahil etmek için true veya 1 olarak ayarlayın.
|
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / StatusApplicationControl / @Weds | 0..1 | Boole | Çarşamba günlerini açıkça dahil etmek için true veya 1 olarak ayarlayın.
|
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / StatusApplicationControl / @Thur | 0..1 | Boole | Perşembe günlerini açıkça dahil etmek için true veya 1 olarak ayarlayın.
|
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / StatusApplicationControl / @Fri | 0..1 | Boole | Cuma günlerini açıkça dahil etmek için true veya 1 olarak ayarlayın.
|
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / StatusApplicationControl / @Sat | 0..1 | Boole | Cumartesi günlerini açıkça dahil etmek için true veya 1 olarak ayarlayın.
|
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / StatusApplicationControl / @Sun | 0..1 | Boole | Pazar günlerini açıkça dahil etmek için true veya 1 olarak ayarlayın.
|
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / StatusApplicationControl / @InvTypeCode | 1 | Dize | Envanterin benzersiz tanımlayıcısıdır (oda türü). Bu değer, Transaction (Tesis Verileri) mesajlarındaki <RoomID> ile eşlenir. |
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / StatusApplicationControl / @RatePlanCode | 0..1 | Dize | Ücret planının benzersiz tanımlayıcısıdır. Bu tanımlayıcı, Transaction (Tesis Verileri) mesajlarındaki <PackageID> değeriyle eşlenir. Ücret planı, hem <OTA_HotelRateAmountNotifRQ> hem de <OTA_HotelAvailNotifRQ> mesajlarındaki <StatusApplicationControl> öğesinde ayrıntılı olarak tanımlanır ve belirtilir.
|
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / LengthsOfStay | 0..1 | LengthsOfStay | LOS kısıtlamalarını tanımlayan kapsayıcıdır. <AvailStatusMessage> , BookingLimit özelliğini içeriyorsa bu öğe kullanılmamalıdır. |
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / LengthsOfStay / LengthOfStay | 1..n | LengthOfStay | Konaklama süresiyle ilgili kısıtlamaları tanımlar. Birden fazla <LengthOfStay> öğesi kullanılırken her birinin farklı bir MinMaxMessageType değerini belirtmesi gerekir. |
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / LengthsOfStay / LengthOfStay / @Time | 1 | Int | Konaklama süresi ölçümünün birim değeridir. Değer sıfır olarak ayarlandığında kısıtlama olmayacağını unutmayın. Örneğin, <LengthOfStay
Time="0" MinMaxMessageType="SetMaxLOS"/> maksimum konaklama süresinin olmadığı anlamına gelir. |
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / LengthsOfStay / LengthOfStay / @TimeUnit | 0..1 | Enum | Zaman birimidir. Sağlanmazsa varsayılan olarak "Day" (Gün) olur. Geçerli değerler şunlardır:
|
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / LengthsOfStay / LengthOfStay / @MinMaxMessageType | 1 | Enum | Konaklama süresi kısıtlamalarının çeşitli türleridir. SetMaxLOS ve SetMinLOS varış tarihini temel alır.
SetForwardMinStay ve SetForwardMaxStay ise konaklama süresini temel alır. Maksimum değerler, minimum değerlerden büyük veya bu değerlere eşit olmalıdır. |
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / RestrictionStatus | 0..1 | RestrictionStatus | Seyahat planı kısıtlamalarını tanımlar. <AvailStatusMessage> , BookingLimit özelliğini içeriyorsa bu öğe kullanılmamalıdır. |
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / RestrictionStatus / @Status | 0..1 | Enum |
Not: Belirli bir |
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / RestrictionStatus / @Restriction | 0..1 | Enum |
Geçerli değerler şunlardır:
|
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / RestrictionStatus / @MinAdvancedBookingOffset | 0..1 | Int | Bu oda fiyatında rezervasyon yapabilmek için varış tarihinden önceki minimum gün sayısıdır. |
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / RestrictionStatus / @MaxAdvancedBookingOffset | 0..1 | Int | Bu oda fiyatında rezervasyon yapabilmek için varış tarihinden önceki maksimum gün sayısıdır. |
Örnekler
1. Örnek
Min./Maks. Konaklama Süresi (varış tarihine göre) + Min./Maks. Ön Satış + Varış Kapalı + Envanter Sayısı
<OTA_HotelAvailNotifRQ xmlns="http://www.opentravel.org/OTA/2003/05" TimeStamp="2020-05-13T20:50:37-05:00" Version="3.0"> <AvailStatusMessages HotelCode="Property_1"> <AvailStatusMessage BookingLimit="5"> <StatusApplicationControl Start="2020-05-18" End="2020-05-23" InvTypeCode="RoomID_1"/> </AvailStatusMessage> <AvailStatusMessage> <StatusApplicationControl Start="2020-05-18" End="2020-05-23" InvTypeCode="RoomID_1" RatePlanCode="PackageID_1"/> <LengthsOfStay> <LengthOfStay Time="5" MinMaxMessageType="SetMaxLOS"/> <LengthOfStay Time="2" MinMaxMessageType="SetMinLOS"/> </LengthsOfStay> </AvailStatusMessage> <AvailStatusMessage> <StatusApplicationControl Start="2020-05-18" End="2020-05-23" InvTypeCode="RoomID_1" RatePlanCode="PackageID_1"/> <RestrictionStatus Status="Close" Restriction="Arrival" MaxAdvancedBookingOffset="30" MinAdvancedBookingOffset="7"/> </AvailStatusMessage> </AvailStatusMessages> </OTA_HotelAvailNotifRQ>
2. Örnek
Min./Maks. Konaklama Süresi (konaklama süresine göre)
<?xml version="1.0" encoding="UTF-8"?> <OTA_HotelAvailNotifRQ xmlns="http://www.opentravel.org/OTA/2003/05" TimeStamp="2020-05-13T20:50:37-05:00" Version="3.0"> <AvailStatusMessages HotelCode="Property_1"> <AvailStatusMessage> <StatusApplicationControl Start="2020-05-18" End="2020-05-23" InvTypeCode="RoomID_1" RatePlanCode="PackageID_1"/> <LengthsOfStay> <LengthOfStay Time="5" MinMaxMessageType="SetForwardMaxStay"/> <LengthOfStay Time="2" MinMaxMessageType="SetForwardMinStay"/> </LengthsOfStay> </AvailStatusMessage> </AvailStatusMessages> </OTA_HotelAvailNotifRQ>
3. Örnek
Gidiş Kapalı (belirtilen tarihlerde çıkış yapılan seyahat planlarını önler)
<?xml version="1.0" encoding="UTF-8"?> <OTA_HotelAvailNotifRQ xmlns="http://www.opentravel.org/OTA/2003/05" TimeStamp="2020-05-13T20:50:37-05:00" Version="3.0"> <AvailStatusMessages HotelCode="Property_1"> <AvailStatusMessage> <StatusApplicationControl Start="2020-05-18" End="2020-05-23" InvTypeCode="RoomID_1" RatePlanCode="PackageID_1"/> <RestrictionStatus Status="Close" Restriction="Departure"/> </AvailStatusMessage> </AvailStatusMessages> </OTA_HotelAvailNotifRQ>
4. Örnek
Varış Kapalı (belirtilen tarihlerde check-in yapılan seyahat planlarını önler)
<?xml version="1.0" encoding="UTF-8"?> <OTA_HotelAvailNotifRQ xmlns="http://www.opentravel.org/OTA/2003/05" TimeStamp="2020-05-13T20:50:37-05:00" Version="3.0"> <AvailStatusMessages HotelCode="Property_1"> <AvailStatusMessage> <StatusApplicationControl Start="2020-05-18" End="2020-05-23" InvTypeCode="RoomID_1" RatePlanCode="PackageID_1"/> <RestrictionStatus Status="Close" Restriction="Arrival"/> </AvailStatusMessage> </AvailStatusMessages> </OTA_HotelAvailNotifRQ>
5. Örnek
Müsaitlik durumu açık, kısıtlama yok
<?xml version="1.0" encoding="UTF-8"?> <OTA_HotelAvailNotifRQ xmlns="http://www.opentravel.org/OTA/2003/05" TimeStamp="2020-05-13T20:50:37-05:00" Version="3.0"> <AvailStatusMessages HotelCode="Property_1"> <AvailStatusMessage BookingLimit="5"> <StatusApplicationControl Start="2020-05-18" End="2020-05-23" InvTypeCode="RoomID_1"/> </AvailStatusMessage> <AvailStatusMessage> <StatusApplicationControl Start="2020-05-18" End="2020-05-23" InvTypeCode="RoomID_1" RatePlanCode="PackageID_1"/> <RestrictionStatus Status="Open" Restriction="Master"/> </AvailStatusMessage> </AvailStatusMessages> </OTA_HotelAvailNotifRQ>
6. Örnek
Yalnızca hafta sonu uygulanan min./maks. ön rezervasyon dönemi kısıtlamaları
<?xml version="1.0" encoding="UTF-8"?> <OTA_HotelAvailNotifRQ xmlns="http://www.opentravel.org/OTA/2003/05" TimeStamp="2020-05-13T20:50:37-05:00" Version="3.0"> <AvailStatusMessages HotelCode="Property_1"> <AvailStatusMessage> <StatusApplicationControl Start="2020-01-01" End="2020-06-30" Mon=”false” Tue=”false” Weds=”false” Thur=”false” Fri=”false” Sat=”true” Sun=”true” InvTypeCode="RoomID_1" RatePlanCode="PackageID_1"/> <RestrictionStatus MaxAdvancedBookingOffset="30" MinAdvancedBookingOffset="2"/> </AvailStatusMessage> </AvailStatusMessages> </OTA_HotelAvailNotifRQ>
7. Örnek
Bir oda türü ve ücret planı için aynı tarihlerde birden fazla kısıtlama ayarlayın.
<?xml version="1.0" encoding="UTF-8"?> <OTA_HotelAvailNotifRQ xmlns="http://www.opentravel.org/OTA/2003/05" TimeStamp="2020-05-13T20:50:37-05:00" Version="3.0"> <AvailStatusMessages HotelCode="Property_1"> <AvailStatusMessage> <StatusApplicationControl Start="2020-05-18" End="2020-05-23" InvTypeCode="RoomID_1" RatePlanCode="PackageID_1"/> <RestrictionStatus Status="Close" Restriction="Master"/> </AvailStatusMessage> <AvailStatusMessage> <StatusApplicationControl Start="2020-05-18" End="2020-05-23" InvTypeCode="RoomID_1" RatePlanCode="PackageID_1"/> <RestrictionStatus Status="Open" Restriction="Arrival"/> </AvailStatusMessage> <AvailStatusMessage> <StatusApplicationControl Start="2020-05-18" End="2020-05-23" InvTypeCode="RoomID_1" RatePlanCode="PackageID_1"/> <RestrictionStatus Status="Open" Restriction="Departure"/> </AvailStatusMessage> </AvailStatusMessages> </OTA_HotelAvailNotifRQ>