ExtraGuestCharges

אפשר לשנות את המחירים שנשלחים דרך <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.

הערה: אם יש לכם קצה עורפי שמספק פידים לכמה חשבונות, הערך הזה צריך להיות זהה לערך המאפיין 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, וההגדרה שמוגדרת כברירת מחדל היא 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> לפניו. אחרת, הגיל יהיה גדול ב-1 מהגיל המקסימלי של קבוצת הגיל הקודמת.
ExtraGuestCharges / HotelExtraGuestCharges / ExtraGuestCharge / AgeBrackets / ChildAgeBrackets / ChildAgeBracket / @exclude_from_capacity 1 boolean ערך בוליאני שמציין אם ילד בטווח הגילאים הזה צריך להיכלל בקיבולת הכוללת של החדר ובקיבולת הילדים. אפשר להגדיר את הקיבולות האלה באמצעות Transaction(Property Data). לדוגמה, יכול להיות שלא צריך לספור תינוקות מתחת לגיל מסוים במסגרת המגבלה על מספר הילדים.
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> בהודעה Transaction (Property Data) ומתייחסים אליו באמצעות הערך <RoomID> שלו. (הערך שלו <RoomID> מקושר גם למאפיין InvTypeCode בהודעות OTA_HotelRateAmountNotifRQ).
ExtraGuestCharges / HotelExtraGuestCharges / ExtraGuestCharge / RoomTypes / RoomType / @id 1 string המזהה הייחודי של מלאי שטחי הפרסום (סוג החדר). הערך הזה ממופה ל-<RoomID> בהודעת Transaction (נתוני נכס). אפשר להזין עד 50 תווים.
ExtraGuestCharges / HotelExtraGuestCharges / ExtraGuestCharge / RatePlans 0..1 RatePlans מאגר לרשימת תוכניות תמחור שהחיובים חלים עליהן. אם לא מציינים את <RatePlans>, החיובים חלים על כל התוכניות.
ExtraGuestCharges / HotelExtraGuestCharges / ExtraGuestCharge / RatePlans / RatePlan 1..n RatePlan מאפיין שמציין תוכנית תעריפים. תוכנית תמחור מוגדרת על ידי שילוב של חבילה, מחירים וזמינות, כפי שמוגדר בהודעות Transaction (Property Data),‏ 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>

בהודעה שלמעלה מצוין שצריך לחייב מבוגרים על כל מוצר עם סוג חדר queen או king, עם תוכנית מחירים free-wifi או hot-breakfast, בתאריכים 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> מצוין שהמחיר של queen ו-free-wifi בין 1 ל-14 בספטמבר צריך להיות 50 למבוגרים נוספים. הערך השני <ExtraGuestCharge> מציין שעל כל מבוגר נוסף שמתארח בין 1 ל-5 בספטמבר בחדר עם מיטה זוגית או מיטה גדולה, עם Wi-Fi בחינם או ארוחת בוקר חמה, יחול חיוב של 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 כוללת את הרכיבים והמאפיינים הבאים:

רכיב / @מאפיין מופעים סוג תיאור
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>