Questa pagina è stata tradotta dall'API Cloud Translation.

Modifiche tariffe

Panoramica

Questa API consente di definire modalità per applicare dinamicamente azioni a una tariffa ogni volta vengano soddisfatte determinate condizioni, ad esempio l'adeguamento del prezzo o l'attivazione del rimborso. A differenza dell'API Promotions, che può essere applicata le promozioni idonee con gli sconti più alti, questa API applica qualsiasi azione quando vengono soddisfatte determinate condizioni, tra cui gli aggiustamenti dei prezzi che potrebbero 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 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 .
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à. Viene applicata ogni modifica alla tariffa a una singola proprietà. Nota: se è possibile apportare più modifiche alle tariffe con la stessa tariffa, vengono applicate tutte le modifiche. Nessun ordine specifico è garantito.
RateModifications / HotelRateModifications / @hotel_id	1	string	L'identificatore univoco della struttura. Questo valore deve corrispondere alla 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 aggiunti o aggiornati per questo hotel. Se `action="overlay"` è specificato, quindi tutti i valori definiti in precedenza le modifiche apportate a questo hotel vengono prima eliminate. Quindi, le modifiche qui specificati. Se viene utilizzato `action="overlay"` e non vengono specificate modifiche all'interno di questo elemento, le modifiche apportate a questo hotel sono state eliminate.
RateModifications / HotelRateModifications / ItineraryRateModification	0..200	ItineraryRateModification	Una singola modifica alla tariffa per una proprietà. Nota. È difficile eseguire il debug delle modifiche alle tariffe e consigliano di usarli 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 è pari a 40 caratteri. 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 memorizzato, poi viene memorizzata la modifica della tariffa. In caso contrario, se non specificato e una modifica della tariffa con lo stesso `id` viene memorizzato, poi la modifica della tariffa esistente viene aggiornato. Se specificato, il valore deve essere `"delete"`. Se `"delete"` è specificato, la modifica della tariffa memorizzata con lo stesso `id` viene eliminata. Quando utilizzi `"delete"`, non includere elementi secondari in `<ItineraryRateModification>`. Inoltre, `"delete"` non è consentito in combinazione con `<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 la prenotazione deve essere per applicare la modifica della tariffa.
RateModifications / HotelRateModifications / ItineraryRateModification / BookingDates / DateRange	1..99	DateRange	Un intervallo di date che specifica quando deve essere effettuata la prenotazione per la tariffa la modifica da applicare.
RateModifications / HotelRateModifications / ItineraryRateModification / 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.
RateModifications / HotelRateModifications / ItineraryRateModification / 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 Data `start`. Se `end` non è specificato, la data è effettivamente 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. 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.
RateModifications / HotelRateModifications / ItineraryRateModification / BookingWindow	0..1	BookingWindow	Specifica il periodo di tempo in cui deve essere effettuata la prenotazione rispetto al 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 non di più 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 della modifica della tariffa. Se non specificato, non è un 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 della modifica della tariffa. Se non specificato, non è 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 per la tariffa la modifica da applicare. Questo elemento non è obbligatorio se l'eliminazione di una o più modifiche alla tariffa.
RateModifications / HotelRateModifications / ItineraryRateModification / 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.
RateModifications / HotelRateModifications / ItineraryRateModification / 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 Data `start`. Se `end` non è specificato, la data è effettivamente 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. 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.
RateModifications / HotelRateModifications / ItineraryRateModification / CheckoutDates	0..1	CheckoutDates	Un contenitore di uno o più intervalli di date che definiscono il momento del pagamento 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 per la tariffa la modifica da applicare. Questo elemento non è obbligatorio se l'eliminazione di una o più modifiche alla tariffa.
RateModifications / HotelRateModifications / ItineraryRateModification / 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.
RateModifications / HotelRateModifications / ItineraryRateModification / 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 Data `start`. Se `end` non è specificato, la data è effettivamente 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. 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.
RateModifications / HotelRateModifications / ItineraryRateModification / Devices	0..1	Devices	Contenitore dell'elenco dei dispositivi utente idonei per il della modifica della tariffa. Se specificato, la modifica della tariffa viene applicata applicata se l'utente corrisponde a uno dei dispositivi elencati. Se non specificato, ciò 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 tariffa modifica.
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 tutte le condizioni specificate sono soddisfatti.
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` sono moltiplicato 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 in File di 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 a un ID regola tariffaria, il valore l'ID regola tariffaria il più piccolo lessicograficamente assegnato a la tariffa. Se questo ID non corrisponde a una regola tariffaria nella tua definizione di regola tariffaria il file viene considerato non idoneo. di Gemini Advanced. Vedi questo articolo per informazioni sulle diverse UI delle tariffe private i trattamenti.
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 la voce Rimborsabile di una tariffa idonea non solo i campi compilati. Se `available` o `refundable_until_days` è non impostato, la tariffa non viene visualizzata come rimborsabile. Se `available` è `0` o `false`, mentre gli altri vengono ignorati. La tariffa non viene visualizzata come Rimborsabile anche se uno o entrambi gli altri attributi sono impostati. Ti consigliamo di impostare `refundable_until_time`. in caso contrario impostata, viene utilizzata la prima ora (mezzanotte).
RateModifications / HotelRateModifications / ItineraryRateModification / ModificationActions / Refundable / @available	1	boolean	(Obbligatorio) Impostato su `1` o `true` per indicare se la tariffa consente un addebito completo refund; altrimenti 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 ricevere un rimborso totale richiesto. 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'ultima ora del giorno, nell'ora locale dell'hotel, che la richiesta di rimborso viene soddisfatta. Questo può essere combinato con `refundable_until_days` da specificare, per ad esempio "i rimborsi sono disponibili fino alle 16:00 di due giorni prima controllo". Se `refundable_until_time` non è impostato, il valore 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	Se `status="unavailable"`, la tariffa viene trattata come se non fosse disponibile, indipendentemente dal fatto che esista un prezzo valido per li annotino.
RateModifications / HotelRateModifications / ItineraryRateModification / LengthOfStay	0..1	LengthOfStay	Definisce i limiti di durata del soggiorno entro i quali è possibile modificare la tariffa . La modifica della tariffa non viene applicata se la durata del soggiorno è al di fuori dei limiti minimo e massimo.
RateModifications / HotelRateModifications / ItineraryRateModification / LengthOfStay / @min	0..1	integer	Il numero minimo di notti consentito per il soggiorno affinché la modifica della tariffa sia applicata applicati. 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é la modifica della tariffa sia applicata applicati. 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 per applicare la modifica della tariffa.
RateModifications / HotelRateModifications / ItineraryRateModification / MinimumAmount / @before_discount	1	integer	Il valore che deve essere superato affinché la modifica della tariffa venga applicati.
RateModifications / HotelRateModifications / ItineraryRateModification / RatePlans	0..1	RatePlans	Contenitore di un elenco di piani tariffari a cui viene applicata la modifica della tariffa . Se `<RatePlans>` non è specificato, la tariffa la modifica si applica a tutti i piani tariffari.
RateModifications / HotelRateModifications / ItineraryRateModification / 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
RateModifications / HotelRateModifications / ItineraryRateModification / RatePlans / RatePlan / @id	1	string	L'identificatore univoco del piano tariffario. Questo valore viene mappato Valore PackageID in `<PackageData>` in un messaggio Transaction (Property Data) e Attributo `RatePlanCode` in `<StatusApplicationControl>` in entrambi `<OTA_HotelRateAmountNotifRQ>` e `<OTA_HotelAvailNotifRQ>` messaggi. 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. Il tipo di camera è definito in `<RoomData>` elemento in un Transaction (Property Data) e viene a cui viene fatto riferimento usando il suo valore `<RoomID>`. (È Il valore `<RoomID>` fa riferimento anche dal Attributo `InvTypeCode` in OTA_HotelRateAmountNotifRQ messages.)
RateModifications / HotelRateModifications / ItineraryRateModification / RoomTypes / RoomType / @id	1	string	L'identificatore univoco dell'inventario (tipo di camera). Questo valore viene 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 modifiche alle 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 in L'itinerario se tutte le date nell'itinerario si sovrappongono con le date del soggiorno. `any`: applica la modifica della tariffa a tutte le notti in l'itinerario se una qualsiasi data dell'itinerario si sovrappone a una data in l'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 apportata la modifica dell'indice applicati.
RateModifications / HotelRateModifications / ItineraryRateModification / 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.
RateModifications / HotelRateModifications / ItineraryRateModification / 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.
RateModifications / HotelRateModifications / ItineraryRateModification / 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.
RateModifications / HotelRateModifications / ItineraryRateModification / UserCountries	0..1	UserCountries	Se specificato, la modifica delle tariffe viene applicata solo se l'utente che si trovano in uno dei paesi specificati. Se non specificato, la tariffa la modifica sia applicata indipendentemente dalla località in cui si trova l'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 come `include`, la modifica della tariffa si applica a degli 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 impostato, viene trattato come `include` e la modifica della tariffa 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 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.

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 un 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 un 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 con una o più nuove modifiche alle tariffe. Quando action="overlay", tutte le modifiche alle tariffe memorizzate vengono eliminate prima del giorno memorizzando le modifiche di tariffa 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 a Utenti giapponesi (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 quanto segue 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.
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 o errori. `<Success>` o `<Issues>` sono presenti in ogni messaggio.
RateModificationsResponse / Issues	0..1	Issues	Un container per uno o più problemi riscontrati durante l'elaborazione Messaggio RateModifications. `<Success>` o `<Issues>` sono presenti in ogni messaggio.
RateModificationsResponse / Issues / Issue	1..n	Issue	La descrizione di un avviso, un errore o un errore riscontrato durante durante l'elaborazione del messaggio RateModifications. I dettagli su questi problemi possono essere trovato in Errore di stato dei feed Messaggi.
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 una modifica di RateModifica elaborata 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>