EkstraKonukÜcretler

<OTA_HotelRateAmountNotifRQ> üzerinden gönderilen fiyatlar, orijinal konuk sayısına ek olarak yetişkin ve çocuk sayısını hesaba katacak şekilde değiştirilebilir. ExtraGuestCharges mesajı, bu ek konuklar için ücretlerin nasıl hesaplanacağını ve hangi odalar, ücret planları ve konaklama tarihleri için ücretlerin geçerli olacağını belirtmenize olanak tanır.

Kapasite Şartları

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

İ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ı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 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 uygulandığını belirtir. Yalnızca overlay desteklenir ve varsayılan ayar yer paylaşımıdır. Güncelleme uygulanmadan önce bu mülk için yapılan önceki tüm ödemeler silinir.
ExtraGuestCharges / HotelExtraGuestCharges / ExtraGuestCharge 0..99 ExtraGuestCharge

Bir tesis için tek bir ücret grubu. Bu, ücretlerin nasıl uygulanabileceği ve yaş veya konuk kategorisine göre nasıl hesaplanacağı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 kombinasyonunu belirtiyorsa mesajın tamamı reddedilir.

ExtraGuestCharges / HotelExtraGuestCharges / ExtraGuestCharge / AgeBrackets 1 AgeBrackets Yaş veya konuk kategorisine göre ücretleri hesaplamak için yaş gruplarını içeren bir kapsayıcı.
ExtraGuestCharges / HotelExtraGuestCharges / ExtraGuestCharge / AgeBrackets / AdultCharge 0..1 AdultCharge Ek bir yetişkin için ücretin kapsayıcısı.
ExtraGuestCharges / HotelExtraGuestCharges / ExtraGuestCharge / AgeBrackets / AdultCharge / @amount 0..1 float Ek bir yetişkin için alınacak sabit tutarı belirten pozitif bir ondalık değer. Bu ödeme, gecelik ücretler için belirtilen para birimi ile yapılır.
ExtraGuestCharges / HotelExtraGuestCharges / ExtraGuestCharge / AgeBrackets / ChildAgeBrackets 0..1 ChildAgeBrackets Ek çocuk ücretleri için kapsayıcı. 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ıralanı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> bölümünde belirtilen ücretlerin uygulanabileceği maksimum yaş. Bu öğeden önce başka <ChildAgeBracket> belirtilmemişse minimum yaş sıfırdır. Aksi takdirde, önceki gruptaki maksimum yaştan 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 bebeklerin çocuk kapasitesine dahil edilmesi gerekmeyebilir.
ExtraGuestCharges / HotelExtraGuestCharges / ExtraGuestCharge / AgeBrackets / ChildAgeBrackets / ChildAgeBracket / @amount 0..1 float Bu aralıkta ek bir çocuk için alınacak sabit tutarı belirten sıfırdan büyük bir ondalık değer. Bu ödeme, gecelik ücretler için belirtilen para biriminde yapılır.
ExtraGuestCharges / HotelExtraGuestCharges / ExtraGuestCharge / AgeBrackets / ChildAgeBrackets / ChildAgeBracket / @percentage 0..1 float

Bu aralıkta ek bir çocuk için alınması gereken yetişkin fiyatının yüzdesini belirten 1 ile 99 arasında bir ondalık değerdir. Bu ödeme, gecelik ücretler için belirtilen para birimi ile yapılı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ıkta ek bir çocuk için yetişkin fiyatından sabit bir indirim tutarını belirten pozitif ondalık değer. Bu ödeme, gecelik ücretler için belirtilen para birimi ile yapılır.

Genel olarak, bu aralıkta bir çocuk için ödeme, sabit tutarın "birim fiyatından" çıkarılmasıyla hesaplanır. Birim fiyat, counts_as_base_occupant özelliği bölümünde daha ayrıntılı olarak ele alınmıştı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 bir <BaseByGuestAmount> oranı seçtiğinizde bir çocuğun NumberOfGuest'e 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 belirtilirse çocuk, fiyatın doluluk sayısına hiçbir zaman dahil edilmemelidir.

    2 yetişkin ve 2 çocuk (2+2) için ücret hesaplamak istiyorsanız çocuklar dahil edilmediğinden 2 yetişkin için geçerli ücreti kullanmanız gerekir.

  • preferred belirtilirse çocuk, tercihen ücretin doluluk sayısına dahil edilmelidir.

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

  • always belirtilirse çocuk, ücretin doluluk oranına her zaman 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 geçerli ü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ç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 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 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 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

Herhangi bir karakter kombinasyonu geçerlidir.

Örnekler

Yetişkin Ücretleri

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 ücretler aşağıda verilmiş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, NumberOfGuests="3" ile <BaseByGuestAmt> oranından, 50 ise AdultCharge amount="50" oranından gelir.

Çocuk ödemeleri

Çocuklar için ücretler, 17 yaşına kadar olan yaş gruplarında ifade edilir ve sabit tutarlar, yüzdeler veya indirimler şeklinde olabilir.

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 ücretler aşağıda verilmiş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

Ödeme 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 "ücretsiz kablosuz internet" veya "sıcak kahvaltı" ücret planına sahip "queen" ya da "king" oda türüne sahip tüm ürünler için yetişkinlerden ücret alınması gerektiği belirtilmektedir.

Çakışan Ödemeler

Bu bölümde, aynı tarih ve ürün kombinasyonları için farklı ücretler 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>

İlk <ExtraGuestCharge>, 1-14 Eylül tarihleri arasında "queen" ve "free-wifi" için ek yetişkinlerden 50 TL ücret alınacağını belirttiği için yukarıdaki mesaj geçersizdir. İkinci <ExtraGuestCharge>, 1-5 Eylül tarihleri arasında "queen" veya "king" odalarında "free-wifi" ya da "hot-breakfast" seçeneklerinden herhangi biri seçildiğinde ek yetişkinler için 20 TL ücret alınacağını belirtir. 1-5 Eylül tarihleri arasında "queen" ve "free-wifi" için çakışan ücretler ve ek yetişkin için 20 mi yoksa 50 mi ücret alınacağı konusunda bir tutarsızlı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ı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 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üdü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>