EkstraKonukÜcretler

<OTA_HotelRateAmountNotifRQ> aracılığıyla gönderilen ücretler, orijinal konuk sayısına ek olarak yetişkinler ve çocuklar için de değiştirilebilir. ExtraGuestCharges mesajı, bu ek konuklar için ücretlerin nasıl hesaplanacağı ve ücretlerin hangi odalar, ücret planları ve konaklama tarihleri için uygulanacağı hakkında ayrıntılı bilgi sağlar.

Kapasite Gereksinimleri

ExtraGuestCharges mesajından hesaplanan fiyatlar, yalnızca tüm kapasite gereksinimleri karşılanırsa geçerlidir. Daha fazla bilgi için Transaction (Tesis Verileri) bölümünü inceleyin.

İstekler

Söz dizimi

ExtraGuestCharges mesajında aşağıdaki söz dizimi kullanılır:

<?xml version="1.0" encoding="UTF-8"?>
<ExtraGuestCharges partner="partner_account_name"
                   id="message_ID"
                   timestamp="timestamp">
  <HotelExtraGuestCharges hotel_id="HotelID" action="[overlay]">
    <ExtraGuestCharge>
      <RatePlans>
        <RatePlan id="PackageID_1"/>
        <RatePlan id="PackageID_2"/>
      </RatePlans>
      <RoomTypes>
        <RoomType id="RoomID_1"/>
        <RoomType id="RoomID_2"/>
      </RoomTypes>
      <StayDates>
        <DateRange start="YYYY-MM-DD" end="YYYY-MM-DD"
                   days_of_week="MTWHFSU_or_subset"/>
      </StayDates>
      <AgeBrackets>
        <AdultCharge amount="float"/>
        <ChildAgeBrackets>
        <!-- The following are different ways child charges can be specified.
        Use the option that matches your system. -->
          <ChildAgeBracket max_age="integer" amount="float"
                           exclude_from_capacity="[true|false]"/>
          <ChildAgeBracket max_age="integer" percentage="float"
                           exclude_from_capacity="[true|false]"
                           counts_as_base_occupant="[never|preferred|always]"/>
          <ChildAgeBracket max_age="integer" discount_amount="float"
                           exclude_from_capacity="[true|false]"
                           counts_as_base_occupant="[never|preferred|always]"/>
        </ChildAgeBrackets>
      </AgeBrackets>
    </ExtraGuestCharge>
  </HotelExtraGuestCharges>
</ExtraGuestCharges>

Öğeler ve Özellikler

ExtraGuestCharges mesajında aşağıdaki öğeler ve özellikler bulunur:

Öğe / @Özellik Yineleme sayısı Tür Açıklama
ExtraGuestCharges 1 Complex element Bu mesajın kök öğesidir.
ExtraGuestCharges / @partner 1 string Bu mesajın iş ortağı hesabıdır. Bu dize değeri, Hotel Center'ın Hesap ayarları sayfasında listelenen Partner key değeridir.

Not: Birden fazla hesap için feed sağlayan bir arka ucunuz varsa bu değerin aynı hesapta <OTA_HotelRateAmountNotifRQ> ve <OTA_HotelAvailNotifRQ> mesajlarınızın <RequestorID> öğesinde belirtilen ID özellik değeriyle eşleşmesi gerekir.
ExtraGuestCharges / @id 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. a-z, A-Z, 0-9, _ (alt çizgi) ve - (kısa çizgi) karakterlerine izin verilir.
ExtraGuestCharges / @timestamp 1 DateTime Bu mesajın oluşturulma tarihi ve saati.
ExtraGuestCharges / HotelExtraGuestCharges 0..n HotelExtraGuestCharges Tek bir tesisin ücretlerinin kapsayıcısıdır.
ExtraGuestCharges / HotelExtraGuestCharges / @hotel_id 1 string 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.
ExtraGuestCharges / HotelExtraGuestCharges / @action 0..1 enum Güncellemenin nasıl uygulandığını belirtir. Yalnızca overlay desteklenir ve varsayılan olarak yer paylaşımı kullanılır. Bu tesisin önceki ödemeleri, güncelleme uygulanmadan önce silinir.
ExtraGuestCharges / HotelExtraGuestCharges / ExtraGuestCharge 0..99 ExtraGuestCharge

