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

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