בקשות
תחביר
ההודעה 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> בהודעה Transaction (נתוני נכס), ומזוהה באמצעות השדה RoomID שלו. (בהודעות OTA_HotelRateAmountNotifRQ יש הפניה גם לערך <RoomID> של המאפיין InvTypeCode ). |
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>
בהודעה Transaction (נתוני נכס), ובמאפיין 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> מוגדר כ-night.
ההגבלה הזו מגבילה את מספר הלילות שעליהם אפשר להחיל מס. אפשר לציין |
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 (ארצות הברית).
הערכים החוקיים הם אם המדיניות לעומת זאת, אם מדינות המשתמש אם המדיניות |
TaxFeeInfo / Property / Taxes / Tax / UserCountries / Country | 1..n | Country | מגדירה מדינה אחת ברשימת UserCountry. |
TaxFeeInfo / Property / Taxes / Tax / UserCountries / Country / @code | 1 | string | קוד מדינה במאגר CLDR, כמו DE או FR . חשוב לשים לב שבמדינות מסוימות, קוד המדינה במאגר CLDR שונה מקוד המדינה בן 2 האותיות לפי תקן ISO. בנוסף, אין תמיכה בקודי אזורים במאגר CLDR. |
TaxFeeInfo / Property / Taxes / Tax / Rank | 1 | integer | דירוג שמציין את סדר הגשת הבקשה למס או לעמלה האלה.
לדוגמה: המשמעות של ערך של 2 היא שהמס הזה יחול השני.
צריך תמיד לציין את הרכיב הזה אם השדה הערך |
TaxFeeInfo / Property / Fees | 0..1 | Fees | קונטיינר של רכיב <Fee> אחד או יותר. |
TaxFeeInfo / Property / Fees / Fee | 1..n | Fee | עמלה אישית שחלה על הנכס. כל רכיבי הצאצא של |
דוגמאות
הודעה בסיסית
הודעת 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>