דף זה תורגם על ידי Cloud Translation API.

חיובים נוספים לאורחים

תעריפים שנשלחים דרך <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 כוללת את הרכיבים הבאים וגם :

רכיב / @Attribute	מופעים	סוג	תיאור
ExtraGuestCharges	1	Complex element	הרכיב הבסיסי (root) של ההודעה הזו.
ExtraGuestCharges / @partner	1	string	חשבון השותף שאליו שייכת ההודעה הזו. ערך המחרוזת הזה הוא ערך אחד (`Partner key`) רשום ב: ה דף הגדרות החשבון ב-Hotel Center. הערה:אם יש לכם קצה עורפי שמספק פידים כמה חשבונות, הערך הזה צריך להיות תואם לערך של `ID` ערך המאפיין שמצוין ב`<RequestorID>` של `<OTA_HotelRateAmountNotifRQ>` ו `<OTA_HotelAvailNotifRQ>` הודעות לאותה מטרה חשבון.
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	המזהה הייחודי של הנכס. הערך הזה חייב להתאים לערך מזהה המלון צוין באמצעות `<id>` ברכיב `<listing>` בפיד של רשימת המלונות. מזהה המלון מופיע גם ב-Hotel Center.
ExtraGuestCharges / HotelExtraGuestCharges / @action	0..1	enum	מציינת את אופן החלת העדכון. רק `overlay` הם וברירת המחדל היא שכבת-על. חיובים קודמים עבור זה יימחק לפני העדכון.
ExtraGuestCharges / HotelExtraGuestCharges / ExtraGuestCharge	0..99	ExtraGuestCharge	קבוצה אחת של חיובים לנכס. המידע הזה עשוי לכלול הגבלות על אופן החלת החיוב ועל אופן החיוב מחושב לפי גיל או קטגוריית אורח. כל `ExtraGuestCharge` בתוך הערך `HotelExtraGuestCharges` חייב לחול על קבוצת תאריכים ייחודית ומוצרים. אם שני רכיבי 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 שמציין את האחוז מחיר למבוגר שצריך לחייב עבור ילד נוסף בסוגריים. החיוב הזה משתמש באותו מטבע שמוגדר לחיוב במחירים ללילה. לפרטים נוספים, יש לעיין בדיון בקטע `counts_as_base_occupant` על אופן החישוב של המחיר למבוגרים.
ExtraGuestCharges / HotelExtraGuestCharges / ExtraGuestCharge / AgeBrackets / ChildAgeBrackets / ChildAgeBracket / @discount_amount	0..1	float	ערך עשרוני חיובי שמציין הנחה קבועה סכום הנחה מהמחיר למבוגר עבור ילד נוסף באזור הזה. החיוב הזה מבוסס על אותו מטבע שמוגדר לחיוב ללילה מחירים. באופן כללי, החיוב על ילד או ילדה בהיררכיה הזו מחושב לפי ניכוי הסכום הקבוע מ"מחיר יחידה". המחיר ליחידה הוא מפורט יותר ב`counts_as_base_occupant` .
ExtraGuestCharges / HotelExtraGuestCharges / ExtraGuestCharge / AgeBrackets / ChildAgeBrackets / ChildAgeBracket / @counts_as_base_occupant	0..1	string	אם `percentage` או `discount_amount` צוין, ואז `counts_as_base_occupant` תצוין גם כן. הערך הזה קובע אם לילד או לילדה ייכללו ב`NumberOfGuest` כשתבחרו שיעור `<BaseByGuestAmount>` להחלת האחוז חיובים והנחות. המטרה כאן היא להשיג 'מחיר יחידה' שממנו למעשה ולא ניתן לחשב אותו. `unit price` = `rate` / `occupancy` הערך של המאפיין הזה חייב להיות אחד מהערכים `never`, `preferred` או `always`. אם מציינים את `never`, הילד או הילדה אף פעם לא יכולים כלולה במחיר הלינה. אם אתם רוצים לחשב תעריף ל-2 מבוגרים ול-2 ילדים (2+2), צריך להשתמש בתעריף ל-2 מבוגרים, כי הילדים לא צריכות להיכלל. אם מציינים את `preferred`, הילד או הילדה צריכים עדיף לכלול כמה שיותר אנשים במחיר הלינה. אם אתם רוצים לחשב תעריף ל-2 מבוגרים וילד אחד (2+1), עדיף להשתמש במחיר ל-3 מבוגרים, אבל אם זה לא אפשרי צריך להשתמש בתעריף ל-2 מבוגרים. אם מציינים את `always`, הילד או הילדה צריכים ייכללו תמיד בתפוסה לפי המחיר. אם אתם רוצים לחשב תעריף ל-2 מבוגרים ול-2 ילדים (2+2), צריך להשתמש בתעריף ל-4 מבוגרים, כי הילדים חייבים ייכללו.
ExtraGuestCharges / HotelExtraGuestCharges / ExtraGuestCharge / RoomTypes	0..1	RoomTypes	מאגר לרשימת סוגי החדרים שעליהם חלים החיובים. החיובים יחולו על כל `<RoomType>` שצוין. אם לא צוין `<RoomTypes>`, החיובים יחולו על כל החדרים במלון שצוין.
ExtraGuestCharges / HotelExtraGuestCharges / ExtraGuestCharge / RoomTypes / RoomType	1..n	RoomType	מציין את סוג החדר. סוג חדר מוגדר רכיב `<RoomData>` בתוך עסקה (נתוני נכס) וההפניה אליו מתבצעת באמצעות ערך של `<RoomID>`. (`<RoomID>` שלו גם המאפיין `InvTypeCode` מפנה לערך הזה ב- הודעות OTA_HotelRateAmountNotifRQ.)
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 הודעות וכפי שמזוהה על ידי PackageID.
ExtraGuestCharges / HotelExtraGuestCharges / ExtraGuestCharge / RatePlans / RatePlan / @id	1	string	המזהה הייחודי של תוכנית התעריפים. ערך זה ממופה אל הערך PackageID ב-`<PackageData>` בהודעה לגבי עסקה (נתוני נכס), מאפיין `RatePlanCode` ב- `<StatusApplicationControl>` בשני הסוגים `<OTA_HotelRateAmountNotifRQ>` והקבוצה `<OTA_HotelAvailNotifRQ>` הודעות. אפשר להזין עד 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" מציין שימי חול מותרים בטווח התאריכים. התווים החוקיים הם: `M` ליום שני `T` ביום שלישי `W` ליום רביעי `H` ליום חמישי `F` ליום שישי `S` ליום שבת `U` ביום ראשון כל שילוב תווים חוקי.