Tesis için tek bir ödeme grubudur. Bu bilgilerde, bir ücretin nasıl uygulanabileceği ve ücretlerin yaşa veya konuk kategorisine göre nasıl hesaplandığıyla ilgili kısıtlamalar yer alabilir.

Bir HotelExtraGuestCharges içindeki her ExtraGuestCharge, benzersiz bir tarih ve ürün grubuna uygulanmalıdır. İki ExtraGuestCharge öğesi aynı tarih-ürün kombinasyonuna işaret ediyorsa mesajın tamamı reddedilir.
ExtraGuestCharges / HotelExtraGuestCharges / ExtraGuestCharge / AgeBrackets 1 AgeBrackets Yaşa veya konuk kategorisine göre ücretleri hesaplamak için kullanılan yaş grubu kapsayıcısıdır.
ExtraGuestCharges / HotelExtraGuestCharges / ExtraGuestCharge / AgeBrackets / AdultCharge 0..1 AdultCharge Ek bir yetişkinin ücretinin alındığı konteyner.
ExtraGuestCharges / HotelExtraGuestCharges / ExtraGuestCharge / AgeBrackets / AdultCharge / @amount 0..1 float Ek bir yetişkin için alınacak sabit tutarı belirten pozitif ondalık değerdir. Bu ödemede, gecelik ücretler için belirtilen para birimiyle aynı para birimi kullanılır.
ExtraGuestCharges / HotelExtraGuestCharges / ExtraGuestCharge / AgeBrackets / ChildAgeBrackets 0..1 ChildAgeBrackets Ek alt ödemeler için kapsayıcı. Bu yaş grupları yalnızca 0-17 yaş aralığını (0-17 dahil) kapsayabilir.
ExtraGuestCharges / HotelExtraGuestCharges / ExtraGuestCharge / AgeBrackets / ChildAgeBrackets / ChildAgeBracket 1..99 ChildAgeBracket Belirli bir yaş aralığındaki çocuklar için geçerli olan ücret. Bunlar en düşük max_age değerinden en yüksek max_age değerine doğru sıralanmalıdır. Ödenecek tutar, amount, percentage veya discount_amount kullanılarak belirtilebilir. Her <ChildAgeBracket> için bu özelliklerden tam olarak biri belirtilmelidir.
ExtraGuestCharges / HotelExtraGuestCharges / ExtraGuestCharge / AgeBrackets / ChildAgeBrackets / ChildAgeBracket / @max_age 1 integer <ChildAgeBracket> kapsamında belirtilen ücretlerin geçerli olabileceği maksimum yaş sınırı. Bundan önce başka bir <ChildAgeBracket> belirtilmemişse minimum yaş sıfırdır. Aksi takdirde önceki dilimin maksimum yaştan bir daha büyüktür.
ExtraGuestCharges / HotelExtraGuestCharges / ExtraGuestCharge / AgeBrackets / ChildAgeBrackets / ChildAgeBracket / @exclude_from_capacity 1 boolean Bu yaş aralığındaki bir çocuğun odanın toplam kapasitesine ve çocuk kapasitesine dahil edilip edilmeyeceğini gösteren boole değeri. Bu kapasiteler, Transaction(Tesis Verileri) ile ayarlanabilir. Örneğin, belirli bir yaşın altındaki bebeklerin çocuk kapasitesine dahil edilmesi gerekmeyebilir.
ExtraGuestCharges / HotelExtraGuestCharges / ExtraGuestCharge / AgeBrackets / ChildAgeBrackets / ChildAgeBracket / @amount 0..1 float Bu parantezdeki ek bir alt öğe için alınacak sabit tutarı belirten negatif olmayan bir ondalık değerdir. Bu ödemede, gecelik ücretler için belirtilen para birimiyle aynı para birimi kullanılır.
ExtraGuestCharges / HotelExtraGuestCharges / ExtraGuestCharge / AgeBrackets / ChildAgeBrackets / ChildAgeBracket / @percentage 0..1 float

