ExtraGuestCharges

<OTA_HotelRateAmountNotifRQ> üzerinden gönderilen fiyatlar, fiyatın orijinal konuk sayısına ek olarak yetişkinleri ve çocukları hesaba katacak şekilde değiştirilebilir. ExtraGuestCharges mesajı, bu ek konuklar için ücretlerin nasıl hesaplanması gerektiği ve hangi odalar, ücret planları ve konaklama tarihleri için ücretlerinin geçerli olması gerektiği konusunda spesifikasyon yapılmasına olanak tanır.

Kapasite Koşulları

ExtraGuestCharges mesajından hesaplanan fiyatlar yalnızca tüm kapasite koşulları karşılandığında geçerlidir. Daha fazla bilgi için Transaction (Tesis Verileri) başlıklı makaleyi 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 öğesi.
ExtraGuestCharges / @partner 1 string Bu mesajın iş ortağı hesabı. 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 genelinde <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 kapsayıcısıdır.
ExtraGuestCharges / HotelExtraGuestCharges / @hotel_id 1 string Tesisin benzersiz tanımlayıcısı. 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 olarak yer paylaşımı kullanılır. Güncelleme uygulanmadan önce bu mülkle ilgili önceki tüm ücretler temizlenir.
ExtraGuestCharges / HotelExtraGuestCharges / ExtraGuestCharge 0..99 ExtraGuestCharge

Bir tesise ait tek bir ücret kümesidir. Bu, ödemenin nasıl alınabileceği ve ödemelerin yaşa veya misafir kategorisine göre nasıl hesaplandığıyla ilgili kısıtlamalar içerebilir.

Bir ExtraGuestCharge içindeki her HotelExtraGuestCharges, benzersiz bir tarih ve ürün grubu için geçerli olmalıdır. İki ExtraGuestCharge öğesi aynı tarih-ürün kombinasyonunu ifade ediyorsa mesajın tamamı reddedilir.

ExtraGuestCharges / HotelExtraGuestCharges / ExtraGuestCharge / AgeBrackets 1 AgeBrackets Ücretleri yaşa veya misafir kategorisine göre hesaplamak için kullanılan yaş aralıklarının bulunduğu bir kapsayıcı.
ExtraGuestCharges / HotelExtraGuestCharges / ExtraGuestCharge / AgeBrackets / AdultCharge 0..1 AdultCharge Ek yetişkin ücretinin kapsayıcısıdır.
ExtraGuestCharges / HotelExtraGuestCharges / ExtraGuestCharge / AgeBrackets / AdultCharge / @amount 0..1 float Ek bir yetişkin için alınacak sabit tutarı belirten pozitif ondalık değer. Bu ücret, gecelik ücretler için belirtilen para birimiyle aynıdır.
ExtraGuestCharges / HotelExtraGuestCharges / ExtraGuestCharge / AgeBrackets / ChildAgeBrackets 0..1 ChildAgeBrackets Ek çocuk ücretlerinin kapsayıcısıdır. Bu yaş aralıkları yalnızca 0-17 yaş aralığını 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. Alınacak tutar amount, percentage veya discount_amount kullanılarak belirtilebilir. Bu özelliklerden tam olarak biri her <ChildAgeBracket> için belirtilmelidir.
ExtraGuestCharges / HotelExtraGuestCharges / ExtraGuestCharge / AgeBrackets / ChildAgeBrackets / ChildAgeBracket / @max_age 1 integer <ChildAgeBracket> içinde belirtilen ücretlerin geçerli olabileceği maksimum yaş. Bu öğeden önce başka <ChildAgeBracket> belirtilmemişse minimum yaş sıfırdır. Aksi takdirde, önceki aralığın maksimum yaşından bir yaş daha büyük olur.
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 belirten bir boole değeri. Bu kapasiteler Transaction(Tesis Verileri) ile ayarlanabilir. Örneğin, belirli bir yaşın altındaki bebekler çocuk kapasitesine dahil edilmeyebilir.
ExtraGuestCharges / HotelExtraGuestCharges / ExtraGuestCharge / AgeBrackets / ChildAgeBrackets / ChildAgeBracket / @amount 0..1 float Bu aralıkta ek bir çocuk için alınacak sabit tutarı belirten, negatif olmayan bir ondalık değer. Bu ücret, gecelik ücretler için belirtilen para birimiyle aynıdır.
ExtraGuestCharges / HotelExtraGuestCharges / ExtraGuestCharge / AgeBrackets / ChildAgeBrackets / ChildAgeBracket / @percentage 0..1 float

