Salsa API XML

Salsa fornisce accesso via API alla lettura e scrittura di disponibilità, tariffe e prenotazioni di un hotel. L'accesso viene fornito tramite protocollo xml over https attraverso questa url:

https://salsa-api.caprionline.it/xml

Aggiornamenti

1 mar 2017
Aggiunta possibilità di specificare l'ID della tariffa in Booking_AvailabilityRead, Booking_AvailabilityWrite, Booking_RateTreatmentsRead e Booking_RateTreatmentsWrite
3 mar 2015
Aggiunte informazioni sulla tariffa prenotata in Booking_ReservationsRead
18 feb 2015
Aggiunta possibilità di aprire/chiudere una tariffa speciale in Booking_RatesTreatmentsWrite
15 gen 2015
Aggiunta gestione tariffe speciali
12 nov 2014
Aggiunte API Booking_RatesTreatmentsRead e Booking_RatesTreatmentsWrite, rispettivamente per leggere e scrivere i prezzi del trattamento base e gli altri supplementi. Queste API sostituiscono Booking_RatesRead e Booking_RatesWrite, ora deprecate.
Aggiunte API Booking_ConfigurationTreatmentsRead e Booking_ConfigurationTreatmentsWrite, rispettivamente per leggere e scrivere nella configurazione dell'hotel il trattamento base e gli altri supplementi.
10 feb 2014
Aggiunto supporto ad altri trattamenti a Booking_RatesRead, Booking_RatesWrite e Booking_ReservationsRead

API disponibili

Elenco delle API supportate con relativi esempi:

Booking_AvailabilityRead

Visualizza la disponibilità di una o più camere, in uno o più periodi. Si può indicare una tariffa specifica per cui visualizzare i dati.

Richiesta

  • Authentication
    • @key - Chiave per l'autenticazione
  • Hotel
    • @id - Identificativo dell'hotel
  • Room - Una o più camere
    • @id - Identificativo della camera
    • @rate_id - Identificativo della tariffa (facoltativo)
    • @rate_type - Tipo di tariffa speciale (facoltativo) - Deprecato, si consiglia di usare rate_id
    • @rate_days - Giorni di anticipo per le tariffe di advance booking (facoltativo) - Deprecato, si consiglia di usare rate_id
  • Period - Uno o più periodi
    • @from - Data di check-in (es. 2012-03-04)
    • @to - Data di check-out (es. 2012-03-06)

Risposta

  • Hotel
    • @id - Identificativo dell'hotel
  • Rooms
    • Room - Una o più camere
      • @id - Identificativo della camera
      • Date - Uno o più periodi
        • @value - Giorno di permanenza
        • Availability - Disponibilità della camera
        • MinimumStay - Soggiorno minimo richiesto
        • CloseToArrival - Arrivi non consentiti in questa data (0/1)
        • CloseToDeparture - Partenze non consentite in questa data (0/1)

Esempio camera singola, unico periodo

Richiesta

<?xml version="1.0"?>
<Booking_AvailabilityReadRQ>
  <Authentication key="Yeip1oVp03AbmUAvLQhrFkaI"/>
  <Hotel id="2226"/>
  <Room id="1155"/>
  <Period from="2012-03-04" to="2012-03-06"/>
</Booking_AvailabilityReadRQ>

Risposta

<?xml version="1.0"?>
<Booking_AvailabilityReadRS>
  <Hotel id="2226"/>
  <Rooms>
    <Room id="1155">
      <Date value="2012-03-04">
        <Availability>1</Availability>
        <MinimumStay>1</MinimumStay>
        <CloseToArrival>0</CloseToArrival>
        <CloseToDeparture>0</CloseToDeparture>
      </Date>
      <Date value="2012-03-05">
        <Availability>0</Availability>
        <MinimumStay>5</MinimumStay>
        <CloseToArrival>0</CloseToArrival>
        <CloseToDeparture>1</CloseToDeparture>
      </Date>
      <Date value="2012-03-06">
        <Availability>5</Availability>
        <MinimumStay>2</MinimumStay>
        <CloseToArrival>0</CloseToArrival>
        <CloseToDeparture>0</CloseToDeparture>
      </Date>
  </Rooms>
</Booking_AvailabilityReadRS>

Esempio più camere nello stesso periodo

Richiesta

<?xml version="1.0"?>
<Booking_AvailabilityReadRQ>
  <Authentication key="tGQbacFT94MEgLaHoFrK8mP5"/>
  <Hotel id="2227"/>
  <Room id="1158"/>
  <Room id="1159"/>
  <Room id="1160"/>
  <Period from="2012-03-04" to="2012-03-06"/>
</Booking_AvailabilityReadRQ>

Risposta

<?xml version="1.0"?>
<Booking_AvailabilityReadRS>
  <Hotel id="2227"/>
  <Rooms>
    <Room id="1158">
      <Date value="2012-03-04">
        <Availability>9</Availability>
        <MinimumStay>1</MinimumStay>
        <CloseToArrival>0</CloseToArrival>
        <CloseToDeparture>0</CloseToDeparture>
      </Date>
      <Date value="2012-03-05">
        <Availability>8</Availability>
        <MinimumStay>3</MinimumStay>
        <CloseToArrival>0</CloseToArrival>
        <CloseToDeparture>0</CloseToDeparture>
      </Date>
      <Date value="2012-03-06">
        <Availability>0</Availability>
        <MinimumStay>5</MinimumStay>
        <CloseToArrival>0</CloseToArrival>
        <CloseToDeparture>1</CloseToDeparture>
      </Date>
    </Room>
    <Room id="1159">
      <Date value="2012-03-04">
        <Availability>2</Availability>
        <MinimumStay>7</MinimumStay>
        <CloseToArrival>0</CloseToArrival>
        <CloseToDeparture>1</CloseToDeparture>
      </Date>
      <Date value="2012-03-05">
        <Availability>4</Availability>
        <MinimumStay>4</MinimumStay>
        <CloseToArrival>1</CloseToArrival>
        <CloseToDeparture>1</CloseToDeparture>
      </Date>
      <Date value="2012-03-06">
        <Availability>6</Availability>
        <MinimumStay>3</MinimumStay>
        <CloseToArrival>0</CloseToArrival>
        <CloseToDeparture>0</CloseToDeparture>
      </Date>
    </Room>
    <Room id="1160">
      <Date value="2012-03-04">
        <Availability>2</Availability>
        <MinimumStay>4</MinimumStay>
        <CloseToArrival>1</CloseToArrival>
        <CloseToDeparture>0</CloseToDeparture>
      </Date>
      <Date value="2012-03-05">
        <Availability>1</Availability>
        <MinimumStay>1</MinimumStay>
        <CloseToArrival>1</CloseToArrival>
        <CloseToDeparture>0</CloseToDeparture>
      </Date>
      <Date value="2012-03-06">
        <Availability>2</Availability>
        <MinimumStay>7</MinimumStay>
        <CloseToArrival>0</CloseToArrival>
        <CloseToDeparture>0</CloseToDeparture>
      </Date>
    </Room>
  </Rooms>
</Booking_AvailabilityReadRS>

Esempio più camere in più periodi

Richiesta

<?xml version="1.0"?>
<Booking_AvailabilityReadRQ>
  <Authentication key="nt0SbugdjyxyxoBcx3YWcNkg"/>
  <Hotel id="2228"/>
  <Room id="1161"/>
  <Room id="1162"/>
  <Room id="1163"/>
  <Period from="2012-03-04" to="2012-03-06"/>
  <Period from="2012-03-12" to="2012-03-14"/>
</Booking_AvailabilityReadRQ>

Risposta