1 ile 99 arasında bir ondalık değerdir. Bu değer, bu parantezdeki ek bir çocuk için ödenmesi gereken yetişkin fiyatının yüzdesini belirtir. Bu ücret, gecelik ücretler için belirtilen para birimiyle aynı para birimini kullanır.

Yetişkinlere uygun fiyatın nasıl hesaplandığı hakkında ayrıntılı bilgi için counts_as_base_occupant bölümündeki tartışmaya göz atın.
ExtraGuestCharges / HotelExtraGuestCharges / ExtraGuestCharge / AgeBrackets / ChildAgeBrackets / ChildAgeBracket / @discount_amount 0..1 float

Bu parantezdeki ek bir çocuk için yetişkin fiyatı üzerinden sabit bir indirim tutarını belirten pozitif ondalık değerdir. Bu ödemede, gecelik ücretler için belirtilen para birimiyle aynı para birimi kullanılır.

Genel olarak, bu basamaktaki bir çocuk için yapılan ücret, sabit tutarın "birim fiyat"tan düşülmesiyle hesaplanır. Birim fiyat, counts_as_base_occupant özellik bölümünde daha ayrıntılı bir şekilde açıklanmaktadır.
ExtraGuestCharges / HotelExtraGuestCharges / ExtraGuestCharge / AgeBrackets / ChildAgeBrackets / ChildAgeBracket / @counts_as_base_occupant 0..1 string

percentage veya discount_amount özelliği belirtilirse counts_as_base_occupant de belirtilmelidir. Bu değer, yüzdelik ücretler ve indirimler uygulamak için <BaseByGuestAmount> ücreti seçtiğinizde NumberOfGuest içine bir alt yayıncının dahil edilip edilmeyeceğini belirler.

Burada amaç, gerçek ücretin hesaplanabilmesi için bir "birim fiyat" elde etmektir.

unit price = rate / occupancy

Bu özelliğin değeri never, preferred veya always olmalıdır.

  • never belirtilirse çocuk hiçbir zaman fiyattaki doluluk oranına dahil edilmemelidir.

    2 yetişkin ve 2 çocuk (2+2) için bir ücret hesaplamak istiyorsanız çocukların dahil edilmemesi gerektiğinden 2 yetişkin için geçerli fiyatı kullanmalısınız.

  • preferred belirtilirse çocuk, fiyattaki doluluk oranına dahil edilmelidir.

    2 yetişkin ve 1 çocuk (2+1) için bir ücret hesaplamak istiyorsanız tercihen 3 yetişkin için geçerli fiyatı kullanmanız gerekir. Bu değeri bulamazsanız 2 yetişkin için geçerli fiyatı kullanmalısınız.

  • always belirtilirse çocuk her zaman fiyattaki doluluk oranına dahil edilmelidir.

    2 yetişkin ve 2 çocuk (2+2) için bir ücret hesaplamak istiyorsanız çocukların dahil edilmesi gerektiğinden 4 yetişkin için geçerli fiyatı kullanmalısınız.
