Questa pagina è stata tradotta dall'API Cloud Translation.

Modifiche tariffe

Panoramica

Questa API consente di definire i modi per applicare dinamicamente azioni a una tariffa ogni volta che sono soddisfatte determinate condizioni, come la regolazione del prezzo o l'abilitazione della possibilità di rimborso. A differenza dell'API Promotions, che può applicare solo le promozioni idonee con gli sconti più alti, questa API applica qualsiasi azione quando vengono soddisfatte determinate condizioni, inclusi gli aggiustamenti dei prezzi che potrebbero in ultimare aumentare il prezzo finale.

Richieste

Sintassi

Il messaggio RateModifications utilizza la seguente sintassi:

<?xml version="1.0" encoding="UTF-8"?>
<RateModifications partner="partner_key"
                      id="message_ID"
                      timestamp="timestamp">
  <HotelRateModifications hotel_id="HotelID" action="[overlay]">
    <ItineraryRateModification id="ModificationID" action="[delete]">
      <BookingDates>
        <DateRange start="YYYY-MM-DD" end="YYYY-MM-DD" days_of_week=""MTWHFSU_or_subset""/>
        <DateRange start="YYYY-MM-DD" end="YYYY-MM-DD" days_of_week=""MTWHFSU_or_subset""/>
      </BookingDates>
      <BookingWindow min="integer" max="integer"/>
      <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>
      <Devices>
        <Device type="[desktop|tablet|mobile]"/>
      </Devices>
      <LengthOfStay min="integer" max="integer"/>
      <MinimumAmount before_discount="integer"/>
      <RatePlans>
        <RatePlan id="PackageID_1"/>
        <RatePlan id="PackageID_2"/>
      </RatePlans>
      <RoomTypes>
        <RoomType id="RoomID_1"/>
        <RoomType id="RoomID_2"/>
      </RoomTypes>
      <StayDates application="[all|any]">
        <DateRange start="YYYY-MM-DD" end="YYYY-MM-DD" days_of_week=""MTWHFSU_or_subset""/>
      </StayDates>
      <UserCountries type="[include|exclude]">
        <Country code="country_code"/>
      </UserCountries>
      <ModificationActions>
        <PriceAdjustment multiplier="float"/>
        <RateRule id="RateRuleID"/>
        <Refundable available="[false|true]"
                       refundable_until_days="number_of_days"
                       refundable_until_time="time"/>
        <Availability status="[unavailable]"/>
      </ModificationActions>
    </ItineraryRateModification>
  </HotelRateModifications>
</RateModifications>

Elementi e attributi

Il messaggio RateModifications contiene i seguenti elementi e attributi:

Elemento / @attributo	Occorrenze	Tipo	Descrizione
RateModifications	1	Complex element	L'elemento principale di un messaggio di modifiche alle tariffe.
RateModifications / @partner	1	string	L'account partner per questo messaggio. Questo valore di stringa è il valore "Chiave del partner" elencato nella pagina Impostazioni account in Hotel Center. Nota: se disponi di un backend che fornisce feed per più account, questo valore deve corrispondere al valore dell'attributo `ID` specificato nell'elemento `<RequestorID>` dei messaggi `<OTA_HotelRateAmountNotifRQ>` e `<OTA_HotelAvailNotifRQ>` per lo stesso account.
RateModifications / @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).
RateModifications / @timestamp	1	DateTime	La data e l'ora di creazione di questo messaggio.
RateModifications / HotelRateModifications	0..n	HotelRateModifications	Modifiche alle tariffe di una proprietà. Ogni modifica alla tariffa viene applicata a una singola proprietà. Nota: se alla stessa tariffa possono essere applicate più modifiche della tariffa, verranno applicate tutte le modifiche. Non è garantito alcun ordine specifico.
RateModifications / HotelRateModifications / @hotel_id	1	string	L'identificatore univoco della struttura. Questo valore deve corrispondere all'ID hotel specificato utilizzando `<id>` nell'elemento `<listing>` nel feed elenco hotel. L'ID hotel è indicato anche in Hotel Center.
RateModifications / HotelRateModifications / @action	0..1	enum	Se `action` non è specificato, le modifiche all'interno di questo elemento vengono aggiunte o aggiornate per questo hotel. Se viene specificato `action="overlay"`, tutte le modifiche definite in precedenza per questo hotel vengono prima eliminate. Quindi, vengono scritte le modifiche specificate qui. Se viene utilizzato `action="overlay"` e non vengono specificate modifiche all'interno di questo elemento, tutte le modifiche per questo hotel vengono eliminate.
RateModifications / HotelRateModifications / ItineraryRateModification	0..200	ItineraryRateModification	Una singola modifica alla tariffa per una proprietà. Nota: il debug delle modifiche alle tariffe è difficile e ti consigliamo di usarle con parsimonia. Contatta il tuo Technical Account Manager (TAM) per i casi d'uso che richiedono più di 200 modifiche alle tariffe.
RateModifications / HotelRateModifications / ItineraryRateModification / @id	1	string	Un identificatore univoco per la modifica della tariffa. Il numero massimo di caratteri consentiti è 40. I caratteri consentiti sono a-z, A-Z, 0-9, _ (trattino basso), - (trattino) e . (punto).
RateModifications / HotelRateModifications / ItineraryRateModification / @action	0..1	enum	Se non specificato e una modifica della tariffa con lo stesso `id` non viene memorizzata, questa modifica della tariffa viene memorizzata. In caso contrario, se non specificato e se viene archiviata una modifica della tariffa con lo stesso `id`, la modifica delle tariffe esistente viene aggiornata. Se specificato, il valore deve essere `"delete"`. Se viene specificato `"delete"`, la modifica della tariffa memorizzata con lo stesso `id` viene eliminata. Quando utilizzi `"delete"`, non includere elementi secondari in `<ItineraryRateModification>`. Inoltre, `"delete"` non è consentito insieme a `<HotelRateModifications action="overlay"/>`.
RateModifications / HotelRateModifications / ItineraryRateModification / BookingDates	0..1	BookingDates	Un contenitore di uno o più intervalli di date che definiscono il momento in cui deve essere effettuata la prenotazione affinché venga applicata la modifica della tariffa.
RateModifications / HotelRateModifications / ItineraryRateModification / BookingDates / DateRange	1..99	DateRange	Un intervallo di date che specifica quando deve essere effettuata la prenotazione affinché venga applicata la modifica della tariffa.
RateModifications / HotelRateModifications / ItineraryRateModification / BookingDates / DateRange / @start	0..1	Date	La data di inizio (inclusa) dell'intervallo di date (in base al fuso orario della proprietà). Questa data deve essere precedente o uguale alla data di `end`. Se `start` non è specificato, l'intervallo di date è a tutti gli effetti illimitato in termini di data di inizio.
RateModifications / HotelRateModifications / ItineraryRateModification / BookingDates / DateRange / @end	0..1	Date	La data di fine (inclusa) dell'intervallo di date (in base al fuso orario della proprietà). Questa data deve essere uguale o successiva alla data di `start`. Se `end` non è specificato, l'intervallo di date è a tutti gli effetti illimitato in termini di data di fine.
RateModifications / HotelRateModifications / ItineraryRateModification / BookingDates / DateRange / @days_of_week	0..1	string	I giorni della settimana consentiti nell'intervallo di date. Se non specificato, sono consentiti tutti i giorni nell'intervallo di date. Ogni carattere nella stringa specifica un giorno. Ad esempio, "MTWHF" specifica che nell'intervallo di date sono consentiti i giorni feriali. 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.
RateModifications / HotelRateModifications / ItineraryRateModification / BookingWindow	0..1	BookingWindow	Specifica il periodo di tempo in cui deve essere effettuata la prenotazione rispetto alla data del check-in (in base al fuso orario della proprietà). Ad esempio, la finestra di prenotazione può essere impostata su un minimo di 7 giorni, ma di un massimo di 180 giorni, prima del check-in.
RateModifications / HotelRateModifications / ItineraryRateModification / BookingWindow / @min	0..1	integer	Il numero minimo di giorni prima del check-in in cui deve essere effettuata la prenotazione affinché la modifica della tariffa venga applicata. Se non specificato, non è previsto un valore minimo.
RateModifications / HotelRateModifications / ItineraryRateModification / BookingWindow / @max	0..1	integer	Il numero massimo di giorni prima del check-in in cui deve essere effettuata la prenotazione affinché la modifica della tariffa venga applicata. Se non specificato, non è previsto un limite massimo.
RateModifications / HotelRateModifications / ItineraryRateModification / 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 affinché venga applicata la modifica della tariffa.
RateModifications / HotelRateModifications / ItineraryRateModification / CheckinDates / DateRange	1..99	DateRange	Un intervallo di date che specifica quando deve essere effettuato il check-in affinché venga applicata la modifica della tariffa. Questo elemento non è necessario se stai eliminando una o più modifiche alle tariffe.
RateModifications / HotelRateModifications / ItineraryRateModification / CheckinDates / DateRange / @start	0..1	Date	La data di inizio (inclusa) dell'intervallo di date (in base al fuso orario della proprietà). Questa data deve essere precedente o uguale alla data di `end`. Se `start` non è specificato, l'intervallo di date è a tutti gli effetti illimitato in termini di data di inizio.
RateModifications / HotelRateModifications / ItineraryRateModification / CheckinDates / DateRange / @end	0..1	Date	La data di fine (inclusa) dell'intervallo di date (in base al fuso orario della proprietà). Questa data deve essere uguale o successiva alla data di `start`. Se `end` non è specificato, l'intervallo di date è a tutti gli effetti illimitato in termini di data di fine.
RateModifications / HotelRateModifications / ItineraryRateModification / CheckinDates / DateRange / @days_of_week	0..1	string	I giorni della settimana consentiti nell'intervallo di date. Se non specificato, sono consentiti tutti i giorni nell'intervallo di date. Ogni carattere nella stringa specifica un giorno. Ad esempio, "MTWHF" specifica che nell'intervallo di date sono consentiti i giorni feriali. 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.
RateModifications / HotelRateModifications / ItineraryRateModification / CheckoutDates	0..1	CheckoutDates	Un contenitore di uno o più intervalli di date che definiscono il momento in cui deve essere effettuato il check-out affinché venga applicata la modifica della tariffa.
RateModifications / HotelRateModifications / ItineraryRateModification / CheckoutDates / DateRange	1..99	DateRange	Un intervallo di date che specifica il periodo in cui deve essere effettuato il check-out affinché venga applicata la modifica della tariffa. Questo elemento non è necessario se stai eliminando una o più modifiche alle tariffe.
RateModifications / HotelRateModifications / ItineraryRateModification / CheckoutDates / DateRange / @start	0..1	Date	La data di inizio (inclusa) dell'intervallo di date (in base al fuso orario della proprietà). Questa data deve essere precedente o uguale alla data di `end`. Se `start` non è specificato, l'intervallo di date è a tutti gli effetti illimitato in termini di data di inizio.
RateModifications / HotelRateModifications / ItineraryRateModification / CheckoutDates / DateRange / @end	0..1	Date	La data di fine (inclusa) dell'intervallo di date (in base al fuso orario della proprietà). Questa data deve essere uguale o successiva alla data di `start`. Se `end` non è specificato, l'intervallo di date è a tutti gli effetti illimitato in termini di data di fine.
RateModifications / HotelRateModifications / ItineraryRateModification / CheckoutDates / DateRange / @days_of_week	0..1	string	I giorni della settimana consentiti nell'intervallo di date. Se non specificato, sono consentiti tutti i giorni nell'intervallo di date. Ogni carattere nella stringa specifica un giorno. Ad esempio, "MTWHF" specifica che nell'intervallo di date sono consentiti i giorni feriali. 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.
RateModifications / HotelRateModifications / ItineraryRateModification / Devices	0..1	Devices	Contenitore dell'elenco dei dispositivi degli utenti idonei alla modifica delle tariffe. Se specificata, la modifica della tariffa viene applicata solo se l'utente corrisponde a uno dei dispositivi elencati. Se non specificato, non limita l'applicazione della modifica della tariffa.
RateModifications / HotelRateModifications / ItineraryRateModification / Devices / Device	1..3	Device	Definisce un tipo di dispositivo dell'utente idoneo alla modifica della tariffa.
RateModifications / HotelRateModifications / ItineraryRateModification / Devices / Device / @type	1	enum	Un tipo di dispositivo. Il valore deve essere `desktop`, `tablet` o `mobile`.
RateModifications / HotelRateModifications / ItineraryRateModification / ModificationActions	1	ModificationActions	Azioni applicate alla tariffa se sono soddisfatte tutte le condizioni specificate.
RateModifications / HotelRateModifications / ItineraryRateModification / ModificationActions / PriceAdjustment	0..1	PriceAdjustment	Modifica la tariffa moltiplicando `AmountBeforeTax` e `AmountAfterTax` per il moltiplicatore specificato
RateModifications / HotelRateModifications / ItineraryRateModification / ModificationActions / PriceAdjustment / @multiplier	1	float	Sia `AmountBeforeTax` che `AmountAfterTax` vengono moltiplicati per questo valore.
RateModifications / HotelRateModifications / ItineraryRateModification / ModificationActions / RateRule	0..1	RateRule	Modifica la tariffa applicando l'ID regola tariffaria specificato.
RateModifications / HotelRateModifications / ItineraryRateModification / ModificationActions / RateRule / @id	1	string	Questo ID associa una tariffa a una definizione nel file Definizione delle regole tariffarie. Nota: Il limite di caratteri per questo campo è 40. Ogni tariffa può essere associata a una sola regola tariffaria. Se vengono apportate più modifiche all'applicazione di un ID regola tariffaria, alla tariffa viene assegnato l'ID regola tariffaria più piccolo dal punto di vista grammaticale. Se questo ID non corrisponde a una regola tariffaria nel tuo file di definizione delle regole tariffarie, è considerato non idoneo. Consulta questo articolo per informazioni sulle diverse opzioni di UI delle tariffe private.
RateModifications / HotelRateModifications / ItineraryRateModification / ModificationActions / Refundable	0..1	Refundable	Sovrascrive la rimborsabilità della tariffa con il valore specificato. Quando imposti gli attributi, tieni presente quanto segue: Questa azione di modifica riscrive completamente l'impostazione Rimborsabile di una tariffa idonea, non solo i campi compilati. Se `available` o `refundable_until_days` non è impostata, la tariffa non viene mostrata come rimborsabile. Se `available` è `0` o `false`, gli altri attributi vengono ignorati. La tariffa non viene mostrata come rimborsabile anche se sono impostati uno o entrambi gli altri attributi. È consigliabile impostare `refundable_until_time`; se non viene configurato, viene utilizzata la prima ora (mezzanotte).
RateModifications / HotelRateModifications / ItineraryRateModification / ModificationActions / Refundable / @available	1	boolean	(Obbligatorio) Deve essere impostato su `1` o `true` per indicare se la tariffa consente un rimborso totale; in caso contrario, deve essere impostato su `0` o `false`.
Transaction / PropertyDataSet / PackageData / Refundable / @refundable_until_days	0..1	integer	(Obbligatorio se `available` è `true`) Specifica il numero di giorni prima del check-in entro cui è possibile richiedere un rimborso totale. Il valore di `refundable_until_days` deve essere un numero intero compreso tra 0 e 330 inclusi.
RateModifications / HotelRateModifications / ItineraryRateModification / ModificationActions / Refundable / @refundable_until_time	0..1	Time	(Consigliato se `available` è `true`) Specifica l'ora più recente del giorno, nell'ora locale dell'hotel, entro cui viene soddisfatta una richiesta di rimborso totale. Puoi combinare questo valore con `refundable_until_days` per specificare, ad esempio, che "i rimborsi sono disponibili fino alle 16:00 di due giorni prima del check-in". Se `refundable_until_time` non è configurato, il valore predefinito è mezzanotte.
RateModifications / HotelRateModifications / ItineraryRateModification / ModificationActions / Availability	0..1	Availability	Sovrascrive la disponibilità della tariffa con il valore specificato. Supportiamo solo l'impostazione della tariffa su `unavailable`.
RateModifications / HotelRateModifications / ItineraryRateModification / ModificationActions / Availability / @status	1	enum	Con `status="unavailable"`, la tariffa viene trattata come se non fosse disponibile, indipendentemente dall'esistenza o meno di un prezzo valido.
RateModifications / HotelRateModifications / ItineraryRateModification / LengthOfStay	0..1	LengthOfStay	Definisce i limiti di durata del soggiorno entro i quali è possibile applicare questa modifica della tariffa. La modifica della tariffa non viene applicata se la durata del soggiorno non rientra nei limiti minimo e massimo.
RateModifications / HotelRateModifications / ItineraryRateModification / LengthOfStay / @min	0..1	integer	Il numero minimo di notti consentito per il soggiorno affinché venga applicata la modifica della tariffa. Se non specificato, non è previsto un limite minimo.
RateModifications / HotelRateModifications / ItineraryRateModification / LengthOfStay / @max	0..1	integer	Il numero massimo di notti consentito per il soggiorno affinché venga applicata la modifica della tariffa. Se non specificato, non è previsto un limite massimo.
RateModifications / HotelRateModifications / ItineraryRateModification / MinimumAmount	0..1	MinimumAmount	Specifica la somma minima delle tariffe giornaliere della camera (utilizzando il valore maggiore tra `AmountBeforeTax` o `AmountAfterTax`) che deve essere superata affinché la modifica della tariffa venga applicata.
RateModifications / HotelRateModifications / ItineraryRateModification / MinimumAmount / @before_discount	1	integer	Il valore che deve essere superato per applicare la modifica della tariffa.
RateModifications / HotelRateModifications / ItineraryRateModification / RatePlans	0..1	RatePlans	Contenitore di un elenco di piani tariffari a cui si applica la modifica tariffaria. Se `<RatePlans>` non è specificato, la modifica delle tariffe si applica a tutti i piani tariffari.
RateModifications / HotelRateModifications / ItineraryRateModification / RatePlans / RatePlan	1..n	RatePlan	Specifica un piano tariffario. Un piano tariffario viene definito da una combinazione di pacchetto, tariffe e disponibilità, come definito nei messaggi Transaction (Property Data), OTA_HotelRateAmountNotifRQ e OTA_HotelAvailNotimul e come identificato da PackageID.
RateModifications / HotelRateModifications / ItineraryRateModification / RatePlans / RatePlan / @id	1	string	L'identificatore univoco del piano tariffario. Questo valore è mappato al valore PackageID in `<PackageData>` in un messaggio Transaction (Property Data) e nell'attributo `RatePlanCode` in `<StatusApplicationControl>` in entrambi i messaggi `<OTA_HotelRateAmountNotifRQ>` e `<OTA_HotelAvailNotifRQ>`. Il numero massimo di caratteri consentiti è 50.
RateModifications / HotelRateModifications / ItineraryRateModification / RoomTypes	0..1	RoomTypes	Contenitore di un elenco di tipi di camera a cui si applica la modifica della tariffa. La modifica delle tariffe viene applicata a ogni `<RoomType>` specificato. Se `<RoomTypes>` non è specificato, la modifica della tariffa si applica a tutte le camere.
RateModifications / HotelRateModifications / ItineraryRateModification / RoomTypes / RoomType	1..n	RoomType	Specifica un tipo di camera. Un tipo di camera è definito in un elemento `<RoomData>` in un messaggio Transaction (Property Data) e viene fatto riferimento tramite il relativo valore `<RoomID>`. (al valore `<RoomID>` viene fatto riferimento anche tramite l'attributo `InvTypeCode` nei messaggi OTA_HotelRateAmountNotifRQ).
RateModifications / HotelRateModifications / ItineraryRateModification / RoomTypes / RoomType / @id	1	string	L'identificatore univoco dell'inventario (tipo di camera). Questo valore è mappato a `<RoomID>` in un messaggio Transaction (Property Data). Il numero massimo di caratteri consentiti è 50.
RateModifications / HotelRateModifications / ItineraryRateModification / StayDates	0..1	StayDates	Un contenitore di uno o più intervalli di date che determinano il modo in cui viene applicata la modifica delle tariffe, ad esempio per adeguarsi ai prezzi stagionali.
RateModifications / HotelRateModifications / ItineraryRateModification / StayDates / @application	1	enum	Descrive come deve essere applicata la modifica dell'aliquota. I valori validi sono: `all`: applica la modifica della tariffa a ogni notte nell'itinerario se tutte le date nell'itinerario si sovrappongono alle date del soggiorno. `any`: applica la modifica della tariffa a tutte le notti nell'itinerario se una qualsiasi data nell'itinerario si sovrappone a una nell'intervallo di date del soggiorno. Questo attributo deve essere sempre specificato.
RateModifications / HotelRateModifications / ItineraryRateModification / StayDates / DateRange	1..99	DateRange	Un intervallo di date che specifica le date in cui deve essere applicata la modifica delle tariffe.
RateModifications / HotelRateModifications / ItineraryRateModification / StayDates / DateRange / @start	0..1	Date	La data di inizio (inclusa) dell'intervallo di date (in base al fuso orario della proprietà). Questa data deve essere precedente o uguale alla data di `end`. Se `start` non è specificato, l'intervallo di date è a tutti gli effetti illimitato in termini di data di inizio.
RateModifications / HotelRateModifications / ItineraryRateModification / StayDates / DateRange / @end	0..1	Date	La data di fine (inclusa) dell'intervallo di date (in base al fuso orario della proprietà). Questa data deve essere uguale o successiva alla data di `start`. Se `end` non è specificato, l'intervallo di date è a tutti gli effetti illimitato in termini di data di fine.
RateModifications / HotelRateModifications / ItineraryRateModification / StayDates / DateRange / @days_of_week	0..1	string	I giorni della settimana consentiti nell'intervallo di date. Se non specificato, sono consentiti tutti i giorni nell'intervallo di date. Ogni carattere nella stringa specifica un giorno. Ad esempio, "MTWHF" specifica che nell'intervallo di date sono consentiti i giorni feriali. 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.
RateModifications / HotelRateModifications / ItineraryRateModification / UserCountries	0..1	UserCountries	Se specificato, la modifica delle tariffe viene applicata solo se l'utente si trova in uno dei paesi specificati. Se non specificato, la modifica della tariffa viene applicata indipendentemente dalla località dell'utente.
RateModifications / HotelRateModifications / ItineraryRateModification / UserCountries / @type	0..1	enum	Il tipo di specifica UserCountries. I valori validi sono `include` e `exclude`. Se il valore `type` UserCountries è impostato su `include`, la modifica delle tariffe si applica agli utenti dei paesi elencati. Se il valore `type` UserCountries è `exclude`, la modifica delle tariffe si applica agli utenti al di fuori dei paesi elencati. Se il valore `type` UserCountries non viene configurato, viene trattato come `include` e la modifica delle tariffe si applica agli utenti dei paesi elencati.
RateModifications / HotelRateModifications / ItineraryRateModification / UserCountries / Country	1..300	Country	Specifica un paese dell'utente consentito per la modifica delle tariffe.
RateModifications / HotelRateModifications / ItineraryRateModification / UserCountries / Country / @code	1	string	Un codice paese CLDR, ad esempio `DE` o `FR`. Tieni presente che, per alcuni paesi, il codice paese CLDR non corrisponde al codice paese ISO di due lettere. Inoltre, i codici regione CLDR non sono supportati.

Esempi

Messaggio di base

L'esempio seguente mostra un messaggio RateModifications di base:

<?xml version="1.0" encoding="UTF-8"?>
<RateModifications partner="account_xyz"
                   id="123_abc"
                   timestamp="2023-05-22T16:20:00-04:00">
  <HotelRateModifications hotel_id="Property_1">
    <ItineraryRateModification id="1">
      <BookingDates>
         <DateRange start="2023-07-01" end="2023-07-31" days_of_week="MTWHF"/>
         <DateRange start="2023-09-01" end="2023-09-30"/>
      </BookingDates>
      <BookingWindow min="7" max="330"/>
      <CheckinDates>
         <DateRange start="2023-10-01" end="2023-10-31" days_of_week="FSU"/>
      </CheckinDates>
      <CheckoutDates>
         <DateRange start="2023-10-08" end="2023-11-07" days_of_week="FSU"/>
      </CheckoutDates>
      <Devices>
        <Device type="mobile"/>
        <Device type="tablet"/>
      </Devices>
      <LengthOfStay min="2" max="14"/>
      <RatePlans>
         <RatePlan id="234"/>
         <RatePlan id="567"/>
      </RatePlans>
      <RoomTypes>
         <RoomType id="123"/>
         <RoomType id="456"/>
      </RoomTypes>
      <UserCountries>
        <Country code="US"/>
        <Country code="GB"/>
      </UserCountries>
      <ModificationActions>
        <PriceAdjustment multiplier="1.2"/>
      </ModificationActions>
    </ItineraryRateModification>
  </HotelRateModifications>
</RateModifications>

Elimina una modifica alla tariffa

L'esempio seguente mostra come eliminare una modifica della tariffa per una proprietà:

<?xml version="1.0" encoding="UTF-8"?>
<RateModifications partner="account_xyz"
                   id="123_abc"
                   timestamp="2023-05-22T16:20:00-04:00">
  <HotelRateModifications hotel_id="Property_1">
    <ItineraryRateModification id="1" action="delete"/>
  </HotelRateModifications>
</RateModifications>

Elimina tutte le modifiche alle tariffe

L'esempio seguente mostra come eliminare tutte le modifiche alle tariffe per una proprietà:

<?xml version="1.0" encoding="UTF-8"?>
<RateModifications partner="account_xyz"
                   id="123_abc"
                   timestamp="2023-05-22T16:20:00-04:00">
  <HotelRateModifications hotel_id="Property_1" action="overlay"/>
</RateModifications>

Sovrapponi tutte le modifiche tariffarie

L'esempio seguente mostra come sovrapporre <HotelRateModifications> per la proprietà con una o più nuove modifiche alle tariffe. Quando action="overlay", tutte le modifiche alle tariffe memorizzate vengono eliminate prima di memorizzare le modifiche delle tariffe specificate nel messaggio corrente:

<?xml version="1.0" encoding="UTF-8"?>
<RateModifications partner="account_xyz"
                   id="123_abc"
                   timestamp="2023-05-22T16:20:00-04:00">
  <HotelRateModifications hotel_id="Property_1" action="overlay"/>
    <ItineraryRateModification id="1">
      <BookingDates>
         <DateRange start="2023-09-01" end="2023-09-30"/>
      </BookingDates>
      <ModificationActions>
        <PriceAdjustment multiplier="1.2"/>
      </ModificationActions>
      <RoomTypes>
         <RoomType id="123"/>
         <RoomType id="456"/>
      </RoomTypes>
      <RatePlans>
         <RatePlan id="234"/>
         <RatePlan id="567"/>
      </RatePlans>
    </ItineraryRateModification>
  </HotelRateModifications>
</RateModifications>

Più azioni di modifica

L'esempio seguente mostra come eseguire più azioni di modifica contemporaneamente:

<?xml version="1.0" encoding="UTF-8"?>
<RateModifications partner="account_xyz"
                   id="123_abc"
                   timestamp="2023-05-22T16:20:00-04:00">
  <HotelRateModifications hotel_id="Property_1">
    <ItineraryRateModification id="1">
      <BookingDates>
         <DateRange start="2023-01-01" end="2023-02-28"/>
      </BookingDates>
      <ModificationActions>
        <PriceAdjustment multiplier=".95"/>
        <Refundable available="true"
                    refundable_until_days="1"
                    refundable_until_time="12:00:00"/>
      </ModificationActions>
    </ItineraryRateModification>
  </HotelRateModifications>
</RateModifications>

Disattivare un piano tariffario per i paesi degli utenti

L'esempio seguente mostra come limitare un piano tariffario solo agli utenti in giapponese (JP):

<?xml version="1.0" encoding="UTF-8"?>
<RateModifications partner="account_xyz"
                   id="123_abc"
                   timestamp="2023-05-22T16:20:00-04:00">
  <HotelRateModifications hotel_id="Property_1">
    <ItineraryRateModification id="1">
      <RatePlans>
         <RatePlan id="jp_only"/>
      </RatePlans>
      <UserCountries type="exclude">
        <Country code="JP"/>
      </UserCountries>
      <ModificationActions>
        <Availability status="unavailable"/>
      </ModificationActions>
    </ItineraryRateModification>
  </HotelRateModifications>
</RateModifications>

Risposte

Sintassi

Il messaggio RateModificationsResponse utilizza la seguente sintassi:

<?xml version="1.0" encoding="UTF-8"?>
<RateModificationsResponse timestamp="timestamp"
                    id="message_ID"
                    partner="partner_key">
  <!-- Either Success or Issues will be populated. -->
  <Success/>
  <Issues>
    <Issue code="issue_code" status="issue_type"><var>issue_description</var></Issue>
  </Issues>
</RateModificationsResponse>

Elementi e attributi

Il messaggio RateModificationsResponse contiene i seguenti elementi e attributi:

Elemento / @attributo	Occorrenze	Tipo	Descrizione
RateModifications	1	Complex element	L'elemento principale che indica l'esito positivo o negativo di un messaggio di richiesta RateModifications ricevuto.
RateModificationsResponse / @timestamp	1	DateTime	La data e l'ora di creazione di questo messaggio.
RateModificationsResponse / @id	1	string	L'identificatore univoco del messaggio RateModifications associato.
RateModificationsResponse / @partner	1	string	L'account partner per questo messaggio.
RateModificationsResponse / Success	0..1	Success	Indica che il messaggio RateModifications è stato elaborato correttamente senza avvisi, errori o problemi. In ogni messaggio è presente `<Success>` o `<Issues>`.
RateModificationsResponse / Issues	0..1	Issues	Un contenitore per uno o più problemi riscontrati durante l'elaborazione del messaggio RateModifications. In ogni messaggio è presente `<Success>` o `<Issues>`.
RateModificationsResponse / Issues / Issue	1..n	Issue	La descrizione di un avviso, un errore o un errore riscontrato durante l'elaborazione del messaggio RateModifications. Per informazioni dettagliate su questi problemi, consulta la sezione Messaggi di errore relativi allo stato dei feed.
RateModificationsResponse / Issues / Issue / @code	1	integer	L'identificatore del problema.
RateModificationsResponse / 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 un messaggio RateModifications elaborato correttamente.

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

Problemi

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

<?xml version="1.0" encoding="UTF-8"?>
<RateModificationsResponse timestamp="2023-05-22T16:20:00-04:00"
                    id="12345678"
                    partner="partner_key">
  <Issues>
    <Issue code="1001" status="error">Example</Issue>
  </Issues>
</RateModificationsResponse>