Esta página foi traduzida pela API Cloud Translation.

Informações fiscais

Solicitações

Sintaxe

A mensagem TaxFeeInfo usa a seguinte sintaxe:

<?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>

Elementos e atributos

A mensagem TaxFeeInfo tem os seguintes elementos e atributos:

Elemento / @Attribute	Ocorrências	Tipo	Descrição
TaxFeeInfo	1	Complex element	O elemento raiz de uma mensagem que define os tributos e as taxas de uma única propriedade.
TaxFeeInfo / @timestamp	1	DateTime	A data e a hora de criação da mensagem.
TaxFeeInfo / @id	1	string	Um identificador exclusivo para essa mensagem de solicitação. Esse valor é retornado na mensagem de resposta. Os caracteres permitidos são `a-z`, `A-Z`, `0-9`, `_` (sublinhado) e `-` (traço).
TaxFeeInfo / @partner	1	string	A conta do parceiro para esta mensagem. Esse valor de string é o valor da "chave do parceiro" listado na página "Configurações da conta" da Central para Hotéis. Observação: se você tiver um back-end que fornece feeds para várias contas, esse valor precisa corresponder ao valor do atributo `ID` especificado no elemento `<RequestorID>` das mensagens `<OTA_HotelRateAmountNotifRQ>` e `<OTA_HotelAvailNotifRQ>` da mesma conta.
TaxFeeInfo / Property	1..n	Property	Um contêiner para definir tributos e taxas de uma única propriedade.
TaxFeeInfo / Property / @action	0..1	string	Especifica como a atualização é aplicada. Somente `overlay` é aceito, e o padrão é `overlay`. Todos os `Taxes` e `Fees` anteriores para essa propriedade serão limpos antes da aplicação da atualização.
TaxFeeInfo / Property / ID	1	string	O identificador exclusivo da propriedade. Esse valor precisa corresponder ao ID do hotel especificado usando <id> no elemento <listing> no feed de lista de hotéis. O ID do hotel também aparece na Central para Hotéis.
TaxFeeInfo / Property / Taxes	0..1	Taxes	Contêiner para um ou mais elementos `<Tax>`.
TaxFeeInfo / Property / Taxes / Tax	1..n	Tax	Um imposto individual que se aplica à propriedade.
TaxFeeInfo / Property / Taxes / Tax / RoomTypes	0..1	RoomTypes	Contêiner para uma lista de tipos de quarto a que o imposto se aplica. O imposto é aplicado a cada `<RoomType>` especificado. Se `<RoomTypes>` não for especificado, o imposto será aplicado a todos os quartos.
TaxFeeInfo / Property / Taxes / Tax / RoomTypes / RoomType	1..n	RoomType	Especifica um tipo de quarto. Um tipo de quarto é definido em um elemento `<RoomData>` em uma mensagem Transação (dados da propriedade) e identificado usando o RoomID. O valor `<RoomID>` também é referenciado pelo atributo `InvTypeCode` nas mensagens `OTA_HotelRateAmountNotifRQ`.
TaxFeeInfo / Property / Taxes / Tax / RoomTypes / RoomType / @id	1	string	O identificador exclusivo do inventário (tipo de quarto). Esse valor é mapeado para `<RoomID>` em uma mensagem Transação (dados da propriedade). O número máximo de caracteres permitido é 50.
TaxFeeInfo / Property / Taxes / Tax / RatePlans	0..1	RatePlans	Contêiner para uma lista de planos de tarifação aos quais o tributo se aplica. Se `<RatePlans>` não for especificado, os tributos serão aplicados a todos os planos de tarifas.
TaxFeeInfo / Property / Taxes / Tax / RatePlans / RatePlan	1..n	RatePlan	Especifica um plano de tarifação. Um plano de tarifas é definido por uma combinação de pacotes, taxas e disponibilidade, conforme definido nas mensagens de transação (dados da propriedade), OTA_HotelRateAmountNotifRQ e OTA_HotelAvailNotifRQ, conforme identificado pelo PackageID.
TaxFeeInfo / Property / Taxes / Tax / RatePlans / RatePlan / @id	1	string	O identificador exclusivo do plano de tarifas. Esse valor é mapeado para o valor de PackageID na `<PackageData>` da mensagem Transaction (Property Data) e para o valor `RatePlanCode` definido no atributo `<StatusApplicationControl>` nas mensagens `<OTA_HotelRateAmountNotifRQ>` e `<OTA_HotelAvailNotifRQ>`. O número máximo de caracteres permitidos é 50.
TaxFeeInfo / Property / Taxes / Tax / BookingDates	0..1	BookingDates	Um contêiner de um ou mais períodos que definem quando a reserva precisa ocorrer para que os tributos sejam aplicados.
TaxFeeInfo / Property / Taxes / Tax / BookingDates / DateRange	1..99	DateRange	Período que especifica quando é necessário fazer uma reserva para que os tributos sejam aplicados.
TaxFeeInfo / Property / Taxes / Tax / BookingDates / DateRange / @start	0..1	Date	A data de início (com base no fuso horário da propriedade) do período. Essa data precisa ser anterior ou igual à data de `end`. Se `start` não for especificado, o período será ilimitado em termos de data de início.
TaxFeeInfo / Property / Taxes / Tax / BookingDates / DateRange / @end	0..1	Date	A data de término (com base no fuso horário da propriedade), inclusive, do período. Essa data precisa ser igual ou posterior à data de `start`. Se `end` não for especificado, o período será ilimitado em termos de data de término.
TaxFeeInfo / Property / Taxes / Tax / BookingDates / DateRange / @days_of_week	0..1	string	Os dias da semana permitidos no período. Se não for especificado, todos os dias serão permitidos no período. Cada caractere na string especifica um dia. Por exemplo, "MTWHF" especifica que os dias da semana são permitidos no período. Os caracteres válidos são: `M` para segunda-feira `T` para terça-feira `W` para quarta-feira `H` para quinta-feira `F` para sexta-feira `S` para sábado `U` para domingo Qualquer combinação de caracteres é válida.
TaxFeeInfo / Property / Taxes / Tax / CheckinDates	0..1	CheckinDates	Um contêiner para um ou mais períodos que definem quando o check-in precisa ocorrer para que a taxa seja aplicada.
TaxFeeInfo / Property / Taxes / Tax / CheckinDates / DateRange	1..20	DateRange	Um período que especifica quando o check-in precisa ocorrer para que a cobrança seja aplicada.
TaxFeeInfo / Property / Taxes / Tax / CheckinDates / DateRange / @start	0..1	Date	A data de início (com base no fuso horário da propriedade) do período. Essa data precisa ser anterior ou igual à data de `end`. Se `start` não for especificado, o período será efetivamente ilimitado em termos de data de início.
TaxFeeInfo / Property / Taxes / Tax / CheckinDates / DateRange / @end	0..1	Date	A data de término (com base no fuso horário da propriedade), inclusive, do período. Essa data precisa ser igual ou posterior à data de `start`. Se `end` não for especificado, o período será ilimitado em termos de data de término.
TaxFeeInfo / Property / Taxes / Tax / CheckinDates / DateRange / @days_of_week	0..1	string	Os dias da semana permitidos no período. Se não for especificado, todos os dias serão permitidos no período. Cada caractere na string especifica um dia. Por exemplo, "MTWHF" especifica que os dias da semana são permitidos no período. Os caracteres válidos são: `M` para segunda-feira `T` para terça-feira `W` para quarta-feira `H` para quinta-feira `F` para sexta-feira `S` para sábado `U` para domingo Qualquer combinação de caracteres é válida.
TaxFeeInfo / Property / Taxes / Tax / CheckoutDates	0..1	CheckoutDates	Um contêiner de um ou mais períodos que definem quando o check-out precisa ocorrer para que os tributos sejam aplicados.
TaxFeeInfo / Property / Taxes / Tax / CheckoutDates / DateRange	1..20	DateRange	Um período que especifica quando o check-out precisa ocorrer para que a tributação seja aplicada.
TaxFeeInfo / Property / Taxes / Tax / CheckoutDates / DateRange / @start	0..1	Date	A data de início (com base no fuso horário da propriedade) do período. Essa data precisa ser anterior ou igual à data de `end`. Se `start` não for especificado, o período será ilimitado em termos de data de início.
TaxFeeInfo / Property / Taxes / Tax / CheckoutDates / DateRange / @end	0..1	Date	A data de término (com base no fuso horário da propriedade), inclusive, do período. Essa data precisa ser igual ou posterior à data de `start`. Se `end` não for especificado, o período será ilimitado em termos de data de término.
TaxFeeInfo / Property / Taxes / Tax / CheckoutDates / DateRange / @days_of_week	0..1	string	Os dias da semana permitidos no período. Se não for especificado, todos os dias serão permitidos no período. Cada caractere na string especifica um dia. Por exemplo, "MTWHF" especifica que os dias da semana são permitidos no período. Os caracteres válidos são: `M` para segunda-feira `T` para terça-feira `W` para quarta-feira `H` para quinta-feira `F` para sexta-feira `S` para sábado `U` para domingo Qualquer combinação de caracteres é válida.
TaxFeeInfo / Property / Taxes / Tax / StayDates	0..1	StayDates	Um contêiner de um ou mais períodos que determinam se os tributos são aplicados, por exemplo, para acomodar descontos sazonais.
TaxFeeInfo / Property / Taxes / Tax / StayDates / @application	1	enum	Descreve como o imposto deve ser aplicado. Os valores válidos são: `all`: aplica a taxa a cada noite do itinerário se todas as datas do itinerário coincidirem com as datas da estadia. `any`: aplica o tributo a todas as noites no itinerário se alguma data nele se sobrepuser a uma do período da estadia. `overlap`: aplica a taxa apenas às noites do itinerário que se sobrepõem a uma data no período da estadia. Observação: `overlap` é válido apenas quando `<Period>` está definido como `night`. Esse atributo precisa sempre ser especificado.
TaxFeeInfo / Property / Taxes / Tax / StayDates / DateRange	1..99	DateRange	Um período que especifica as datas em que o tributo será aplicado.
TaxFeeInfo / Property / Taxes / Tax / StayDates / DateRange / @start	0..1	Date	A data de início (com base no fuso horário da propriedade) do período. Essa data precisa ser anterior ou igual à data de `end`. Se `start` não for especificado, o período será efetivamente ilimitado em termos de data de início.
TaxFeeInfo / Property / Taxes / Tax / StayDates / DateRange / @end	0..1	Date	A data de término (com base no fuso horário da propriedade), inclusive, do período. Essa data precisa ser igual ou posterior à data de `start`. Se `end` não for especificado, o período será ilimitado em termos de data de término.
TaxFeeInfo / Property / Taxes / Tax / StayDates / DateRange / @days_of_week	0..1	string	Os dias da semana permitidos no período. Se não for especificado, todos os dias serão permitidos no período. Cada caractere na string especifica um dia. Por exemplo, "MTWHF" especifica que os dias da semana são permitidos no período. Os caracteres válidos são: `M` para segunda-feira `T` para terça-feira `W` para quarta-feira `H` para quinta-feira `F` para sexta-feira `S` para sábado `U` para domingo Qualquer combinação de caracteres é válida.
TaxFeeInfo / Property / Taxes / Tax / Type	1	enum	Os valores válidos são: `percent:` Uma porcentagem da taxa total `amount:` Um valor fixo a ser adicionado à tarifa final `cumulative_percent:` Uma porcentagem da taxa total, tributos e tarifas acumuladas antes do cálculo desses tributos. Se esse valor for especificado, `<Rank>` também precisará ser especificado. `<Brackets>` e `<AgeBrackets>` não podem ser especificados com `cumulative_percent` como tipo.
TaxFeeInfo / Property / Taxes / Tax / Basis	1	enum	Os valores válidos são: `room:` A `<Amount>` é aplicada ao quarto. `person:` O `<Amount>` é aplicado por pessoa. Esse valor só se aplica se `<Type>` for definido como "amount".
TaxFeeInfo / Property / Taxes / Tax / Period	1	enum	Os valores válidos são: `stay:` O `<Amount>` é adicionado à tarifa total da estadia. `night:` O valor de `<Amount>` é adicionado por noite da estadia.
TaxFeeInfo / Property / Taxes / Tax / Currency	0..1	string	O código da moeda de três letras para a tributação (por exemplo, USD). Observação: se `<Currency>` não for especificado, mas `<Amount>` for, o valor de `<Currency>` será padrão para a moeda da taxa base.
TaxFeeInfo / Property / Taxes / Tax / Amount	0..1	float	O valor da porcentagem ou do valor do imposto.
TaxFeeInfo / Property / Taxes / Tax / ApplicableNights	0..1	ApplicableNights	Esse valor só se aplica se `<Type>` for definido como amount e `<Period>` for definido como night. Restringe o número de noites em que um tributo pode ser aplicado. Especifique `max` ou `excluded`, mas não ambos.
TaxFeeInfo / Property / Taxes / Tax / ApplicableNights / @max	0..1	integer	`<ApplicableNights max="N">` indica que as noites após as primeiras N noites devem ser excluídas.
TaxFeeInfo / Property / Taxes / Tax / ApplicableNights / @excluded	0..1	integer	`<ApplicableNights excluded="N">` indica que as primeiras N noites precisam ser excluídas.
TaxFeeInfo / Property / Taxes / Tax / LengthOfStay	0..1	LengthOfStay	Define os limites de duração da estadia em que essa taxa pode ser aplicada. A taxa não é aplicada quando a duração da estadia está fora dos limites mínimo e máximo.
TaxFeeInfo / Property / Taxes / Tax / LengthOfStay / @min	0..1	integer	O número mínimo de noites permitidas na estadia para que a taxa seja aplicada. Se não for especificado, não haverá valor mínimo.
TaxFeeInfo / Property / Taxes / Tax / LengthOfStay / @max	0..1	integer	O número máximo de noites permitidas na estadia para que a taxa seja aplicada. Se não for especificado, não haverá valor máximo.
TaxFeeInfo / Property / Taxes / Tax / Brackets	0..1	Brackets	Contêiner para um ou mais elementos `<Bracket>`. Define um conjunto de faixas de tributos contíguos e não sobrepostas. Por exemplo: impostos do IBS na Índia. Esse elemento só é válido quando `<Period>` está definido como `night` e `<Amount>` não é especificado.
TaxFeeInfo / Property / Taxes / Tax / Brackets / @base_amount	0..1	float	O valor da porcentagem ou do valor do imposto, aplicado às tarifas noturnas abaixo do valor de `starts_at` do primeiro intervalo.
TaxFeeInfo / Property / Taxes / Tax / Brackets / Bracket	1..n	Bracket	Define uma faixa de imposto com base nas diárias.
TaxFeeInfo / Property / Taxes / Tax / Brackets / Bracket / @starts_at	1	float	Define o limite inferior de uma faixa tributária. O limite máximo é especificado no campo `starts_at` do colchete subsequente. Não há limite superior para o último colchete. Uma faixa fiscal fica ativa quando a taxa por noite é maior ou igual ao valor de `starts_at` da faixa e estritamente menor que o valor de `starts_at` da faixa subsequente. Esse valor precisa ser estritamente maior que 0.
TaxFeeInfo / Property / Taxes / Tax / Brackets / Bracket / @amount	1	float	O valor da porcentagem ou do valor do imposto aplicado a esse limite.
TaxFeeInfo / Property / Taxes / Tax / AgeBrackets	0..1	AgeBrackets	Permite especificar um conjunto de tributos com base na idade dos ocupantes. Esse elemento só é válido quando `<Brackets>` e `<Amount>` não são especificados, `<Basis>` é definido como `person` e `<Type>` é definido como `amount`.
TaxFeeInfo / Property / Taxes / Tax / AgeBrackets / AdultCharge	0..1	AdultCharge	Contêiner para especificar tributos para adultos.
TaxFeeInfo / Property / Taxes / Tax / AgeBrackets / AdultCharge / @amount	1	float	O valor fixo do imposto aplicado a adultos.
TaxFeeInfo / Property / Taxes / Tax / AgeBrackets / ChildAgeBrackets	0..1	ChildAgeBrackets	Contêiner para armazenar um ou mais elementos `<ChildAgeBracket>`.
TaxFeeInfo / Property / Taxes / Tax / AgeBrackets / ChildAgeBrackets / ChildAgeBracket	1..n	ChildAgeBracket	Define uma faixa etária para crianças e o valor do imposto correspondente.
TaxFeeInfo / Property / Taxes / Tax / AgeBrackets / ChildAgeBrackets / ChildAgeBracket / @max_age	1	integer	Define o limite máximo da idade de uma criança. O limite inferior é especificado no campo `max_age` + 1 do colchete anterior. Os limites máximo e mínimo são inclusivos. O limite inferior do primeiro colchete é 0. `max_age` precisa estar entre 0 e 17 (inclusive).
TaxFeeInfo / Property / Taxes / Tax / AgeBrackets / ChildAgeBrackets / ChildAgeBracket / @amount	1	float	O valor fixo do imposto aplicado a crianças nessa faixa etária.
TaxFeeInfo / Property / Taxes / Tax / UserCountries	0..1	UserCountries	Contêiner para listar os países dos usuários em que o imposto é incluído ou excluído. Se estiver presente, o tributo só será incluído ou excluído para usuários dos países especificados.
TaxFeeInfo / Property / Taxes / Tax / UserCountries / @type	0..1	enum	O tipo de especificação de UserCountries. Os valores válidos são `include` e `exclude`. Se a `type` de UserCountries estiver definida como `include`, o imposto será aplicado apenas a usuários dos países listados. Se o UserCountries `type` for `exclude`, o imposto será aplicado apenas a usuários fora dos países listados. Se o UserCountries `type` não estiver definido, ele será tratado como `include` e o imposto será aplicado apenas a usuários dos países listados.
TaxFeeInfo / Property / Taxes / Tax / UserCountries / Country	1..n	Country	Define um país na lista de UserCountries.
TaxFeeInfo / Property / Taxes / Tax / UserCountries / Country / @code	1	string	Um código de país do CLDR, como `DE` ou `FR`. Em alguns países, o código de país CLDR não é igual ao código ISO do país de duas letras. Além disso, não há suporte para códigos de região CLDR.
TaxFeeInfo / Property / Taxes / Tax / Rank	1	integer	Uma classificação que especifica a ordem de inscrição para esse tributo ou taxa. Por exemplo, um valor de 2 significa que essa taxa será aplicada em segundo plano. Esse elemento precisa sempre ser especificado se `<Type>` estiver definido como `cumulative_percent`. Em geral, essa ordem é aplicada a tributos e taxas. Valores de classificação duplicados são permitidos entre tributos e taxas, mas isso pode resultar em comportamento indefinido, em que tributos e taxas são aplicados de maneira arbitrária e cumulativa. Os tributos e as taxas sem classificações são aplicados antes de todas as entradas classificadas. `<Rank>` precisa estar entre 1 e 99 (inclusive).
TaxFeeInfo / Property / Fees	0..1	Fees	Contêiner para um ou mais elementos `<Fee>`.
TaxFeeInfo / Property / Fees / Fee	1..n	Fee	Uma taxa individual que se aplica à propriedade. Todos os elementos filhos de `<Tax>` também têm suporte para `<Fee>` com a mesma sintaxe.