<?xml version="1.0"?>
<Booking_AvailabilityReadRS>
  <Hotel id="2228"/>
  <Rooms>
    <Room id="1161">
      <Date value="2012-03-04">
        <Availability>9</Availability>
        <MinimumStay>2</MinimumStay>
        <CloseToArrival>1</CloseToArrival>
        <CloseToDeparture>1</CloseToDeparture>
      </Date>
      <Date value="2012-03-05">
        <Availability>4</Availability>
        <MinimumStay>6</MinimumStay>
        <CloseToArrival>1</CloseToArrival>
        <CloseToDeparture>1</CloseToDeparture>
      </Date>
      <Date value="2012-03-06">
        <Availability>6</Availability>
        <MinimumStay>6</MinimumStay>
        <CloseToArrival>1</CloseToArrival>
        <CloseToDeparture>1</CloseToDeparture>
      </Date>
      <Date value="2012-03-12">
        <Availability>8</Availability>
        <MinimumStay>1</MinimumStay>
        <CloseToArrival>1</CloseToArrival>
        <CloseToDeparture>1</CloseToDeparture>
      </Date>
      <Date value="2012-03-13">
        <Availability>9</Availability>
        <MinimumStay>3</MinimumStay>
        <CloseToArrival>0</CloseToArrival>
        <CloseToDeparture>0</CloseToDeparture>
      </Date>
      <Date value="2012-03-14">
        <Availability>8</Availability>
        <MinimumStay>5</MinimumStay>
        <CloseToArrival>1</CloseToArrival>
        <CloseToDeparture>0</CloseToDeparture>
      </Date>
    </Room>
    <Room id="1162">
      <Date value="2012-03-04">
        <Availability>4</Availability>
        <MinimumStay>3</MinimumStay>
        <CloseToArrival>1</CloseToArrival>
        <CloseToDeparture>1</CloseToDeparture>
      </Date>
      <Date value="2012-03-05">
        <Availability>4</Availability>
        <MinimumStay>3</MinimumStay>
        <CloseToArrival>1</CloseToArrival>
        <CloseToDeparture>1</CloseToDeparture>
      </Date>
      <Date value="2012-03-06">
        <Availability>7</Availability>
        <MinimumStay>4</MinimumStay>
        <CloseToArrival>0</CloseToArrival>
        <CloseToDeparture>1</CloseToDeparture>
      </Date>
      <Date value="2012-03-12">
        <Availability>7</Availability>
        <MinimumStay>4</MinimumStay>
        <CloseToArrival>1</CloseToArrival>
        <CloseToDeparture>0</CloseToDeparture>
      </Date>
      <Date value="2012-03-13">
        <Availability>2</Availability>
        <MinimumStay>3</MinimumStay>
        <CloseToArrival>1</CloseToArrival>
        <CloseToDeparture>0</CloseToDeparture>
      </Date>
      <Date value="2012-03-14">
        <Availability>5</Availability>
        <MinimumStay>3</MinimumStay>
        <CloseToArrival>0</CloseToArrival>
        <CloseToDeparture>0</CloseToDeparture>
      </Date>
    </Room>
    <Room id="1163">
      <Date value="2012-03-04">
        <Availability>8</Availability>
        <MinimumStay>3</MinimumStay>
        <CloseToArrival>1</CloseToArrival>
        <CloseToDeparture>1</CloseToDeparture>
      </Date>
      <Date value="2012-03-05">
        <Availability>3</Availability>
        <MinimumStay>7</MinimumStay>
        <CloseToArrival>0</CloseToArrival>
        <CloseToDeparture>0</CloseToDeparture>
      </Date>
      <Date value="2012-03-06">
        <Availability>1</Availability>
        <MinimumStay>6</MinimumStay>
        <CloseToArrival>1</CloseToArrival>
        <CloseToDeparture>1</CloseToDeparture>
      </Date>
      <Date value="2012-03-12">
        <Availability>0</Availability>
        <MinimumStay>3</MinimumStay>
        <CloseToArrival>0</CloseToArrival>
        <CloseToDeparture>0</CloseToDeparture>
      </Date>
      <Date value="2012-03-13">
        <Availability>2</Availability>
        <MinimumStay>2</MinimumStay>
        <CloseToArrival>0</CloseToArrival>
        <CloseToDeparture>0</CloseToDeparture>
      </Date>
      <Date value="2012-03-14">
        <Availability>3</Availability>
        <MinimumStay>1</MinimumStay>
        <CloseToArrival>0</CloseToArrival>
        <CloseToDeparture>0</CloseToDeparture>
      </Date>
    </Room>
  </Rooms>
</Booking_AvailabilityReadRS>

Booking_AvailabilityWrite

Consente di inserire la disponibilità di una o più camere, in uno o più periodi. Non sono ammesse date passate, né più di 3 anni.

Richiesta

  • Authentication
    • @key - Chiave per l'autenticazione
  • Hotel
    • @id - Identificativo dell'hotel
  • Rooms
    • Room - Una o più camere
      • @id - Identificativo della camera
      • Date - Uno o più periodi
        • @value - Giorno di permanenza
        • Rate - Tariffa di riferimento per i prezzi (facoltativo). Se non specificata, i valori faranno riferimento alla tariffa standard.
          • @id - Identificativo della tariffa
          • @type - Tipo della tariffa (not_refundable, early_booking, last_minute) - Deprecato, si consiglia di usare id
          • @days - Giorni di anticipo per le tariffe early_booking o last_minute - Deprecato, si consiglia di usare id
        • Availability - Disponibilità della camera - non obbligatorio
        • MinimumStay - Soggiorno minimo richiesto - non obbligatorio
        • CloseToArrival - Arrivi non consentiti in questa data (0/1) - non obbligatorio
        • CloseToDeparture - Partenze non consentite in questa data (0/1) - non obbligatorio
<?xml version="1.0"?>
<Booking_AvailabilityWriteRQ>
  <Authentication key="MlIHxCGrXJQlB9r58oGRB3Xd"/>
  <Hotel id="2280"/>
  <Rooms>
    <Room id="1317">
      <Date value="2012-05-04">
        <Availability>4</Availability>
        <MinimumStay>7</MinimumStay>
        <CloseToArrival>0</CloseToArrival>
        <CloseToDeparture>0</CloseToDeparture>
      </Date>
      <Date value="2012-05-05">
        <Availability>0</Availability>
      </Date>
      <Date value="2012-05-06">
        <CloseToArrival>1</CloseToArrival>
        <CloseToDeparture>0</CloseToDeparture>
      </Date>
    </Room>
    <Room id="1318">
      <Date value="2012-05-04">
        <Availability>5</Availability>
        <MinimumStay>5</MinimumStay>
        <CloseToDeparture>1</CloseToDeparture>
      </Date>
      <Date value="2012-05-05">
        <MinimumStay>3</MinimumStay>
      </Date>
      <Date value="2012-05-06">
        <Availability>5</Availability>
        <CloseToDeparture>1</CloseToDeparture>
      </Date>
    </Room>
    <Room id="1319">
      <Date value="2012-05-04">
        <MinimumStay>2</MinimumStay>
        <CloseToArrival>1</CloseToArrival>
      </Date>
      <Date value="2012-05-05">
        <Availability>7</Availability>
        <MinimumStay>6</MinimumStay>
      </Date>
      <Date value="2012-05-06">
        <Availability>6</Availability>
        <MinimumStay>7</MinimumStay>
        <CloseToArrival>0</CloseToArrival>
        <CloseToDeparture>1</CloseToDeparture>
      </Date>
    </Room>
  </Rooms>
</Booking_AvailabilityWriteRQ>

Risposta

<?xml version="1.0"?>
<Booking_AvailabilityWriteRS>
  <Success/>
</Booking_AvailabilityWriteRS>

Booking_RatesTreatmentsRead

Visualizza le tariffe di una o più camere, in uno o più periodi, includendo i dettagli sui sovrapprezzi dei trattamenti.

Richiesta

  • Authentication
    • @key - Chiave per l'autenticazione
  • Hotel
    • @id - Identificativo dell'hotel
  • Room - Una o più camere
    • @id - Identificativo della camera
  • Period - Uno o più periodi
    • @from - Data di check-in (es. 2012-03-04)
    • @to - Data di check-out (es. 2012-03-06)
  • Rate - Tariffa di riferimento (opzionale). Se non specificata, i prezzi faranno riferimento alla tariffa standard.
    • @id - Identificativo tariffa
    • @type - Tipo di tariffa (not_refundable, early_booking, last_minute) - Deprecato, si consiglia di usare id
    • @days - Giorni di anticipo per le tariffe early_booking o last_minute - Deprecato, si consiglia di usare id

Risposta

  • Hotel
    • @id - Identificativo dell'hotel
  • Rooms
    • Room - Una o più camere
      • @id - Identificativo della camera
      • Date - Una o più date
        • @value - Giorno di permanenza (es. 2012-03-04)
        • Occupations - Raccoglie i prezzi per ogni occupazione
          • Occupation - Una singola occupazione
            • @value - Occupazione camera (numero ospiti)
        • TreatmentBase - Indica il trattamento a cui fanno riferimento i prezzi in Occupations. (stay_only, bed_and_breakfast, half_board, full_board, all_inclusive)
        • ExtraPrices - Supplementi per trattamenti superiori a quello base
          • ExtraPrice - Supplemento per trattamento a persona
            • @treatment - Codice del trattamento (stay_only, bed_and_breakfast, half_board, full_board, all_inclusive)
        • Enabled - La tariffa è attiva (Y/N)

Esempio camera singola, tariffa standard, unico periodo

Richiesta

<?xml version="1.0"?>
<Booking_RatesTreatmentsReadRQ>
  <Authentication key="aHEThVdHJJPaO5p17nJayw0T"/>
  <Hotel id="2233"/>
  <Room id="1176"/>
  <Period from="2012-03-04" to="2012-03-06"/>
</Booking_RatesTreatmentsReadRQ>

Risposta

