TaxFeeInfo

Richieste

Sintassi

Il messaggio TaxFeeInfo utilizza la seguente sintassi:

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

Elementi e attributi

Il messaggio TaxFeeInfo contiene i seguenti elementi e attributi:

Elemento / @attributo Occorrenze Tipo Descrizione
TaxFeeInfo 1 Complex element L'elemento principale di un messaggio che definisce le tasse e le commissioni di un singolo proprietà.
TaxFeeInfo / @timestamp 1 DateTime La data e l'ora di creazione di questo messaggio.
TaxFeeInfo / @id 1 string Un identificatore univoco per questo messaggio di richiesta. Questo valore viene restituito nel messaggio di risposta. I caratteri consentiti sono a-z, A-Z 0-9 _ (trattino basso) e - (trattino).
TaxFeeInfo / @partner 1 string L'account partner per questo messaggio. Questo valore di stringa corrisponde alla "Chiave del partner" valore indicato il Impostazioni account in Hotel Center.

Nota: se hai un backend che fornisce feed per più account, questo valore deve corrispondere a ID specificato nel campo <RequestorID> elemento di <OTA_HotelRateAmountNotifRQ> e <OTA_HotelAvailNotifRQ> messaggi per lo stesso account.

TaxFeeInfo / Property 1..n Property Un contenitore per la definizione di tasse e commissioni di una singola proprietà.
TaxFeeInfo / Property / @action 0..1 string Specifica il modo in cui viene applicato l'aggiornamento. Solo overlay è supportati e il valore predefinito è overlay. Qualsiasi precedente I valori Taxes e Fees per questa proprietà saranno eliminate prima dell'applicazione dell'aggiornamento.
TaxFeeInfo / Property / ID 1 string L'identificatore univoco della struttura. Questo valore deve corrispondere alla ID hotel specificato utilizzando <id> nel L'elemento <listing> nell'elemento Hotel Feed elenco. L'ID hotel è indicato anche in Hotel Center.
TaxFeeInfo / Property / Taxes 0..1 Taxes Contenitore per uno o più elementi <Tax>.
TaxFeeInfo / Property / Taxes / Tax 1..n Tax Una tassa individuale applicabile alla proprietà.
TaxFeeInfo / Property / Taxes / Tax / RoomTypes 0..1 RoomTypes Contenitore di un elenco dei tipi di camera a cui si applica la tassa. L'imposta viene applicata a ogni <RoomType> specificato. Se <RoomTypes> non è specificato, Le tasse si applicano a tutte le camere.
TaxFeeInfo / Property / Taxes / Tax / RoomTypes / RoomType 1..n RoomType Specifica un tipo di camera. Il tipo di camera è definito in <RoomData> elemento in un Transaction (Property Data) e così via identificato mediante il relativo RoomID. (È Il valore <RoomID> fa riferimento anche dal Attributo InvTypeCode in OTA_HotelRateAmountNotifRQ messages.)
TaxFeeInfo / Property / Taxes / Tax / RoomTypes / RoomType / @id 1 string L'identificatore univoco dell'inventario (tipo di camera). Questo valore viene mappato a <RoomID> in una transazione (Property Data). Il numero massimo di caratteri consentiti è 50.
TaxFeeInfo / Property / Taxes / Tax / RatePlans 0..1 RatePlans Contenitore di un elenco di piani tariffari a cui si applica la tassa. Se <RatePlans> non è specificato, la tassa si applica a tutti i piani tariffari.
TaxFeeInfo / Property / Taxes / Tax / RatePlans / RatePlan 1..n RatePlan Specifica un piano tariffario. Un piano tariffario è definito da una combinazione di pacchetto, tariffe e disponibilità, come definiti nella sezione Transazione (Dati della proprietà), OTA_HotelRateAmountNotifRQ e OTA_HotelAvailNotifRQ e come identificato dal valore
TaxFeeInfo / Property / Taxes / Tax / RatePlans / RatePlan / @id 1 string L'identificatore univoco del piano tariffario. Questo valore viene mappato Il valore PackageID nel campo Messaggio Transaction (Property Data) <PackageData> e il valore RatePlanCode impostato sotto il Attributo <StatusApplicationControl> in entrambi <OTA_HotelRateAmountNotifRQ> e <OTA_HotelAvailNotifRQ> messaggi. Il numero massimo di caratteri consentiti è 50.
TaxFeeInfo / Property / Taxes / Tax / BookingDates 0..1 BookingDates Un contenitore di uno o più intervalli di date che definiscono il momento in cui la prenotazione deve essere perché l'imposta venga applicata.
TaxFeeInfo / Property / Taxes / Tax / BookingDates / DateRange 1..99 DateRange Un intervallo di date che specifica quando deve avvenire la prenotazione affinché l'imposta applicati.
TaxFeeInfo / Property / Taxes / Tax / BookingDates / DateRange / @start 0..1 Date La data di inizio (in base al fuso orario della proprietà), inclusa, di l'intervallo di date. Questa data deve essere precedente o uguale alla data Data end. Se start non è specificato, la data è di fatto illimitato in termini di data di inizio.
TaxFeeInfo / Property / Taxes / Tax / BookingDates / DateRange / @end 0..1 Date La data di fine (in base al fuso orario della proprietà), inclusa, della data intervallo di date. Questa data deve essere uguale o successiva alla data start data. Se end non è specificato, la data è effettivamente illimitato in termini di data di fine.
TaxFeeInfo / Property / Taxes / Tax / BookingDates / DateRange / @days_of_week 0..1 string