Bu parantezdeki ek bir çocuk için alınması gereken yetişkin fiyatının yüzdesini belirten 1-99 arasında ondalık bir değerdir. Bu ödeme, gecelik ücretler için belirtilen para birimiyle aynıdır.

Yetişkin fiyatının nasıl hesaplandığıyla ilgili ayrıntılar için counts_as_base_occupant bölümündeki tartışmaya bakın.

ExtraGuestCharges / HotelExtraGuestCharges / ExtraGuestCharge / AgeBrackets / ChildAgeBrackets / ChildAgeBracket / @discount_amount 0..1 float

Bu aralıktaki ek bir çocuk için yetişkin fiyatından düşülecek sabit indirim tutarını belirten pozitif ondalık değer. Bu ücret, gecelik ücretler için belirtilen para birimiyle aynıdır.

Genel olarak, bu aralıktaki bir çocuk için ücret, sabit tutarın "birim fiyatından" düşülmesiyle hesaplanır. Birim fiyatı, counts_as_base_occupant özelliği 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 belirtilmişse counts_as_base_occupant özelliği de belirtilmelidir. Bu değer, yüzde cinsinden ücret ve indirim uygulamak için <BaseByGuestAmount> oranını seçtiğinizde çocuğun NumberOfGuest'ya dahil edilip edilmeyeceğini belirler.

Buradaki 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 belirtilmişse çocuk hiçbir zaman ücretin konaklama kapasitesine dahil edilmemelidir.

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

  • preferred belirtilirse çocuk tercihen ücretin konaklama kapasitesine dahil edilmelidir.

    2 yetişkin ve 1 çocuk (2+1) için bir fiyat hesaplamak istiyorsanız tercihen 3 yetişkin için geçerli fiyatı kullanmalısınız. Bu fiyat bulunamazsa 2 yetişkin için geçerli fiyatı kullanmalısınız.

  • always belirtilmişse çocuk her zaman ücretin konaklama kapasitesine dahil edilmelidir.

    2 yetişkin ve 2 çocuk (2+2) için bir fiyat hesaplamak istiyorsanız çocukların dahil edilmesi gerektiğinden 4 yetişkin için geçerli fiyatı 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çerlidir. <RoomTypes> belirtilmezse ücretler, belirtilen tesis içindeki 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 belirtilir. (<RoomID> değeri, OTA_HotelRateAmountNotifRQ mesajlarındaki InvTypeCode özelliği tarafından da belirtilir.)
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 uygulandığı ü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), OA_HotelRateAmountNotifRQ ve OTA_HotelAvailNotifRQ mesajlarında belirtilen ve PackageID tarafından tanımlanan paket, ücret ve stok durumunun birleşimiyle 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 uygulanacağı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 ilgili 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 ilgili 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ünlerdir. 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çindeki günlere 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 kombinasyonu uygulanabilir.

Örnekler

Yetişkinlere Yönelik Ücretler

Ek yetişkinler için ücretler 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 oranlar ş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>

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

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

Çocuk Ödemeleri

Çocuk ücretleri 17 yaşına kadar olan yaş aralıkları şeklinde ifade edilir ve sabit tutarlar, yüzdeler veya indirimler şeklinde belirtilebilir.

Aşağıdaki örnekte, çocuk ü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>
      <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 oranlar ş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

Şarj 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 ile 14 Eylül 2020 tarihleri arasında "free-wifi" veya "hot-breakfast" fiyat planına sahip "queen" veya "king" oda türündeki tüm ürünler için yetişkinlerden ücret alınması gerektiği belirtiliyor.

Çakışan Ücretler

Bu bölümde, aynı tarih ve ürün kombinasyonları için farklı ücretler belirten geçersiz bir mesaja örnek verilmektedir.


<?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, ilk <ExtraGuestCharge> 1-14 Eylül tarihleri arasında "queen" ve "free-wifi" için ek yetişkinlerden 50 TL ücret alınması gerektiğini belirttiği için geçersizdir. İkinci <ExtraGuestCharge> 1-5 Eylül tarihleri arasında "queen" veya "king" ile "free-wifi" veya "hot-breakfast" seçeneklerinden herhangi birini tercih eden ek yetişkinlerden 20 TL ücret alınması gerektiğini belirtir. 1-5 Eylül tarihleri arasında "queen" ve "free-wifi" için çakışan ücretler var ve ek bir yetişkin için 20 TL mi yoksa 50 TL mi alınacağı konusunda bir anlaşmazlık var.

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ı.
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 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 şeklindedir.

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