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]</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>
      </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]</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>
      </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 tributos e taxas para uma única propriedade.
TaxFeeInfo / @timestamp	1	DateTime	A data e a hora da criação desta mensagem.
TaxFeeInfo / @id	1	string	Um identificador exclusivo da 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 da string é o valor de "Chave do parceiro" listado na página "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 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 para uma única propriedade.
TaxFeeInfo / Property / @action	0..1	string	Especifica como a atualização é aplicada. Somente `overlay` é compatível, e o padrão é `overlay`. Qualquer `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 deve corresponder ao código do hotel especificado usando <id> no elemento <listing> no Feed de lista de hotéis. O ID do hotel também é listado 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	Recipiente para uma lista de tipos de quarto a que os impostos se aplicam. O imposto é aplicado a cada `<RoomType>` especificado. Se `<RoomTypes>` não for especificado, o imposto será aplicado a todas as salas.
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 Transaction (Property Data) e conforme 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 de Transaction (Property Data). O número máximo de caracteres permitidos é 50.
TaxFeeInfo / Property / Taxes / Tax / RatePlans	0..1	RatePlans	Recipiente para uma lista de planos de tarifas aos quais os impostos se aplicam. Se `<RatePlans>` não for especificado, o imposto será aplicado a todos os planos de tarifas.
TaxFeeInfo / Property / Taxes / Tax / RatePlans / RatePlan	1..n	RatePlan	Especifica um plano de tarifas. Um plano de tarifação é definido por uma combinação de pacote, tarifas e disponibilidade, conforme definido nas mensagens Transaction (Property Data), OTA_HotelRateAmountNotifRQ e OTA_HotelAvailNotifRQ, e 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 PackageID em `<PackageData>` em uma mensagem Transaction (Property Data) e no atributo `RatePlanCode` em `<StatusApplicationControl>` em 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 para um ou mais períodos que definem quando a reserva precisa ocorrer para que o imposto seja aplicado.
TaxFeeInfo / Property / Taxes / Tax / BookingDates / DateRange	1..99	DateRange	Um período que especifica quando a reserva precisa ocorrer para que o imposto seja aplicado.
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 anterior ou igual à data `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 de `start`. Se `end` não for especificado, o período será efetivamente ilimitado em termos de uma data de término.
TaxFeeInfo / Property / Taxes / Tax / BookingDates / DateRange / @days_of_week	0..1	string	Os dias da semana que são 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 dias úteis 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 imposto seja aplicado.
TaxFeeInfo / Property / Taxes / Tax / CheckinDates / DateRange	1..20	DateRange	Um período que especifica quando o check-in deve ocorrer para que o imposto seja aplicado.
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 anterior ou igual à data `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á efetivamente ilimitado em termos de uma data de término.
TaxFeeInfo / Property / Taxes / Tax / CheckinDates / DateRange / @days_of_week	0..1	string	Os dias da semana que são 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 dias úteis 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 quando o check-out precisa ocorrer para que o imposto seja aplicado.
TaxFeeInfo / Property / Taxes / Tax / CheckoutDates / DateRange	1..20	DateRange	Um período que especifica quando a finalização de compra precisa ocorrer para que o imposto seja aplicado.
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 anterior ou igual à data `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 de `start`. Se `end` não for especificado, o período será efetivamente ilimitado em termos de uma data de término.
TaxFeeInfo / Property / Taxes / Tax / CheckoutDates / DateRange / @days_of_week	0..1	string	Os dias da semana que são 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 dias úteis 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 o imposto deve ser aplicado. 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 os tributos a todas as noites no itinerário se alguma data no itinerário se sobrepuser a uma data no período de estadia. `overlap`: aplica os tributos apenas às noites no 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 ser sempre especificado.
TaxFeeInfo / Property / Taxes / Tax / StayDates / DateRange	1..99	DateRange	Um período que especifica as datas em que os impostos devem ser 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 anterior ou igual à data `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á efetivamente ilimitado em termos de uma data de término.
TaxFeeInfo / Property / Taxes / Tax / StayDates / DateRange / @days_of_week	0..1	string	Os dias da semana que são 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 dias úteis 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:` Porcentagem da taxa total `amount:` um valor fixo a ser adicionado à taxa final
TaxFeeInfo / Property / Taxes / Tax / Basis	1	enum	Os valores válidos são: `room:` O `<Amount>` é aplicado à sala. `person:` O `<Amount>` é aplicado por pessoa. Esse valor só será aplicado se `<Type>` estiver definido como um valor.
TaxFeeInfo / Property / Taxes / Tax / Period	1	enum	Os valores válidos são: `stay:` O valor de `<Amount>` é adicionado à taxa 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 imposto (por exemplo: USD).
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>` estiver definido como amount e `<Period>` como night. Restringe o número de noites para as quais um imposto 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 depois das primeiras N noites precisam ser excluídas.
TaxFeeInfo / Property / Taxes / Tax / ApplicableNights / @excluded	0..1	integer	`<ApplicableNights excluded="N">` indica que as primeiras N noites serão excluídas.
TaxFeeInfo / Property / Taxes / Tax / LengthOfStay	0..1	LengthOfStay	Define os limites de duração da estadia dentro da qual este imposto pode ser aplicado. O imposto 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	A quantidade mínima de noites permitidas na estadia para que os tributos sejam aplicados. Se isso não for especificado, não haverá um valor mínimo.
TaxFeeInfo / Property / Taxes / Tax / LengthOfStay / @max	0..1	integer	O número 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 chaves fiscais contíguas e não sobrepostas, por exemplo, impostos sobre as taxas de GST da Índia. Esse elemento é válido somente quando `<Period>` está definido como `night` e `<Amount>` não está especificado.
TaxFeeInfo / Property / Taxes / Tax / Brackets / @base_amount	0..1	float	O valor percentual ou tributário aplicado a taxas noturnas abaixo do valor de `starts_at` entre os primeiros colchetes.
TaxFeeInfo / Property / Taxes / Tax / Brackets / Bracket	1..n	Bracket	Define uma faixa de tributos com base nas diárias.
TaxFeeInfo / Property / Taxes / Tax / Brackets / Bracket / @starts_at	1	float	Define o limite inferior de um colchete fiscal. O limite superior é especificado no campo `starts_at` do colchete subsequente. Não há limite superior para o último colchete. Um colchete fiscal fica ativo quando a taxa noturna é maior ou igual ao valor `starts_at` do colchete e estritamente menor que o valor `starts_at` do colchete subsequente. Esse valor precisa ser estritamente maior que 0.
TaxFeeInfo / Property / Taxes / Tax / Brackets / Bracket / @amount	1	float	O valor do percentual ou valor dos tributos aplicados a essa chave.
TaxFeeInfo / Property / Taxes / Tax / AgeBrackets	0..1	AgeBrackets	Permite especificar um conjunto de tributos com base na idade dos ocupantes. Esse elemento é válido somente quando `<Brackets>` e `<Amount>` não estão especificados, `<Basis>` está definido como `person` e `<Type>` está definido como `amount`.
TaxFeeInfo / Property / Taxes / Tax / AgeBrackets / AdultCharge	0..1	AdultCharge	Contêiner para especificar impostos para adultos.
TaxFeeInfo / Property / Taxes / Tax / AgeBrackets / AdultCharge / @amount	1	float	O valor fixo de tributos aplicados para adultos.
TaxFeeInfo / Property / Taxes / Tax / AgeBrackets / ChildAgeBrackets	0..1	ChildAgeBrackets	Contêiner para manter 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 fiscal correspondente.
TaxFeeInfo / Property / Taxes / Tax / AgeBrackets / ChildAgeBrackets / ChildAgeBracket / @max_age	1	integer	Define o limite superior da idade de um filho. O limite inferior é especificado no campo `max_age` do colchete anterior + 1. Os limites superior e inferior são inclusivos. O limite inferior do 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 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 para os quais o imposto está incluído ou excluído. Se estiver presente, o imposto 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 UserCountries. Os valores válidos são `include` e `exclude`. Se o UserCountries `type` estiver definido como `include`, o imposto só será aplicado aos usuários dos países listados. Considerando que, se o UserCountries `type` for `exclude`, o imposto será aplicado apenas aos usuários fora dos países listados. Se a `type` não for definida, ela será tratada como `include`, e o tributo só será aplicado aos 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 CLDR, como `DE` ou `FR`. Em alguns países, o código de país CLDR não é igual ao código de duas letras do ISO. Além disso, os códigos de região CLDR não são compatíveis.
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 para o 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>

Tributos de laje

Imposto de tributação do IBS da Índia aplicado com base nas tarifas por noite. Os colchetes são:

Não há impostos se a tarifa noturna é menor ou igual a 1.000.
12% de impostos se a tarifa noturna for maior que 1.000 e menor ou igual a 7.500.
18% de impostos se a tarifa diária 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>

Impostos baseados na idade

Impostos aplicados com base na idade dos ocupantes:

Imposto de US$ 20 para adultos.
Imposto de US$ 10 para crianças entre 11 e 17 anos.
Imposto 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 da criação desta 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 com êxito 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 ao processar a 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 encontrado ao processar a mensagem TaxFeeInfo. Veja 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 mensagem do 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>

Issues

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>