<?xml version="1.0"?>
<Booking_RatesTreatmentsReadRS>
  <Hotel id="2233"/>
  <Rooms>
    <Room id="1176">
      <Date value="2012-03-04">
        <Occupations>
          <Occupation value="1">394.00</Occupation>
          <Occupation value="2">112.00</Occupation>
          <Occupation value="3">196.00</Occupation>
          <Occupation value="4">13.00</Occupation>
        </Occupations>
        <TreatmentBase>bed_and_breakfast</TreatmentBase>
        <ExtraPrices>
          <ExtraPrice treatment="half_board">35</ExtraPrice>
          <ExtraPrice treatment="full_board">70</ExtraPrice>
        </ExtraPrices>
        <Enabled>Y</Enabled>
      </Date>
      <Date value="2012-03-05">
        <Occupations>
          <Occupation value="1">450.00</Occupation>
          <Occupation value="2">121.00</Occupation>
          <Occupation value="3">437.00</Occupation>
          <Occupation value="4">73.00</Occupation>
        </Occupations>
        <TreatmentBase>bed_and_breakfast</TreatmentBase>
        <ExtraPrices>
          <ExtraPrice treatment="half_board">35</ExtraPrice>
        </ExtraPrices>
        <Enabled>Y</Enabled>
      </Date>
      <Date value="2012-03-06">
        <Occupations>
          <Occupation value="1">262.00</Occupation>
          <Occupation value="2">431.00</Occupation>
          <Occupation value="3">236.00</Occupation>
          <Occupation value="4">488.00</Occupation>
        </Occupations>
        <TreatmentBase>half_board</TreatmentBase>
        <ExtraPrices>
          <ExtraPrice treatment="full_board">70</ExtraPrice>
        </ExtraPrices>
        <Enabled>Y</Enabled>
      </Date>
    </Room>
  </Rooms>
</Booking_RatesTreatmentsReadRS>

Esempio camera singola, tariffa non rimborsabile, unico periodo

Richiesta

<?xml version="1.0"?>
<Booking_RatesTreatmentsReadRQ>
  <Authentication key="aHEThVdHJJPaO5p17nJayw0T"/>
  <Hotel id="2233"/>
  <Room id="1176"/>
  <Period from="2012-03-04" to="2012-03-06"/>
  <Rate type="not_refundable" />
</Booking_RatesTreatmentsReadRQ>

Risposta

<?xml version="1.0"?>
<Booking_RatesTreatmentsReadRS>
  <Hotel id="2233"/>
  <Rooms>
    <Room id="1176">
      <Date value="2012-03-04">
        <Occupations>
          <Occupation value="1">374.00</Occupation>
          <Occupation value="2">102.00</Occupation>
          <Occupation value="3">156.00</Occupation>
          <Occupation value="4">12.00</Occupation>
        </Occupations>
        <TreatmentBase>bed_and_breakfast</TreatmentBase>
        <ExtraPrices>
          <ExtraPrice treatment="half_board">35</ExtraPrice>
          <ExtraPrice treatment="full_board">70</ExtraPrice>
        </ExtraPrices>
        <Enabled>Y</Enabled>
      </Date>
      <Date value="2012-03-05">
        <Occupations>
          <Occupation value="1">430.00</Occupation>
          <Occupation value="2">111.00</Occupation>
          <Occupation value="3">427.00</Occupation>
          <Occupation value="4">53.00</Occupation>
        </Occupations>
        <TreatmentBase>bed_and_breakfast</TreatmentBase>
        <ExtraPrices>
          <ExtraPrice treatment="half_board">35</ExtraPrice>
        </ExtraPrices>
        <Enabled>Y</Enabled>
      </Date>
      <Date value="2012-03-06">
        <Occupations>
          <Occupation value="1">242.00</Occupation>
          <Occupation value="2">411.00</Occupation>
          <Occupation value="3">226.00</Occupation>
          <Occupation value="4">468.00</Occupation>
        </Occupations>
        <TreatmentBase>half_board</TreatmentBase>
        <ExtraPrices>
          <ExtraPrice treatment="full_board">70</ExtraPrice>
        </ExtraPrices>
        <Enabled>Y</Enabled>
      </Date>
    </Room>
  </Rooms>
</Booking_RatesTreatmentsReadRS>

Esempio più camere nello stesso periodo

Richiesta

<?xml version="1.0"?>
<Booking_RatesTreatmentsReadRQ>
  <Authentication key="yV7CZX6AAIOUJMCEOVdvfSJa"/>
  <Hotel id="2234"/>
  <Room id="1179"/>
  <Room id="1180"/>
  <Room id="1181"/>
  <Period from="2012-03-04" to="2012-03-06"/>
</Booking_RatesTreatmentsReadRQ>

Risposta

<?xml version="1.0"?>
<Booking_RatesTreatmentsReadRS>
  <Hotel id="2234"/>
  <Rooms>
    <Room id="1179">
      <Date value="2012-03-04">
        <Occupations>
          <Occupation occupation="1">469.00</Occupation>
          <Occupation occupation="2">327.00</Occupation>
          <Occupation occupation="3">499.00</Occupation>
          <Occupation occupation="4">186.00</Occupation>
        </Occupations>
        <TreatmentBase>bed_and_breakfast</TreatmentBase>
        <ExtraPrices>
          <ExtraPrice treatment="half_board">35</ExtraPrice>
          <ExtraPrice treatment="full_board">70</ExtraPrice>
        </ExtraPrices>
        <Enabled>Y</Enabled>
      </Date>
      <Date value="2012-03-05">
        <Occupations>
          <Occupation occupation="1">374.00</Occupation>
          <Occupation occupation="2">295.00</Occupation>
          <Occupation occupation="3">402.00</Occupation>
          <Occupation occupation="4">140.00</Occupation>
        </Occupations>
        <TreatmentBase>bed_and_breakfast</TreatmentBase>
        <ExtraPrices>
          <ExtraPrice treatment="half_board">35</ExtraPrice>
          <ExtraPrice treatment="full_board">70</ExtraPrice>
        </ExtraPrices>
        <Enabled>Y</Enabled>
      </Date>
      <Date value="2012-03-06">
        <Occupations>
          <Occupation occupation="1">33.00</Occupation>
          <Occupation occupation="2">499.00</Occupation>
          <Occupation occupation="3">105.00</Occupation>
          <Occupation occupation="4">444.00</Occupation>
        </Occupations>
        <TreatmentBase>bed_and_breakfast</TreatmentBase>
        <ExtraPrices>
          <ExtraPrice treatment="half_board">35</ExtraPrice>
          <ExtraPrice treatment="full_board">70</ExtraPrice>
        </ExtraPrices>
        <Enabled>Y</Enabled>
      </Date>
    </Room>
    <Room id="1180">
      <Date value="2012-03-04">
        <Occupations>
          <Occupation occupation="1">394.00</Occupation>
          <Occupation occupation="2">169.00</Occupation>
          <Occupation occupation="3">500.00</Occupation>
        </Occupations>
        <TreatmentBase>bed_and_breakfast</TreatmentBase>
        <ExtraPrices>
          <ExtraPrice treatment="half_board">35</ExtraPrice>
          <ExtraPrice treatment="full_board">70</ExtraPrice>
        </ExtraPrices>
        <Enabled>Y</Enabled>
      </Date>
      <Date value="2012-03-05">
        <Occupations>
          <Occupation occupation="1">301.00</Occupation>
          <Occupation occupation="2">45.00</Occupation>
          <Occupation occupation="3">480.00</Occupation>
        </Occupations>
        <TreatmentBase>bed_and_breakfast</TreatmentBase>
        <ExtraPrices>
          <ExtraPrice treatment="half_board">35</ExtraPrice>
          <ExtraPrice treatment="full_board">70</ExtraPrice>
        </ExtraPrices>
        <Enabled>Y</Enabled>
      </Date>
      <Date value="2012-03-06">
        <Occupations>
          <Occupation occupation="1">43.00</Occupation>
          <Occupation occupation="2">108.00</Occupation>
          <Occupation occupation="3">175.00</Occupation>
        </Occupations>
        <TreatmentBase>bed_and_breakfast</TreatmentBase>
        <ExtraPrices>
          <ExtraPrice treatment="half_board">35</ExtraPrice>
          <ExtraPrice treatment="full_board">70</ExtraPrice>
        </ExtraPrices>
        <Enabled>Y</Enabled>
      </Date>
    </Room>
    <Room id="1181">
      <Date value="2012-03-04">
        <Occupations>
          <Occupation occupation="1">434.00</Occupation>
        </Occupations>
        <TreatmentBase>half_board</TreatmentBase>
        <ExtraPrices>
          <ExtraPrice treatment="full_board">70</ExtraPrice>
        </ExtraPrices>
        <Enabled>Y</Enabled>
      </Date>
      <Date value="2012-03-05">
        <Occupations>
          <Occupation occupation="1">89.00</Occupation>
        </Occupations>
        <TreatmentBase>half_board</TreatmentBase>
        <ExtraPrices>
          <ExtraPrice treatment="full_board">70</ExtraPrice>
        </ExtraPrices>
        <Enabled>Y</Enabled>
      </Date>
      <Date value="2012-03-06">
        <Occupations>
          <Occupation occupation="1">329.00</Occupation>
        </Occupations>
        <TreatmentBase>half_board</TreatmentBase>
        <ExtraPrices>
          <ExtraPrice treatment="full_board">70</ExtraPrice>
        </ExtraPrices>
        <Enabled>Y</Enabled>
      </Date>
    </Room>
  </Rooms>
</Booking_RatesTreatmentsReadRS>

Esempio più camere in più periodi

Richiesta