Exemplos

Há um limite de 300 impostos e taxas por propriedade. Consulte o exemplo "Excluir tributos" para remover tributos e taxas de uma propriedade.

Mensagem básica

Uma mensagem TaxFeeInfo básica:

<?xml version="1.0" encoding="UTF-8"?>
<TaxFeeInfo timestamp="2024-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>

Excluir tributos

Exclua todos os tributos e taxas no nível da propriedade para o hotel especificado:

<?xml version="1.0" encoding="UTF-8"?>
<TaxFeeInfo timestamp="2024-06-16T16:20:00-04:00"
            id="12345678"
            partner="partner_key">
  <Property action="overlay"/>
    <ID>Property_1</ID>
  </Property>
</TaxFeeInfo>

Tributo fixo

Tributo GST indiano aplicado com base nas taxas por noite. Os colchetes fiscais são:

Nenhum imposto se a diária for menor ou igual a 1.000.
Tributos de 12% se a tarifa por noite for maior que 1.000 e menor ou igual a 7.500.
18% de imposto se a diária for maior que 7.500.

<?xml version="1.0" encoding="UTF-8"?>
<TaxFeeInfo timestamp="2024-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>

Tributos com base na idade

Tributos aplicados com base na idade dos ocupantes:

Tributo de US$ 20 para ocupantes adultos.
US$ 10 de imposto para crianças entre 11 e 17 anos.
Taxa de US$ 5 para crianças entre 0 e 10 anos.

