<OTA_HotelRateAmountNotifRQ> से भेजे जाने वाले किराये में वयस्कों और बच्चों के हिसाब से बदलाव किए जा सकते हैं. इसके अलावा, किराये की मूल संख्या में बदलाव भी किए जा सकते हैं. ExtraGuestCharges मैसेज में यह बताया जाता है कि इन अतिरिक्त मेहमानों के लिए किराये का हिसाब कैसे लगाया जाना चाहिए. साथ ही, यह जानकारी भी दी जाती है कि किन कमरों, कमरों के किराये की योजना, और ठहरने की तारीख के लिए उनके शुल्क लागू होने चाहिए.
क्षमता से जुड़ी ज़रूरी शर्तें
ExtraGuestCharges मैसेज से मिली कीमतों का हिसाब सिर्फ़ तब मान्य होता है, जब
क्षमता से जुड़ी सभी ज़रूरी शर्तें पूरी होती हों. ज़्यादा जानकारी के लिए, लेन-देन (प्रॉपर्टी डेटा) देखें.
अनुरोध
सिंटैक्स
ExtraGuestCharges मैसेज इस सिंटैक्स का इस्तेमाल करता है:
<?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>
एलिमेंट और एट्रिब्यूट
ExtraGuestCharges मैसेज में ये एलिमेंट और एट्रिब्यूट होते हैं:
| एलिमेंट / @एट्रिब्यूट | दोहराए जाने की संख्या | टाइप | ब्यौरा |
|---|---|---|---|
| ExtraGuestCharges | 1 | Complex element | इस मैसेज का रूट एलिमेंट. |
| ExtraGuestCharges / @partner | 1 | string | इस मैसेज के लिए पार्टनर खाता. यह स्ट्रिंग वैल्यू, एक Partner key वैल्यू है. यह Hotel Center में
खाता सेटिंग वाले पेज पर दी गई है.
ध्यान दें: अगर आपके पास ऐसा बैकएंड है जो कई खातों के लिए फ़ीड उपलब्ध कराता है, तो यह वैल्यू, |
| ExtraGuestCharges / @id | 1 | string | अनुरोध के इस मैसेज के लिए यूनीक आइडेंटिफ़ायर. यह वैल्यू
रिस्पॉन्स मैसेज में दिखती है. a-z, A-Z, 0-9, _ (अंडरस्कोर), और
- (डैश) जैसे वर्ण इस्तेमाल करने की अनुमति है. |
| ExtraGuestCharges / @timestamp | 1 | DateTime | इस मैसेज को बनाने की तारीख और समय. |
| ExtraGuestCharges / HotelExtraGuestCharges | 0..n | HotelExtraGuestCharges | एक प्रॉपर्टी के शुल्कों वाला कंटेनर. |
| ExtraGuestCharges / HotelExtraGuestCharges / @hotel_id | 1 | string | प्रॉपर्टी के लिए यूनीक आइडेंटिफ़ायर. यह मान
होटल आईडी से मेल खाना चाहिए, जो होटल सूची फ़ीड में
<listing> में <id> एलिमेंट का इस्तेमाल करके दिया गया है. होटल आईडी की जानकारी Hotel Center में भी होती है. |
| ExtraGuestCharges / HotelExtraGuestCharges / @action | 0..1 | enum | बताता है कि अपडेट कैसे लागू किया जाता है. सिर्फ़ overlay का इस्तेमाल किया जा सकता है और डिफ़ॉल्ट तौर पर, ओवरले का इस्तेमाल किया जाता है. इस अपडेट के लागू होने से पहले, इस प्रॉपर्टी के लिए
पहले से लिए गए शुल्क मिटा दिए जाते हैं. |
| ExtraGuestCharges / HotelExtraGuestCharges / ExtraGuestCharge | 0..99 | ExtraGuestCharge | किसी प्रॉपर्टी के लिए शुल्कों का एक सेट. इसमें शुल्क लागू करने के तरीके और उम्र या मेहमान कैटगरी के हिसाब से शुल्क का हिसाब लगाने पर पाबंदी लगाई जा सकती है.
|
| ExtraGuestCharges / HotelExtraGuestCharges / ExtraGuestCharge / AgeBrackets | 1 | AgeBrackets | उम्र ब्रैकेट का एक कंटेनर, जिसका इस्तेमाल उम्र या मेहमान कैटगरी के आधार पर शुल्क का हिसाब लगाने के लिए किया जाता है. |
| ExtraGuestCharges / HotelExtraGuestCharges / ExtraGuestCharge / AgeBrackets / AdultCharge | 0..1 | AdultCharge | एक और वयस्क के शुल्क का कंटेनर. |
| ExtraGuestCharges / HotelExtraGuestCharges / ExtraGuestCharge / AgeBrackets / AdultCharge / @amount | 0..1 | float | एक पॉज़िटिव डेसिमल वैल्यू, जो किसी दूसरे वयस्क से लिए जाने वाले शुल्क के बारे में बताती है. इस शुल्क में वही मुद्रा इस्तेमाल होती है जो रात के किराये के लिए तय की गई मुद्रा में होती है. |
| ExtraGuestCharges / HotelExtraGuestCharges / ExtraGuestCharge / AgeBrackets / ChildAgeBrackets | 0..1 | ChildAgeBrackets | बच्चों के लिए अतिरिक्त शुल्क के लिए कंटेनर. ये उम्र सीमा सिर्फ़ 0 से 17 साल की उम्र सीमा को कवर कर सकती हैं. |
| ExtraGuestCharges / HotelExtraGuestCharges / ExtraGuestCharge / AgeBrackets / ChildAgeBrackets / ChildAgeBracket | 1..99 | ChildAgeBracket | किसी खास उम्र सीमा के बच्चों पर लागू होने वाला शुल्क. इन्हें
सबसे कम max_age से सबसे ज़्यादा
max_age के क्रम में लगाया जाना चाहिए. शुल्क के लिए ली जाने वाली रकम के बारे में
amount, percentage या
discount_amount में से किसी एक का इस्तेमाल किया जा सकता है. हर <ChildAgeBracket> के लिए, इनमें से एक एट्रिब्यूट की वैल्यू देना ज़रूरी है.
|
| ExtraGuestCharges / HotelExtraGuestCharges / ExtraGuestCharge / AgeBrackets / ChildAgeBrackets / ChildAgeBracket / @max_age | 1 | integer | वह ज़्यादा से ज़्यादा उम्र जिसके लिए <ChildAgeBracket> में बताए गए शुल्क लागू हो सकते हैं. अगर इससे पहले कोई <ChildAgeBracket> तय नहीं किया गया है,
तो कम से कम उम्र शून्य होगी. अगर ऐसा नहीं है, तो यह पिछले ब्रैकेट की ज़्यादा से ज़्यादा उम्र से एक बड़ी है. |
| ExtraGuestCharges / HotelExtraGuestCharges / ExtraGuestCharge / AgeBrackets / ChildAgeBrackets / ChildAgeBracket / @exclude_from_capacity | 1 | boolean | एक बूलियन जो बताता है कि इस उम्र की सीमा में मौजूद किसी बच्चे को, कमरे की कुल क्षमता और बच्चे की क्षमता में शामिल किया जाना चाहिए या नहीं. इन क्षमताओं को लेन-देन(प्रॉपर्टी का डेटा) की मदद से सेट किया जा सकता है. उदाहरण के लिए, हो सकता है कि एक खास उम्र से कम उम्र के शिशुओं को बच्चों की क्षमता के हिसाब से गिनती करने की ज़रूरत न हो. |
| ExtraGuestCharges / HotelExtraGuestCharges / ExtraGuestCharge / AgeBrackets / ChildAgeBrackets / ChildAgeBracket / @amount | 0..1 | float | एक नॉन-नेगेटिव दशमलव वैल्यू, जो इस ब्रैकेट में मौजूद एक और बच्चे से लिए जाने वाले फ़्लैट की रकम के बारे में बताती है. इस शुल्क में वही मुद्रा इस्तेमाल होती है जो रात के किराये के लिए तय की गई मुद्रा में होती है. |
| ExtraGuestCharges / HotelExtraGuestCharges / ExtraGuestCharge / AgeBrackets / ChildAgeBrackets / ChildAgeBracket / @percentage | 0..1 | float | 1 से 99 तक की दशमलव वैल्यू, जो वयस्कों के लिए तय की गई उस कीमत का प्रतिशत बताती है जो इस ब्रैकेट में शामिल एक और बच्चे से ली जानी चाहिए. इस शुल्क में वही मुद्रा इस्तेमाल होती है जो रात के किराये के लिए तय की गई मुद्रा में होती है. वयस्कों के लिए कीमत का हिसाब कैसे लगाया जाता है, इस बारे में जानने के लिए
|
| ExtraGuestCharges / HotelExtraGuestCharges / ExtraGuestCharge / AgeBrackets / ChildAgeBrackets / ChildAgeBracket / @discount_amount | 0..1 | float | पॉज़िटिव दशमलव वैल्यू, जो इस ब्रैकेट में शामिल किसी अन्य बच्चे के लिए, वयस्क कीमत पर मिलने वाली छूट की रकम के बारे में बताती है. इस शुल्क में उसी मुद्रा का इस्तेमाल होता है जो रात के किराये के लिए तय की गई मुद्रा में होती है. आम तौर पर, इस ब्रैकेट में किसी बच्चे के लिए शुल्क का हिसाब,
"इकाई की कीमत" में से एक जैसी रकम घटाकर लगाया जाता है. इकाई की कीमत के बारे में
|
| ExtraGuestCharges / HotelExtraGuestCharges / ExtraGuestCharge / AgeBrackets / ChildAgeBrackets / ChildAgeBracket / @counts_as_base_occupant | 0..1 | string | अगर यहां लक्ष्य यह है कि एक "इकाई कीमत" पाई जाए, जिससे असल शुल्क का हिसाब लगाया जा सके.
इस एट्रिब्यूट की वैल्यू,
|
| ExtraGuestCharges / HotelExtraGuestCharges / ExtraGuestCharge / RoomTypes | 0..1 | RoomTypes | कमरों के टाइप की सूची के लिए कंटेनर, जिस पर शुल्क लागू होते हैं.
यह शुल्क, बताए गए हर <RoomType>
पर लागू होता है. अगर <RoomTypes> की जानकारी नहीं दी गई है, तो इस प्रॉपर्टी के सभी कमरों पर शुल्क लागू होंगे. |
| ExtraGuestCharges / HotelExtraGuestCharges / ExtraGuestCharge / RoomTypes / RoomType | 1..n | RoomType | यह बताता है कि कमरा किस तरह का है. लेन-देन (प्रॉपर्टी का डेटा) मैसेज के
<RoomData> एलिमेंट में किस तरह का कमरा शामिल होता है,
इसकी जानकारी देने के लिए,
<RoomID> वैल्यू का इस्तेमाल किया जाता है. (इसकी <RoomID>
वैल्यू, OTA_HotelRateAmountNotifRQ मैसेज में भी InvTypeCode एट्रिब्यूट में दी गई है.) |
| ExtraGuestCharges / HotelExtraGuestCharges / ExtraGuestCharge / RoomTypes / RoomType / @id | 1 | string | इन्वेंट्री के लिए यूनीक आइडेंटिफ़ायर (कमरे का टाइप). यह वैल्यू, ट्रांज़ैक्शन (प्रॉपर्टी डेटा) मैसेज में
<RoomID> पर मैप करती है.
ज़्यादा से ज़्यादा 50 वर्ण इस्तेमाल किए जा सकते हैं. |
| ExtraGuestCharges / HotelExtraGuestCharges / ExtraGuestCharge / RatePlans | 0..1 | RatePlans | दर प्लान की सूची के लिए कंटेनर, जिस पर शुल्क लागू होते हैं.
अगर <RatePlans> की जानकारी नहीं दी गई है, तो ये शुल्क
सभी रेट प्लान पर लागू होंगे. |
| ExtraGuestCharges / HotelExtraGuestCharges / ExtraGuestCharge / RatePlans / RatePlan | 1..n | RatePlan | इससे रेट प्लान की जानकारी मिलती है. पैकेज, किराये, और उपलब्धता की जानकारी के आधार पर, रेट प्लान तय किया जाता है. पैकेज आईडी से इसकी पहचान की जाती है, जैसा कि लेन-देन (प्रॉपर्टी डेटा), OTA_HotelRateAmountNotifRQ, और OTA_HotelAvailNotifRQ मैसेज में बताया गया है. |
| ExtraGuestCharges / HotelExtraGuestCharges / ExtraGuestCharge / RatePlans / RatePlan / @id | 1 | string | रेट प्लान के लिए यूनीक आइडेंटिफ़ायर. यह वैल्यू,
लेन-देन (प्रॉपर्टी डेटा) मैसेज में <PackageData> की
PackageID वैल्यू पर होती है. साथ ही,
<OTA_HotelRateAmountNotifRQ> और
<OTA_HotelAvailNotifRQ> मैसेज,
<StatusApplicationControl> के RatePlanCode एट्रिब्यूट में
मैप की जाती है.
ज़्यादा से ज़्यादा 50 वर्ण इस्तेमाल किए जा सकते हैं. |
| ExtraGuestCharges / HotelExtraGuestCharges / ExtraGuestCharge / StayDates | 0..1 | StayDates | एक या उससे ज़्यादा तारीख की सीमाओं वाला कंटेनर, जो यह तय करता है कि शुल्क कैसे लागू किए जाएंगे. |
| ExtraGuestCharges / HotelExtraGuestCharges / ExtraGuestCharge / StayDates / DateRange | 1..99 | DateRange | तारीख की सीमा जिसमें प्रमोशन लागू होने की तारीखें शामिल होती हैं. |
| ExtraGuestCharges / HotelExtraGuestCharges / ExtraGuestCharge / StayDates / DateRange / @start | 0..1 | Date | शुरू होने की तारीख (प्रॉपर्टी के टाइम ज़ोन के आधार पर). इसमें
तारीख की सीमा भी शामिल है. यह तारीख, end तारीख से पहले या उसके पहले की होनी चाहिए. अगर start नहीं दी गई है, तो शुरू होने की तारीख
के हिसाब से तारीख की सीमा असल में अनलिमिटेड होती है. |
| ExtraGuestCharges / HotelExtraGuestCharges / ExtraGuestCharge / StayDates / DateRange / @end | 0..1 | Date | प्रॉपर्टी के टाइम ज़ोन के आधार पर,
तारीख की सीमा के साथ खत्म होने की तारीख. यह तारीख वही या उसके बाद की होनी चाहिए जो start
तारीख है. अगर end नहीं दी गई है, तो खत्म होने की तारीख के हिसाब से तारीख की सीमा अनलिमिटेड होती है. |
| ExtraGuestCharges / HotelExtraGuestCharges / ExtraGuestCharge / StayDates / DateRange / @days_of_week | 0..1 | string | हफ़्ते के वे दिन जिनकी तारीख की सीमा में अनुमति है. अगर तारीख की सीमा नहीं बताई गई है, तो तारीख की सीमा में सभी दिनों की अनुमति है. स्ट्रिंग का हर वर्ण एक दिन के बारे में बताता है. उदाहरण के लिए, "MTWHF" से पता चलता है कि तारीख की सीमा में सोमवार से शुक्रवार तक डेटा इस्तेमाल करने की अनुमति है. मान्य वर्ण हैं:
कोई भी वर्ण संयोजन मान्य है. |
उदाहरण
वयस्कों के लिए शुल्क
अतिरिक्त वयस्कों के लिए लिए जाने वाले शुल्क, सिर्फ़ एक तय रकम के तौर पर दिखाए जा सकते हैं. इस उदाहरण में ExtraGuestCharges मैसेज दिखाया गया है, जिसमें वयस्कों के लिए बने शुल्कों की जानकारी दी गई है:
<?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>
संबंधित दरें यहां दी गई हैं:
<?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>
जब कोई उपयोगकर्ता Google पर चार वयस्कों को खोजता है, तो कुल दर 170 = 120 + 50 होगी.
120 का मान, NumberOfGuests="3" की <BaseByGuestAmt> दर से आता है और 50
AdultCharge amount="50" के हिसाब से आते हैं.
बच्चों के लिए शुल्क
बच्चों से लिए जाने वाले शुल्क, 17 साल तक की उम्र के ब्रैकेट में बताए जाते हैं. इन्हें तय रकम, प्रतिशत या छूट के तौर पर दिखाया जा सकता है.
इस उदाहरण में ExtraGuestCharges मैसेज दिखाया गया है, जिसमें चाइल्ड शुल्क के बारे में बताया गया है:
<?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>
संबंधित दरें यहां दी गई हैं:
<?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
शुल्क की पाबंदियां
सभी तरह की पाबंदियां ज़रूरी नहीं होती हैं और उन्हें किसी भी कॉम्बिनेशन में इस्तेमाल किया जा सकता है.
इस उदाहरण में एक ExtraGuestCharges मैसेज दिखाया गया है, जिसमें पाबंदियों के बारे में बताया गया है:
<?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>
ऊपर दिए गए मैसेज में बताया गया है कि वयस्कों से ऐसे किसी भी प्रॉडक्ट के लिए शुल्क लिया जाना चाहिए जिसमें 1 सितंबर, 2020 से 14 सितंबर, 2020 तक, रेट प्लान "फ़्री-वाई-फ़ाई" या "हॉट-ब्रेकफ़ास्ट" वाले कमरे का टाइप "क्वीन" या "किंग" है.
ओवरलैपिंग शुल्क
इस सेक्शन में गलत मैसेज का उदाहरण दिखाया गया है. इसमें तारीख और प्रॉडक्ट के एक ही कॉम्बिनेशन के लिए अलग-अलग शुल्कों के बारे में बताया गया है.
<?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>
ऊपर दिया गया मैसेज अमान्य है, क्योंकि पहले <ExtraGuestCharge> में बताया गया है कि 1 से 14 सितंबर के लिए, "क्वीन" और "मुफ़्त-वाई-फ़ाई" वाले 50 वयस्कों वाले बच्चों से अलग से शुल्क लिया जाना चाहिए. दूसरे <ExtraGuestCharge> में बताया गया है कि 1 से 5 सितंबर के लिए, किसी भी "मुफ़्त वाई-फ़ाई" या "हॉट-नास्ट" की सुविधा इस्तेमाल करने वाले किसी भी "रानी" या "राजा" को, 20 साल के और वयस्कों के लिए शुल्क देना चाहिए.
"क्वीन" और "फ़्री-वाई-फ़ाई" के लिए, 1 से 5 सितंबर तक एक-दूसरे से ओवरलैप होने का शुल्क लिया जाता है. साथ ही, इस बात पर फ़र्क़ होता है कि किसी वयस्क के लिए 20 या 50 का शुल्क लिया जाए या नहीं.
जवाब
सिंटैक्स
ExtraGuestChargesResponse मैसेज में इस
सिंटैक्स का इस्तेमाल किया जाता है:
<?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>
एलिमेंट और एट्रिब्यूट
ExtraGuestChargesResponse मैसेज में ये एलिमेंट और एट्रिब्यूट होते हैं:
| एलिमेंट / @एट्रिब्यूट | दोहराए जाने की संख्या | टाइप | ब्यौरा |
|---|---|---|---|
| ExtraGuestChargesResponse | 1 | Complex element | ExtraGuestCharges अनुरोध के मिले मैसेज की सफलता या समस्याओं की जानकारी देने वाला रूट एलिमेंट. |
| ExtraGuestChargesResponse / @timestamp | 1 | DateTime | इस मैसेज को बनाने की तारीख और समय. |
| ExtraGuestChargesResponse / @id | 1 | string | जुड़े हुए ExtraGuestCharges मैसेज से मिला यूनीक आइडेंटिफ़ायर. |
| ExtraGuestChargesResponse / @partner | 1 | string | इस मैसेज के लिए पार्टनर खाता. |
| ExtraGuestChargesResponse / Success | 0..1 | Success | इससे पता चलता है कि ExtraGuestCharges मैसेज बिना किसी चेतावनी, गड़बड़ी या गड़बड़ी के प्रोसेस हो गया था.
हर मैसेज में |
| ExtraGuestChargesResponse / Issues | 0..1 | Issues | ExtraGuestCharges मैसेज को प्रोसेस करते समय, एक या उससे ज़्यादा समस्याओं वाला कंटेनर मिला.
हर मैसेज में |
| ExtraGuestChargesResponse / Issues / Issue | 1..n | Issue | ExtraGuestCharges मैसेज को प्रोसेस करते समय मिली चेतावनी, गड़बड़ी या गड़बड़ी
का ब्यौरा. इन समस्याओं की जानकारी,
फ़ीड के स्टेटस से जुड़ी गड़बड़ी के मैसेज में देखी जा सकती है. |
| ExtraGuestChargesResponse / Issues / Issue / @code | 1 | integer | समस्या के लिए आइडेंटिफ़ायर. |
| ExtraGuestChargesResponse / Issues / Issue / @status | 1 | enum | किस तरह की समस्या हुई है. मान्य वैल्यू हैं |
उदाहरण
पुष्टि हो गई
यहां, सही से प्रोसेस किए गए ExtraGuestCharges मैसेज का जवाब दिया गया है.
<?xml version="1.0" encoding="UTF-8"?>
<ExtraGuestChargesResponse timestamp="2020-05-18T16:20:00-04:00"
id="12345678"
partner="partner_key">
<Success/>
</ExtraGuestChargesResponse>
समस्याएं
यह ExtraGuestCharges मैसेज का जवाब है, जो गड़बड़ियों की वजह से प्रोसेस नहीं हुआ.
<?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>