<?xml version="1.0"?>
<Booking_RatesTreatmentsReadRQ>
  <Authentication key="ItQFjAqVT6PUJeKT0zAbtvSJ"/>
  <Hotel id="2235"/>
  <Room id="1182"/>
  <Room id="1183"/>
  <Room id="1184"/>
  <Period from="2012-03-04" to="2012-03-06"/>
  <Period from="2012-03-12" to="2012-03-14"/>
</Booking_RatesTreatmentsReadRQ>

Risposta

<?xml version="1.0"?>
<Booking_RatesTreatmentsReadRS>
  <Hotel id="2235"/>
  <Rooms>
    <Room id="1182">
      <Date value="2012-03-04">
        <Occupations>
          <Occupation occupation="1">323.00</Occupation>
          <Occupation occupation="2">285.00</Occupation>
          <Occupation occupation="3">113.00</Occupation>
          <Occupation occupation="4">80.00</Occupation>
        </Occupations>
        <TreatmentBase>bed_and_breakfast</TreatmentBase>
        <ExtraPrices>
          <ExtraPrice treatment="half_board">35</ExtraPrice>
          <ExtraPrice treatment="full_board">70</ExtraPrice>
        </ExtraPrices>
        <Enabled>Y</Enabled>
      </Date>
      <Date value="2012-03-05">
        <Occupations>
          <Occupation occupation="1">26.00</Occupation>
          <Occupation occupation="2">165.00</Occupation>
          <Occupation occupation="3">30.00</Occupation>
          <Occupation occupation="4">359.00</Occupation>
        </Occupations>
        <TreatmentBase>bed_and_breakfast</TreatmentBase>
        <ExtraPrices>
          <ExtraPrice treatment="half_board">35</ExtraPrice>
          <ExtraPrice treatment="full_board">70</ExtraPrice>
        </ExtraPrices>
        <Enabled>Y</Enabled>
      </Date>
      <Date value="2012-03-06">
        <Occupations>
          <Occupation occupation="1">443.00</Occupation>
          <Occupation occupation="2">328.00</Occupation>
          <Occupation occupation="3">125.00</Occupation>
          <Occupation occupation="4">205.00</Occupation>
        </Occupations>
        <TreatmentBase>bed_and_breakfast</TreatmentBase>
        <ExtraPrices>
          <ExtraPrice treatment="half_board">35</ExtraPrice>
          <ExtraPrice treatment="full_board">70</ExtraPrice>
        </ExtraPrices>
        <Enabled>Y</Enabled>
      </Date>
      <Date value="2012-03-12">
        <Occupations>
          <Occupation occupation="1">51.00</Occupation>
          <Occupation occupation="2">106.00</Occupation>
          <Occupation occupation="3">118.00</Occupation>
          <Occupation occupation="4">468.00</Occupation>
        </Occupations>
        <TreatmentBase>bed_and_breakfast</TreatmentBase>
        <ExtraPrices>
          <ExtraPrice treatment="half_board">35</ExtraPrice>
          <ExtraPrice treatment="full_board">70</ExtraPrice>
        </ExtraPrices>
        <Enabled>Y</Enabled>
      </Date>
      <Date value="2012-03-13">
        <Occupations>
          <Occupation occupation="1">292.00</Occupation>
          <Occupation occupation="2">250.00</Occupation>
          <Occupation occupation="3">412.00</Occupation>
          <Occupation occupation="4">141.00</Occupation>
        </Occupations>
        <TreatmentBase>bed_and_breakfast</TreatmentBase>
        <ExtraPrices>
          <ExtraPrice treatment="half_board">35</ExtraPrice>
          <ExtraPrice treatment="full_board">70</ExtraPrice>
        </ExtraPrices>
        <Enabled>Y</Enabled>
      </Date>
      <Date value="2012-03-14">
        <Occupations>
          <Occupation occupation="1">412.00</Occupation>
          <Occupation occupation="2">214.00</Occupation>
          <Occupation occupation="3">435.00</Occupation>
          <Occupation occupation="4">402.00</Occupation>
        </Occupations>
        <TreatmentBase>bed_and_breakfast</TreatmentBase>
        <ExtraPrices>
          <ExtraPrice treatment="half_board">35</ExtraPrice>
          <ExtraPrice treatment="full_board">70</ExtraPrice>
        </ExtraPrices>
        <Enabled>Y</Enabled>
      </Date>
    </Room>
    <Room id="1183">
      <Date value="2012-03-04">
        <Occupations>
          <Occupation occupation="1">50.00</Occupation>
          <Occupation occupation="2">42.00</Occupation>
          <Occupation occupation="3">79.00</Occupation>
        </Occupations>
        <TreatmentBase>half_board</TreatmentBase>
        <ExtraPrices>
          <ExtraPrice treatment="full_board">70</ExtraPrice>
        </ExtraPrices>
        <Enabled>Y</Enabled>
      </Date>
      <Date value="2012-03-05">
        <Occupations>
          <Occupation occupation="1">79.00</Occupation>
          <Occupation occupation="2">480.00</Occupation>
          <Occupation occupation="3">39.00</Occupation>
        </Occupations>
        <TreatmentBase>half_board</TreatmentBase>
        <ExtraPrices>
          <ExtraPrice treatment="full_board">70</ExtraPrice>
        </ExtraPrices>
        <Enabled>Y</Enabled>
      </Date>
      <Date value="2012-03-06">
        <Occupations>
          <Occupation occupation="1">246.00</Occupation>
          <Occupation occupation="2">309.00</Occupation>
          <Occupation occupation="3">374.00</Occupation>
        </Occupations>
        <TreatmentBase>half_board</TreatmentBase>
        <ExtraPrices>
          <ExtraPrice treatment="full_board">70</ExtraPrice>
        </ExtraPrices>
        <Enabled>Y</Enabled>
      </Date>
      <Date value="2012-03-12">
        <Occupations>
          <Occupation occupation="1">142.00</Occupation>
          <Occupation occupation="2">433.00</Occupation>
          <Occupation occupation="3">443.00</Occupation>
        </Occupations>
        <TreatmentBase>half_board</TreatmentBase>
        <ExtraPrices>
          <ExtraPrice treatment="full_board">70</ExtraPrice>
        </ExtraPrices>
        <Enabled>Y</Enabled>
      </Date>
      <Date value="2012-03-13">
        <Occupations>
          <Occupation occupation="1">112.00</Occupation>
          <Occupation occupation="2">9.00</Occupation>
          <Occupation occupation="3">62.00</Occupation>
        </Occupations>
        <TreatmentBase>half_board</TreatmentBase>
        <ExtraPrices>
          <ExtraPrice treatment="full_board">70</ExtraPrice>
        </ExtraPrices>
        <Enabled>Y</Enabled>
      </Date>
      <Date value="2012-03-14">
        <Occupations>
          <Occupation occupation="1">62.00</Occupation>
          <Occupation occupation="2">127.00</Occupation>
          <Occupation occupation="3">428.00</Occupation>
        </Occupations>
        <TreatmentBase>half_board</TreatmentBase>
        <ExtraPrices>
          <ExtraPrice treatment="full_board">70</ExtraPrice>
        </ExtraPrices>
        <Enabled>Y</Enabled>
      </Date>
    </Room>
    <Room id="1184">
      <Date value="2012-03-04">
        <Occupations>
          <Occupation occupation="1">84.00</Occupation>
        </Occupations>
        <TreatmentBase>full_board</TreatmentBase>
        <Enabled>N</Enabled>
      </Date>
      <Date value="2012-03-05">
        <Occupations>
          <Occupation occupation="1">330.00</Occupation>
        </Occupations>
        <TreatmentBase>full_board</TreatmentBase>
        <Enabled>N</Enabled>
      </Date>
      <Date value="2012-03-06">
        <Occupations>
          <Occupation occupation="1">450.00</Occupation>
        </Occupations>
        <TreatmentBase>full_board</TreatmentBase>
        <Enabled>N</Enabled>
      </Date>
      <Date value="2012-03-12">
        <Occupations>
          <Occupation occupation="1">321.00</Occupation>
        </Occupations>
        <TreatmentBase>full_board</TreatmentBase>
        <Enabled>N</Enabled>
      </Date>
      <Date value="2012-03-13">
        <Occupations>
          <Occupation occupation="1">118.00</Occupation>
        </Occupations>
        <TreatmentBase>full_board</TreatmentBase>
        <Enabled>N</Enabled>
      </Date>
      <Date value="2012-03-14">
        <Occupations>
          <Occupation occupation="1">377.00</Occupation>
        </Occupations>
        <TreatmentBase>full_board</TreatmentBase>
        <Enabled>N</Enabled>
      </Date>
    </Room>
  </Rooms>
</Booking_RatesTreatmentsReadRS>

Booking_RatesTreatmentsWrite

Consente di inserire le tariffe di una o più camere, in uno o più periodi, indicare il trattamento base a cui fanno riferimento e i supplementi specifici per ogni trattamento superiore (a persona). Inoltre puoi specificare la tariffa a cui si fa riferimento (non rimborsabile, early booking e last minute), indicando se è abilitata per la vendita. Non sono ammesse date passate, né più di 3 anni.

