OTA_HotelRateAmountNotifRQ

Richieste

Sintassi

Il messaggio OTA_HotelRateAmountNotifRQ utilizza la seguente sintassi:

<?xml version="1.0" encoding="UTF-8"?>
<OTA_HotelRateAmountNotifRQ xmlns="http://www.opentravel.org/OTA/2003/05"
                            EchoToken="message_ID"
                            TimeStamp="timestamp"
                            Version="3.0"
                            NotifType="[Overlay|Delta|Remove]"
                            NotifScopeType="[ProductRate]">
  <POS>
    <Source>
      <RequestorID ID="partner_key"/>
    </Source>
  </POS>
  <RateAmountMessages HotelCode="HotelID">
    <RateAmountMessage>
      <StatusApplicationControl Start="YYYY-MM-DD"
                                End="YYYY-MM-DD"
                                Mon="boolean_value"
                                Tue="boolean_value"
                                Weds="boolean_value"
                                Thur="boolean_value"
                                Fri="boolean_value"
                                Sat="boolean_value"
                                Sun="boolean_value"
                                InvTypeCode="RoomID"
                                RatePlanCode="PackageID"
                                RatePlanType="[26]" />
      <Rates>
        <Rate>
          <BaseByGuestAmts>
            <BaseByGuestAmt AmountBeforeTax="float"
                            AmountAfterTax="float"
                            CurrencyCode="currency"
                            NumberOfGuests="integer"/>
          </BaseByGuestAmts>
          <AdditionalGuestAmounts>
            <AdditionalGuestAmount Amount="float"
                                   AgeQualifyingCode="[10|8]"
                                   MaxAge="integer"/>
          </AdditionalGuestAmounts>
        </Rate>
      </Rates>
    </RateAmountMessage>
  </RateAmountMessages>
</OTA_HotelRateAmountNotifRQ>

Elementi e attributi

Il messaggio OTA_HotelRateAmountNotifRQ contiene i seguenti elementi e attributi:

Elemento / @attributo Occorrenze Tipo Descrizione
OTA_HotelRateAmountNotifRQ 1 Complex element L'elemento principale di un messaggio relativo alle tariffe.
OTA_HotelRateAmountNotifRQ / @xmlns 0..1 string (URI) Lo spazio dei nomi XML.
OTA_HotelRateAmountNotifRQ / @EchoToken 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, _ (underscore) e - (dash).
OTA_HotelRateAmountNotifRQ / @TimeStamp 1 DateTime La data e l'ora di creazione di questo messaggio.
OTA_HotelRateAmountNotifRQ / @Version 1 decimal La versione del messaggio OpenTravel.
OTA_HotelRateAmountNotifRQ / @NotifType 0..1 enum

Il tipo di notifica da applicare a ogni <RateAmountMessage>.

I valori validi sono:

Per capire come funzionano questi attributi, consulta gli esempi.

  • Overlay: Elimina tutti i tariffe in base al numero di persone per tipo di camera, piano tariffario e date specificato in <StatusApplicationControl> e sostituirle con nuove tariffe.
  • Remove: Elimina tutte le voci esistenti tariffe in base al numero di persone per tipo di camera, piano tariffario e date specificato in <StatusApplicationControl>.
  • Delta: (il valore predefinito se NotifType non è specificato) Aggiungi o aggiorna le tariffe esistenti in base al numero di persone per il tipo di camera, il piano tariffario e le date specificate in <StatusApplicationControl>.
OTA_HotelRateAmountNotifRQ / @NotifScopeType 0..1 enum

L'ambito delle NotifType da applicare a ogni <RateAmountMessage>.

I valori validi sono:

  • ProductRate: (il valore predefinito se NotifScopeType non è specificato) Il parametro NotifType si applica a prodotti: combinazioni di tipo di camera (InvTypeCode) e piano tariffario (RatePlanCode).
OTA_HotelRateAmountNotifRQ / POS 0..1 POS Un contenitore per specificare l'account partner per questo messaggio (utilizzato in genere se il backend fornisce feed del prezzo per più account partner).
OTA_HotelRateAmountNotifRQ / POS / Source 1 Source Obbligatorio se è presente <POS>. Un container per <RequestorID>.
OTA_HotelRateAmountNotifRQ / POS / RequestorID 1 RequestorID Obbligatorio se è presente <POS>. Definisce il partner .
OTA_HotelRateAmountNotifRQ / POS / RequestorID / @ID 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 disponi di un backend che fornisce feed per più questo valore deve corrispondere al valore partner del messaggio Transaction (Property Data) e il valore ID nel campo <RequestorID> elemento di <OTA_HotelAvailNotifRQ> messaggio per lo stesso .
OTA_HotelRateAmountNotifRQ / RateAmountMessages 1 RateAmountMessages Una raccolta di elementi <RateAmountMessage> che che definiscono le tariffe.
OTA_HotelRateAmountNotifRQ / RateAmountMessages / @HotelCode 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.
OTA_HotelRateAmountNotifRQ / RateAmountMessages / RateAmountMessage 1..n RateAmountMessage Un contenitore per l'impostazione dei prezzi di una tariffa della camera (un tipo di camera e la tariffa). di piani in un intervallo di date).
OTA_HotelRateAmountNotifRQ / RateAmountMessages / RateAmountMessage / StatusApplicationControl 1 StatusApplicationControl Definisce l'intervallo di date, nonché gli identificatori per il tipo di camera (InvTypeCode) e piano tariffario (RatePlanCode).
OTA_HotelRateAmountNotifRQ / RateAmountMessages / RateAmountMessage / StatusApplicationControl / @Start 1 Date La data di inizio (in base al fuso orario della proprietà), inclusa, di l'intervallo di date.
OTA_HotelRateAmountNotifRQ / RateAmountMessages / RateAmountMessage / StatusApplicationControl / @End 1 Date La data di fine (in base al fuso orario della proprietà), inclusa, della data intervallo di date. Deve essere uguale o maggiore del valore start. Se start e end sono uguali, l'aggiornamento si applica fino a quella data. Tieni presente che Google supporta fino a tre anni di dati.
OTA_HotelRateAmountNotifRQ / RateAmountMessages / RateAmountMessage / StatusApplicationControl / @Mon 0..1 boolean Imposta su true o 1 per includere esplicitamente lunedì.

