EkstraKonukÜcretler

<OTA_HotelRateAmountNotifRQ> aracılığıyla gönderilen fiyatlar, orijinal konuk sayısına ek olarak yetişkinler ve çocuklar için geçerli olacak şekilde değiştirilebilir. ExtraGuestCharges mesajı, bu ek konuklar için ücretlerin nasıl hesaplanacağı ve ücretlerinin hangi odalar, ücret planları ve konaklama tarihleri için geçerli olacağı konusunda spesifikasyonlara imkan tanır.

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 şu 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ı hesap için <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. İzin verilen karakterler a-z, A-Z, 0-9, _ (alt çizgi) ve - (kısa çizgi) şeklindedir.
ExtraGuestCharges / @timestamp	1	DateTime	Bu mesajın oluşturulma tarihi ve saatidir.
ExtraGuestCharges / HotelExtraGuestCharges	0..n	HotelExtraGuestCharges	Tek bir tesise ait ücretlerin yer aldığı kapsayıcı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 uygulanacağını belirtir. Yalnızca overlay desteklenir ve varsayılan değer yer paylaşımıdır. Bu tesisin önceki ödemeleri, güncelleme uygulanmadan önce temizlenir.
ExtraGuestCharges / HotelExtraGuestCharges / ExtraGuestCharge	0..99	ExtraGuestCharge	Bir tesis için tek bir ücret grubu. Bu, bir ödemenin nasıl alınabileceği ve ücretlerin yaşa veya konuk kategorisine göre nasıl hesaplandığıyla ilgili kısıtlamalar içerebilir. Bir HotelExtraGuestCharges içindeki her ExtraGuestCharge, benzersiz bir tarih ve ürün grubu için geçerli olmalıdır. İki ExtraGuestCharge öğesi aynı tarih-ürün kombinasyonuna işaret ediyorsa mesajın tamamı reddedilir.
ExtraGuestCharges / HotelExtraGuestCharges / ExtraGuestCharge / AgeBrackets	1	AgeBrackets	Ücretleri yaşa veya konuk kategorisine göre hesaplamak için kullanılan, yaş gruplarındaki bir kapsayıcıdır.
ExtraGuestCharges / HotelExtraGuestCharges / ExtraGuestCharge / AgeBrackets / AdultCharge	0..1	AdultCharge	Ek yetişkin ücretinin depolandığı kutu.
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 çocuk ücretlerinin yer aldığı kapsayıcıdır. Bu yaş grupları yalnızca 0-17 yaş aralığını (bu yaş aralığı 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> politikasında belirtilen ücretlerin uygulanabileceği maksimum yaştır. Bundan önce başka bir <ChildAgeBracket> belirtilmemişse minimum yaş sıfırdır. Aksi takdirde, önceki dilimin maksimum yaş değerinden 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 alt kapasitesine dahil edilip edilmeyeceğini gösteren boole. 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 ücretlendirilecek sabit tutarı belirten, negatif olmayan bir ondalık değerdir. Bu ödemede, gecelik fiyatlar için belirtilen para birimiyle aynı para birimi kullanılır.
ExtraGuestCharges / HotelExtraGuestCharges / ExtraGuestCharge / AgeBrackets / ChildAgeBrackets / ChildAgeBracket / @percentage	0..1	float	1-99 arasında, bu yaş aralığındaki ek bir çocuk için alınması gereken yetişkin fiyatının yüzdesini belirten ondalık değerdir. Bu ödemede, gecelik ücretler için belirtilen para birimiyle aynı para birimi kullanılır. Yetişkinlere uygun fiyatın nasıl hesaplandığıyla ilgili ayrıntılar için counts_as_base_occupant bölümündeki tartışmayı inceleyin.
ExtraGuestCharges / HotelExtraGuestCharges / ExtraGuestCharge / AgeBrackets / ChildAgeBrackets / ChildAgeBracket / @discount_amount	0..1	float	Bu yaş aralığındaki ek bir çocuk için yetişkin fiyatı üzerinden sabit bir indirim tutarı belirten pozitif ondalık değerdir. Bu ödemede, gecelik ücretler için belirtilen para birimiyle aynı para birimi kullanılır. Genel olarak bu yaş aralığındaki çocuklar için ü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ı olarak ele alınmaktadı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üzde ücretleri ve indirimlerin uygulanması için <BaseByGuestAmount> ücreti seçtiğinizde bir çocuğun NumberOfGuest bölümüne dahil edilip edilmeyeceğini belirler. Burada amaç, gerçek ücretin hesaplanabileceği 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 ücretin doluluk oranına dahil edilmemelidir. 2 yetişkin ve 2 çocuk (2+2) için ücret hesaplamak istiyorsanız çocuklar dahil edilmediğinden bu ücreti 2 yetişkin için kullanmanız gerekir. preferred belirtilirse çocuk tercihen fiyata dahil edilmelidir. 2 yetişkin ve 1 çocuk (2+1) için ücret hesaplamak istiyorsanız tercihen 3 yetişkin için bu fiyatı kullanmanız gerekir. Bu bulunamazsa 2 yetişkin için belirtilen ücreti kullanmanız gerekir. always belirtilirse çocuk her zaman ücretin doluluk oranına dahil edilmelidir. 2 yetişkin ve 2 çocuk (2+2) için ücret hesaplamak istiyorsanız çocukların dahil edilmesi gerektiğinden 4 yetişkin için ücreti kullanmanız gerekir.
ExtraGuestCharges / HotelExtraGuestCharges / ExtraGuestCharge / RoomTypes	0..1	RoomTypes	Ücretlerin geçerli olduğu oda türleri listesinin kapsayıcısıdır. Ücretler, belirtilen her bir <RoomType> için geçerli olur. <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 <RoomData> öğesinde tanımlanır ve <RoomID> değeri kullanılarak belirtilir. (<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	Ödemelerin 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 müsaitlik 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ının <StatusApplicationControl> öğesindeki RatePlanCode özelliğinde bulunan PackageID değeriyle eşlenir. İzin verilen maksimum karakter sayısı 50'dir.
ExtraGuestCharges / HotelExtraGuestCharges / ExtraGuestCharge / StayDates	0..1	StayDates	Ücretlerin 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 (girilen tarihler dahil) başlangıç tarihidir (tesisin bulunduğu saat dilimine göre). 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ırlandırılmaz.
ExtraGuestCharges / HotelExtraGuestCharges / ExtraGuestCharge / StayDates / DateRange / @end	0..1	Date	Tarih aralığının (girilen tarihler dahil) bitiş tarihidir (tesisin bulunduğu saat dilimine göre). 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ırlandırılmaz.
ExtraGuestCharges / HotelExtraGuestCharges / ExtraGuestCharge / StayDates / DateRange / @days_of_week	0..1	string	Tarih aralığında izin verilen günler. 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 Tüm karakter kombinasyonları geçerlidir.

Örnekler

Yetişkin Ücretleri

Ek yetişkinler için ücretler yalnızca sabit tutarlar olarak ifade edilebilir. Aşağıdaki örnekte, yetişkinlere yönelik ücretleri 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 aşağıda belirtilmiştir:

<?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>

Bir kullanıcı Google'da dört yetişkin için arama yaptığında toplam ücret 170 = 120 + 50 olur.

120 değeri, NumberOfGuests="3" içeren <BaseByGuestAmt> ücretinden ve 50 değeri AdultCharge amount="50" üzerinden gelir.

Alt Ödemeler

Çocuklar için alınan ücretler, 17 yaşına kadar olan yaş gruplarıyla ifade edilir ve sabit tutarlar, yüzde veya indirim cinsinden 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 aşağıda belirtilmiştir:

<?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 mesajda, 1 Eylül 2020 - 14 Eylül 2020 tarihleri arasında "free-wifi" (ücretsiz-kablosuz) veya "hot-break fast" paketine sahip oda türü "kraliçe" veya "tek kişilik" olan tüm ürünler için yetişkinlerin ücretlendirilmesi gerektiği belirtilmektedir.

Çakışan Masraflar

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

Uyarı: Aşağıdaki mesaj geçersiz. Kullanmayın!

<?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 için "kraliçe" ve "ücretsiz kablosuz bağlantı" için 50 yetişkin tutarında ek ödeme alınması gerektiğini belirtir. İkinci <ExtraGuestCharge>, 1-5 Eylül tarihleri için "ücretsiz kablosuz bağlantı" veya "sıcak kahvaltı" özelliklerinden herhangi birine sahip bir "kraliçe" veya "kral" için 20 yetişkin için ek ücret ödenmesi gerektiğini belirtir. 1-5 Eylül tarihleri arasında "kraliçe" ve "ücretsiz-kablosuz" ücretleri çakışmaktadır ve ek bir yetişkin için 20 veya 50 ABD doları arasında ücret alınması çakışmaktadı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ında aşağıdaki öğeler ve özellikler bulunur:

Öğ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 saatidir.
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ıdır. Bu sorunlarla ilgili ayrıntıları Feed Durumu Hata Mesajları konusunda bulabilirsiniz.
ExtraGuestChargesResponse / Issues / Issue / @code	1	integer	Sorunun tanımlayıcısı.
ExtraGuestChargesResponse / Issues / Issue / @status	1	enum	Karşılaşılan sorunun türü. Geçerli değerler warning, error ve failure'dir.

Ö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>