ExtraGuestCharges / HotelExtraGuestCharges / ExtraGuestCharge / RoomTypes 0..1 RoomTypes Ücretlerin geçerli olduğu oda türleri listesinin kapsayıcısıdır. Fiyatlar, belirtilen her bir <RoomType> için geçerlidir. <RoomTypes> belirtilmezse ücretler belirtilen tesisteki tüm odalar için geçerli olur.
ExtraGuestCharges / HotelExtraGuestCharges / ExtraGuestCharge / RoomTypes / RoomType 1..n RoomType Oda türünü belirtir. Oda türü, Transaction (Tesis Verileri) mesajındaki bir <RoomData> öğesinde tanımlanır ve <RoomID> değeri kullanılarak referans verilir. (<RoomID> değerine, OTA_HotelRateAmountNotifRQ mesajlarındaki InvTypeCode özelliği tarafından da referans verilir.)
ExtraGuestCharges / HotelExtraGuestCharges / ExtraGuestCharge / RoomTypes / RoomType / @id 1 string Envanterin benzersiz tanımlayıcısıdır (oda türü). Bu değer, Transaction (Tesis Verileri) mesajlarındaki <RoomID> ile eşlenir. İzin verilen maksimum karakter sayısı 50'dir.
ExtraGuestCharges / HotelExtraGuestCharges / ExtraGuestCharge / RatePlans 0..1 RatePlans Ücretlerin geçerli olduğu ücret planları listesinin kapsayıcısıdır. <RatePlans> belirtilmezse ücretler tüm ücret planları için geçerlidir.
ExtraGuestCharges / HotelExtraGuestCharges / ExtraGuestCharge / RatePlans / RatePlan 1..n RatePlan Ücret planını belirtir. Ücret planı; Transaction (Tesis Verileri), OTA_HotelRateAmountNotifRQ ve OTA_HotelAvailNotifRQ mesajlarında tanımlanan ve PackageID tarafından tanımlanan paket, ücret ve stok durumunun kombinasyonuyla tanımlanır.
ExtraGuestCharges / HotelExtraGuestCharges / ExtraGuestCharge / RatePlans / RatePlan / @id 1 string Ücret planının benzersiz tanımlayıcısıdır. Bu değer, Transaction (Tesis Verileri) mesajındaki <PackageData> öğesinde ve hem <OTA_HotelRateAmountNotifRQ> hem de <OTA_HotelAvailNotifRQ> mesajlarındaki <StatusApplicationControl> öğesindeki RatePlanCode özelliğinde yer alan PackageID değeriyle eşlenir. İzin verilen maksimum karakter sayısı 50'dir.
ExtraGuestCharges / HotelExtraGuestCharges / ExtraGuestCharge / StayDates 0..1 StayDates Ödemelerin nasıl uygulandığını belirleyen bir veya daha fazla tarih aralığının kapsayıcısıdır.
ExtraGuestCharges / HotelExtraGuestCharges / ExtraGuestCharge / StayDates / DateRange 1..99 DateRange Promosyonun uygulanacağı tarihleri belirten tarih aralığıdır.
ExtraGuestCharges / HotelExtraGuestCharges / ExtraGuestCharge / StayDates / DateRange / @start 0..1 Date Tarih aralığının (tesisin bulunduğu saat dilimine göre) başlangıç tarihidir. Bu tarih, end tarihinden önce veya bu tarihle aynı olmalıdır. start belirtilmezse tarih aralığı, başlangıç tarihi açısından etkin bir şekilde sınırsızdır.
ExtraGuestCharges / HotelExtraGuestCharges / ExtraGuestCharge / StayDates / DateRange / @end 0..1 Date Tarih aralığının (tesisin bulunduğu saat dilimine göre) bitiş tarihidir. Bu tarih, start tarihiyle aynı veya bu tarihten sonra olmalıdır. end belirtilmezse tarih aralığı, bitiş tarihi açısından etkin bir şekilde sınırsızdır.
ExtraGuestCharges / HotelExtraGuestCharges / ExtraGuestCharge / StayDates / DateRange / @days_of_week 0..1 string

Tarih aralığında izin verilen günleri ifade eder. Belirtilmezse tarih aralığında tüm günlere izin verilir. Dizedeki her karakter bir gün belirtir. Örneğin "MTWHF", tarih aralığında hafta içi günlerine izin verildiğini belirtir.

Geçerli karakterler şunlardır:

  • Pazartesi için M
  • Salı için T
  • Çarşamba için W
  • Perşembe için H
  • Cuma için F
  • Cumartesi için S
  • Pazar için U

Karakter kombinasyonları geçerlidir.

Örnekler

Yetişkin Ücretleri

Ek yetişkinler için alınan ödemeler yalnızca sabit tutarlar olarak ifade edilebilir. Aşağıdaki örnekte, yetişkin ücretlerini belirten bir ExtraGuestCharges mesajı gösterilmektedir:

<?xml version="1.0" encoding="UTF-8"?>
<ExtraGuestCharges timestamp="2001-02-03T04:05:06+00:00" id="1">
  <HotelExtraGuestCharges hotel_id="ABC" action="overlay">
    <ExtraGuestCharge>
      <StayDates />
      <AgeBrackets>
        <AdultCharge amount="50" />
      </AgeBrackets>
    </ExtraGuestCharge>
  </HotelExtraGuestCharges>
