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

אפשר לשנות תעריפים שנשלחים דרך <OTA_HotelRateAmountNotifRQ> כדי להביא בחשבון מבוגרים וילדים, בנוסף למספר האורחים המקורי לפי התעריף. בהודעה ExtraGuestCharges תוכלו לציין איך יחושבו התעריפים לאורחים הנוספים האלה, ולאילו חדרים, תוכניות תעריפים ותאריכי השהייה יחולו עליהם החיובים שלהם.

דרישות לגבי מספר המשתתפים

המחירים שמחושבים מההודעה ExtraGuestCharges תקפים רק אם עומדים בכל הדרישות לגבי הקיבולת. למידע נוסף, קראו את המאמר טרנזקציה (נתוני נכס).

Requests

תחביר

בהודעה 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 הרכיב הבסיסי (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 ערך בוליאני שמציין אם ילד או ילדה בטווח הגיל הזה צריכים לספור את הקיבולת הכוללת של החדר ואת הקיבולת שלו. אפשר להגדיר את הקיבולת הזו באמצעות השדה 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> בהודעה מסוג עסקה (נתוני נכס), וההפניה אליו מתבצעת באמצעות הערך <RoomID> שלו. (המאפיין InvTypeCode מפנה לערך <RoomID> בהודעות 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 כוללת את הרכיבים ואת המאפיינים הבאים:

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