I giorni della settimana consentiti nell'intervallo di date. In caso contrario specificato, sono consentiti tutti i giorni nell'intervallo di date. Ciascuna nella stringa specifica un giorno. Ad esempio, "MTWHF" specifica determinati giorni della settimana sono consentiti nell'intervallo di date.

I caratteri validi sono:

  • M per lunedì
  • T per martedì
  • W per mercoledì
  • H per giovedì
  • F per venerdì
  • S per sabato
  • U per domenica

È valida qualsiasi combinazione di caratteri.

TaxFeeInfo / Property / Taxes / Tax / CheckinDates 0..1 CheckinDates Un contenitore di uno o più intervalli di date che definiscono il momento in cui deve essere effettuato il check-in per l'applicazione dell'imposta.
TaxFeeInfo / Property / Taxes / Tax / CheckinDates / DateRange 1..20 DateRange Un intervallo di date che specifica il periodo in cui deve essere effettuato il check-in affinché l'imposta .
TaxFeeInfo / Property / Taxes / Tax / CheckinDates / DateRange / @start 0..1 Date La data di inizio (in base al fuso orario della proprietà), inclusa, di l'intervallo di date. Questa data deve essere precedente o uguale alla data Data end. Se start non è specificato, la data è di fatto illimitato in termini di data di inizio.
TaxFeeInfo / Property / Taxes / Tax / CheckinDates / DateRange / @end 0..1 Date La data di fine (in base al fuso orario della proprietà), inclusa, della data intervallo di date. Questa data deve essere uguale o successiva alla data start data. Se end non è specificato, la data è effettivamente illimitato in termini di data di fine.
TaxFeeInfo / Property / Taxes / Tax / CheckinDates / DateRange / @days_of_week 0..1 string

I giorni della settimana consentiti nell'intervallo di date. In caso contrario specificato, sono consentiti tutti i giorni nell'intervallo di date. Ciascuna nella stringa specifica un giorno. Ad esempio, "MTWHF" specifica determinati giorni della settimana sono consentiti nell'intervallo di date.

I caratteri validi sono:

  • M per lunedì
  • T per martedì
  • W per mercoledì
  • H per giovedì
  • F per venerdì
  • S per sabato
  • U per domenica

È valida qualsiasi combinazione di caratteri.