</ExtraGuestCharges>

İlgili ücretler şunlardır:

<?xml version="1.0" encoding="UTF-8"?>
<OTA_HotelRateAmountNotifRQ xmlns="http://www.opentravel.org/OTA/2003/05"
                            EchoToken="12345678"
                            TimeStamp="2020-05-19T20:50:37-05:00"
                            Version="3.0">
  <RateAmountMessages HotelCode="ABC">
    <RateAmountMessage>
      <StatusApplicationControl Start="2020-05-18"
                                End="2020-05-23"
                                InvTypeCode="RoomID_1"
                                RatePlanCode="PackageID_1"/>
      <Rates>
        <Rate>
          <BaseByGuestAmts>
            <BaseByGuestAmt AmountAfterTax="100.00"
                            CurrencyCode="USD"
                            NumberOfGuests="1"/>
            <BaseByGuestAmt AmountAfterTax="110.00"
                            CurrencyCode="USD"
                            NumberOfGuests="2"/>
            <BaseByGuestAmt AmountAfterTax="120.00"
                            CurrencyCode="USD"
                            NumberOfGuests="3"/>
          </BaseByGuestAmts>
        </Rate>
      </Rates>
    </RateAmountMessage>
  </RateAmountMessages>
</OTA_HotelRateAmountNotifRQ>

Kullanıcı Google'da dört yetişkini aradığında toplam ücret 170 = 120 + 50 olur.

120, NumberOfGuests="3" ile <BaseByGuestAmt> oranından, 50 ise AdultCharge amount="50" üzerinden gelir.

Alt Öğe Ödemeleri

Çocuklar için yapılan ödemeler, 17 yaşına kadar olan yaş gruplarıyla ifade edilir ve sabit tutarlar, yüzdeler veya indirimlerle ifade edilebilir.

Aşağıdaki örnekte, alt ödemeleri belirten bir ExtraGuestCharges mesajı gösterilmektedir:

<?xml version="1.0" encoding="UTF-8"?>
<ExtraGuestCharges timestamp="2001-02-03T04:05:06+00:00" id="1">
  <HotelExtraGuestCharges hotel_id="ABC" action="overlay">
    <ExtraGuestCharge>
      <AgeBrackets>
        <ChildAgeBrackets>
          <ChildAgeBracket max_age="3" percentage="10"
                           counts_as_base_occupant="never" />
          <ChildAgeBracket max_age="10" percentage="30"
                           counts_as_base_occupant="preferred"/>
          <ChildAgeBracket max_age="17" discount_amount="10"
                           counts_as_base_occupant="always" />
        </ChildAgeBrackets>
      </AgeBrackets>
    </ExtraGuestCharge>
  </HotelExtraGuestCharges>
</ExtraGuestCharges>

İlgili ücretler şunlardır:

<?xml version="1.0" encoding="UTF-8"?>
<OTA_HotelRateAmountNotifRQ xmlns="http://www.opentravel.org/OTA/2003/05"
                            EchoToken="12345678"
                            TimeStamp="2020-05-19T20:50:37-05:00"
                            Version="3.0">
  <RateAmountMessages HotelCode="ABC">
    <RateAmountMessage>
      <StatusApplicationControl Start="2020-05-18"
                                End="2020-05-23"
                                InvTypeCode="RoomID_1"
                                RatePlanCode="PackageID_1"/>
      <Rates>
        <Rate>
          <BaseByGuestAmts>
            <BaseByGuestAmt AmountAfterTax="100.00"
                            CurrencyCode="USD"
                            NumberOfGuests="1"/>
            <BaseByGuestAmt AmountAfterTax="110.00"
                            CurrencyCode="USD"
                            NumberOfGuests="2"/>
          </BaseByGuestAmts>
        </Rate>
      </Rates>
    </RateAmountMessage>
  </RateAmountMessages>
