בקשות
תחביר
ההודעה TaxFeeInfo
מבוססת על התחביר הבא:
<?xml version="1.0" encoding="UTF-8"?>
<TaxFeeInfo timestamp="timestamp"
id="message_ID"
partner="partner_key">
<Property action="[overlay]">
<ID>HotelID</ID>
<Taxes>
<Tax>
<RoomTypes>
<RoomType id="RoomID_1"/>
<RoomType id="RoomID_2"/>
</RoomTypes>
<RatePlans>
<RatePlan id="PackageID_1"/>
<RatePlan id="PackageID_2"/>
</RatePlans>
<BookingDates>
<DateRange start="YYYY-MM-DD" end="YYYY-MM-DD" days_of_week="MTWHFSU_or_subset"/>
</BookingDates>
<CheckinDates>
<DateRange start="YYYY-MM-DD" end="YYYY-MM-DD" days_of_week="MTWHFSU_or_subset"/>
</CheckinDates>
<CheckoutDates>
<DateRange start="YYYY-MM-DD" end="YYYY-MM-DD" days_of_week="MTWHFSU_or_subset"/>
</CheckoutDates>
<StayDates application="[all|any|overlap]">
<DateRange start="YYYY-MM-DD" end="YYYY-MM-DD" days_of_week="MTWHFSU_or_subset"/>
</StayDates>
<Type>[percent|amount|cumulative_percent]</Type>
<Basis>[room|person]</Basis>
<Period>[stay|night]</Period>
<Currency>currency_code</Currency>
<Amount>tax_amount</Amount>
<ApplicableNights max="integer" excluded="integer"/>
<LengthOfStay min="integer" max="integer"/>
<!-- Use either <Amount> or <Brackets> -->
<Brackets base_amount="tax_amount"/>
<Bracket starts_at="nightly_rate" amount="tax_amount"/>
</Brackets>
<AgeBrackets>
<AdultCharge amount="tax_amount"/>
<ChildAgeBrackets>
<ChildAgeBracket max_age="max_age" amount="tax_amount"/>
</ChildAgeBrackets>
</AgeBrackets>
<UserCountries type="[include|exclude]">
<Country code="country_code1"/>
<Country code="country_code2"/>
</UserCountries>
<Rank>integer</Rank>
</Tax>
</Taxes>
<Fees>
<Fee>
<RoomTypes>
<RoomType id="RoomID_1"/>
<RoomType id="RoomID_2"/>
</RoomTypes>
<RatePlans>
<RatePlan id="PackageID_1"/>
<RatePlan id="PackageID_2"/>
</RatePlans>
<BookingDates>
<DateRange start="YYYY-MM-DD" end="YYYY-MM-DD" days_of_week="MTWHFSU_or_subset"/>
</BookingDates>
<CheckinDates>
<DateRange start="YYYY-MM-DD" end="YYYY-MM-DD" days_of_week="MTWHFSU_or_subset"/>
</CheckinDates>
<CheckoutDates>
<DateRange start="YYYY-MM-DD" end="YYYY-MM-DD" days_of_week="MTWHFSU_or_subset"/>
</CheckoutDates>
<StayDates application="[all|any|overlap]">
<DateRange start="YYYY-MM-DD" end="YYYY-MM-DD" days_of_week="MTWHFSU_or_subset"/>
</StayDates>
<Type>[percent|amount|cumulative_percent]</Type>
<Basis>[room|person]</Basis>
<Period>[stay|night]</Period>
<Currency>currency_code</Currency>
<Amount>fee_amount</Amount>
<ApplicableNights max="integer" excluded="integer"/>
<LengthOfStay min="integer" max="integer"/>
<!-- Use either <Amount> or <Brackets> -->
<Brackets base_amount="tax_amount"/>
<Bracket starts_at="nightly_rate" amount="tax_amount"/>
</Brackets>
<AgeBrackets>
<AdultCharge amount="tax_amount"/>
<ChildAgeBrackets>
<ChildAgeBracket max_age="max_age" amount="tax_amount"/>
</ChildAgeBrackets>
</AgeBrackets>
<UserCountries type="[include|exclude]">
<Country code="country_code1"/>
<Country code="country_code2"/>
</UserCountries>
<Rank>integer</Rank>
</Fee>
</Fees>
</Property>
</TaxFeeInfo>
רכיבים ומאפיינים
הודעת TaxFeeInfo
כוללת את הרכיבים הבאים וגם
:
רכיב / @Attribute | מופעים | סוג | תיאור |
---|---|---|---|
TaxFeeInfo | 1 | Complex element | רכיב הבסיס של הודעה שמגדיר מיסים ועמלות לחשבון יחיד לנכס. |
TaxFeeInfo / @timestamp | 1 | DateTime | התאריך והשעה של יצירת ההודעה הזו. |
TaxFeeInfo / @id | 1 | string | מזהה ייחודי להודעת הבקשה הזו. הערך הזה מוחזר
בהודעת התשובה. התווים המותרים הם a-z ,
A-Z , 0-9 , _
(קו תחתון) ו-- (קו מפריד). |
TaxFeeInfo / @partner | 1 | string | חשבון השותף שאליו שייכת ההודעה הזו. ערך המחרוזת הזה הוא
מפתח שותף הערך שרשום ב
ה
דף הגדרות החשבון ב-Hotel Center.
הערה:אם יש לכם קצה עורפי שמספק פידים
כמה חשבונות, הערך הזה צריך להיות תואם לערך של |
TaxFeeInfo / Property | 1..n | Property | מאגר להגדרת מיסים ועמלות בנכס בודד. |
TaxFeeInfo / Property / @action | 0..1 | string | מציינת את אופן החלת העדכון. רק overlay הם
וברירת המחדל היא overlay . כל הקודם
Taxes ו-Fees עבור הנכס הזה יהיו
נמחקה לפני החלת העדכון. |
TaxFeeInfo / Property / ID | 1 | string | המזהה הייחודי של הנכס. הערך הזה חייב להתאים לערך מזהה המלון צוין באמצעות הפרמטר <id> באזור הרכיב <listing> במלון הצגת רשימה של פידים. מזהה המלון מופיע גם ב-Hotel Center. |
TaxFeeInfo / Property / Taxes | 0..1 | Taxes | קונטיינר של רכיב <Tax> אחד או יותר. |
TaxFeeInfo / Property / Taxes / Tax | 1..n | Tax | מס נפרד שחל על הנכס. |
TaxFeeInfo / Property / Taxes / Tax / RoomTypes | 0..1 | RoomTypes | מאגר לרשימת סוגי החדרים שעליהם חל המס.
המס חל על כל <RoomType>
שצוין. אם לא צוין <RoomTypes> ,
המס חל על כל החדרים. |
TaxFeeInfo / Property / Taxes / Tax / RoomTypes / RoomType | 1..n | RoomType | מציין את סוג החדר. סוג חדר מוגדר
רכיב <RoomData> בתוך
עסקה (נתוני נכס), ובתור
זוהה באמצעות RoomID שלו. (
גם לערך <RoomID> יש הפניה באמצעות המאפיין
מאפיין InvTypeCode ב-OTA_HotelRateAmountNotifRQ
messages.) |
TaxFeeInfo / Property / Taxes / Tax / RoomTypes / RoomType / @id | 1 | string | המזהה הייחודי של המלאי (סוג החדר). הערך הזה ממפה
אל <RoomID> בעסקה
(נתוני נכס). מספר התווים המקסימלי הוא
50. |
TaxFeeInfo / Property / Taxes / Tax / RatePlans | 0..1 | RatePlans | מאגר לרשימת תעריפים שבהם חל המס.
אם לא צוין <RatePlans> , שיעור המס
חלה על כל תוכניות התעריפים. |
TaxFeeInfo / Property / Taxes / Tax / RatePlans / RatePlan | 1..n | RatePlan | מציין תוכנית תעריפים. תוכנית תעריפים מוגדרת לפי שילוב של החבילה, המחירים והזמינות, כפי שמוגדר בעסקה (נתוני נכס), OTA_HotelRateAmountNotifRQ ו-OTA_HotelAvailNotifRQ הודעות וכפי שמזוהה על ידי PackageID. |
TaxFeeInfo / Property / Taxes / Tax / RatePlans / RatePlan / @id | 1 | string | המזהה הייחודי של תוכנית התעריפים. ערך זה ממופה אל
הערך PackageID בעמודה
בהודעה של עסקה (נתוני נכס)
<PackageData> והקבוצה
הערך RatePlanCode שמוגדר מתחת
מאפיין <StatusApplicationControl> בשני המקומות
<OTA_HotelRateAmountNotifRQ> והקבוצה
הודעות <OTA_HotelAvailNotifRQ> .
אפשר להזין עד 50 תווים. |
TaxFeeInfo / Property / Taxes / Tax / BookingDates | 0..1 | BookingDates | מאגר בטווח תאריכים אחד או יותר שמוגדר מתי ההזמנה חייבת צריך לבצע את הפעולות הנדרשות כדי להחיל את המס. |
TaxFeeInfo / Property / Taxes / Tax / BookingDates / DateRange | 1..99 | DateRange | טווח תאריכים שמציין מתי ההזמנה צריכה להתקיים כדי שהמס יהיה הוחלו. |
TaxFeeInfo / Property / Taxes / Tax / BookingDates / DateRange / @start | 0..1 | Date | תאריך ההתחלה (לפי אזור הזמן של הנכס), כולל
טווח התאריכים. התאריך הזה חייב להיות לפני, או זהה לתאריך
תאריך: end . אם לא צוין start , התאריך
בפועל אינו מוגבל מבחינת תאריך ההתחלה. |
TaxFeeInfo / Property / Taxes / Tax / BookingDates / DateRange / @end | 0..1 | Date | תאריך הסיום (על סמך אזור הזמן של הנכס), כולל
טווח תאריכים. התאריך הזה חייב להיות זהה לתאריך start או אחריו
תאריך. אם לא צוין end , התאריך
בפועל הוא בלתי מוגבל במונחים של תאריך סיום. |
TaxFeeInfo / Property / Taxes / Tax / BookingDates / DateRange / @days_of_week | 0..1 | string | הימים בשבוע שמותרים בטווח התאריכים. אחרת שצוין, כל הימים מותרים בטווח התאריכים. כל אחד במחרוזת מציין יום. לדוגמה, "MTWHF" מציין שימי חול מותרים בטווח התאריכים. התווים החוקיים הם:
כל שילוב תווים חוקי. |
TaxFeeInfo / Property / Taxes / Tax / CheckinDates | 0..1 | CheckinDates | מאגר בטווח תאריכים אחד או יותר שמוגדר מתי צריך לבצע צ'ק-אין על מנת שהמס יחול. |
TaxFeeInfo / Property / Taxes / Tax / CheckinDates / DateRange | 1..20 | DateRange | טווח תאריכים שמציין מתי צריך לבצע צ'ק-אין כדי שהמס יהיה להיות מיושם. |
TaxFeeInfo / Property / Taxes / Tax / CheckinDates / DateRange / @start | 0..1 | Date | תאריך ההתחלה (לפי אזור הזמן של הנכס), כולל
טווח התאריכים. התאריך הזה חייב להיות לפני, או זהה לתאריך
תאריך: end . אם לא צוין start , התאריך
בפועל אינו מוגבל מבחינת תאריך ההתחלה. |
TaxFeeInfo / Property / Taxes / Tax / CheckinDates / DateRange / @end | 0..1 | Date | תאריך הסיום (על סמך אזור הזמן של הנכס), כולל
טווח תאריכים. התאריך הזה חייב להיות זהה לתאריך start או אחריו
תאריך. אם לא צוין end , התאריך
בפועל הוא בלתי מוגבל במונחים של תאריך סיום. |
TaxFeeInfo / Property / Taxes / Tax / CheckinDates / DateRange / @days_of_week | 0..1 | string | הימים בשבוע שמותרים בטווח התאריכים. אחרת שצוין, כל הימים מותרים בטווח התאריכים. כל אחד במחרוזת מציין יום. לדוגמה, "MTWHF" מציין שימי חול מותרים בטווח התאריכים. התווים החוקיים הם:
כל שילוב תווים חוקי. |
TaxFeeInfo / Property / Taxes / Tax / CheckoutDates | 0..1 | CheckoutDates | מאגר לטווח תאריכים אחד או יותר שמוגדר בזמן התשלום בקופה חייב להתרחש כדי שהמס יחול. |
TaxFeeInfo / Property / Taxes / Tax / CheckoutDates / DateRange | 1..20 | DateRange | טווח תאריכים שמציין את המועד שבו צריך לבצע צ'ק-אאוט כדי שהמס יהיה להיות מיושם. |
TaxFeeInfo / Property / Taxes / Tax / CheckoutDates / DateRange / @start | 0..1 | Date | תאריך ההתחלה (לפי אזור הזמן של הנכס), כולל
טווח התאריכים. התאריך הזה חייב להיות לפני, או זהה לתאריך
תאריך: end . אם לא צוין start , התאריך
בפועל אינו מוגבל מבחינת תאריך ההתחלה. |
TaxFeeInfo / Property / Taxes / Tax / CheckoutDates / DateRange / @end | 0..1 | Date | תאריך הסיום (על סמך אזור הזמן של הנכס), כולל
טווח תאריכים. התאריך הזה חייב להיות זהה לתאריך start או אחריו
תאריך. אם לא צוין end , התאריך
בפועל הוא בלתי מוגבל במונחים של תאריך סיום. |
TaxFeeInfo / Property / Taxes / Tax / CheckoutDates / DateRange / @days_of_week | 0..1 | string | הימים בשבוע שמותרים בטווח התאריכים. אחרת שצוין, כל הימים מותרים בטווח התאריכים. כל אחד במחרוזת מציין יום. לדוגמה, "MTWHF" מציין שימי חול מותרים בטווח התאריכים. התווים החוקיים הם:
כל שילוב תווים חוקי. |
TaxFeeInfo / Property / Taxes / Tax / StayDates | 0..1 | StayDates | מאגר לטווח תאריכים אחד או יותר שקובע אם המס חל, למשל, כדי להתאים להנחות עונתיות. |
TaxFeeInfo / Property / Taxes / Tax / StayDates / @application | 1 | enum | תיאור האופן שבו צריך להחיל את המס. הערכים החוקיים כוללים:
תמיד צריך לציין את המאפיין הזה. |
TaxFeeInfo / Property / Taxes / Tax / StayDates / DateRange | 1..99 | DateRange | טווח תאריכים שמציין את התאריכים שבהם יחול המס. |
TaxFeeInfo / Property / Taxes / Tax / StayDates / DateRange / @start | 0..1 | Date | תאריך ההתחלה (לפי אזור הזמן של הנכס), כולל
טווח התאריכים. התאריך הזה חייב להיות לפני, או זהה לתאריך
תאריך: end . אם לא צוין start , התאריך
בפועל אינו מוגבל מבחינת תאריך ההתחלה. |
TaxFeeInfo / Property / Taxes / Tax / StayDates / DateRange / @end | 0..1 | Date | תאריך הסיום (על סמך אזור הזמן של הנכס), כולל
טווח תאריכים. התאריך הזה חייב להיות זהה לתאריך start או אחריו
תאריך. אם לא צוין end , התאריך
בפועל הוא בלתי מוגבל במונחים של תאריך סיום. |
TaxFeeInfo / Property / Taxes / Tax / StayDates / DateRange / @days_of_week | 0..1 | string | הימים בשבוע שמותרים בטווח התאריכים. אחרת שצוין, כל הימים מותרים בטווח התאריכים. כל אחד במחרוזת מציין יום. לדוגמה, "MTWHF" מציין שימי חול מותרים בטווח התאריכים. התווים החוקיים הם:
כל שילוב תווים חוקי. |
TaxFeeInfo / Property / Taxes / Tax / Type | 1 | enum | הערכים החוקיים כוללים:
|
TaxFeeInfo / Property / Taxes / Tax / Basis | 1 | enum | הערכים החוקיים כוללים:
|
TaxFeeInfo / Property / Taxes / Tax / Period | 1 | enum |
הערכים החוקיים כוללים:
|
TaxFeeInfo / Property / Taxes / Tax / Currency | 0..1 | string | קוד המטבע בן שלוש האותיות של המס (לדוגמה: USD). |
TaxFeeInfo / Property / Taxes / Tax / Amount | 0..1 | float | הערך של אחוז או סכום המס. |
TaxFeeInfo / Property / Taxes / Tax / ApplicableNights | 0..1 | ApplicableNights | הערך הזה חל רק אם מוגדר הערך <Type>
amount ו-<Period> מוגדרים כ-
לילה.
ההגבלה הזו מגבילה את מספר הלילות שעליהם אפשר להחיל מס. יש לציין |
TaxFeeInfo / Property / Taxes / Tax / ApplicableNights / @max | 0..1 | integer | <ApplicableNights max="N"> מציין כי לילות
אחרי N לילות ראשונות. |
TaxFeeInfo / Property / Taxes / Tax / ApplicableNights / @excluded | 0..1 | integer | <ApplicableNights excluded="N"> מציין
אין לכלול N לילות ראשונים. |
TaxFeeInfo / Property / Taxes / Tax / LengthOfStay | 0..1 | LengthOfStay | הגדרת מגבלות על משך השהייה שבמהלכן אפשר להחיל את המס. המס לא יחול כשמשך השהייה נמצא מחוץ לטווח של המינימום והמקסימום מגבלות בפועל. |
TaxFeeInfo / Property / Taxes / Tax / LengthOfStay / @min | 0..1 | integer | מספר הלילות המינימלי המותר במהלך השהייה לחיוב המס. אם לא צוין ערך, אין מינימום. |
TaxFeeInfo / Property / Taxes / Tax / LengthOfStay / @max | 0..1 | integer | מספר הלילות המקסימלי המותר לשהייה שבו יחול המס. אם אין ערך מקסימלי, אין הגבלה. |
TaxFeeInfo / Property / Taxes / Tax / Brackets | 0..1 | Brackets | קונטיינר של רכיב <Bracket> אחד או יותר.
מגדירה קבוצה של טווחי מס רציפים ולא חופפים. לדוגמה: מיסים על GST בהודו.
הרכיב הזה תקף רק אם המדיניות |
TaxFeeInfo / Property / Taxes / Tax / Brackets / @base_amount | 0..1 | float | הערך של אחוז או סכום המס שחל על תעריפים ללילה
מתחת לערך starts_at של הסוגר הראשון. |
TaxFeeInfo / Property / Taxes / Tax / Brackets / Bracket | 1..n | Bracket | מגדיר טווח מס על סמך תעריפים ללילה. |
TaxFeeInfo / Property / Taxes / Tax / Brackets / Bracket / @starts_at | 1 | float | מגדיר את הגבול התחתון של סולם מס. הגבול העליון הוא
צוין בשדה כשהתעריף ללילה גדול או שווה, טווח המס פעיל.
לערך הערך הזה חייב להיות גדול מ-0. |
TaxFeeInfo / Property / Taxes / Tax / Brackets / Bracket / @amount | 1 | float | הערך של אחוז או סכום המס שחל על רמת המס הזו. |
TaxFeeInfo / Property / Taxes / Tax / AgeBrackets | 0..1 | AgeBrackets | מאפשרת לציין קבוצת מיסים על סמך האורחים גילים.
הרכיב הזה תקף רק כאשר |
TaxFeeInfo / Property / Taxes / Tax / AgeBrackets / AdultCharge | 0..1 | AdultCharge | מאגר לציון מיסים למבוגרים. |
TaxFeeInfo / Property / Taxes / Tax / AgeBrackets / AdultCharge / @amount | 1 | float | סכום המס הקבוע שחל למבוגרים. |
TaxFeeInfo / Property / Taxes / Tax / AgeBrackets / ChildAgeBrackets | 0..1 | ChildAgeBrackets | קונטיינר לשמירה של <ChildAgeBracket> אחד או יותר
רכיבים. |
TaxFeeInfo / Property / Taxes / Tax / AgeBrackets / ChildAgeBrackets / ChildAgeBracket | 1..n | ChildAgeBracket | מגדיר טווח גילאים לילדים ואת סכום המס המתאים. |
TaxFeeInfo / Property / Taxes / Tax / AgeBrackets / ChildAgeBrackets / ChildAgeBracket / @max_age | 1 | integer | מגדיר את הגבול העליון של גיל הילד או הילדה. הגבול התחתון הוא
צוין בשדה הערך |
TaxFeeInfo / Property / Taxes / Tax / AgeBrackets / ChildAgeBrackets / ChildAgeBracket / @amount | 1 | float | סכום המס הקבוע שחל על ילדים בטווח הגילאים הזה. |
TaxFeeInfo / Property / Taxes / Tax / UserCountries | 0..1 | UserCountries | מאגר שבו אפשר לראות את רשימת המדינות של המשתמשים שבהן חל המס להכללה או להחרגה. אם השדה הזה קיים, המס ייכלל רק או לא נכלל עבור משתמשים מהמדינות שצוינו. |
TaxFeeInfo / Property / Taxes / Tax / UserCountries / @type | 0..1 | enum | סוג המפרט UserCountries (ארצות הברית).
הערכים החוקיים הם אם המדיניות UserCountries מוגדרת בתור לעומת זאת אם מדינות המשתמש אם המדיניות |
TaxFeeInfo / Property / Taxes / Tax / UserCountries / Country | 1..n | Country | מגדירה מדינה אחת ברשימת UserCountry. |
TaxFeeInfo / Property / Taxes / Tax / UserCountries / Country / @code | 1 | string | קוד מדינה במאגר CLDR.
כמו DE או FR . שימו לב שלחלק
מדינות, קוד המדינה של ה-CLDR שונה מקוד ה-ISO בן 2 האותיות
. בנוסף, אין תמיכה בקודי אזורים במאגר CLDR. |
TaxFeeInfo / Property / Taxes / Tax / Rank | 1 | integer | דירוג שמציין את סדר הגשת הבקשה למס או לעמלה האלה.
לדוגמה: המשמעות של ערך של 2 היא שהמס הזה יחול השני.
צריך תמיד לציין את הרכיב הזה אם הערך |
TaxFeeInfo / Property / Fees | 0..1 | Fees | קונטיינר של רכיב <Fee> אחד או יותר. |
TaxFeeInfo / Property / Fees / Fee | 1..n | Fee | עמלה אישית שחלה על הנכס. גם כל רכיבי הצאצא של |
דוגמאות
לכל נכס יש מגבלה של 300 מיסים ועמלות. עיינו ב "מחיקת מיסים" דוגמה להסרת מיסים ועמלות מנכס מסוים.
הודעה בסיסית
הודעת TaxFeeInfo
בסיסית:
<?xml version="1.0" encoding="UTF-8"?> <TaxFeeInfo timestamp="2020-05-18T16:20:00-04:00" id="12345678" partner="partner_key"> <Property> <ID>Property_1</ID> <Taxes> <Tax> <Type>percent</Type> <Basis>room</Basis> <Period>stay</Period> <Amount>10.00</Amount> </Tax> </Taxes> <Fees> <Fee> <Type>amount</Type> <Basis>person</Basis> <Period>night</Period> <Currency>USD</Currency> <Amount>5.00</Amount> </Fee> </Fees> </Property> </TaxFeeInfo>
מחיקת מיסים
מחיקת כל המיסים והעמלות ברמת הנכס לגבי המלון שצוין:
<?xml version="1.0" encoding="UTF-8"?> <TaxFeeInfo timestamp="2022-06-16T16:20:00-04:00" id="12345678" partner="partner_key" <Property action="overlay"/> <ID>Property_1</ID> </Property> </TaxFeeInfo>
מס Slab
מס GST בהודו, שחל על פי תעריפים ללילה. מדרגות המס הן:
- ללא מס אם המחיר ללילה נמוך מ-1,000 או שווה לו.
- 12% מס אם המחיר ללילה גבוה מ-1,000 ונמוך מ- או שווה ל-7,500.
- 18% מס אם המחיר ללילה גבוה מ-7,500.
<?xml version="1.0" encoding="UTF-8"?> <TaxFeeInfo timestamp="2020-05-18T16:20:00-04:00" id="12345678" partner="partner_key"> <Property> <ID>Property_1</ID> <Taxes> <Tax> <Type>percent</Type> <Basis>room</Basis> <Period>night</Period> <Brackets base_amount="0"> <Bracket starts_at="1000.01" amount="12"/> <Bracket starts_at="7500.01" amount="18"/> </Brackets> </Tax> </Taxes> </Property> </TaxFeeInfo>
מיסים לפי גיל
מיסים שחלים על בסיס גיל הצופים:
- מס בסך 20$ למבוגרים.
- מס בסך 10$ לילדים בגילאי 11 עד 17.
- מס בסך 5$ לילדים בגילאי 0 עד 10.
<?xml version="1.0" encoding="UTF-8"?> <TaxFeeInfo timestamp="2020-05-18T16:20:00-04:00" id="12345678" partner="partner_key"> <Property> <ID>Property_1</ID> <Taxes> <Tax> <Type>amount</Type> <Basis>person</Basis> <Period>night</Period> <AgeBrackets> <AdultCharge amount="20"/> <ChildAgeBrackets> <ChildAgeBracket max_age="10" amount="5"/> <ChildAgeBracket max_age="17" amount="10"/> </ChildAgeBrackets> </AgeBrackets> </Tax> </Taxes> </Property> </TaxFeeInfo>
תשובות
תחביר
ההודעה TaxFeeInfoResponse
מבוססת על התחביר הבא:
<?xml version="1.0" encoding="UTF-8"?>
<TaxFeeInfoResponse 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>
</TaxFeeInfoResponse>
רכיבים ומאפיינים
הודעת TaxFeeInfoResponse
כוללת את הפרטים הבאים
רכיבים ומאפיינים:
רכיב / @Attribute | מופעים | סוג | תיאור |
---|---|---|---|
TaxFeeInfoResponse | 1 | Complex element | רכיב השורש שמציין את ההצלחה או הבעיות עבור קבלה הודעת בקשה של TaxFeeInfo. |
TaxFeeInfoResponse / @timestamp | 1 | DateTime | התאריך והשעה של יצירת ההודעה הזו. |
TaxFeeInfoResponse / @id | 1 | string | המזהה הייחודי של הודעת TaxFeeInfo המשויכת. |
TaxFeeInfoResponse / @partner | 1 | string | חשבון השותף שאליו שייכת ההודעה הזו. |
TaxFeeInfoResponse / Success | 0..1 | Success | מציין שההודעה של TaxFeeInfo עובדה בהצלחה
ללא אזהרות, שגיאות או כשלים.
|
TaxFeeInfoResponse / Issues | 0..1 | Issues | מאגר שמתאר בעיה אחת או יותר במהלך העיבוד של
הודעה אחת (TaxFeeInfo ).
|
TaxFeeInfoResponse / Issues / Issue | 1..n | Issue | תיאור של אזהרה, שגיאה או כשל במהלך עיבוד ההודעה TaxFeeInfo. ניתן למצוא פרטים על הבעיות האלה בקטע הודעות שגיאה של סטטוס הפיד. |
TaxFeeInfoResponse / Issues / Issue / @code | 1 | integer | המזהה של הבעיה. |
TaxFeeInfoResponse / Issues / Issue / @status | 1 | enum | סוג הבעיה. הערכים החוקיים הם |
דוגמאות
הפעולה הצליחה
התגובה הבאה היא תשובה לקובץ TaxFeeInfo שעבר עיבוד בהצלחה. הודעה.
<?xml version="1.0" encoding="UTF-8"?> <TaxFeeInfoResponse timestamp="2020-05-18T16:20:00-04:00" id="12345678" partner="partner_key"> <Success/> </TaxFeeInfoResponse>
בעיות
התשובה הבאה היא תשובה להודעת TaxFeeInfo שלא עובדה בגלל שגיאות.
<?xml version="1.0" encoding="UTF-8"?> <TaxFeeInfoResponse timestamp="2020-05-18T16:20:00-04:00" id="12345678" partner="partner_key"> <Issues> <Issue code="1001" status="error">Example</Issue> </Issues> </TaxFeeInfoResponse>