Richiesta

  • Authentication
    • @key - Chiave per l'autenticazione
  • Hotel
    • @id - Identificativo dell'hotel
  • Rooms
    • Room - Una o più camere
      • @id - Identificativo della camera
      • Date - Una o più date
        • @value - Giorno di permanenza (es. 2012-03-04)
        • Prices - I prezzi delle occupazioni nel trattamento standard
          • Price - Prezzo per una o più occupazioni
            • @occupation - Occupazione camera (numero ospiti)
        • Rate - Tariffa di riferimento per i prezzi (facoltativo). Se non specificata, i prezzi faranno riferimento alla tariffa standard.
          • @id - Identificativo della tariffa
          • @type - Tipo della tariffa (not_refundable, early_booking, last_minute) - Deprecato, si consiglia di usare id
          • @days - Giorni di anticipo per le tariffe early_booking o last_minute - Deprecato, si consiglia di usare id
        • TreatmentBase - Il trattamento base a cui fanno riferimento i prezzi (facoltativo) (stay_only, bed_and_breakfast, half_board, full_board, all_inclusive). Se non specificato, viene inteso quello inserito nella configurazione.
        • ExtraPrices - Supplementi per i trattamenti superiori a quello base (facoltativo)
          • ExtraPrice - Supplemento per il trattamento (a persona)
            • @treatment - Codice del trattamento (stay_only, bed_and_breakfast, half_board, full_board, all_inclusive)
        • Enabled - La tariffa è attiva? (Y/N) (facoltativo)

Esempio due camere, tariffa standard

Richiesta

<?xml version="1.0"?>
<Booking_RatesTreatmentsWriteRQ>
  <Authentication key="cbIhpaBQAKYpfWEj57lxdcah"/>
  <Hotel id="2309"/>
  <Rooms>
    <Room id="1458">
      <Date value="2012-05-04">
        <Prices>
          <Price occupation="1">413.00</Price>
          <Price occupation="2">98.00</Price>
          <Price occupation="3">296.00</Price>
          <Price occupation="4">160.00</Price>
        </Prices>
      </Date>
      <Date value="2012-05-05">
        <Prices>
          <Price occupation="1">400.00</Price>
          <Price occupation="2">213.00</Price>
          <Price occupation="3">479.00</Price>
          <Price occupation="4">155.00</Price>
        </Prices>
      </Date>
      <Date value="2012-05-06">
        <Prices>
          <Price occupation="1">258.00</Price>
          <Price occupation="2">452.00</Price>
          <Price occupation="3">432.00</Price>
          <Price occupation="4">69.00</Price>
        </Prices>
      </Date>
    </Room>
    <Room id="1459">
      <Date value="2012-05-04">
        <Prices>
          <Price occupation="1">216.00</Price>
          <Price occupation="2">93.00</Price>
          <Price occupation="3">162.00</Price>
        </Prices>
      </Date>
      <Date value="2012-05-05">
        <Prices>
          <Price occupation="1">227.00</Price>
          <Price occupation="2">441.00</Price>
          <Price occupation="3">373.00</Price>
        </Prices>
      </Date>
      <Date value="2012-05-06">
        <Prices>
          <Price occupation="1">122.00</Price>
          <Price occupation="2">228.00</Price>
          <Price occupation="3">296.00</Price>
        </Prices>
      </Date>
    </Room>
  </Rooms>
</Booking_RatesTreatmentsWriteRQ>

Risposta

<?xml version="1.0"?>
<Booking_RatesTreatmentsWriteRS>
  <Success/>
</Booking_RatesTreatmentsWriteRS>

Esempio due camere, tariffa standard, diverso trattamento base

Richiesta

<?xml version="1.0"?>
<Booking_RatesTreatmentsWriteRQ>
  <Authentication key="cbIhpaBQAKYpfWEj57lxdcah"/>
  <Hotel id="2309"/>
  <Rooms>
    <Room id="1458">
      <Date value="2012-05-04">
        <Prices>
          <Price occupation="1">413.00</Price>
          <Price occupation="2">98.00</Price>
          <Price occupation="3">296.00</Price>
          <Price occupation="4">160.00</Price>
        </Prices>
        <TreatmentBase>half_board</TreatmentBase>
      </Date>
      <Date value="2012-05-05">
        <Prices>
          <Price occupation="1">400.00</Price>
          <Price occupation="2">213.00</Price>
          <Price occupation="3">479.00</Price>
          <Price occupation="4">155.00</Price>
        </Prices>
        <TreatmentBase>half_board</TreatmentBase>
      </Date>
      <Date value="2012-05-06">
        <Prices>
          <Price occupation="1">258.00</Price>
          <Price occupation="2">452.00</Price>
          <Price occupation="3">432.00</Price>
          <Price occupation="4">69.00</Price>
        </Prices>
        <TreatmentBase>half_board</TreatmentBase>
      </Date>
    </Room>
    <Room id="1459">
      <Date value="2012-05-04">
        <Prices>
          <Price occupation="1">216.00</Price>
          <Price occupation="2">93.00</Price>
          <Price occupation="3">162.00</Price>
        </Prices>
        <TreatmentBase>full_board</TreatmentBase>
      </Date>
      <Date value="2012-05-05">
        <Prices>
          <Price occupation="1">227.00</Price>
          <Price occupation="2">441.00</Price>
          <Price occupation="3">373.00</Price>
        </Prices>
        <TreatmentBase>full_board</TreatmentBase>
      </Date>
      <Date value="2012-05-06">
        <Prices>
          <Price occupation="1">122.00</Price>
          <Price occupation="2">228.00</Price>
          <Price occupation="3">296.00</Price>
        </Prices>
        <TreatmentBase>full_board</TreatmentBase>
      </Date>
    </Room>
  </Rooms>
</Booking_RatesTreatmentsWriteRQ>

Risposta

<?xml version="1.0"?>
<Booking_RatesTreatmentsWriteRS>
  <Success/>
</Booking_RatesTreatmentsWriteRS>

Esempio due camere, tariffa standard, supplementi specifici

Richiesta

<?xml version="1.0"?>
<Booking_RatesTreatmentsWriteRQ>
  <Authentication key="cbIhpaBQAKYpfWEj57lxdcah"/>
  <Hotel id="2309"/>
  <Rooms>
    <Room id="1458">
      <Date value="2012-05-04">
        <Prices>
          <Price occupation="1">413.00</Price>
          <Price occupation="2">98.00</Price>
          <Price occupation="3">296.00</Price>
          <Price occupation="4">160.00</Price>
        </Prices>
        <ExtraPrices>
          <ExtraPrice treatment="half_board">40</ExtraPrice>
          <ExtraPrice treatment="full_board">80</ExtraPrice>
        </ExtraPrices>
      </Date>
      <Date value="2012-05-05">
        <Prices>
          <Price occupation="1">400.00</Price>
          <Price occupation="2">213.00</Price>
          <Price occupation="3">479.00</Price>
          <Price occupation="4">155.00</Price>
        </Prices>
        <ExtraPrices>
          <ExtraPrice treatment="half_board">40</ExtraPrice>
          <ExtraPrice treatment="full_board">80</ExtraPrice>
        </ExtraPrices>
      </Date>
      <Date value="2012-05-06">
        <Prices>
          <Price occupation="1">258.00</Price>
          <Price occupation="2">452.00</Price>
          <Price occupation="3">432.00</Price>
          <Price occupation="4">69.00</Price>
        </Prices>
        <ExtraPrices>
          <ExtraPrice treatment="half_board">40</ExtraPrice>
          <ExtraPrice treatment="full_board">80</ExtraPrice>
        </ExtraPrices>
      </Date>
    </Room>
    <Room id="1459">
      <Date value="2012-05-04">
        <Prices>
          <Price occupation="1">216.00</Price>
          <Price occupation="2">93.00</Price>
          <Price occupation="3">162.00</Price>
        </Prices>
        <TreatmentBase>half_board</TreatmentBase>
        <ExtraPrices>
          <ExtraPrice treatment="full_board">80</ExtraPrice>
        </ExtraPrices>
      </Date>
      <Date value="2012-05-05">
        <Prices>
          <Price occupation="1">227.00</Price>
          <Price occupation="2">441.00</Price>
          <Price occupation="3">373.00</Price>
        </Prices>
        <TreatmentBase>half_board</TreatmentBase>
        <ExtraPrices>
          <ExtraPrice treatment="full_board">80</ExtraPrice>
        </ExtraPrices>
      </Date>
      <Date value="2012-05-06">
        <Prices>
          <Price occupation="1">122.00</Price>
          <Price occupation="2">228.00</Price>
          <Price occupation="3">296.00</Price>
        </Prices>
        <TreatmentBase>half_board</TreatmentBase>
        <ExtraPrices>
          <ExtraPrice treatment="full_board">80</ExtraPrice>
        </ExtraPrices>
      </Date>
    </Room>
  </Rooms>
</Booking_RatesTreatmentsWriteRQ>

Risposta

<?xml version="1.0"?>
<Booking_RatesTreatmentsWriteRS>
  <Success/>