Se impostato su true, gli altri giorni della settimana non lo sono esplicitamente impostati su true vengono esclusi (in effetti, escluso dalle date all'interno di Start e End).
OTA_HotelRateAmountNotifRQ / RateAmountMessages / RateAmountMessage / StatusApplicationControl / @Tue 0..1 boolean Imposta su true o 1 per includere esplicitamente Ogni martedì.

Se impostato su true, gli altri giorni della settimana non lo sono esplicitamente impostati su true vengono esclusi (in effetti, escluso dalle date all'interno di Start e End).
OTA_HotelRateAmountNotifRQ / RateAmountMessages / RateAmountMessage / StatusApplicationControl / @Weds 0..1 boolean Imposta su true o 1 per includere esplicitamente Ogni mercoledì.

Se impostato su true, gli altri giorni della settimana non lo sono esplicitamente impostati su true vengono esclusi (in effetti, escluso dalle date all'interno di Start e End).
OTA_HotelRateAmountNotifRQ / RateAmountMessages / RateAmountMessage / StatusApplicationControl / @Thur 0..1 boolean Imposta su true o 1 per includere esplicitamente Ogni giovedì.

Se impostato su true, gli altri giorni della settimana non lo sono esplicitamente impostati su true vengono esclusi (in effetti, escluso dalle date all'interno di Start e End).
OTA_HotelRateAmountNotifRQ / RateAmountMessages / RateAmountMessage / StatusApplicationControl / @Fri 0..1 boolean Imposta su true o 1 per includere esplicitamente ogni venerdì.

Se impostato su true, gli altri giorni della settimana non lo sono esplicitamente impostati su true vengono esclusi (in effetti, escluso dalle date all'interno di Start e End).
OTA_HotelRateAmountNotifRQ / RateAmountMessages / RateAmountMessage / StatusApplicationControl / @Sat 0..1 boolean Imposta su true o 1 per includere esplicitamente ogni sabato.

Se impostato su true, gli altri giorni della settimana non lo sono esplicitamente impostati su true vengono esclusi (in effetti, escluso dalle date all'interno di Start e End).
OTA_HotelRateAmountNotifRQ / RateAmountMessages / RateAmountMessage / StatusApplicationControl / @Sun 0..1 boolean Imposta su true o 1 per includere esplicitamente Ogni domenica.

Se impostato su true, gli altri giorni della settimana non lo sono esplicitamente impostati su true vengono esclusi (in effetti, escluso dalle date all'interno di Start e End).
OTA_HotelRateAmountNotifRQ / RateAmountMessages / RateAmountMessage / StatusApplicationControl / @InvTypeCode 1 string L'identificatore univoco dell'inventario (tipo di camera). Questo valore viene mappato a <RoomID> in un messaggio Transaction (Property Data).
OTA_HotelRateAmountNotifRQ / RateAmountMessages / RateAmountMessage / StatusApplicationControl / @RatePlanCode 1 string Un identificatore univoco del piano tariffario. Questo identificatore viene mappato <PackageID> in una transazione (dati proprietà) . Il piano tariffario viene ulteriormente definito e definito in <StatusApplicationControl> in entrambi <OTA_HotelRateAmountNotifRQ> e <OTA_HotelAvailNotifRQ> messaggi.
OTA_HotelRateAmountNotifRQ / RateAmountMessages / RateAmountMessage / StatusApplicationControl / @RatePlanType 0..1 string Un identificatore che indica il tipo di modello di prezzi ARI che si applicano a questo aggiornamento dei prezzi. Deve essere specificato solo, utilizzando un parametro pari a 26, quando si utilizza il modello di prezzi basato su LOS. Esclusione di questo attributo indica che si tratta di un prezzo per data aggiornamento.
OTA_HotelRateAmountNotifRQ / RateAmountMessages / RateAmountMessage / Rates 0..1 Rates Contenitore di una raccolta di elementi <Rate>. Se NotifType è "Remove", questo elemento non deve che l'utente può specificare. In caso contrario, questo elemento deve essere specificato esattamente una volta.
OTA_HotelRateAmountNotifRQ / RateAmountMessages / RateAmountMessage / Rates / Rate 1 Rate Contenitore per una raccolta di <BaseByGuestAmts> elementi.
OTA_HotelRateAmountNotifRQ / RateAmountMessages / RateAmountMessage / Rates / Rate / @RateTimeUnit 0..1 String L'unità di misura per la durata del soggiorno specificata. L'unico modello supportato è "Day", il che significa che la durata del soggiorno sarà specificato in giorni.

Per utilizzare i prezzi basati su LOS, RateTimeUnit e UnitMultiplier devono essere specificato. In caso contrario, nessuno dei due deve essere specificato.
OTA_HotelRateAmountNotifRQ / RateAmountMessages / RateAmountMessage / Rates / Rate / @UnitMultiplier 0..1 Integer Il numero di RateTimeUnits che compongono la lunghezza per questa tariffa.

Ad esempio, se il valore di RateTimeUnits è "Day", un UnitMultiplier di 5 indica che le tariffe specificate sotto questo oggetto Rate si applicano a ogni notte di un soggiorno di 5 notti.

Le tariffe per il numero di persone specificate ai sensi di questa Rate verrà moltiplicato per UnitMultiplier (durata del soggiorno) per arrivare al prezzo totale del soggiorno.

Per utilizzare i prezzi basati su LOS, RateTimeUnit e UnitMultiplier devono essere specificato. In caso contrario, nessuno dei due deve essere specificato.
OTA_HotelRateAmountNotifRQ / RateAmountMessages / RateAmountMessage / Rates / Rate / BaseByGuestAmts 1 BaseByGuestAmts Contenitore per una raccolta degli addebiti base.
OTA_HotelRateAmountNotifRQ / RateAmountMessages / RateAmountMessage / Rates / Rate / BaseByGuestAmts / BaseByGuestAmt 1..n BaseByGuestAmt Specifica i prezzi delle camere in una valuta specificata. Il prezzo può essere in base al numero di persone utilizzando più <BaseByGuestAmt> elementi, ciascuno con un valore diverso per NumberOfGuests. In caso contrario, il prezzo è applicabile a un numero massimo di persone definito da NumberOfGuests.
OTA_HotelRateAmountNotifRQ / RateAmountMessages / RateAmountMessage / Rates / Rate / BaseByGuestAmts / BaseByGuestAmt / @AmountBeforeTax 0..1 float

Il prezzo giornaliero della tariffa della camera al netto di tasse e commissioni.

Sia AmountBeforeTax che È possibile specificare AmountAfterTax. Se AmountBeforeTax non è specificato, È necessario specificare AmountAfterTax. Se AmountBeforeTax è specificato e AmountAfterTax non specificato, tasse e commissioni deve essere specificato in un messaggio <TaxFeeInfo>.

Se utilizzi le promozioni, lo sconto viene applicato a AmountBeforeTax; percentuale vengono applicati anche a AmountAfterTax. Dal momento che non funziona con alcune strutture fiscali, consigliamo vivamente solo specificando AmountBeforeTax qui e utilizzando <TaxFeeInfo> per specificare tasse e commissioni.
OTA_HotelRateAmountNotifRQ / RateAmountMessages / RateAmountMessage / Rates / Rate / BaseByGuestAmts / BaseByGuestAmt / @AmountAfterTax 0..1 float Il prezzo giornaliero della tariffa della camera al netto delle tasse applicabili e tariffe. Se AmountAfterTax è specificato, separa per proprietà Non è necessario inviare <TaxFeeInfo> messaggi. Questo può essere utilizzato in combinazione con AmountBeforeTax per fornire tariffe di base e totali che possono essere mostrate agli utenti in alcune regioni.

Avviso: se utilizzi le promozioni, ti consigliamo vivamente sconsiglia di usare AmountAfterTax importi corrispondenti. Se vuoi utilizzare gli sconti, specifica tasse e commissioni per usando il messaggio <TaxFeeInfo>. I tuoi sconti da applicare agli importi AmountBeforeTax.

Nota: se AmountBeforeTax non è specificato, è necessario specificare AmountAfterTax.
OTA_HotelRateAmountNotifRQ / RateAmountMessages / RateAmountMessage / Rates / Rate / BaseByGuestAmts / BaseByGuestAmt / @CurrencyCode 1 enum Il codice alfanumerico ISO 4217 (3) per una specifica unità monetaria.

Consulta l'elenco dei supporti valute.
OTA_HotelRateAmountNotifRQ / RateAmountMessages / RateAmountMessage / Rates / Rate / BaseByGuestAmts / BaseByGuestAmt / @NumberOfGuests 0..1 integer Numero massimo di ospiti che possono essere ospitati da questa tariffa. Se non viene specificato, il valore predefinito è 2 ospiti.

Tieni presente che se <AdditionalGuestAmounts> contiene addebiti per bambini, si riferisce solo a NumberOfGuests agli adulti. Se <AdditionalGuestAmounts> non è specificato o non contiene addebiti per i bambini, NumberOfGuests si riferisce al numero totale di persone inclusi adulti e bambini.

OTA_HotelRateAmountNotifRQ / RateAmountMessages / RateAmountMessage / Rates / Rate / AdditionalGuestAmounts 0..1 AdditionalGuestAmounts Contenitore di una riscossione degli addebiti per gli ospiti aggiuntivi.

Questa sintassi è utile se tariffe aggiuntive per ospiti o bambini cambia in base alla data. Valuta l'uso della soluzione più efficiente ExtraGuestCharges se questi importi possono essere definiti in modo statico nella proprietà livello.

Gli importi aggiuntivi per gli ospiti vengono applicati come segue:
  • Vengono applicati in aggiunta alla tariffa base per il numero di persone. La base è la percentuale più alta, specificata in <BaseByGuestAmts>, pari o inferiore a il numero di adulti in una ricerca utente.
  • Vengono applicati purché il numero di persone in una ricerca dell'utente sia che rientrano nella capacità della stanza.
  • <AdditionalGuestAmounts> sostituisce sempre specificati in precedenza con nuovi importi quando NotifType è Delta o Overlay.
  • <AdditionalGuestAmounts> potrebbe essere inviato a prescindere dalle tariffe di base solo quando NotifType è Delta. È necessario specificare <BaseByGuestAmts> quando NotifType è Overlay.
  • Un elemento <AdditionalGuestAmounts> vuoto con Il campo NotifType impostato su Delta rimuove gli elementi esistenti importi aggiuntivi senza influire sulle tariffe di base.
  • Vengono applicati utilizzando la valuta specificata in <BaseByGuestAmt>.

Ad esempio, supponiamo che le tariffe di base siano specificate per 1 e 2 adulti.

  • Se un utente cerca 3 adulti, la tariffa per 2 persone viene calcolata da selezionare come tariffa di base e un importo ospite aggiuntivo per 1 adulti.
  • Se l'utente cerca 1 adulto e 2 bambini, il singolo come tariffa di base viene selezionata come tariffa di base e aggiuntivi verranno applicati ai due figli.
OTA_HotelRateAmountNotifRQ / RateAmountMessages / RateAmountMessage / Rates / Rate / AdditionalGuestAmounts / AdditionalGuestAmount 0..n AdditionalGuestAmount Specifica i prezzi in base al tipo di ospite, specificato tramite AgeQualifyingCode e, se applicabile, l'età dell'ospite specificato tramite MaxAge.
OTA_HotelRateAmountNotifRQ / RateAmountMessages / RateAmountMessage / Rates / Rate / AdditionalGuestAmounts / AdditionalGuestAmount / @AgeQualifyingCode 1 enum Definisce il tipo di ospite aggiuntivo, adulto o bambino. Valido sono:
  • 10: Adulti.
  • 8: bambino/a.

AgeQualifyingCode può essere impostato su 10 per alle più di un elemento AdditionalGuestAmount.

MaxAge deve essere specificato quando AgeQualifyingCode è 8.
OTA_HotelRateAmountNotifRQ / RateAmountMessages / RateAmountMessage / Rates / Rate / AdditionalGuestAmounts / AdditionalGuestAmount / @MaxAge 0..1 integer MaxAge deve essere specificato quando AgeQualifyingCode è 8. Non deve essere specificato quando AgeQualifyingCode è 10.

MaxAge deve essere un numero intero compreso tra 0 e 17.

Se viene specificato un valore 0, i bambini vengono disattivati.

I valori superiori a 17 verranno trattati come valore accettato di 17.

È possibile specificare più fasce d'età per bambini tramite AdditionalGuestAmount elementi. Le fasce d'età devono essere contigue e non sovrapposte.
OTA_HotelRateAmountNotifRQ / RateAmountMessages / RateAmountMessage / Rates / Rate / AdditionalGuestAmounts / AdditionalGuestAmount / @Amount 1 float Importo al netto di tasse e commissioni aggiunte alla tariffa di base per ciascuno ospite aggiuntivo.

Tasse e commissioni a seconda del numero di ospiti le età devono essere specificate tramite l'elemento <AgeBrackets> in un <TaxFeeInfo> messaggio.

Esempi

Questa sezione fornisce esempi di codice che evidenziano come:

di Gemini Advanced.

Quando imposti i valori add, overlay o remove, gli intervalli di date possono uguali o diversi a seconda dei tuoi obiettivi. Ad esempio, puoi utilizzare overlay per impostare solo poche settimane per le festività di dicembre anziché le l'intero intervallo impostato per "Aggiungi tariffa" . Questo numero sostituirà il numero di persone tariffe disponibili solo per questo periodo.

Prezzi per data

Per una camera e un piano tariffario specifici è possibile includere un massimo di 50 tariffe a seconda del numero di persone proprietà. Se le tariffe sono uguali per tutti i numeri di numero di persone, invia semplicemente per un numero massimo di persone al prezzo richiesto. In questo modo Google deduce che anche il numero di persone più basso riceve la stessa tariffa di base.

Configurare le tariffe di base e le tariffe totali

Esempio 1

Tariffa di base (senza tasse o commissioni) per il numero di persone predefinito (2 persone). In questo le tasse e le commissioni della struttura devono essere definite utilizzando <TaxFeeInfo> messaggio. La tariffa di base sarà più in evidenza per gli utenti che eseguono ricerche da determinate regioni.

<?xml version="1.0" encoding="UTF-8"?>
<OTA_HotelRateAmountNotifRQ xmlns="http://www.opentravel.org/OTA/2003/05"
                            EchoToken="12345678"
                            TimeStamp="2020-05-19T20:50:37-05:00"
                            Version="3.0">
  <RateAmountMessages HotelCode="Property_1">
    <RateAmountMessage>
      <StatusApplicationControl Start="2020-05-18"
                                End="2020-05-23"
                                InvTypeCode="RoomID_1"
                                RatePlanCode="PackageID_1"/>
      <Rates>
        <Rate>
          <BaseByGuestAmts>
            <BaseByGuestAmt AmountBeforeTax="100.00"
                            CurrencyCode="USD"/>
          </BaseByGuestAmts>
        </Rate>
      </Rates>
    </RateAmountMessage>
  </RateAmountMessages>
</OTA_HotelRateAmountNotifRQ>

Esempio 2

Tariffa di base e totale per il numero di persone predefinito (doppio). In questo modello, le tasse e le tariffe non devono essere definite separatamente utilizzando <TaxFeeInfo> messaggi. La tariffa di base sarà maggiormente in evidenza per gli utenti che effettuano ricerche da: alcune regioni.

<?xml version="1.0" encoding="UTF-8"?>
<OTA_HotelRateAmountNotifRQ xmlns="http://www.opentravel.org/OTA/2003/05"
                            EchoToken="12345678"
                            TimeStamp="2020-05-19T20:50:37-05:00"
                            Version="3.0">
  <RateAmountMessages HotelCode="Property_1">
    <RateAmountMessage>
      <StatusApplicationControl Start="2020-05-18"
                                End="2020-05-23"
                                InvTypeCode="RoomID_1"
                                RatePlanCode="PackageID_1"/>
      <Rates>
        <Rate>
          <BaseByGuestAmts>
            <BaseByGuestAmt AmountBeforeTax="100.00"
                            AmountAfterTax="110.00"
                            CurrencyCode="USD"/>
          </BaseByGuestAmts>
        </Rate>
      </Rates>
    </RateAmountMessage>
  </RateAmountMessages>
</OTA_HotelRateAmountNotifRQ>

Esempio 3

Tariffa totale (con tasse e commissioni) per più persone. In questo modello, le tasse e le commissioni non devono essere definite separatamente utilizzando <TaxFeeInfo> messaggi.

<?xml version="1.0" encoding="UTF-8"?>
<OTA_HotelRateAmountNotifRQ xmlns="http://www.opentravel.org/OTA/2003/05"
                            EchoToken="12345678"
                            TimeStamp="2020-05-19T20:50:37-05:00"
                            Version="3.0">
  <RateAmountMessages HotelCode="Property_1">
    <RateAmountMessage>
      <StatusApplicationControl Start="2020-05-18"
                                End="2020-05-23"
                                InvTypeCode="RoomID_1"
                                RatePlanCode="PackageID_1"/>
      <Rates>
        <Rate>
          <BaseByGuestAmts>
            <BaseByGuestAmt AmountAfterTax="100.00"
                            CurrencyCode="USD"
                            NumberOfGuests="1"/>
            <BaseByGuestAmt AmountAfterTax="110.00"
                            CurrencyCode="USD"
                            NumberOfGuests="2"/>
            <BaseByGuestAmt AmountAfterTax="120.00"
                            CurrencyCode="USD"
                            NumberOfGuests="3"/>
          </BaseByGuestAmts>
        </Rate>
      </Rates>
    </RateAmountMessage>
  </RateAmountMessages>
</OTA_HotelRateAmountNotifRQ>

Esempio 4

Tariffa di base e totale per più tipi di camera e piani tariffari in tutti intervalli di date diversi.

<?xml version="1.0" encoding="UTF-8"?>
<OTA_HotelRateAmountNotifRQ xmlns="http://www.opentravel.org/OTA/2003/05"
                            EchoToken="12345678"
                            TimeStamp="2020-05-19T20:50:37-05:00"
                            Version="3.0">
  <RateAmountMessages HotelCode="Property_1">
    <RateAmountMessage>
      <StatusApplicationControl Start="2020-05-18"
                                End="2020-05-23"
                                InvTypeCode="RoomID_1"
                                RatePlanCode="PackageID_1"/>
      <Rates>
        <Rate>
          <BaseByGuestAmts>
            <BaseByGuestAmt AmountBeforeTax="100.00"
                            AmountAfterTax="110.00"
                            CurrencyCode="USD"
                            NumberOfGuests="2"/>
          </BaseByGuestAmts>
        </Rate>
      </Rates>
    </RateAmountMessage>
    <RateAmountMessage>
      <StatusApplicationControl Start="2020-05-01"
                                End="2020-05-31"
                                InvTypeCode="RoomID_2"
                                RatePlanCode="PackageID_2"/>
      <Rates>
        <Rate>
          <BaseByGuestAmts>
            <BaseByGuestAmt AmountBeforeTax="200.00"
                            AmountAfterTax="220.00"
                            CurrencyCode="USD"
                            NumberOfGuests="2"/>
          </BaseByGuestAmts>
        </Rate>
      </Rates>
    </RateAmountMessage>
  </RateAmountMessages>
</OTA_HotelRateAmountNotifRQ>
Aggiungere, sovrapporre e rimuovere tariffe

Esiste un limite di 5000 prodotti: tipo di camera e pacchetto combinazioni, per proprietà. Usa la notifica Overlay o Remove per rimuovere i prodotti definiti in precedenza.

Aggiungi tariffe

Imposta NotifType su Delta per aggiungere le tariffe in base al numero di persone per RoomID_1 e PackageID_1 tra il 20/10/2021 e il 31/12/2021. Tieni presente che Google supporta fino a tre anni di dati.

<?xml version="1.0" encoding="UTF-8"?>
<OTA_HotelRateAmountNotifRQ xmlns="http://www.opentravel.org/OTA/2003/05"
                            EchoToken="12345678"
                            TimeStamp="2021-10-20T20:50:37-05:00"
                            Version="3.0"
                            NotifType="Delta"
                            NotifScopeType="ProductRate">
  <RateAmountMessages HotelCode="Property_1">
    <RateAmountMessage>
      <StatusApplicationControl Start="2021-10-20"
                                End="2021-12-31"
                                InvTypeCode="RoomID_1"
                                RatePlanCode="PackageID_1"/>
      <Rates>
        <Rate>
          <BaseByGuestAmts>
            <BaseByGuestAmt AmountBeforeTax="100.00"
                            CurrencyCode="USD"
                            NumberOfGuests="1"/>
            <BaseByGuestAmt AmountBeforeTax="110.00"
                            CurrencyCode="USD"
                            NumberOfGuests="2"/>
            <BaseByGuestAmt AmountBeforeTax="120.00"
                            CurrencyCode="USD"
                            NumberOfGuests="3"/>
          </BaseByGuestAmts>
        </Rate>
      </Rates>
    </RateAmountMessage>
  </RateAmountMessages>
</OTA_HotelRateAmountNotifRQ>

Tariffe overlay

Imposta NotifType su Overlay per eliminare tutti i dati in base al numero di persone tariffe per RoomID_1 e PackageID_1 tra il 20/10/2021 e il 31/12/2021 e sostituiscile con le nuove tariffe specificate in base al numero di persone.

Ad esempio, se questo messaggio è stato inviato dopo il link "Aggiungi tariffe" messaggio, il le tariffe per le persone 1, 2 e 3 verranno eliminate, mentre solo la nuova per le persone 1 verrà archiviata. Puoi anche impostare un intervallo di date più breve (ad es. 20/12/2021 e 31/12/2021) per sostituire solo parte del numero di persone tariffe in determinate date, ad esempio per le festività. 

<?xml version="1.0" encoding="UTF-8"?>
<OTA_HotelRateAmountNotifRQ xmlns="http://www.opentravel.org/OTA/2003/05"
                            EchoToken="12345678"
                            TimeStamp="2021-10-20T20:50:37-05:00"
                            Version="3.0"
                            NotifType="Overlay"
                            NotifScopeType="ProductRate">
  <RateAmountMessages HotelCode="Property_1">
    <RateAmountMessage>
      <StatusApplicationControl Start="2021-10-20"
                                End="2021-12-31"
                                InvTypeCode="RoomID_1"
                                RatePlanCode="PackageID_1"/>
      <Rates>
        <Rate>
          <BaseByGuestAmts>
            <BaseByGuestAmt AmountBeforeTax="200.00"
                            CurrencyCode="USD"
                            NumberOfGuests="1"/>
          </BaseByGuestAmts>
        </Rate>
      </Rates>
    </RateAmountMessage>
  </RateAmountMessages>
</OTA_HotelRateAmountNotifRQ>

Rimuovi tariffe

Imposta il valore NotifType su Remove per eliminare tutti i dati in base al numero di persone tariffe per RoomID_1 e PackageID_1 tra il 20/10/2021 e il 31/12/2021.

Ad esempio, se questo messaggio è stato inviato dopo uno degli altri esempi non verrà archiviata nessuna tariffa in base al numero di persone.

<?xml version="1.0" encoding="UTF-8"?>
<OTA_HotelRateAmountNotifRQ xmlns="http://www.opentravel.org/OTA/2003/05"
                            EchoToken="12345678"
                            TimeStamp="2021-10-20T20:50:37-05:00"
                            Version="3.0"
                            NotifType="Remove"
                            NotifScopeType="ProductRate">>
  <RateAmountMessages HotelCode="Property_1">
    <RateAmountMessage>
      <StatusApplicationControl Start="2021-10-20"
                                End="2021-12-31"
                                InvTypeCode="RoomID_1"
                                RatePlanCode="PackageID_1"/>
    </RateAmountMessage>
  </RateAmountMessages>
</OTA_HotelRateAmountNotifRQ>
Aggiungere, sovrapporre e rimuovere un numero aggiuntivo di ospiti

Aggiungi importi

Imposta NotifType su Delta per aggiungere le tariffe di base per numero di persone 1 e 2 e numero di ospiti aggiuntivi per RoomID_1 e PackageID_1 tra il 20/10/2021 e il 31/12/2021.

Gli importi aggiuntivi per gli ospiti verranno applicati in aggiunta a una tariffa di base che determinato dal numero di persone in una ricerca eseguita dagli utenti. L'utente ha specificato il numero di persone deve rientrare nella capacità di RoomID_1.

In questo esempio, gli importi aggiuntivi per gli ospiti verranno applicati come:

  • 5 $ per i bambini da 0 a 10 anni (inclusi).
  • 10 $ per i bambini da 11 a 17 anni (compreso).
  • 20 $ per gli adulti.
<?xml version="1.0" encoding="UTF-8"?>
<OTA_HotelRateAmountNotifRQ xmlns="http://www.opentravel.org/OTA/2003/05"
                            EchoToken="12345678"
                            TimeStamp="2021-10-20T20:50:37-05:00"
                            Version="3.0"
                            NotifType="Delta"
                            NotifScopeType="ProductRate">
  <RateAmountMessages HotelCode="Property_1">
    <RateAmountMessage>
      <StatusApplicationControl Start="2021-10-20"
                                End="2021-12-31"
                                InvTypeCode="RoomID_1"
                                RatePlanCode="PackageID_1"/>
      <Rates>
        <Rate>
          <BaseByGuestAmts>
            <BaseByGuestAmt AmountBeforeTax="100.00"
                            CurrencyCode="USD"
                            NumberOfGuests="1"/>
            <BaseByGuestAmt AmountBeforeTax="110.00"
                            CurrencyCode="USD"
                            NumberOfGuests="2"/>
          </BaseByGuestAmts>
          <AdditionalGuestAmounts>
            <AdditionalGuestAmount Amount="5.00" AgeQualifyingCode="8" MaxAge="10" />
            <AdditionalGuestAmount Amount="10.00" AgeQualifyingCode="8" MaxAge="17" />
            <AdditionalGuestAmount Amount="20.00" AgeQualifyingCode="10" />
          </AdditionalGuestAmounts>
        </Rate>
      </Rates>
    </RateAmountMessage>
  </RateAmountMessages>
</OTA_HotelRateAmountNotifRQ>

Importi in overlay

Imposta NotifType su Overlay per eliminare tutti i dati in base al numero di persone tariffe e tutti gli importi aggiuntivi per gli ospiti per RoomID_1 e PackageID_1 tra il 20/10/2021 e il 31/12/2021 e sostituirli con i nuovi le tariffe specificate in base al numero di persone e gli importi aggiuntivi.

Ad esempio, se questo messaggio è stato inviato dopo il link "Aggiungi tariffe" messaggio, il Le tariffe per il numero di persone base 1 e 2 verranno eliminate e solo la nuova base verrà archiviata per il numero di persone 1. Il gruppo precedente di invitati aggiuntivi verrebbero eliminati e verrà archiviato solo il nuovo insieme di importi. Gli ospiti aggiuntivi utilizzano ora la nuova tariffa per 1 persona come e la tariffa di base. Tieni presente che, dopo questo aggiornamento, non ci saranno altri invitati addebiti definiti per i bambini. 

<?xml version="1.0" encoding="UTF-8"?>
<OTA_HotelRateAmountNotifRQ xmlns="http://www.opentravel.org/OTA/2003/05"
                            EchoToken="12345678"
                            TimeStamp="2021-10-20T20:50:37-05:00"
                            Version="3.0"
                            NotifType="Overlay"
                            NotifScopeType="ProductRate">
  <RateAmountMessages HotelCode="Property_1">
    <RateAmountMessage>
      <StatusApplicationControl Start="2021-10-20"
                                End="2021-12-31"
                                InvTypeCode="RoomID_1"
                                RatePlanCode="PackageID_1"/>
      <Rates>
        <Rate>
          <BaseByGuestAmts>
            <BaseByGuestAmt AmountBeforeTax="200.00"
                            CurrencyCode="USD"
                            NumberOfGuests="1"/>
          </BaseByGuestAmts>
          <AdditionalGuestAmounts>
            <AdditionalGuestAmount Amount="30.00" AgeQualifyingCode="10" />
          </AdditionalGuestAmounts>
        </Rate>
      </Rates>
    </RateAmountMessage>
  </RateAmountMessages>
</OTA_HotelRateAmountNotifRQ>

Rimuovi importi

Imposta NotifType su Delete per eliminare tutti i dati in base al numero di persone le tariffe di base e tutti gli importi ospite aggiuntivi per RoomID_1 e PackageID_1 tra il 20/10/2021 e il 31/12/2021.

Ad esempio, se questo messaggio è stato inviato dopo uno degli altri esempi messaggi, nessuna tariffa base in base al numero di persone o la quantità di ospiti aggiuntivi essere archiviati.

<?xml version="1.0" encoding="UTF-8"?>
<OTA_HotelRateAmountNotifRQ xmlns="http://www.opentravel.org/OTA/2003/05"
                            EchoToken="12345678"
                            TimeStamp="2021-10-20T20:50:37-05:00"
                            Version="3.0"
                            NotifType="Remove"
                            NotifScopeType="ProductRate">>
  <RateAmountMessages HotelCode="Property_1">
    <RateAmountMessage>
      <StatusApplicationControl Start="2021-10-20"
                                End="2021-12-31"
                                InvTypeCode="RoomID_1"
                                RatePlanCode="PackageID_1"/>
    </RateAmountMessage>
  </RateAmountMessages>
</OTA_HotelRateAmountNotifRQ>

Rimuovi solo importi aggiuntivi per gli ospiti

Imposta NotifType su Delta con uno spazio vuoto <AdditionalGuestAmounts> elemento per eliminare tutto numero aggiuntivo di ospiti per RoomID_1 e PackageID_1 senza influire tariffe di base comprese tra il 20/10/2021 e il 31/12/2021.

Ad esempio, se questo messaggio è stato inviato dopo uno degli altri esempi vengono archiviate solo le quantità di base.

<?xml version="1.0" encoding="UTF-8"?>
<OTA_HotelRateAmountNotifRQ xmlns="http://www.opentravel.org/OTA/2003/05"
                            EchoToken="12345678"
                            TimeStamp="2021-10-20T20:50:37-05:00"
                            Version="3.0"
                            NotifType="Delta"
                            NotifScopeType="ProductRate">
  <RateAmountMessages HotelCode="Property_1">
    <RateAmountMessage>
      <StatusApplicationControl Start="2021-10-20"
                                End="2021-12-31"
                                InvTypeCode="RoomID_1"
                                RatePlanCode="PackageID_1"/>
      <Rates>
        <Rate>
          <AdditionalGuestAmounts/>
        </Rate>
      </Rates>
    </RateAmountMessage>
  </RateAmountMessages>
</OTA_HotelRateAmountNotifRQ>

Prezzi basati sulla lunghezza del soggiorno

Configura le tariffe basate sulla lunghezza del soggiorno

Esempio 1

Imposta tariffe per soggiorni di 1, 2 e 3 notti a partire dal 18/05/2020. La la tariffa totale per soggiorni di 1, 2 e 3 notti in questo esempio è di 100 €, rispettivamente 180 e 240 $.

<?xml version="1.0" encoding="UTF-8"?>
<OTA_HotelRateAmountNotifRQ xmlns="http://www.opentravel.org/OTA/2003/05"
                            EchoToken="12345678"
                            TimeStamp="2020-05-19T20:50:37-05:00"
                            Version="3.0">
  <RateAmountMessages HotelCode="Property_1">
    <RateAmountMessage>
      <StatusApplicationControl Start="2020-05-18"
                                End="2020-05-18"
                                InvTypeCode="RoomID_1"
                                RatePlanCode="PackageID_1"
                                RatePlanType="26"/>
      <Rates>
        <Rate UnitMultiplier="1" RateTimeUnit="Day">
          <BaseByGuestAmts>
            <BaseByGuestAmt AmountBeforeTax="100.00"
                            CurrencyCode="USD"
                            NumberOfGuests="2"/>
          </BaseByGuestAmts>
        </Rate>
        <Rate UnitMultiplier="2" RateTimeUnit="Day">
          <BaseByGuestAmts>
            <BaseByGuestAmt AmountBeforeTax="90.00"
                            CurrencyCode="USD"
                            NumberOfGuests="2"/>
          </BaseByGuestAmts>
        </Rate>
        <Rate UnitMultiplier="3" RateTimeUnit="Day">
          <BaseByGuestAmts>
            <BaseByGuestAmt AmountBeforeTax="80.00"
                            CurrencyCode="USD"
                            NumberOfGuests="2" />
          </BaseByGuestAmts>
        </Rate>
      </Rates>
    </RateAmountMessage>
  </RateAmountMessages>
</OTA_HotelRateAmountNotifRQ>
Aggiungere, sovrapporre e rimuovere le tariffe basate sulla lunghezza del soggiorno

Aggiungi durate del soggiorno

Con i prezzi basati sulla lunghezza del soggiorno, un'operazione Delta consente di aggiornati in modo incrementale per gli intervalli di date di check-in indicati in <StatusApplicationControl> e per tutte le durate del soggiorno indicato dal parametro Rate di ogni elemento UnitMultiplier.

Per ogni data di check-in e durata del soggiorno applicabili, tutti i numeri è necessario specificare le tariffe.

<?xml version="1.0" encoding="UTF-8"?>
<OTA_HotelRateAmountNotifRQ xmlns="http://www.opentravel.org/OTA/2003/05"
                            EchoToken="12345678"
                            TimeStamp="2020-05-19T20:50:37-05:00"
                            Version="3.0"
                            NotifType="Delta"
                            NotifScopeType="ProductRate">
  <RateAmountMessages HotelCode="Property_1">
    <RateAmountMessage>
      <StatusApplicationControl Start="2020-05-18"
                                End="2020-05-18"
                                InvTypeCode="RoomID_1"
                                RatePlanCode="PackageID_1"
                                RatePlanType="26"/>
      <Rates>
        <Rate UnitMultiplier="3" RateTimeUnit="Day">
          <BaseByGuestAmts>
            <BaseByGuestAmt AmountBeforeTax="80.00"
                            CurrencyCode="USD"
                            NumberOfGuests="2"/>
          </BaseByGuestAmts>
        </Rate>
      </Rates>
    </RateAmountMessage>
  </RateAmountMessages>
</OTA_HotelRateAmountNotifRQ>

Durata del soggiorno nell'overlay

Con i prezzi basati sulla lunghezza del soggiorno, un'operazione Overlay sostituisce le tariffe per tutte le durate del soggiorno del prodotto e la data di check-in intervallo indicato in <StatusApplicationControl>.

Con questo messaggio, vengono indicate le tariffe in base al numero di persone per tutte le durate del soggiorno sui date di arrivo specificate verranno rimosse e sostituite da una camera doppia tariffa definita solo per la durata del soggiorno 3.

<?xml version="1.0" encoding="UTF-8"?>
<OTA_HotelRateAmountNotifRQ xmlns="http://www.opentravel.org/OTA/2003/05"
                            EchoToken="12345678"
                            TimeStamp="2020-05-19T20:50:37-05:00"
                            Version="3.0"
                            NotifType="Overlay"
                            NotifScopeType="ProductRate">
  <RateAmountMessages HotelCode="Property_1">
    <RateAmountMessage>
      <StatusApplicationControl Start="2020-05-18"
                                End="2020-05-18"
                                InvTypeCode="RoomID_1"
                                RatePlanCode="PackageID_1"
                                RatePlanType="26"/>
      <Rates>
        <Rate UnitMultiplier="3" RateTimeUnit="Day">
          <BaseByGuestAmts>
            <BaseByGuestAmt AmountBeforeTax="80.00"
                            CurrencyCode="USD"
                            NumberOfGuests="2"/>
          </BaseByGuestAmts>
        </Rate>
      </Rates>
    </RateAmountMessage>
  </RateAmountMessages>
</OTA_HotelRateAmountNotifRQ>

Rimuovi durate del soggiorno

Con i prezzi basati sulla lunghezza del soggiorno, un'operazione Remove rimuove le tariffe per tutte le durate del soggiorno del prodotto e l'intervallo di date di check-in indicato in <StatusApplicationControl>.

<?xml version="1.0" encoding="UTF-8"?>
<OTA_HotelRateAmountNotifRQ xmlns="http://www.opentravel.org/OTA/2003/05"
                            EchoToken="12345678"
                            TimeStamp="2021-10-20T20:50:37-05:00"
                            Version="3.0"
                            NotifType="Remove"
                            NotifScopeType="ProductRate">
  <RateAmountMessages HotelCode="Property_1">
    <RateAmountMessage>
      <StatusApplicationControl Start="2021-10-20"
                                End="2021-12-31"
                                InvTypeCode="RoomID_1"
                                RatePlanCode="PackageID_1"
                                RatePlanType="26"/>
    </RateAmountMessage>
  </RateAmountMessages>
</OTA_HotelRateAmountNotifRQ>

Risposte

Sintassi

Il messaggio OTA_HotelRateAmountNotifRS utilizza la seguente sintassi:

<?xml version="1.0" encoding="UTF-8"?>
<OTA_HotelRateAmountNotifRS xmlns="http://www.opentravel.org/OTA/2003/05"
                            TimeStamp="timestamp"
                            EchoToken="echo_token"
                            Version="3.0">
  <!-- Either Success or Errors will be populated. -->
  <Success/>
  <Errors>
    <Error Type="12" Status="NotProcessed" ShortText="issue_code">issue_description</Error>
  </Errors>
</OTA_HotelRateAmountNotifRS>

Elementi e attributi

Il messaggio OTA_HotelRateAmountNotifRS contiene quanto segue elementi e attributi:

Elemento / @attributo Occorrenze Tipo Descrizione
OTA_HotelRateAmountNotifRS 1 Complex element L'elemento principale per una risposta a un messaggio sulla disponibilità.
OTA_HotelRateAmountNotifRS / @TimeStamp 1 DateTime La data e l'ora di creazione di questo messaggio.
OTA_HotelRateAmountNotifRS / @EchoToken 1 string L'identificatore univoco dell'elemento associato OTA_HotelRateAmountNotifRQ messaggio.
OTA_HotelRateAmountNotifRS / Success 0..1 Success Indica che il messaggio OTA_HotelRateAmountNotifRQ era elaborato correttamente.

<Success> o <Errors> sono presenti in ogni messaggio.
OTA_HotelRateAmountNotifRS / Errors 0..1 Errors Un container per uno o più problemi riscontrati durante l'elaborazione OTA_HotelRateAmountNotifRQ messaggio.

<Success> o <Errors> sono presenti in ogni messaggio.
OTA_HotelRateAmountNotifRS / Errors / Error 1..n Error La descrizione di un errore riscontrato durante l'elaborazione del OTA_HotelRateAmountNotifRQ messaggio. Dettagli in merito consulta la sezione Messaggi di errore relativi allo stato dei feed.
OTA_HotelRateAmountNotifRS / Errors / Error / @Type 1 integer Il EWT (Error Warning Type) OpenTravel Alliance associato al . Viene utilizzato solo il valore 12 (Processing exception).
OTA_HotelRateAmountNotifRS / Errors / Error / @Code 1 integer L'ERR (Error Code) OpenTravel Alliance associato all'errore. Viene utilizzato solo il valore 450 (Unable to process).
OTA_HotelRateAmountNotifRS / Errors / Error / @Code 1 enum Lo stato della richiesta originale. Solo il valore È in uso NotProcessed.
OTA_HotelRateAmountNotifRS / Errors / Error / @ShortText 1 string L'identificatore Google del problema. I dettagli su questi errori possono essere trovato nei messaggi di errore relativi allo stato dei feed.

Esempi

Operazione riuscita

Di seguito è riportata una risposta a un modulo elaborato correttamente Messaggio OTA_HotelRateAmountNotifRQ.

<?xml version="1.0" encoding="UTF-8"?>
<OTA_HotelRateAmountNotifRS xmlns="http://www.opentravel.org/OTA/2003/05"
                       EchoToken="12345678"
                       TimeStamp="2021-10-20T20:50:37-05:00"
                       Version="3.0">
  <Success/>
</OTA_HotelRateAmountNotifRS>

Errori

Di seguito è riportata una risposta a un messaggio OTA_HotelRateAmountNoti Controllo non specificato elaborati a causa di errori.

<?xml version="1.0" encoding="UTF-8"?>
<OTA_HotelRateAmountNotifRS xmlns="http://www.opentravel.org/OTA/2003/05"
                       EchoToken="12345678"
                       TimeStamp="2021-10-20T20:50:37-05:00"
                       Version="3.0">
  <Errors>
    <Error Type="12" Code="450" Status="NotProcessed" ShortText="8001">Example</Error>
  </Errors>
</OTA_HotelRateAmountNotifRS>