TaxFeeInfo

Запросы

Синтаксис

Сообщение 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 рассматривается как наложение для указанных отелей. Другими словами, для каждого элемента <Property> с допустимым элементом <ID> все предыдущие обновления TaxFeeInfo для этого отеля фактически удаляются перед применением текущего обновления.

Элементы и атрибуты

Сообщение TaxFeeInfo имеет следующие элементы и атрибуты:

Элемент/@Атрибут	События	Тип	Описание
TaxFeeInfo	1	Complex element	Корневой элемент сообщения, определяющего налоги и сборы для одного объекта недвижимости.
TaxFeeInfo / @timestamp	1	DateTime	Дата и время создания этого сообщения.
TaxFeeInfo / @id	1	string	Уникальный идентификатор этого сообщения запроса. Это значение возвращается в ответном сообщении. Допустимые символы: az , AZ , 0-9 , _ (подчеркивание) и - (тире).
TaxFeeInfo / @partner	1	string	Партнерский аккаунт для этого сообщения. Это строковое значение представляет собой значение «Партнерского ключа», указанное на странице настроек учетной записи в Hotel Center. Примечание. Если у вас есть серверная часть, которая предоставляет каналы для нескольких учетных записей, это значение должно соответствовать значению атрибута ID , указанному в элементе <RequestorID> ваших сообщений <OTA_HotelRateAmountNotifRQ> и <OTA_HotelAvailNotifRQ> для одной и той же учетной записи.
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 .)
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	Указывает тарифный план. Тарифный план определяется комбинацией пакета, тарифов и доступности, как определено в сообщениях Transaction (Data Property), 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» указывает, что в диапазоне дат разрешены дни недели. Допустимые символы: M на понедельник T во вторник W для среды H для четверга F для пятницы S для субботы U на воскресенье Любая комбинация символов допустима.
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» указывает, что в диапазоне дат разрешены дни недели. Допустимые символы: M на понедельник T во вторник W для среды H для четверга F для пятницы S для субботы U на воскресенье Любая комбинация символов допустима.
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» указывает, что в диапазоне дат разрешены дни недели. Допустимые символы: M на понедельник T во вторник W для среды H для четверга F для пятницы S для субботы U на воскресенье Любая комбинация символов допустима.
TaxFeeInfo / Property / Taxes / Tax / StayDates	0..1	StayDates	Контейнер для одного или нескольких диапазонов дат, определяющих, применяется ли налог, например для учета сезонных скидок.
TaxFeeInfo / Property / Taxes / Tax / StayDates / @application	1	enum	Описано, как следует применять налог. Допустимые значения: all : Налог применяется к каждой ночи в маршруте, если все даты в маршруте совпадают с датами пребывания. any : налог применяется ко всем ночам в маршруте, если какая-либо дата в маршруте совпадает с датой в диапазоне дат пребывания. overlap : применяется налог только к тем ночам в маршруте, которые совпадают с датой в диапазоне дат пребывания. Примечание . overlap допустимо только в том случае, если для <Period> установлено значение « night ». Этот атрибут должен быть указан всегда.
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» указывает, что в диапазоне дат разрешены дни недели. Допустимые символы: M на понедельник T во вторник W для среды H для четверга F для пятницы S для субботы U на воскресенье Любая комбинация символов допустима.
TaxFeeInfo / Property / Taxes / Tax / Type	1	enum	Допустимые значения: percent: процент от общей ставки amount: фиксированная сумма, добавляемая к окончательной ставке. cumulative_percent: процент от общей ставки, налогов и сборов, накопленных до расчета этого налога или сбора. Если указано это значение, необходимо также указать <Rank> . <Brackets> и <AgeBrackets> нельзя указывать с типом cumulative_percent .
TaxFeeInfo / Property / Taxes / Tax / Basis	1	enum	Допустимые значения: room: <Amount> применяется к комнате. person: <Amount> применяется на человека. Это значение применяется только в том случае, если для <Type> установлено значение суммы.
TaxFeeInfo / Property / Taxes / Tax / Period	1	enum	Допустимые значения: stay: <Amount> добавляется к общей стоимости проживания. night: <Amount> добавляется за ночь пребывания.
TaxFeeInfo / Property / Taxes / Tax / Currency	0..1	string	Трехбуквенный код валюты налога (например, доллар США).
TaxFeeInfo / Property / Taxes / Tax / Amount	0..1	float	Значение процента или суммы налога.
TaxFeeInfo / Property / Taxes / Tax / ApplicableNights	0..1	ApplicableNights	Это значение применяется только в том случае, если для <Type> установлено значение суммы , а <Period> установлено значение ночь . Ограничивает количество ночей, за которые может взиматься налог. Укажите либо max , либо excluded , но не то и другое.
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. Этот элемент действителен только в том случае, если для <Period> установлено значение « night », а <Amount> не указано.
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	Определяет нижнюю границу налоговой категории. Верхняя граница указывается в поле starts_at последующей скобки. Для последней скобки нет верхней границы. Налоговая группа активна, когда суточная ставка больше или равна значению starts_at группы и строго меньше значения starts_at последующей группы. Это значение должно быть строго больше 0.
TaxFeeInfo / Property / Taxes / Tax / Brackets / Bracket / @amount	1	float	Значение процента или суммы налога, применяемого к этой налоговой категории.
TaxFeeInfo / Property / Taxes / Tax / AgeBrackets	0..1	AgeBrackets	Позволяет указать набор налогов в зависимости от возраста жильцов. Этот элемент действителен только в том случае, если <Brackets> и <Amount> не указаны, для <Basis> установлено значение person , а <Type> установлено amount .
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	Определяет верхнюю границу возраста ребенка. Нижняя граница указана в поле max_age предыдущей скобки + 1. Верхняя и нижняя границы включаются. Нижняя граница первой скобки равна 0. max_age должен находиться в диапазоне от 0 до 17 (включительно).
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. Допустимые значения include и exclude . Если type UserCountries установлено include , налог будет применяться только к пользователям из перечисленных стран. Принимая во внимание, что если type UserCountries exclude , налог будет применяться только к пользователям за пределами перечисленных стран. Если type UserCountries не установлен, мы будем рассматривать его как include , и налог будет применяться только к пользователям из перечисленных стран.
TaxFeeInfo / Property / Taxes / Tax / UserCountries / Country	1..n	Country	Определяет одну страну в списке UserCountries.
TaxFeeInfo / Property / Taxes / Tax / UserCountries / Country / @code	1	string	Код страны CLDR , например DE или FR . Обратите внимание, что для некоторых стран код страны CLDR не совпадает с двухбуквенным кодом страны ISO. Кроме того, коды регионов CLDR не поддерживаются.
TaxFeeInfo / Property / Taxes / Tax / Rank	1	integer	Ранг, определяющий порядок применения этого налога или сбора. Например, значение 2 означает, что этот налог будет применяться вторым. Этот элемент всегда следует указывать, если для <Type> установлено значение cumulative_percent . В целом этот порядок применяется как к налогам, так и к сборам. Среди налогов и сборов допускаются повторяющиеся значения рангов, но это может привести к неопределенному поведению, когда налоги и сборы будут применяться произвольным и кумулятивным образом. Налоги и сборы без рангов применяются перед всеми рейтинговыми заявками. <Rank> должен находиться в диапазоне от 1 до 99 (включительно).
TaxFeeInfo / Property / Fees	0..1	Fees	Контейнер для одного или нескольких элементов <Fee> .
TaxFeeInfo / Property / Fees / Fee	1..n	Fee	Индивидуальная плата, которая применяется к объекту недвижимости. Все дочерние элементы <Tax> также поддерживаются для <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>