</Booking_RatesTreatmentsWriteRS>

Esempio due camere, tariffa non rimborsabile

Richiesta

<?xml version="1.0"?>
<Booking_RatesTreatmentsWriteRQ>
  <Authentication key="cbIhpaBQAKYpfWEj57lxdcah"/>
  <Hotel id="2309"/>
  <Rooms>
    <Room id="1458">
      <Date value="2012-05-04">
        <Prices>
          <Price occupation="1">403.00</Price>
          <Price occupation="2">78.00</Price>
          <Price occupation="3">266.00</Price>
          <Price occupation="4">150.00</Price>
        </Prices>
        <Rate id="250" />
      </Date>
      <Date value="2012-05-05">
        <Prices>
          <Price occupation="1">390.00</Price>
          <Price occupation="2">203.00</Price>
          <Price occupation="3">469.00</Price>
          <Price occupation="4">145.00</Price>
        </Prices>
        <Rate id="250" />
      </Date>
      <Date value="2012-05-06">
        <Prices>
          <Price occupation="1">248.00</Price>
          <Price occupation="2">442.00</Price>
          <Price occupation="3">422.00</Price>
          <Price occupation="4">59.00</Price>
        </Prices>
        <Rate id="250" />
      </Date>
    </Room>
    <Room id="1459">
      <Date value="2012-05-04">
        <Prices>
          <Price occupation="1">206.00</Price>
          <Price occupation="2">83.00</Price>
          <Price occupation="3">152.00</Price>
        </Prices>
        <Rate id="250" />
      </Date>
      <Date value="2012-05-05">
        <Prices>
          <Price occupation="1">217.00</Price>
          <Price occupation="2">431.00</Price>
          <Price occupation="3">363.00</Price>
        </Prices>
        <Rate id="250" />
      </Date>
      <Date value="2012-05-06">
        <Prices>
          <Price occupation="1">112.00</Price>
          <Price occupation="2">218.00</Price>
          <Price occupation="3">286.00</Price>
        </Prices>
        <Rate id="250" />
      </Date>
    </Room>
  </Rooms>
</Booking_RatesTreatmentsWriteRQ>

Risposta

<?xml version="1.0"?>
<Booking_RatesTreatmentsWriteRS>
  <Success/>
</Booking_RatesTreatmentsWriteRS>

Esempio due camere, tariffa early booking 60gg, trattamento minimo mezza pensione

Richiesta

<?xml version="1.0"?>
<Booking_RatesTreatmentsWriteRQ>
  <Authentication key="cbIhpaBQAKYpfWEj57lxdcah"/>
  <Hotel id="2309"/>
  <Rooms>
    <Room id="1458">
      <Date value="2012-05-04">
        <Prices>
          <Price occupation="1">403.00</Price>
          <Price occupation="2">78.00</Price>
          <Price occupation="3">266.00</Price>
          <Price occupation="4">150.00</Price>
        </Prices>
        <Rate id="251" />
        <TreatmentBase>half_board</TreatmentBase>
      </Date>
      <Date value="2012-05-05">
        <Prices>
          <Price occupation="1">390.00</Price>
          <Price occupation="2">203.00</Price>
          <Price occupation="3">469.00</Price>
          <Price occupation="4">145.00</Price>
        </Prices>
        <Rate id="251" />
        <TreatmentBase>half_board</TreatmentBase>
      </Date>
      <Date value="2012-05-06">
        <Prices>
          <Price occupation="1">248.00</Price>
          <Price occupation="2">442.00</Price>
          <Price occupation="3">422.00</Price>
          <Price occupation="4">59.00</Price>
        </Prices>
        <Rate id="251" />
        <TreatmentBase>half_board</TreatmentBase>
      </Date>
    </Room>
    <Room id="1459">
      <Date value="2012-05-04">
        <Prices>
          <Price occupation="1">206.00</Price>
          <Price occupation="2">83.00</Price>
          <Price occupation="3">152.00</Price>
        </Prices>
        <Rate id="251" />
        <TreatmentBase>half_board</TreatmentBase>
      </Date>
      <Date value="2012-05-05">
        <Prices>
          <Price occupation="1">217.00</Price>
          <Price occupation="2">431.00</Price>
          <Price occupation="3">363.00</Price>
        </Prices>
        <Rate id="251" />
        <TreatmentBase>half_board</TreatmentBase>
      </Date>
      <Date value="2012-05-06">
        <Prices>
          <Price occupation="1">112.00</Price>
          <Price occupation="2">218.00</Price>
          <Price occupation="3">286.00</Price>
        </Prices>
        <Rate id="251" />
        <TreatmentBase>half_board</TreatmentBase>
      </Date>
    </Room>
  </Rooms>
</Booking_RatesTreatmentsWriteRQ>

Risposta

<?xml version="1.0"?>
<Booking_RatesTreatmentsWriteRS>
  <Success/>
</Booking_RatesTreatmentsWriteRS>

Esempio una camera, chiusura della tariffa 'Non rimborsabile'

Richiesta

<?xml version="1.0"?>
<Booking_RatesTreatmentsWriteRQ>
  <Authentication key="cbIhpaBQAKYpfWEj57lxdcah"/>
  <Hotel id="2309"/>
  <Rooms>
    <Room id="1458">
      <Date value="2012-05-04">
        <Rate id="250" />
        <Enabled>N</Enabled>
      </Date>
      <Date value="2012-05-05">
        <Rate id="250" />
        <Enabled>N</Enabled>
      </Date>
      <Date value="2012-05-06">
        <Rate id="250" />
        <Enabled>N</Enabled>
      </Date>
    </Room>
  </Rooms>
</Booking_RatesTreatmentsWriteRQ>

Risposta

<?xml version="1.0"?>
<Booking_RatesTreatmentsWriteRS>
  <Success/>
</Booking_RatesTreatmentsWriteRS>

Booking_ReservationsRead

Visualizza le prenotazioni create o modificate a partire da una certa data.

Ogni prenotazione può avere una o più camere però ognuna avrà le stesse date di checkin e checkout.

Le prenotazioni possono avere i seguenti status:

  • completed sono quelle confermate
  • in_hotel indica che il cliente è ancora in albergo
  • stayed indica che il cliente ha terminato il soggiorno
  • deleted sono le prenotazioni cancellate dal cliente
  • no_show indica che il cliente non si è presentato in hotel

Richiesta

  • Authentication
    • @key - Chiave per l'autenticazione
  • Hotel
    • @id - Identificativo dell'hotel
  • Period
    • @from - Data e ora di inizio periodo (es. 2012-03-04 11:37:08)
  • Filter (non obbligatorio)
    • @value - Per filtrare le prenotazioni secondo i seguenti criteri:
      • new (solo le prenotazioni nuove)
      • modified (solo le prenotazioni modificate - non quelle cancellate)
      • cancelled (solo le prenotazioni cancellate)
<?xml version="1.0"?>
<Booking_ReservationsReadRQ>
  <Authentication key="R8NVnqFAH3vSYvT1voT5SucI"/>
  <Hotel id="2265"/>
  <Period from="2012-03-04 11:37:08"/>
  <Filter value="new"/>
</Booking_ReservationsReadRQ>

Risposta

  • Hotel
    • @id - Identificativo dell'hotel
  • Reservation
    • Reservation - una o più prenotazioni
      • @code - Codice della prenotazione
      • Status - Status della prenotazione (completed/deleted/stayed/in_hotel/noshow)
      • Price - Prezzo totale del soggiorno (IVA inclusa)
      • NotRefundable - La prenotazione non è rimborsabile? (Y/N)
      • CreationDateTime - Data e ora di creazione della prenotazione (es. 2012-03-04 11:37:08)
      • Customer - Informazioni utente
        • Title - Titolo
        • Name - Nome
        • Surname - Cognome
        • Email - Email
        • Address - Indirizzo
        • Zip - CAP
        • City - Città
        • Country - Paese
        • Phone - Telefono
        • Note - Note dell'utente
        • CreditCardType - Circuito carta di credito
        • CreditCardName - Intestatario carta di credito
        • CreditCardNumber - Numero carta di credito (es. 4444333322221111)
        • CreditCardCCV - Codice di sicurezza carta di credito (es. 123)
        • CreditCardExpirationMonth - Mese di scadenza carta di credito (es. 1)
        • CreditCardExpirationYear - Anno di scadenza carta di credito (es. 2013)
      • Rooms
        • Room - una o più camere prenotate
          • @id - Identificativo della camera
          • Checkin - Data di check-in (es. 2012-03-14)
          • Checkout - Data di check-out (es. 2012-03-15)
          • Name - Nome della camera
          • GuestsTotal - Ospiti totali
          • Price - Prezzo singola camera
          • TreatmentId - Identificativo del trattamento
            • 1 - Solo pernottamento
            • 2 - Camera e colazione
            • 3 - Mezza pensione
            • 4 - Pensione completa
            • 5 - Tutto incluso
          • Rate - la tariffa con cui è stata effettuata prenotata la camera
            • @type - il tipo di tariffa (standard, not_refundable, early_booking, last_minute)
            • @days - i giorni relativi alle tariffe not_refundable e early_booking (opzionale)