TaxFeeInfo / Property / Taxes / Tax / CheckoutDates 0..1 CheckoutDates Un contenitore di uno o più intervalli di date che definiscono il momento del pagamento perché l'imposta venga applicata.
TaxFeeInfo / Property / Taxes / Tax / CheckoutDates / DateRange 1..20 DateRange Un intervallo di date che specifica il periodo in cui deve essere effettuato il check-out affinché l'imposta .
TaxFeeInfo / Property / Taxes / Tax / CheckoutDates / DateRange / @start 0..1 Date La data di inizio (in base al fuso orario della proprietà), inclusa, di l'intervallo di date. Questa data deve essere precedente o uguale alla data Data end. Se start non è specificato, la data è di fatto illimitato in termini di data di inizio.
TaxFeeInfo / Property / Taxes / Tax / CheckoutDates / DateRange / @end 0..1 Date La data di fine (in base al fuso orario della proprietà), inclusa, della data intervallo di date. Questa data deve essere uguale o successiva alla data start data. Se end non è specificato, la data è effettivamente illimitato in termini di data di fine.
TaxFeeInfo / Property / Taxes / Tax / CheckoutDates / DateRange / @days_of_week 0..1 string

I giorni della settimana consentiti nell'intervallo di date. In caso contrario specificato, sono consentiti tutti i giorni nell'intervallo di date. Ciascuna nella stringa specifica un giorno. Ad esempio, "MTWHF" specifica determinati giorni della settimana sono consentiti nell'intervallo di date.

I caratteri validi sono:

  • M per lunedì
  • T per martedì
  • W per mercoledì
  • H per giovedì
  • F per venerdì
  • S per sabato
  • U per domenica

È valida qualsiasi combinazione di caratteri.

TaxFeeInfo / Property / Taxes / Tax / StayDates 0..1 StayDates

Un contenitore di uno o più intervalli di date che determinano se l'imposta viene applicata, ad esempio per adeguarsi agli sconti stagionali.

TaxFeeInfo / Property / Taxes / Tax / StayDates / @application 1 enum

Descrive come applicare l'imposta.

I valori validi sono:

  • all: applica l'imposta a ogni notte nell'intervallo di date itinerario se tutte le date nell'itinerario si sovrappongono con le date del soggiorno.
  • any: applica la tassa a tutte le notti in itinerario se una data dell'itinerario si sovrappone a una data nell'intervallo dell'intervallo di date del soggiorno.
  • overlap: applica la tassa solo alle notti nel seguente paese: L'itinerario che si sovrappone a una data nell'intervallo di date del soggiorno.

    Nota: overlap è valido solo se <Period> è impostato su night.

Questo attributo deve essere sempre specificato.

TaxFeeInfo / Property / Taxes / Tax / StayDates / DateRange 1..99 DateRange Un intervallo di date che specifica le date in cui deve essere applicata la tassa.
TaxFeeInfo / Property / Taxes / Tax / StayDates / DateRange / @start 0..1 Date La data di inizio (in base al fuso orario della proprietà), inclusa, di l'intervallo di date. Questa data deve essere precedente o uguale alla data Data end. Se start non è specificato, la data è di fatto illimitato in termini di data di inizio.
TaxFeeInfo / Property / Taxes / Tax / StayDates / DateRange / @end 0..1 Date La data di fine (in base al fuso orario della proprietà), inclusa, della data intervallo di date. Questa data deve essere uguale o successiva alla data start data. Se end non è specificato, la data è effettivamente illimitato in termini di data di fine.
TaxFeeInfo / Property / Taxes / Tax / StayDates / DateRange / @days_of_week 0..1 string

I giorni della settimana consentiti nell'intervallo di date. In caso contrario specificato, sono consentiti tutti i giorni nell'intervallo di date. Ciascuna nella stringa specifica un giorno. Ad esempio, "MTWHF" specifica determinati giorni della settimana sono consentiti nell'intervallo di date.

I caratteri validi sono:

  • M per lunedì
  • T per martedì
  • W per mercoledì
  • H per giovedì
  • F per venerdì
  • S per sabato
  • U per domenica

È valida qualsiasi combinazione di caratteri.

TaxFeeInfo / Property / Taxes / Tax / Type 1 enum

