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. O valor da string é o valor da "Chave do parceiro" listado na página "Configurações da conta" da Central para Hotéis. Observação:se você tem 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>` para a mesma conta.
TaxFeeInfo / Property	1..n	Property	Um contêiner para definir tributos e taxas para uma única propriedade.
TaxFeeInfo / Property / @action	0..1	string	Especifica como a atualização é aplicada. Apenas `overlay` é aceito, e o padrão é `overlay`. Todos os `Taxes` e `Fees` anteriores desta propriedade serão apagados antes que essa atualização seja aplicada.
TaxFeeInfo / Property / ID	1	string	O identificador exclusivo da propriedade. Esse valor precisa corresponder ao ID do hotel especificado com <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 tributo individual que se aplica à propriedade.
TaxFeeInfo / Property / Taxes / Tax / RoomTypes	0..1	RoomTypes	Contêiner para uma lista de tipos de quarto aos quais os impostos se aplicam. Os tributos são aplicados a cada `<RoomType>` especificado. Se `<RoomTypes>` não for especificado, os tributos serão aplicados 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 de Transação (dados da propriedade) e conforme identificado com 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 de 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 tarifas aos quais os tributos se aplicam. 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 de 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 tarifa. Esse valor é mapeado para o valor de PackageID em `<PackageData>` em uma mensagem de Transação (dados da propriedade) e no atributo `RatePlanCode` em `<StatusApplicationControl>` nas mensagens `<OTA_HotelRateAmountNotifRQ>` e `<OTA_HotelAvailNotifRQ>`. O número máximo de caracteres permitido é 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), inclusive, do período. Essa data precisa ser igual ou anterior à 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 / 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 `start`. Se `end` não for especificado, o período será efetivamente 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 da string especifica um dia. Por exemplo, "MTWHF" especifica que 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 de um ou mais períodos que definem quando o check-in precisa ser feito para que os tributos sejam aplicados.
TaxFeeInfo / Property / Taxes / Tax / CheckinDates / DateRange	1..20	DateRange	Um período que especifica quando o check-in precisa ocorrer para que os tributos sejam aplicados.
TaxFeeInfo / Property / Taxes / Tax / CheckinDates / DateRange / @start	0..1	Date	A data de início (com base no fuso horário da propriedade), inclusive, do período. Essa data precisa ser igual ou anterior à 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 `start`. Se `end` não for especificado, o período será efetivamente 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 da string especifica um dia. Por exemplo, "MTWHF" especifica que 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 é necessário fazer o check-out para que os tributos sejam aplicados.
TaxFeeInfo / Property / Taxes / Tax / CheckoutDates / DateRange	1..20	DateRange	Período que especifica quando é necessário fazer o check-out para que os tributos sejam aplicados.
TaxFeeInfo / Property / Taxes / Tax / CheckoutDates / DateRange / @start	0..1	Date	A data de início (com base no fuso horário da propriedade), inclusive, do período. Essa data precisa ser igual ou anterior à 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 / 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 `start`. Se `end` não for especificado, o período será efetivamente 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 da string especifica um dia. Por exemplo, "MTWHF" especifica que 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 para 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 aplicar os tributos. Os valores válidos são: `all`: aplica o tributo a cada noite no itinerário se todas as datas no itinerário se sobrepuserem às datas da estadia. `any`: aplica o tributo a todas as noites no itinerário se alguma data nele se sobrepuser a uma data no período da estadia. `overlap`: aplica o tributo 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 deve sempre ser especificado.
TaxFeeInfo / Property / Taxes / Tax / StayDates / DateRange	1..99	DateRange	Um período que especifica as datas em que os tributos serão aplicados.
TaxFeeInfo / Property / Taxes / Tax / StayDates / DateRange / @start	0..1	Date	A data de início (com base no fuso horário da propriedade), inclusive, do período. Essa data precisa ser igual ou anterior à 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 `start`. Se `end` não for especificado, o período será efetivamente 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 da string especifica um dia. Por exemplo, "MTWHF" especifica que 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 à taxa final `cumulative_percent:` Uma porcentagem da taxa total, tributos e tarifas acumuladas antes do cálculo desses tributos. Se esse valor for definido, `<Rank>` também precisará ser. `<Brackets>` e `<AgeBrackets>` não podem ser especificados com `cumulative_percent` como um tipo.
TaxFeeInfo / Property / Taxes / Tax / Basis	1	enum	Os valores válidos são: `room:` A `<Amount>` é aplicada à sala. `person:` O `<Amount>` é aplicado por pessoa. Esse valor só se aplica se `<Type>` estiver definido como o valor.
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 o tributo (por exemplo: USD).
TaxFeeInfo / Property / Taxes / Tax / Amount	0..1	float	O valor da porcentagem ou do valor dos tributos.
TaxFeeInfo / Property / Taxes / Tax / ApplicableNights	0..1	ApplicableNights	Esse valor só será aplicado se `<Type>` estiver definido como amount e `<Period>` estiver 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 serão 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 esses impostos podem ser aplicados. O tributo não é aplicado 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 diárias permitidas na estadia para que os tributos sejam aplicados. Se isso não for especificado, não haverá valor mínimo.
TaxFeeInfo / Property / Taxes / Tax / LengthOfStay / @max	0..1	integer	O máximo de noites permitidas na estadia para que os tributos sejam aplicados. Se isso não for especificado, não haverá limite máximo.
TaxFeeInfo / Property / Taxes / Tax / Brackets	0..1	Brackets	Contêiner para um ou mais elementos `<Bracket>`. Define um conjunto de colchetes fiscais contíguos e não sobrepostos, por exemplo, tributos do IBS indiano. 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 percentual ou total dos tributos, aplicado às diárias abaixo do valor de `starts_at` da primeira faixa.
TaxFeeInfo / Property / Taxes / Tax / Brackets / Bracket	1..n	Bracket	Define uma faixa fiscal com base nas tarifas noturnas.
TaxFeeInfo / Property / Taxes / Tax / Brackets / Bracket / @starts_at	1	float	Define o limite inferior de uma faixa fiscal. O limite superior é especificado no campo `starts_at` do colchete seguinte. 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 do que 0.
TaxFeeInfo / Property / Taxes / Tax / Brackets / Bracket / @amount	1	float	É o valor percentual ou total dos tributos aplicados a essa faixa.
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>` está definido como `person` e `<Type>` é definido como `amount`.
TaxFeeInfo / Property / Taxes / Tax / AgeBrackets / AdultCharge	0..1	AdultCharge	Recipiente para especificar impostos para adultos.
TaxFeeInfo / Property / Taxes / Tax / AgeBrackets / AdultCharge / @amount	1	float	O valor fixo de tributo aplicado para adultos.
TaxFeeInfo / Property / Taxes / Tax / AgeBrackets / ChildAgeBrackets	0..1	ChildAgeBrackets	Contêiner para conter 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 tributo correspondente.
TaxFeeInfo / Property / Taxes / Tax / AgeBrackets / ChildAgeBrackets / ChildAgeBracket / @max_age	1	integer	Define o limite superior na idade de uma criança. O limite inferior é especificado no campo `max_age` + 1 do colchete anterior. Os limites superior e inferior são inclusivos. O limite inferior para o primeiro colchete é 0. `max_age` precisa estar no intervalo de 0 a 17 (inclusive).
TaxFeeInfo / Property / Taxes / Tax / AgeBrackets / ChildAgeBrackets / ChildAgeBracket / @amount	1	float	O valor fixo de tributos aplicado a crianças nessa faixa etária.
TaxFeeInfo / Property / Taxes / Tax / UserCountries	0..1	UserCountries	Contêiner para listar os países do usuário em que os tributos estão incluídos ou excluídos. Se houver, os tributos só serão incluídos ou excluídos para usuários dos países especificados.
TaxFeeInfo / Property / Taxes / Tax / UserCountries / @type	0..1	enum	O tipo de especificação Usercountries. Os valores válidos são `include` e `exclude`. Se o campo Usercountries `type` estiver definido como `include`, os tributos serão aplicados apenas aos usuários dos países listados. Por outro lado, se `type` for `exclude`, os tributos serão aplicados apenas aos usuários fora dos países listados. Se o campo User countries `type` não for definido, ele será tratado como `include`, e os tributos serão aplicados apenas aos usuários dos países listados.
TaxFeeInfo / Property / Taxes / Tax / UserCountries / Country	1..n	Country	Define um país na lista de Userpaíses.
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, os códigos de região CLDR não são compatíveis.
TaxFeeInfo / Property / Taxes / Tax / Rank	1	integer	Uma classificação que especifica a ordem de inscrição para esse tributo ou taxa. Por exemplo, o valor 2 significa que esse tributo será aplicado em segundo lugar. Esse elemento precisa ser sempre especificado se `<Type>` for 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 um comportamento indefinido, em que os tributos e as tarifas serã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 no intervalo de 1 a 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 são compatíveis com `<Fee>` com a mesma sintaxe.

Exemplos

Mensagem básica

Uma mensagem TaxFeeInfo básica:

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

Excluir tributos

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

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

Tributo de Slab

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

Não haverá tributos se a tarifa por noite for menor que 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.
Tributos de 18% se a tarifa por noite for maior que 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>

Tributos com base na idade

Tributos aplicados com base na idade dos ocupantes:

Tributos de US$ 20 para adultos.
Tributos de US$ 10 para crianças entre 11 e 17 anos.
Tributos de US$ 5 para crianças entre 0 e 10 anos.

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

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. Cada mensagem tem `<Success>` ou `<Issues>`.
TaxFeeInfoResponse / Issues	0..1	Issues	Um contêiner para um ou mais problemas encontrados durante o processamento da mensagem `TaxFeeInfo`. Cada mensagem tem `<Success>` ou `<Issues>`.
TaxFeeInfoResponse / Issues / Issue	1..n	Issue	A descrição de um aviso, erro ou falha encontrada ao processar a mensagem TaxFeeInfo. Os detalhes sobre esses problemas podem ser encontrados nas 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

Concluído

Veja a seguir uma resposta a uma mensagem TaxFeeInfo processada.

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

Problemas

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

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