<?xml version="1.0"?>
<Booking_ReservationsReadRS>
  <Hotel id="2265"/>
  <Reservations>
    <Reservation code="KHFNPCR">
      <Status>completed</Status>
      <Price>672</Price>
      <NotRefundable>N</NotRefundable>
      <CreationDateTime>2012-03-04 11:37:08</CreationDateTime>
      <Customer>
        <Title>Mr</Title>
        <Name>Enzo</Name>
        <Surname>Benincasa</Surname>
        <Email>enzo@caprionline.it</Email>
        <Address>Via Le Botteghe, 10/a</Address>
        <Zip>80073</Zip>
        <City>Capri</City>
        <Country>Italy</Country>
        <Phone/>
        <Note>Note scritte dall"utente</Note>
        <CreditCardType>VISA</CreditCardType>
        <CreditCardName>enzo benincasa</CreditCardName>
        <CreditCardNumber>4444333322221111</CreditCardNumber>
        <CreditCardCCV>123</CreditCardCCV>
        <CreditCardExpirationMonth>1</CreditCardExpirationMonth>
        <CreditCardExpirationYear>2013</CreditCardExpirationYear>
      </Customer>
      <Rooms>
        <Room id="1273">
          <Checkin>2012-03-14</Checkin>
          <Checkout>2012-03-15</Checkout>
          <Name>Camera tripla</Name>
          <GuestsTotal>3</GuestsTotal>
          <Price>672.00</Price>
          <TreatmentId>2</TreatmentId>
          <Rate id="212" />
        </Room>
      </Rooms>
    </Reservation>
    <Reservation code="R8UETN2">
      <Status>completed</Status>
      <Price>273</Price>
      <NotRefundable>N</NotRefundable>
      <CreationDateTime>2012-03-04 11:37:08</CreationDateTime>
      <Customer>
        <Title>Mr</Title>
        <Name>Enzo</Name>
        <Surname>Benincasa</Surname>
        <Email>enzo@caprionline.it</Email>
        <Address>Via Le Botteghe, 10/a</Address>
        <Zip>80073</Zip>
        <City>Capri</City>
        <Country>Italy</Country>
        <Phone/>
        <Note>Note scritte dall"utente</Note>
        <CreditCardType>VISA</CreditCardType>
        <CreditCardName>enzo benincasa</CreditCardName>
        <CreditCardNumber>4444333322221111</CreditCardNumber>
        <CreditCardCCV>123</CreditCardCCV>
        <CreditCardExpirationMonth>1</CreditCardExpirationMonth>
        <CreditCardExpirationYear>2013</CreditCardExpirationYear>
      </Customer>
      <Rooms>
        <Room id="1274">
          <Checkin>2012-03-15</Checkin>
          <Checkout>2012-03-17</Checkout>
          <Name>Camera doppia</Name>
          <GuestsTotal>2</GuestsTotal>
          <Price>273.00</Price>
          <TreatmentId>2</TreatmentId>
          <Rate id="212" />
        </Room>
      </Rooms>
    </Reservation>
    <Reservation code="KSMCBL6">
      <Status>completed</Status>
      <Price>120</Price>
      <NotRefundable>N</NotRefundable>
      <CreationDateTime>2012-03-04 11:37:08</CreationDateTime>
      <Customer>
        <Title>Mr</Title>
        <Name>Enzo</Name>
        <Surname>Benincasa</Surname>
        <Email>enzo@caprionline.it</Email>
        <Address>Via Le Botteghe, 10/a</Address>
        <Zip>80073</Zip>
        <City>Capri</City>
        <Country>Italy</Country>
        <Phone/>
        <Note>Note scritte dall"utente</Note>
        <CreditCardType>VISA</CreditCardType>
        <CreditCardName>enzo benincasa</CreditCardName>
        <CreditCardNumber>4444333322221111</CreditCardNumber>
        <CreditCardCCV>123</CreditCardCCV>
        <CreditCardExpirationMonth>1</CreditCardExpirationMonth>
        <CreditCardExpirationYear>2013</CreditCardExpirationYear>
      </Customer>
      <Rooms>
        <Room id="1274">
          <Checkin>2012-03-16</Checkin>
          <Checkout>2012-03-19</Checkout>
          <Name>Camera doppia</Name>
          <GuestsTotal>2</GuestsTotal>
          <Price>120.00</Price>
          <TreatmentId>2</TreatmentId>
          <Rate id="212" />
        </Room>
      </Rooms>
    </Reservation>
    <Reservation code="LS63DPF">
      <Status>completed</Status>
      <Price>848</Price>
      <NotRefundable>Y</NotRefundable>
      <CreationDateTime>2012-03-04 11:37:09</CreationDateTime>
      <Customer>
        <Title>Mr</Title>
        <Name>Enzo</Name>
        <Surname>Benincasa</Surname>
        <Email>enzo@caprionline.it</Email>
        <Address>Via Le Botteghe, 10/a</Address>
        <Zip>80073</Zip>
        <City>Capri</City>
        <Country>Italy</Country>
        <Phone/>
        <Note>Note scritte dall"utente</Note>
        <CreditCardType>VISA</CreditCardType>
        <CreditCardName>enzo benincasa</CreditCardName>
        <CreditCardNumber>4444333322221111</CreditCardNumber>
        <CreditCardCCV>123</CreditCardCCV>
        <CreditCardExpirationMonth>1</CreditCardExpirationMonth>
        <CreditCardExpirationYear>2013</CreditCardExpirationYear>
      </Customer>
      <Rooms>
        <Room id="1272">
          <Checkin>2012-03-18</Checkin>
          <Checkout>2012-03-21</Checkout>
          <Name>Camera singola</Name>
          <GuestsTotal>1</GuestsTotal>
          <Price>206.00</Price>
          <Rate id="212" />
        </Room>
        <Room id="1274">
          <Checkin>2012-03-18</Checkin>
          <Checkout>2012-03-21</Checkout>
          <Name>Camera doppia</Name>
          <GuestsTotal>2</GuestsTotal>
          <Price>642.00</Price>
          <TreatmentId>2</TreatmentId>
          <Rate id="250" />
        </Room>
      </Rooms>
    </Reservation>
    <Reservation code="5STQXMR">
      <Status>completed</Status>
      <Price>428</Price>
      <NotRefundable>N</NotRefundable>
      <CreationDateTime>2012-03-04 11:37:09</CreationDateTime>
      <Customer>
        <Title>Mr</Title>
        <Name>Enzo</Name>
        <Surname>Benincasa</Surname>
        <Email>enzo@caprionline.it</Email>
        <Address>Via Le Botteghe, 10/a</Address>
        <Zip>80073</Zip>
        <City>Capri</City>
        <Country>Italy</Country>
        <Phone/>
        <Note>Note scritte dall"utente</Note>
        <CreditCardType>VISA</CreditCardType>
        <CreditCardName>enzo benincasa</CreditCardName>
        <CreditCardNumber>4444333322221111</CreditCardNumber>
        <CreditCardCCV>123</CreditCardCCV>
        <CreditCardExpirationMonth>1</CreditCardExpirationMonth>
        <CreditCardExpirationYear>2013</CreditCardExpirationYear>
      </Customer>
      <Rooms>
        <Room id="1272">
          <Checkin>2012-03-19</Checkin>
          <Checkout>2012-03-20</Checkout>
          <Name>Camera doppia</Name>
          <GuestsTotal>2</GuestsTotal>
          <Price>428.00</Price>
          <TreatmentId>2</TreatmentId>
          <Rate id="251" />
        </Room>
      </Rooms>
    </Reservation>
  </Reservations>
</Booking_ReservationsReadRS>

Booking_ConfigurationRead

Consente di ricevere le informazioni relative alle camere configurate dall'hotel.

Richiesta

  • Authentication
    • @key - Chiave per l'autenticazione
  • Hotel
    • @id - Identificativo dell'hotel
<?xml version="1.0"?>
<Booking_ConfigurationReadRQ>
  <Authentication key="7m5lwFiaeDjTL9uoWSKWjGfg"/>
  <Hotel id="2207"/>
</Booking_ConfigurationReadRQ>

Risposta

  • Hotel
    • @id - Identificativo dell'hotel
  • Rooms
    • Room
      • @id - Identificativo della camera
      • Name - Nome della camera
      • StandardOccupation - Numero standard di ospiti (es: 2 per una doppia, 3 per una tripla)
      • MaxOccupation - Numero massimo di ospiti (es: 3 per una doppia con letto aggiunto)
      • AllowInfant - È prevista l'aggiunta di una culla? (Y/N)
      • Enabled - La camera è attiva? (Y/N)
