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

תעריפים שנשלחים דרך <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>