<?xml version="1.0" encoding="UTF-8"?>
<TaxFeeInfo timestamp="2024-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>

Respostas

Sintaxe

A mensagem TaxFeeInfoResponse usa a seguinte sintaxe:

<?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>

Elementos e atributos

A mensagem TaxFeeInfoResponse tem os seguintes elementos e atributos:

Elemento / @Attribute	Ocorrências	Tipo	Descrição
TaxFeeInfoResponse	1	Complex element	O elemento raiz que indica o sucesso ou os problemas de uma mensagem de solicitação de TaxFeeInfo recebida.
TaxFeeInfoResponse / @timestamp	1	DateTime	A data e a hora de criação da mensagem.
TaxFeeInfoResponse / @id	1	string	O identificador exclusivo da mensagem TaxFeeInfo associada.
TaxFeeInfoResponse / @partner	1	string	A conta do parceiro para esta mensagem.
TaxFeeInfoResponse / Success	0..1	Success	Indica que a mensagem TaxFeeInfo foi processada sem avisos, erros ou falhas. `<Success>` ou `<Issues>` está presente em cada mensagem.
TaxFeeInfoResponse / Issues	0..1	Issues	Um contêiner para um ou mais problemas encontrados durante o processamento da mensagem `TaxFeeInfo`. `<Success>` ou `<Issues>` está presente em cada mensagem.
TaxFeeInfoResponse / Issues / Issue	1..n	Issue	A descrição de um aviso, erro ou falha encontrada durante o processamento da mensagem TaxFeeInfo. Confira detalhes sobre esses problemas em Mensagens de erro de status do feed.
TaxFeeInfoResponse / Issues / Issue / @code	1	integer	O identificador do problema.
TaxFeeInfoResponse / Issues / Issue / @status	1	enum	O tipo de problema encontrado. Os valores válidos são `warning`, `error` e `failure`.

Exemplos

Sucesso

Confira a seguir uma resposta para uma mensagem TaxFeeInfo processada com sucesso.

<?xml version="1.0" encoding="UTF-8"?>
<TaxFeeInfoResponse timestamp="2024-05-18T16:20:00-04:00"
                    id="12345678"
                    partner="partner_key">
  <Success/>
</TaxFeeInfoResponse>

Problemas

Confira a seguir uma resposta a uma mensagem TaxFeeInfo não processada devido a erros.

<?xml version="1.0" encoding="UTF-8"?>
<TaxFeeInfoResponse timestamp="2024-05-18T16:20:00-04:00"
                    id="12345678"
                    partner="partner_key">
  <Issues>
    <Issue code="1001" status="error">Example</Issue>
  </Issues>
</TaxFeeInfoResponse>