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 impostos e as taxas para uma única .
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 e _ (sublinhado) e - (traço).
TaxFeeInfo / @partner 1 string A conta do parceiro para esta mensagem. Esse valor de string é o "Chave do parceiro" valor listado em o página de configurações da conta na Central para Hotéis.

Observação: se você tem um back-end que fornece feeds para várias contas, esse valor precisa corresponder ao ID o valor do atributo especificado em <RequestorID> elemento dos seus <OTA_HotelRateAmountNotifRQ> e <OTA_HotelAvailNotifRQ> mensagens da 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 é com suporte, e o padrão é overlay. Qualquer anterior Taxes e Fees para esta propriedade serão limpos antes que a atualização seja aplicada.
TaxFeeInfo / Property / ID 1 string O identificador exclusivo da propriedade. Esse valor precisa corresponder ao ID do hotel especificado usando <id> no o elemento <listing> na lista de hotéis Feed de lista. 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, o O imposto é cobrado de todos os quartos.
TaxFeeInfo / Property / Taxes / Tax / RoomTypes / RoomType 1..n RoomType Especifica um tipo de quarto. Um tipo de quarto é definido em uma <RoomData> elemento em um mensagem Transação (dados da propriedade), e como identificados usando o RoomID. (Seu O valor <RoomID> também é referenciado pelo Atributo InvTypeCode em OTA_HotelRateAmountNotifRQ messages.)
TaxFeeInfo / Property / Taxes / Tax / RoomTypes / RoomType / @id 1 string O identificador exclusivo do inventário (tipo de quarto). Esse valor mapeia para <RoomID> em uma 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 se aplica a todos os planos de tarifas.
TaxFeeInfo / Property / Taxes / Tax / RatePlans / RatePlan 1..n RatePlan Especifica um plano de tarifação. Um plano de tarifação é definido por uma combinação de pacote, taxas e disponibilidade, conforme definido em Transação (Dados de propriedade), OTA_HotelRateAmountNotifRQ e OTA_HotelAvailNotifRQ e conforme identificado por PackageID.
TaxFeeInfo / Property / Taxes / Tax / RatePlans / RatePlan / @id 1 string O identificador exclusivo do plano de tarifa. Esse valor é mapeado para o PackageID na coluna Mensagem da transação (dados da propriedade) <PackageData> e o valor RatePlanCode que é definido no <StatusApplicationControl> em ambos <OTA_HotelRateAmountNotifRQ> e <OTA_HotelAvailNotifRQ> mensagens. O número máximo de caracteres permitido é 50.
TaxFeeInfo / Property / Taxes / Tax / BookingDates 0..1 BookingDates Um contêiner para um ou mais períodos que definem quando as reservas precisam para que o tributo seja aplicado.
TaxFeeInfo / Property / Taxes / Tax / BookingDates / DateRange 1..99 DateRange Um período que especifica quando é necessário fazer uma reserva para que o tributo seja aplicada.
TaxFeeInfo / Property / Taxes / Tax / BookingDates / DateRange / @start 0..1 Date A data de início (com base no fuso horário da propriedade), inclusive, de o período. Essa data deve ser anterior ou igual à data end. Se start não for especificada, a data é 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. A data precisa ser igual ou posterior a start. data. Se end não for especificada, a data período é 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. Caso contrário especificado, todos os dias são permitidos no período. Cada 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 o tributo seja aplicado.
TaxFeeInfo / Property / Taxes / Tax / CheckinDates / DateRange 1..20 DateRange Um período que especifica quando o check-in deve ocorrer para que os impostos ser aplicadas.
TaxFeeInfo / Property / Taxes / Tax / CheckinDates / DateRange / @start 0..1 Date A data de início (com base no fuso horário da propriedade), inclusive, de o período. Essa data deve ser anterior ou igual à data end. Se start não for especificada, a data é 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. A data precisa ser igual ou posterior a start. data. Se end não for especificada, a data período é 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. Caso contrário especificado, todos os dias são permitidos no período. Cada 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 para um ou mais períodos que definem o momento do check-out precisa ocorrer para que o tributo seja aplicado.
TaxFeeInfo / Property / Taxes / Tax / CheckoutDates / DateRange 1..20 DateRange Um período que especifica quando o check-out deve ocorrer para que os impostos ser aplicadas.
TaxFeeInfo / Property / Taxes / Tax / CheckoutDates / DateRange / @start 0..1 Date A data de início (com base no fuso horário da propriedade), inclusive, de o período. Essa data deve ser anterior ou igual à data end. Se start não for especificada, a data é 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. A data precisa ser igual ou posterior a start. data. Se end não for especificada, a data período é 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. Caso contrário especificado, todos os dias são permitidos no período. Cada 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 para um ou mais períodos que determinam se o imposto é aplicado, 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 do Itinerário se todas as datas do itinerário se sobrepuserem com as datas da estadia.
  • any: aplica o tributo a todas as noites do itinerário se alguma data do itinerário se sobrepuser a uma data no período da estadia.
  • overlap: aplica o tributo apenas às noites em o itinerário que se sobrepõe a uma data no período da estadia.

    Observação: overlap é válido somente 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, de o período. Essa data deve ser anterior ou igual à data end. Se start não for especificada, a data é 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. A data precisa ser igual ou posterior a start. data. Se end não for especificada, a data período é 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. Caso contrário especificado, todos os dias são permitidos no período. Cada 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 à taxa final
  • cumulative_percent: Uma porcentagem do taxa total, impostos e taxas acumulados antes do cálculo do esse tributo ou taxa. Se esse valor for especificado, <Rank> também precisam ser especificadas.
  • <Brackets> e <AgeBrackets> não pode ser especificado 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> foi adicionado a a tarifa total da estadia.
  • night: O <Amount> foi 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ó se aplica se <Type> for definido como amount e <Period> são definidos como noite.