I valori validi sono:

  • percent: Una percentuale della tariffa totale
  • amount: Un importo fisso da aggiungere alla tariffa finale
  • cumulative_percent: Una percentuale del l'aliquota totale, le tasse e le commissioni accumulate prima del calcolo questa imposta o commissione. Se questo valore viene specificato, <Rank> è necessario specificare anche un valore.
  • <Brackets> e <AgeBrackets> non può essere specificato con cumulative_percent come tipo.

TaxFeeInfo / Property / Taxes / Tax / Basis 1 enum

I valori validi sono:

  • room: Il <Amount> viene applicato alla stanza.
  • person: L'offerta <Amount> viene applicata a persona. Questo valore si applica solo se <Type> è impostato sull'importo.
TaxFeeInfo / Property / Taxes / Tax / Period 1 enum

I valori validi sono:

  • stay: Il <Amount> è stato aggiunto a la tariffa totale del soggiorno.
  • night: Il <Amount> è stato aggiunto per notte di soggiorno.
TaxFeeInfo / Property / Taxes / Tax / Currency 0..1 string Il codice valuta di tre lettere della tassa (ad es. USD).
TaxFeeInfo / Property / Taxes / Tax / Amount 0..1 float Il valore della percentuale o dell'importo della tassa.
TaxFeeInfo / Property / Taxes / Tax / ApplicableNights 0..1 ApplicableNights Questo valore si applica solo se <Type> è impostato su amount e <Period> è impostato su notte.

Vincola il numero di notti a cui può essere applicata una tassa.

Puoi specificare max o excluded, ma non entrambi.

TaxFeeInfo / Property / Taxes / Tax / ApplicableNights / @max 0..1 integer <ApplicableNights max="N"> indica che le notti dopo le prime N notti.
TaxFeeInfo / Property / Taxes / Tax / ApplicableNights / @excluded 0..1 integer <ApplicableNights excluded="N"> indica che le prime N notti devono essere escluse.
TaxFeeInfo / Property / Taxes / Tax / LengthOfStay 0..1 LengthOfStay Definisce i limiti di durata del soggiorno entro i quali può essere applicata questa tassa. La tassa non viene applicata se la durata del soggiorno non rientra tra i valori minimo e massimo limiti.
TaxFeeInfo / Property / Taxes / Tax / LengthOfStay / @min 0..1 integer Il numero minimo di notti consentito per il soggiorno ai fini dell'applicazione della tassa. Se non specificato, non è previsto un limite minimo.
TaxFeeInfo / Property / Taxes / Tax / LengthOfStay / @max 0..1 integer Il numero massimo di notti consentito per il soggiorno ai fini dell'applicazione della tassa. Se non specificato, non è previsto un limite massimo.
TaxFeeInfo / Property / Taxes / Tax / Brackets 0..1 Brackets Contenitore per uno o più elementi <Bracket>. Definisce un insieme di scaglioni fiscali contigui e non sovrapposti. Ad esempio: imposte GST indiana (GST).

Questo elemento è valido solo quando <Period> è impostato su night e <Amount> non sono specificati.

TaxFeeInfo / Property / Taxes / Tax / Brackets / @base_amount 0..1 float Il valore della percentuale o dell'importo della tassa applicata alle tariffe per notte sotto il valore di starts_at della prima parentesi.
TaxFeeInfo / Property / Taxes / Tax / Brackets / Bracket 1..n Bracket Definisce uno scaglione d'imposta basato sulle tariffe per notte.
TaxFeeInfo / Property / Taxes / Tax / Brackets / Bracket / @starts_at 1 float

Definisce il limite inferiore di uno scaglione fiscale. Il limite superiore è specificato nel campo starts_at della parentesi quadra successiva. Non esiste un limite superiore per l'ultima parentesi.

Una fascia d'imposta è attiva quando la tariffa per notte è maggiore o uguale a al valore starts_at della parentesi e rigorosamente minore di il valore starts_at della parentesi successiva.

Questo valore deve essere strettamente maggiore di 0.