דוגמאות

חיובים למבוגרים

חיובים עבור מבוגרים נוספים יכולים להתבטא כסכומים קבועים בלבד. בדוגמה הבאה מוצגת הודעת 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 מגיע מהתעריף <BaseByGuestAmt> עם NumberOfGuests="3" ו-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>

בהודעה שלמעלה צוין שצריך לחייב את המבוגרים על כל מוצר. יש חדר מסוג 'קווין' או 'קינג' עם תוכנית תעריפים "Wi-Fi בחינם" או "ארוחת בוקר חמה" אם התאריכים 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> הראשון מציין ש"מלכה" וגם 'Wi-Fi בחינם' ל-1 עד 14 בספטמבר. מבוגרים נוספים: 50. <ExtraGuestCharge> השני מציין שכל מודל 'מלכה' או 'קינג' באמצעות כל 'Wi-Fi בחינם' או "ארוחת בוקר חמה" ל-1 עד 5 בספטמבר צריך לשלם 20 מבוגרים נוספים. יש חיובים חופפים עבור "מלכה" וגם 'Wi-Fi בחינם' ל-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 כוללת את הרכיבים הבאים ומאפיינים:

רכיב / @Attribute	מופעים	סוג	תיאור
ExtraGuestChargesResponse	1	Complex element	רכיב השורש שמציין את ההצלחה או הבעיות עבור קבלה הודעה עם בקשת `ExtraGuestCharges`.
ExtraGuestChargesResponse / @timestamp	1	DateTime	התאריך והשעה של יצירת ההודעה הזו.
ExtraGuestChargesResponse / @id	1	string	המזהה הייחודי של הודעת `ExtraGuestCharges` המשויכת.
ExtraGuestChargesResponse / @partner	1	string	חשבון השותף שאליו שייכת ההודעה הזו.
ExtraGuestChargesResponse / Success	0..1	Success	מציין שההודעה `ExtraGuestCharges` עובדה בהצלחה ללא אזהרות, שגיאות או כשלים. `<Success>` או `<Issues>` הם שנמצא בכל הודעה.
ExtraGuestChargesResponse / Issues	0..1	Issues	מאגר שמתאר בעיה אחת או יותר במהלך העיבוד של הודעה אחת (`ExtraGuestCharges`). `<Success>` או `<Issues>` הם שנמצא בכל הודעה.
ExtraGuestChargesResponse / Issues / Issue	1..n	Issue	תיאור של אזהרה, שגיאה או כשל במהלך מתבצע עיבוד של ההודעה `ExtraGuestCharges`. ניתן למצוא פרטים על הבעיות האלה בקטע הודעות שגיאה של סטטוס הפיד.
ExtraGuestChargesResponse / Issues / Issue / @code	1	integer	המזהה של הבעיה.
ExtraGuestChargesResponse / Issues / Issue / @status	1	enum	סוג הבעיה. הערכים החוקיים הם `warning`, `error`, ו-`failure`.

דוגמאות

הפעולה הצליחה

התגובה הבאה נשלחה בהצלחה הודעה אחת (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>