Restringe o número de noites em que um tributo pode ser aplicado.

Especifique max ou excluded, mas não os dois.

TaxFeeInfo / Property / Taxes / Tax / ApplicableNights / @max 0..1 integer <ApplicableNights max="N"> indica que as noites após as primeiras N diárias serão excluídos.
TaxFeeInfo / Property / Taxes / Tax / ApplicableNights / @excluded 0..1 integer <ApplicableNights excluded="N"> indica que o As primeiras N noites devem 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 limites.
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 sobre o GST da Índia.

Este elemento só é válido quando <Period> é definido como night e <Amount> não estão especificados.

TaxFeeInfo / Property / Taxes / Tax / Brackets / @base_amount 0..1 float O valor do percentual ou valor dos tributos aplicado às tarifas noturnas abaixo do valor starts_at do primeiro colchete.
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 subsequente. Não há limite superior para o último colchete.

Uma faixa fiscal fica ativa quando a tarifa por noite é maior ou igual a ao valor starts_at do colchete e estritamente menor que o valor starts_at do colchete seguinte.

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 nos ocupantes idades.

Este elemento só é válido quando <Brackets> e <Amount> não forem especificadas, <Basis> é definido como person e <Type> está 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 armazenar um ou mais <ChildAgeBracket> os elementos.
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 do colchete anterior + 1. Os limites superior e inferior são inclusivos. O limite inferior do 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 são aplicados incluídos ou excluídos. Se estiver presente, os impostos só serão incluídos ou excluído 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 somente aos usuários do países listados.

Por outro lado, se o campo Userpaíses type for exclude, os impostos serão aplicados somente aos usuários fora do países listados.

Se o campo User countries type não estiver definido, ele será tratado como include e o imposto será aplicado somente aos usuários do 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 CLDR como DE ou FR. Para alguns países, o código de país CLDR não é igual ao código ISO de duas letras código do país. 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 Defina como cumulative_percent. Em geral, essa ordem é aplicados em tributos e taxas. Valores de classificação duplicados são permitidos entre impostos e taxas, mas isso pode resultar em um comportamento indefinido, em que tarifas e tributos 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 tem suporte para <Fee> com a mesma sintaxe.

Exemplos

Há um limite de 300 tributos e taxas por propriedade. Consulte a "Excluir tributos" exemplo 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="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 que 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 o seguinte 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 da solicitação de TaxFeeInfo.
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> são presentes em cada mensagem.

TaxFeeInfoResponse / Issues 0..1 Issues Um contêiner para um ou mais problemas encontrados durante o processamento da TaxFeeInfo mensagem.

<Success> ou <Issues> são presentes em cada mensagem.

TaxFeeInfoResponse / Issues / Issue 1..n Issue A descrição de um aviso, erro ou falha encontrado processando a mensagem TaxFeeInfo. Confira os 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

Veja a seguir uma resposta a uma TaxFeeInfo processada mensagem.

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