<?xml version="1.0"?>
<Booking_ConfigurationReadRS>
  <Hotel id="2207"/>
  <Rooms>
    <Room id="1104">
      <Name>Doppia standard</Name>
      <StandardOccupation>2</StandardOccupation>
      <MaxOccupation>3</MaxOccupation>
      <AllowInfant>Y</AllowInfant>
      <Enabled>Y</Enabled>
    </Room>
    <Room id="1105">
      <Name>Doppia deluxe</Name>
      <StandardOccupation>2</StandardOccupation>
      <MaxOccupation>3</MaxOccupation>
      <AllowInfant>Y</AllowInfant>
      <Enabled>Y</Enabled>
    </Room>
    <Room id="1106">
      <Name>Tripla</Name>
      <StandardOccupation>3</StandardOccupation>
      <MaxOccupation>3</MaxOccupation>
      <AllowInfant>Y</AllowInfant>
      <Enabled>Y</Enabled>
    </Room>
  </Rooms>
</Booking_ConfigurationReadRS>

Booking_ConfigurationTreatmentsRead

Consente di ricevere le informazioni relative ai trattamenti configurati dall'hotel.

Richiesta

  • Authentication
    • @key - Chiave per l'autenticazione
  • Hotel
    • @id - Identificativo dell'hotel
<?xml version="1.0"?>
<Booking_ConfigurationTreatmentsReadRQ>
  <Authentication key="7m5lwFiaeDjTL9uoWSKWjGfg"/>
  <Hotel id="2207"/>
</Booking_ConfigurationTreatmentsReadRQ>

Risposta

  • Hotel
    • @id - Identificativo dell'hotel
  • TreatmentBase - Indica il trattamento minimo per il soggiorno
  • ExtraPrices - Supplementi per trattamenti superiori a quello base
    • ExtraPrice - Supplemento per trattamento a persona
      • @treatment - Codice del trattamento (stay_only, bed_and_breakfast, half_board, full_board, all_inclusive)
<?xml version="1.0"?>
<Booking_ConfigurationTreatmentsReadRS>
  <Hotel id="2207"/>
  <TreatmentBase>bed_and_breakfast</TreatmentBase>
  <ExtraPrices>
    <ExtraPrice treatment="half_board">30</ExtraPrice>
    <ExtraPrice treatment="full_board">60</ExtraPrice>
  </ExtraPrices>
</Booking_ConfigurationTreatmentsReadRS>

Booking_ConfigurationTreatmentsWrite

Consente di salvare nella configurazione dell'hotel le informazioni relative ai trattamenti.

Richiesta

  • Authentication
    • @key - Chiave per l'autenticazione
  • Hotel
    • @id - Identificativo dell'hotel
  • TreatmentBase - Indica il trattamento minimo per il soggiorno
  • ExtraPrices - Supplementi per trattamenti superiori a quello base
    • ExtraPrice - Supplemento per trattamento a persona
      • @treatment - Codice del trattamento (stay_only, bed_and_breakfast, half_board, full_board, all_inclusive)
<Booking_ConfigurationTreatmentsWriteRQ>
  <Authentication key="7m5lwFiaeDjTL9uoWSKWjGfg"/>
  <Hotel id="2207"/>
  <TreatmentBase>bed_and_breakfast</TreatmentBase>
  <ExtraPrices>
    <ExtraPrice treatment="half_board">30</ExtraPrice>
    <ExtraPrice treatment="full_board">60</ExtraPrice>
  </ExtraPrices>
</Booking_ConfigurationTreatmentsWriteRQ>

Risposta

<?xml version="1.0"?>
<Booking_ConfigurationTreatmentsWriteRS>
  <Success/>
</Booking_ConfigurationTreatmentsWriteRS>

Booking_ConfigurationRatesRead

Consente di ricevere le informazioni relative alle tariffe configurate dall'hotel.

Richiesta

  • Authentication
    • @key - Chiave per l'autenticazione
  • Hotel
    • @id - Identificativo dell'hotel
<?xml version="1.0"?>
<Booking_ConfigurationRatesReadRQ>
  <Authentication key="7m5lwFiaeDjTL9uoWSKWjGfg"/>
  <Hotel id="2207"/>
</Booking_ConfigurationRatesReadRQ>

Risposta

  • Hotel
    • @id - Identificativo dell'hotel
  • Rates - Elenco delle tariffe
    • Rate - Singola tariffa da presente nella configurazione
      • @id - Identificativo della tariffa.
      • @type - Tipo di tariffa (not_refundable, early_booking, last_minute).
      • @days - Giorni di anticipo sulla prenotazione in caso di Early Booking o Last Minute.
      • Name - Nome della tariffa
      • CancellationPolicyType - Tipo di politica di cancellazione
      • Rooms - Le camere a cui è associata la tariffa
        • Room
          • @id - ID della camera vendibile con questa tariffa
<?xml version="1.0"?>
<Booking_ConfigurationRatesReadRS>
  <Hotel id="2207"/>
  <Rates>
    <Rate id="153" type="not_refundable" days="0">
      <Name>Non rimborsabile</Name>
      <CancellationPolicyType>not_refundable</CancellationPolicyType>
      <Rooms>
        <Room id="12" />
        <Room id="45" />
        <Room id="56" />
      </Rooms>
    </Rate>
  </Rates>
</Booking_ConfigurationRatesReadRS>

Booking_ConfigurationRatesWrite

Consente di salvare nella configurazione dell'hotel le informazioni relative alle tariffe.

Richiesta

  • Authentication
    • @key - Chiave per l'autenticazione
  • Hotel
    • @id - Identificativo dell'hotel
  • Rates - Elenco delle tariffe
    • Rate - Singola tariffa da inserire nella configurazione
      • @type - Tipo di tariffa (not_refundable, early_booking, last_minute).
      • @days - Giorni di anticipo sulla prenotazione in caso di Early Booking o Last Minute.
      • Name - Nome della tariffa
      • CancellationPolicyType - Tipo di politica di cancellazione
      • Rooms - Le camere a cui vuoi associare la tariffa
        • Room
          • @id - ID della camera vendibile con questa tariffa
<Booking_ConfigurationRatesWriteRQ>
  <Authentication key="7m5lwFiaeDjTL9uoWSKWjGfg"/>
  <Hotel id="2207"/>
  <Rates>
    <Rate type="not_refundable" days="0">
      <Name>Non rimborsabile</Name>
      <CancellationPolicyType>not_refundable</CancellationPolicyType>
      <Rooms>
        <Room id="12" />
        <Room id="45" />
        <Room id="56" />
      </Rooms>
    </Rate>
  </Rates>
</Booking_ConfigurationRatesWriteRQ>

Risposta

<?xml version="1.0"?>
<Booking_ConfigurationRatesWriteRS>
  <Success/>
</Booking_ConfigurationRatesWriteRS>

Booking_RatesRead (deprecata)

Questa API è deprecata. Utilizza Booking_RatesTreatmentsRead.

Booking_RatesWrite (deprecata)

Questa API è deprecata. Utilizza Booking_RatesTreatmentsWrite.

FAQ - Domande frequenti

La URL per l'accesso alle API è anche l'URL di produzione?
La URL:
https://salsa-api.caprionline.it/xml
permette l'accesso ai dati di produzione ed è valida per tutti i portali che gestiamo, tra cui: italytraveller.com, capri.it, capri.com, capri.net, capribooking.com, positano.com.
Viene effettuato un filtraggio degli IP da cui provengono le richieste HTTP?
Al momento non effettuiamo un filtraggio degli IP, però in futuro non è escluso che lo implementeremo.
C'è qualche limite nel numero di richieste HTTP al minuto?
Al momento no, però nel futuro potremo implementarli.
Avete intenzione di implementare un sistema in push, in modo da alleggerire le richieste?
Al momento non abbiamo implementato un sistema di push, però potremo aggiungerlo in futuro.
Qual è l'indirizzo del pannello per l'accesso al backoffice?
http://www.salsapanel.com/
Una volta attivata l'interfaccia XML, l'hotel può comunque accedere al backoffice?
Sì.
Quando nella risposta ad una richiesta viene riportato un errore, se nella richiesta ci sono parti senza errori, non viene committato nulla o ci sono parti che vengono scritte?
In AvailabilityWrite e RatesWrite, le chiamate sono atomiche, o vengono scritte tutte le righe o nessuna. Se c'è un errore non viene effettuata nessuna operazione.
Per l'accesso alle API, ogni hotel ha la sua authentication key?
Sì.
Una volta attivata l'interfaccia XML, l'hotel riceve comunque le notifiche delle nuove prenotazioni ricevute?
Sì, arrivano comunque all'hotel.
I campi disponibilità, minimum stay e price che valori possono prendere?
  • availability: tinyint
  • minimum stay: tinyint
  • price: float
I prezzi che scrivo/leggo o che trovo nelle prenotazioni sono netti o lordi?
Sono i prezzi finali ai visitatori.
Nel caso di prenotazioni confermate o cancellate, la disponibilità viene aggiornata automaticamente dal sistema?
La disponibilità viene scalata al momento della prenotazione, mentre quando avviene una cancellazione, ciò non avviene.
Gestite forme di allotment?
No, non gestiamo allotment.
Quali sono i codici identificativi delle carte di credito?
Usiamo questi codici:
  • visa: Visa
  • mastercard: Master Card
  • amex: American Express
  • jcb: JCB
  • diners: Diners
A quale email si può eventualmente fare una richiesta attivazione di un nuovo hotel?
support@caprionline.it