</OTA_HotelRateAmountNotifRQ>
```

  1.  Suppose you want the total price for 2 adults and 1 child of 2 years
      of age.

      Children aged 0-3 are never included in the rate's occupancy,
      so here you should take the double occupancy rate and divide by 2 to
      get the unit price. Then, multiply by the percentage rate and sum
      with the rate to get the total price.

      `unit price ` = 110 / 2 = 55

      `total price` = 110 + 55 * 0.1 = 115.5

  1.  Suppose you want the total price for 1 adult and 2 children, both of 5
      years of age.

      Children aged 4-10 are preferably included in the rate's
      occupancy. you should start by looking for a 3 adult rate since both
      children are preferably included in the rate's occupancy. Since
      that doesn't exist you should fall back to the 2 adult rate and then,
      take this rate and divide by two to get the unit price. Finally,
      multiply by the percentage rate and sum with the scaled rate to
      get the total price.

      `unit price` = 110 / 2 = 55

      `total price` = 55 + 55 * 0.3 + 55 * 0.3 = 88

  1.  Suppose you want the total price for 1 adult and 1 child of 17
      years of age.

      Children aged 11-17 are always included in the rate's occupancy, so,
      in this case, take the double occupancy rate and divide by 2 to get
      the unit price. Then, deduct it by the discount amount and sum with
      the scaled rate to get the total price.

      `unit price` = 110 / 2 = 55

      `total price` = 55 + (55 - 10) = 100

Ücret Kısıtlamaları

Tüm kısıtlama türleri isteğe bağlıdır ve bunların herhangi bir kombinasyonu kullanılabilir.

Aşağıdaki örnekte, kısıtlamaları belirten bir ExtraGuestCharges mesajı gösterilmektedir:

<?xml version="1.0" encoding="UTF-8"?>
<ExtraGuestCharges timestamp="2001-02-03T04:05:06+00:00" id="1">
  <HotelExtraGuestCharges hotel_id="ABC" action="overlay">
    <ExtraGuestCharge>
      <RoomTypes>
        <RoomType id="queen" />
        <RoomType id="king" />
      </RoomTypes>
      <RatePlans>
        <RatePlan id="free-wifi" />
        <RatePlan id="hot-breakfast" />
      </RatePlans>
      <StayDates>
        <DateRange start="2020-09-01" end="2020-09-14"/>
      </StayDates>
      <AgeBrackets>
        <AdultCharge amount="50" />
      </AgeBrackets>
    </ExtraGuestCharge>
  </HotelExtraGuestCharges>
</ExtraGuestCharges>

Yukarıdaki mesaj, 1 Eylül 2020 - 14 Eylül 2020 tarihleri arasında "ücretsiz kablosuz bağlantı" veya "sıcak kahvaltı" ücret planına sahip "kraliçe" veya "iki kişilik" oda türüne sahip tüm ürünler için yetişkinlerin ücretlendirilmesi gerektiğini belirtir.

Çakışan Masraflar

Bu bölümde, aynı tarih ve ürün kombinasyonları için farklı ödemeler belirten geçersiz bir mesaj örneği gösterilmektedir.


<?xml version="1.0" encoding="UTF-8"?>
<ExtraGuestCharges timestamp="2001-02-03T04:05:06+00:00" id="1">
  <HotelExtraGuestCharges hotel_id="ABC" action="overlay">
    <ExtraGuestCharge>
      <RoomTypes>
        <RoomType id="queen" />
      </RoomTypes>
      <RatePlans>
        <RatePlan id="free-wifi" />
      </RatePlans>
      <StayDates>
        <DateRange start="2020-09-01" end="2020-09-14"/>
      </StayDates>
      <AgeBrackets>
        <AdultCharge amount="50" />
      </AgeBrackets>
    </ExtraGuestCharge>
    <ExtraGuestCharge>
      <RoomTypes>
        <RoomType id="queen" />
        <RoomType id="king" />
      </RoomTypes>
      <RatePlans>
        <RatePlan id="free-wifi" />
        <RatePlan id="hot-breakfast" />
      </RatePlans>
      <StayDates>
        <DateRange start="2020-09-01" end="2020-09-05"/>
      </StayDates>
      <AgeBrackets>
        <AdultCharge amount="20" />
      </AgeBrackets>
    </ExtraGuestCharge>
  </HotelExtraGuestCharges>
</ExtraGuestCharges>

Yukarıdaki mesaj geçersizdir çünkü ilk <ExtraGuestCharge>, 1-14 Eylül tarihlerinde geçerli olan "kraliçe" ve "ücretsiz kablosuz bağlantı"nın 50 yetişkin için ek ücret alması gerektiğini belirtir. İkinci <ExtraGuestCharge>, 1-5 Eylül tarihlerinde "ücretsiz kablosuz bağlantı" veya "sıcak kahvaltı" özelliklerinden herhangi birini içeren "kraliçe" veya "iki kişilik" rezervasyonların 20 yetişkin için ek ödeme yapması gerektiğini belirtir. 1-5 Eylül'de "kraliçe" ve "ücretsiz kablosuz bağlantı" için birbiriyle çelişen ücretler vardır. Ek bir yetişkin için 20 veya 50 ABD doları ödeme alınması arasında çakışma yaşanır.

Yanıtlar

Söz dizimi

ExtraGuestChargesResponse mesajında şu söz dizimi kullanılır:

<?xml version="1.0" encoding="UTF-8"?>
<ExtraGuestChargesResponse timestamp="timestamp"
                    id="message_ID"
                    partner="partner_key">
  <!-- Either Success or Issues will be populated. -->
  <Success/>
  <Issues>
    <Issue code="issue_code" status="issue_type">issue_description</Issue>
  </Issues>
</ExtraGuestChargesResponse>

Öğeler ve Özellikler

ExtraGuestChargesResponse mesajı aşağıdaki öğelere ve özelliklere sahiptir:

Öğe / @Özellik Yineleme sayısı Tür Açıklama
ExtraGuestChargesResponse 1 Complex element Alınan ExtraGuestCharges istek mesajının başarısını veya sorunlarını gösteren kök öğedir.
ExtraGuestChargesResponse / @timestamp 1 DateTime Bu mesajın oluşturulma tarihi ve saati.
ExtraGuestChargesResponse / @id 1 string İlişkilendirilmiş ExtraGuestCharges mesajındaki benzersiz tanımlayıcıdır.
ExtraGuestChargesResponse / @partner 1 string Bu mesajın iş ortağı hesabıdır.
ExtraGuestChargesResponse / Success 0..1 Success ExtraGuestCharges mesajının uyarı, hata veya sorun olmadan başarıyla işlendiğini belirtir.

Her mesajda <Success> veya <Issues> bulunur.
ExtraGuestChargesResponse / Issues 0..1 Issues ExtraGuestCharges mesajı işlenirken karşılaşılan bir veya daha fazla sorun için kullanılan bir kapsayıcıdır.

Her mesajda <Success> veya <Issues> bulunur.
ExtraGuestChargesResponse / Issues / Issue 1..n Issue ExtraGuestCharges mesajı işlenirken karşılaşılan uyarı, hata veya sorunun açıklaması. Bu sorunlarla ilgili ayrıntılar Feed Durumu Hata Mesajları bölümünde bulunabilir.
ExtraGuestChargesResponse / Issues / Issue / @code 1 integer Sorunun tanımlayıcısıdır.
ExtraGuestChargesResponse / Issues / Issue / @status 1 enum

Karşılaşılan sorunun türü.

Geçerli değerler warning, error ve failure değerleridir.

Örnekler

Başarılı

Aşağıda, başarıyla işlenmiş bir ExtraGuestCharges mesajına yanıt yer almaktadır.

<?xml version="1.0" encoding="UTF-8"?>
<ExtraGuestChargesResponse timestamp="2020-05-18T16:20:00-04:00"
                    id="12345678"
                    partner="partner_key">
  <Success/>
</ExtraGuestChargesResponse>

Sorunlar

Aşağıda, hatalar nedeniyle işlenmemiş bir ExtraGuestCharges mesajına yanıt yer almaktadır.

<?xml version="1.0" encoding="UTF-8"?>
<ExtraGuestChargesResponse timestamp="2020-05-18T16:20:00-04:00"
                    id="12345678"
                    partner="partner_key">
  <Issues>
    <Issue code="1001" status="error">Example</Issue>
  </Issues>
</ExtraGuestChargesResponse>