TaxFeeInfo / Property / Taxes / Tax / Brackets / Bracket / @amount 1 float Il valore della percentuale o dell'importo di imposta applicata a questo scaglione fiscale.
TaxFeeInfo / Property / Taxes / Tax / AgeBrackets 0..1 AgeBrackets Consente di specificare una serie di tasse in base alle età.

Questo elemento è valido solo quando <Brackets> e <Amount> non sono specificati, <Basis> è impostato su person e <Type> è impostato su amount.

TaxFeeInfo / Property / Taxes / Tax / AgeBrackets / AdultCharge 0..1 AdultCharge Contenitore per specificare le tasse per gli adulti.
TaxFeeInfo / Property / Taxes / Tax / AgeBrackets / AdultCharge / @amount 1 float L'importo fisso della tassa applicata per gli adulti.
TaxFeeInfo / Property / Taxes / Tax / AgeBrackets / ChildAgeBrackets 0..1 ChildAgeBrackets Contenitore per contenere uno o più <ChildAgeBracket> elementi.
TaxFeeInfo / Property / Taxes / Tax / AgeBrackets / ChildAgeBrackets / ChildAgeBracket 1..n ChildAgeBracket Definisce una fascia di età per i bambini e l'importo delle tasse corrispondente.
TaxFeeInfo / Property / Taxes / Tax / AgeBrackets / ChildAgeBrackets / ChildAgeBracket / @max_age 1 integer

Definisce il limite superiore di età di un bambino. Il limite inferiore è specificato nel campo max_age della parentesi quadra precedente + 1. I limiti superiore e inferiore sono entrambi inclusi. Il limite inferiore per la prima parentesi è 0.

Il valore max_age deve essere compreso tra 0 e 17 (inclusi).

TaxFeeInfo / Property / Taxes / Tax / AgeBrackets / ChildAgeBrackets / ChildAgeBracket / @amount 1 float L'importo fisso delle tasse applicato ai bambini in questa fascia d'età.
TaxFeeInfo / Property / Taxes / Tax / UserCountries 0..1 UserCountries Contenitore dell'elenco dei paesi degli utenti per i quali la tassa è inclusi o esclusi. Se presente, l'imposta verrà inclusa o escluso per gli utenti dei paesi specificati.
TaxFeeInfo / Property / Taxes / Tax / UserCountries / @type 0..1 enum Il tipo di specifica UserCountries.

I valori validi sono include e exclude.

Se il valore type UserCountries è impostato come include, l'imposta verrà applicata solo agli utenti dei seguenti paesi: paesi elencati.

Invece se il valore typeUserCountries è exclude, l'imposta verrà applicata solo agli utenti al di fuori del seguente paese: paesi elencati.

Se il valore type UserCountries non viene impostato, verrà trattato come include e l'imposta verrà applicata solo agli utenti dei seguenti paesi: paesi elencati.

TaxFeeInfo / Property / Taxes / Tax / UserCountries / Country 1..n Country Definisce un paese nell'elenco di UserCountries.
TaxFeeInfo / Property / Taxes / Tax / UserCountries / Country / @code 1 string Un codice paese CLDR come DE o FR. Tieni presente che, per alcuni paesi, il codice paese CLDR non corrisponde all'ISO di due lettere il prefisso internazionale del paese. Inoltre, i codici regione CLDR non sono supportati.
TaxFeeInfo / Property / Taxes / Tax / Rank 1 integer

Un ranking che specifica l'ordine di applicazione di questa imposta o commissione. Ad esempio, il valore 2 indica che questa imposta verrà applicata per seconda. Questo elemento deve sempre essere specificato se <Type> è impostato su cumulative_percent. In generale, questo ordine è sia per le tasse che per le commissioni. Sono consentiti valori di ranking duplicati tasse e commissioni, ma ciò può portare a un comportamento indefinito tasse e commissioni verranno applicate in modo arbitrario e cumulativo. Le tasse e le commissioni senza ranking vengono applicate prima di tutti i contenuti classificati.

Il valore <Rank> deve essere compreso tra 1 e 99 (inclusi).

