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

אפשר לשנות את התעריפים שנשלחים דרך <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 רכיב הבסיס של ההודעה הזו.
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 ערך בוליאני שמציין אם ילד בקבוצת הגיל הזו צריך להיכלל בקיבולת הכוללת של החדר ובקיבולת של הילדים. אפשר להגדיר את הקיבולת הזו באמצעות 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 (נתוני נכס), והפניה אליו מתבצעת באמצעות הערך שלו ב-<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‏ (נתוני המלון), OTA_HotelRateAmountNotifRQ ו-OTA_HotelAvailNotifRQ, וכפי שהם מזוהים לפי PackageID.
ExtraGuestCharges / HotelExtraGuestCharges / ExtraGuestCharge / RatePlans / RatePlan / @id 1 string המזהה הייחודי של תוכנית התמחור. הערך הזה ממופה לערך PackageID ב-<PackageData> בהודעת Transaction (נתוני נכס), ובמאפיין 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>

בהודעה שלמעלה צוין שצריך לחייב מבוגרים על כל מוצר מסוג 'חדר עם מיטה רגילה' או 'חדר עם מיטה גדולה' עם חבילת תעריפים 'אינטרנט אלחוטי חינם' או 'ארוחת בוקר חמה' בתאריכים 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> מציין שעבור כל אחת מהאפשרויות 'queen' או 'king' עם כל אחת מהאפשרויות 'free-wifi' או 'hot-breakfast' בתאריכים 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 יש את הרכיבים והמאפיינים הבאים:

רכיב / @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>