Налог на слябы

Индийский налог на плиты GST, взимаемый на основе ночных ставок. Налоговые категории:

• Налог не взимается, если суточная ставка меньше или равна 1000.
• Налог 12%, если цена за ночь превышает 1000 и меньше или равна 7500.
• Налог 18%, если цена за ночь превышает 7500.

<?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 имеет следующие элементы и атрибуты:

Элемент/@Атрибут	События	Тип	Описание
TaxFeeInfoResponse	1	Complex element	Корневой элемент, указывающий успешность или проблемы полученного сообщения запроса TaxFeeInfo.
TaxFeeInfoResponse / @timestamp	1	DateTime	Дата и время создания этого сообщения.
TaxFeeInfoResponse / @id	1	string	Уникальный идентификатор из связанного сообщения TaxFeeInfo.
TaxFeeInfoResponse / @partner	1	string	Партнерский аккаунт для этого сообщения.
TaxFeeInfoResponse / Success	0..1	Success	Указывает, что сообщение TaxFeeInfo было успешно обработано без предупреждений, ошибок или сбоев. В каждом сообщении присутствует либо <Success> , либо <Issues> .
TaxFeeInfoResponse / Issues	0..1	Issues	Контейнер для одной или нескольких проблем, возникших при обработке сообщения TaxFeeInfo . В каждом сообщении присутствует либо <Success> , либо <Issues> .
TaxFeeInfoResponse / Issues / Issue	1..n	Issue	Описание предупреждения, ошибки или сбоя, возникшего при обработке сообщения TaxFeeInfo. Подробную информацию об этих проблемах можно найти в разделе «Сообщения об ошибках статуса фида» .
TaxFeeInfoResponse / Issues / Issue / @code	1	integer	Идентификатор проблемы.
TaxFeeInfoResponse / Issues / Issue / @status	1	enum	Тип возникшей проблемы. Допустимые значения: warning , error и failure .

Примеры

Успех

Ниже приведен ответ на успешно обработанное сообщение 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>