TaxFeeInfo / Property / Fees 0..1 Fees Contenitore per uno o più elementi <Fee>.
TaxFeeInfo / Property / Fees / Fee 1..n Fee

Una tariffa individuale applicabile alla proprietà.

Anche tutti gli elementi secondari di <Tax> sono supportato per <Fee> con la stessa sintassi.

Esempi

Esiste un limite di 300 tasse e commissioni per proprietà. Consulta le "Elimina tasse" esempio per rimuovere tasse e commissioni da una proprietà.

Messaggio di base

Un messaggio TaxFeeInfo di base:

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

Elimina tasse

Elimina tutte le tasse e le commissioni a livello di struttura per l'hotel specificato:

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

Imposta con piano

Imposta GST (GST) indiana applicata in base alle tariffe per notte. Le fasce d'imposta sono:

  • Nessuna imposta se la tariffa per notte è inferiore o uguale a 1000.
  • Tassa del 12% se la tariffa per notte è maggiore di 1000 e minore di o pari a 7500.
  • Tassa del 18% se la tariffa per notte è superiore a 7500.
<?xml version="1.0" encoding="UTF-8"?>
<TaxFeeInfo timestamp="2020-05-18T16:20:00-04:00"
            id="12345678"
            partner="partner_key">
  <Property>
    <ID>Property_1</ID>
    <Taxes>
      <Tax>
        <Type>percent</Type>
        <Basis>room</Basis>
        <Period>night</Period>
        <Brackets base_amount="0">
          <Bracket starts_at="1000.01" amount="12"/>
          <Bracket starts_at="7500.01" amount="18"/>
        </Brackets>
      </Tax>
    </Taxes>
  </Property>
</TaxFeeInfo>

Tasse basate sull'età

Tasse applicate in base all'età degli ospiti:

  • Tassa di 20 $ per gli adulti.
  • Tassa di 10 $ per i bambini di età compresa tra 11 e 17 anni.
  • Tassa di 5 $ per i bambini di età compresa tra 0 e 10 anni.
<?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>

Risposte

Sintassi

Il messaggio TaxFeeInfoResponse utilizza la seguente sintassi:

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

Elementi e attributi

Il messaggio TaxFeeInfoResponse contiene quanto segue elementi e attributi:

Elemento / @attributo Occorrenze Tipo Descrizione
TaxFeeInfoResponse 1 Complex element L'elemento principale che indica l'esito positivo o negativo di un Messaggio di richiesta TaxFeeInfo.
TaxFeeInfoResponse / @timestamp 1 DateTime La data e l'ora di creazione di questo messaggio.
TaxFeeInfoResponse / @id 1 string L'identificatore univoco del messaggio TaxFeeInfo associato.
TaxFeeInfoResponse / @partner 1 string L'account partner per questo messaggio.
TaxFeeInfoResponse / Success 0..1 Success Indica che il messaggio TaxFeeInfo è stato elaborato correttamente senza avvisi o errori.

<Success> o <Issues> sono presenti in ogni messaggio.

TaxFeeInfoResponse / Issues 0..1 Issues Un container per uno o più problemi riscontrati durante l'elaborazione TaxFeeInfo messaggio.

<Success> o <Issues> sono presenti in ogni messaggio.

TaxFeeInfoResponse / Issues / Issue 1..n Issue La descrizione di un avviso, un errore o un errore riscontrato durante durante l'elaborazione del messaggio TaxFeeInfo. Puoi trovare i dettagli su questi problemi nella sezione Messaggi di errore relativi allo stato dei feed.
TaxFeeInfoResponse / Issues / Issue / @code 1 integer L'identificatore del problema.
TaxFeeInfoResponse / Issues / Issue / @status 1 enum

Il tipo di problema riscontrato.

I valori validi sono warning, error, e failure .

Esempi

Operazione riuscita

Di seguito è riportata una risposta a una richiesta TaxFeeInfo elaborata correttamente .

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

Problemi

Di seguito è riportata una risposta a un messaggio TaxFeeInfo non elaborato a causa di errori.

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