Diferencia entre revisiones de «API Reference: Búsqueda de Disponibilidad de Hoteles»

Revisión actual del 12:53 30 jul 2024

Búsqueda de Disponibilidad de Hoteles (AvailabilityQuery)

Consulta de disponibilidad para hoteles en un destino y un rango de fechas determinado. Retorna una colección de tarifas, una por cada hotel ofrecido por los proveedores habilitados para el contrato del usuario.

Request: AvailabilityQueryRQ Estructura del Documento

Response: AvailabilityQueryRS Estructura del Documento

Ejemplo de uso:

- - Solicitud:

<AvailabilityQueryRQ TransactionId="9c8ac0a3_3e12_4fc5_ad86_6a774def52b6" TransactionMode="Synchronous">

 <GeneralParameters>
   <PreferedLanguage LanguageCode="es"/>
   <PreferedCurrency CurrencyCode="EUR"/>
 </GeneralParameters>
 <Trips>
   <Trip>
     <Destination>5735</Destination>
     <ProductsParameters>
       <HotelsParameters>
         <Criterion>
           <Rooms>
             <Room RoomType="NMO.HTL.RMT.SGL" RoomSequence="1"/>
             <Room RoomType="NMO.HTL.RMT.DBL" RoomSequence="2"/>
           </Rooms>
           <CheckIn>2014-06-15</CheckIn>
           <CheckOut>2014-06-16</CheckOut>
           <Availability>CNF</Availability>            
           <HotelName>Savoy</HotelName>
           <HotelCodeList>93316,155879</HotelCodeList>
           <Ratings>3,5</Ratings>
         </Criterion>
       </HotelsParameters>
     </ProductsParameters>
   </Trip>
 </Trips>
 <Passengers>
   <Passenger AgeType="NMO.GBL.AGT.ADT" RoomSequence="1"/>
   <Passenger AgeType="NMO.GBL.AGT.CHD" RoomSequence="1">
     <Age>10</Age>
   </Passenger>
   <Passenger AgeType="NMO.GBL.AGT.ADT" RoomSequence="2"/>
   <Passenger AgeType="NMO.GBL.AGT.ADT" RoomSequence="2"/>
   <Passenger AgeType="NMO.GBL.AGT.INF" RoomSequence="2">
     <Age>1</Age>
   </Passenger>
 </Passengers>
 <RequestSet>
   <FirstItem>1</FirstItem>
   <ItemsPerPage>10</ItemsPerPage>
 </RequestSet>

</AvailabilityQueryRQ>

Parámetro

Obligatorio

Descripción

TransactionId

Sí

Deberá contener solo letras, números o "_" y lo genera el cliente para identificar un ID de transacción entre todos los mensajes del fujo de reserva. Debe ser único por cada mensaje de búsqueda.

TransactionMode

Sí

Synchronous / StartAsync / ContinueAsync, Normalmente se usará "Synchronous".

Synchronous: Las búsquedas en este modo esperarán que termine hasta el último proveedor en responder. Luego se ordenarán por precio y se retornarán.
StartAsync y ContinueAsync: Se utilizan en conjunto para hacer pooling.

(Ver en detalle el uso de TransactionMode en el capítulo Price_Surfer_-_Web_Services#Especificaciones_y_recomendaciones)

GeneralParameters

Sí

PreferedLanguage

Sí

Establece el lenguaje requerido para la respuesta.

Atributos:

LanguageCode: Código de lenguaje correspondiente a los códigos de lenguaje estándar provistos por Nemo.

PreferedCurrency

No

No está habilitado el uso de multimoneda. La moneda utilizada será la configurada en el contrato.

Atributos:

CurrencyCode: Código de moneda correspondiente a los códigos de moneda estándar provistos.

(Dicho nodo es No Obligatorio ya que la moneda utilizada actualmente es la configurada en el contrato)

Trip

Se deberá enviar un único Trip con un único destino en una solicitud. Si se envía mas de un Trip con diferentes destinos, sólo se devolverán resultados del primero de ellos.

Destination

Sí

Código de ciudad para la que se realiza la consulta de disponibilidad de tarifas. Destinos

ProductsParameters

Sí

HotelsParameters

Sí

Parámetros específicos de hoteles.

Criterion

Sí

Indica los distintos parámetros de la búsqueda.

CheckIn

Sí

Fecha de inicio de la estadía. Formato 'YYYY-MM-DD'. No incluir el indicador de TimeZone UTC (la letra "Z" luego del día) (huso horario UTC = GMT 0), pues al hacerlo la fecha indicada cambiará luego de cierta hora

CheckOut

Sí

Fecha de fin de la estadía. Formato 'YYYY-MM-DD'. No incluir el indicador de TimeZone UTC (la letra "Z" luego del día) (huso horario UTC = GMT 0), pues al hacerlo la fecha indicada cambiará luego de cierta hora

Rooms

Sí

Información sobre las habitaciones solicitadas.

Room

Sí

Identifica una habitación en los parámetros de la búsqueda. Cada habitación tendrá su RoomSequence, número entero consecutivo y comenzando en 1, que también colocará a los pasajeros en el nodo Passengers, para así armar la ocupación determinada para la búsqueda de hoteles.

Atributos:

RoomType: Tipo de habitación requerido en la busqueda. Los tipos de habitación admitidos en la búsqueda de disponibilidad son los siguientes:

Código	Descripción
SGL	Single (1 adulto)
DBL	Doble (2 adultos)
DBL.TSU	Doble de uso individual (1 adulto)
DBL.TWN	Doble Twin (2 adultos)
TPL	Trilpe (3 adultos)
QUA	Quadruple (4 adultos)
PEN	Quintuple (5 adultos)
HEX	Sextuple (6 adultos)
SEP	Septuple (7 adultos)
OCT	Octuple (8 adultos)
NON	Nonuple (9 adultos)

En el request de busqueda el atributo "RoomType" se puede utilizar los "tipos de room" simplificados o completos:

Tipos de room simplificados (ej: DBL)
Tipos de room completo (ej: NMO.HTL.RMT.DBL)

El atributo "RoomType" no es obligatorio, pero sólo una sugerencia para los proveedores habilitados. La búsqueda se hará por ocupación, indicada en el nodo Passengers, pero si se requiere un tipo especial de habitación, por ejemplo Doble Twin, se puede indicar aquí.

Importante: La respuesta dependerá de la disponibilidad del proveedor, y puede contener habitaciones con otros tipos de habitación. Al reservar un hotel se debe tener en cuenta el tipo de habitación devuelto en la búsqueda.

RoomSequence: Es un número consecutivo que comienza en 1 que identifica la habitación donde estará alojado cada pasajero.

Availability

No

Tipo de disponibilidad de la tarifa

Valores posibles(estrictos): "ALL"(Cualquier Disponibilidad) - "CNF"(Confirmacion Inmediata) - "ORQ"(Bajo Peticion)

Suppliers

No

Dicho filtro sirve para realizar "Busquedas Exclusivas Online" para solo los proveedores del filtro (sujeto a las credenciales del contrato).

Las tarifas retornadas inicialmente se almacenan en cache por 10 minutos. Pasado dicho tiempo eliminar el filtro "Suppliers" o reducir/extender el listado de proveedores.

Los codigos utilizados identifican a los proveedores (separados por comas) como ser TOH (Tourico Holidays) o BOL (HotelBeds)

Ej:

  <Criterion>
    ...
    <Suppliers>TOH,BOL</Suppliers>

HotelName

No

Define nombre del hotel requerido

Hoteles que contengan el nombre "Savoy" (ej: "Esplendor Savoy Rosario"): <HotelName>Savoy</HotelName>

HotelCodeList

No

Establece los códigos de hoteles (separados por comas) que solo son requeridos en el resultado de la búsqueda. Pueden corresponder a uno o varios proveedores.

Ratings

No

Establece los Ratings abarcativos (separados por comas) que son requeridos en el resultado de la busqueda.

Hoteles con ratings en 3, 4 y 5: <Ratings>3,5</Ratings>

Hoteles solo con "ratings=5": <Ratings>5</Ratings>

PriceRange

No

Establece un rango de precios (valores enteros separados por comas) que son requeridos en el resultado de la busqueda.

Precios de rates entre 1 y 200: <PriceRange>1,200</PriceRange>

Precios de rates mayores a 200: <PriceRange>200</PriceRange>

Offers

No

Define filtrar por rates que tengan ofertas declaradas. Caso contrario no usar dicho filtro.

<Offers>true</Offers>

Boards

No

Establece un rango de regimenes (valores enteros separados por comas) que son requeridos en el resultado de la busqueda.

Rates con Regimen "Desayuno": <Boards>2</Boards>

Rates con Regimen "Solo Habitacion" + Rates con Regimen "Desayuno": <Boards>1,2</Boards>

Zones

No

Define las zonas (valores enteros separados por comas) que son requeridos en el resultado de la busqueda (se indican en el nodo Responset).

Hoteles en zona G1 y G2: <Zones>G1,G2</Zones>

Zonas basicas:

G1 - Centro
G2 - Aeropuerto y Cercanías
G3 - Cercano a estacion de omnibus o trenes
G4 - Puerto y Cercanías
G5 - Cercano al mar
G6 - Zona Rural / Agreste
G7 - Montaña
G8 - Area suburbana
G9 - Cerca del centro

TripAdvisors

No

Define rango segun la escala de TripAdvisor (valores enteros separados por comas) que son requeridos en el resultado de la busqueda (se indican en el nodo Responset).

Hoteles con TripAdvisor con valores "3,4,5,6": <TripAdvisors>3</TripAdvisors>
Hoteles con TripAdvisor con valores "1,2,3": <TripAdvisors>1,3</TripAdvisors>

Nota: sujeto a que el contrato tenga el servicio de TripAdvisor.

Passenger

Sí

Establece los pasajeros para la búsqueda realizada.

Atributos:

AgeType: indica el tipo de pasajero Adulto, Child o Infante (NMO.GBL.AGT.ADT , NMO.GBL.AGT.CHD , NMO.GBL.AGT.INF).

RoomSequence: En hoteles, indicar todos los pasajeros con su correspondiente identificador de habitación RoomSequence. Por ejemplo para dos habitaciones dobles colocar dos pasajeros con RoomSequence=1 y otros dos pasajeros con RoomSequence=2.

Nota: Busquedas limitadas hasta 4 menores por room, con un maximo de 2 infantes (ej: 2 Adultos + 3 Child + 1 Infante)

Age

No

Edad del pasajero. Sólo obligatorio para pasajeros Child o Infante. La edad del infante debe informarse como 1 año. La edad del child deberá ser de 2 a 17 años inclusive. (Algunos proveedores consideran child hasta 12, 13 o 17 años, las tarifas dependerán de la edad del child y del proveedor involucrado) Si las edades no corresponden los resultados serán inesperados. Importante: La edad enviada debe ser la edad del pasajero al momento del Check-In

RequestSet

No

Establece los parametros de paginacion.

Atributos:

FirstItem: valor numerico que indica la pagina solicitada
ItemsPerPage: valor numerico que define el tamaño del conjunto de datos

Ej para "ItemsPerPage=10" :

- FirstItem = 1 -> se retornara los resultados del rango (0,10)

- FirstItem = 2 -> se retornara los resultados del rango (10,20)

- FirstItem = 3 -> se retornara los resultados del rango (20,30)

- - Respuesta:

<AvailabilityQueryRS TransactionId="9c8ac0a3_3e12_4fc5_ad86_6a774def52b6" TransactionMode="Synchronous">

 <Echo TransactionId="9c8ac0a3_3e12_4fc5_ad86_6a774def52b6" TransactionMode="Synchronous">
   <GeneralParameters>
     <PreferedLanguage LanguageCode="es"/>
     <PreferedCurrency CurrencyCode="ARS"/>
   </GeneralParameters>
   <Trips>
     <Trip>
       <Destination>5735</Destination>
       <ProductsParameters>
         <HotelsParameters>
           <Criterion>
             <Rooms>
               <Room RoomType="NMO.HTL.RMT.SGL" RoomSequence="1"/>
               <Room RoomType="NMO.HTL.RMT.DBL" RoomSequence="2"/>
             </Rooms>
             <CheckIn>2014-06-10</CheckIn>
             <CheckOut>2014-06-19</CheckOut>
           </Criterion>
         </HotelsParameters>
       </ProductsParameters>
     </Trip>
   </Trips>
   <Passengers>
     <Passenger AgeType="NMO.GBL.AGT.ADT" RoomSequence="1"/>
     <Passenger AgeType="NMO.GBL.AGT.CHD" RoomSequence="1">
       <Age>10</Age>
     </Passenger>
     <Passenger AgeType="NMO.GBL.AGT.ADT" RoomSequence="2"/>
     <Passenger AgeType="NMO.GBL.AGT.ADT" RoomSequence="2"/>
     <Passenger AgeType="NMO.GBL.AGT.INF" RoomSequence="2">
       <Age>1</Age>
     </Passenger>
   </Passengers>
 </Echo>
 <Details>
   <Trips>
     <Trip>
       <HotelsAvailability>
         <Hotels>
           <Hotel HotelDetailId="VED-2CGU-3G8" Code="93316" Name="Pullman City Center Rosario" Longitude="-60.6629" Latitude="-33.0111">
             <DestinationDetails>
               <Destination Code="5735" Type="NMO.HTL.DST.CTY"/>
             </DestinationDetails>
             <Rates>
               <Rate TripProductID="o0JPTM0RiqYxODY1MjejMi0wwgEDBQQCzQISzy.qSgnC1+Dd:2SJhN2Q5MDk2Yzg1M2Q5NmY5Mjk2ODkwMjllODdlYzhiY0AyabHj.wY." PossiblyNonRefundable="false">
                 <Rooms>
                   <Room Availability="CNF" Type="NMO.HTL.RMT.DBL" Occupancy="2/1/0">DOBLE TWIN</Room>
                   <Room Availability="CNF" Type="NMO.HTL.RMT.DBL" Occupancy="1/1/0">DOBLE TWIN</Room>
                 </Rooms>
                 <Board Code="14">SOLO HABITACIÓN</Board>
                 <RatePrices>
                   <RatePrice Currency="ARS" Type="NMO.GBL.RPT.GRS">2065.36</RatePrice>
                   <RatePrice Currency="ARS" Type="NMO.HTL.RPT.NET">2062.36</RatePrice>
                 </RatePrices>
               </Rate>
               <Rate TripProductID="o0JPTM0RiqYxODY1MjejMi0wwgEDBQQCzQISzy.qSgnC1+Dd:2SJhN2Q5MDk2Yzg1M2Q5NmY5Mjk2ODkwMjllOAclYzhiY0AyzgHj.wY." PossiblyNonRefundable="false">
                 <Rooms>
                   <Room Availability="CNF" Type="NMO.HTL.RMT.DBL" Occupancy="2/1/0">DOBLE CAMA KING SIZE</Room>
                   <Room Availability="CNF" Type="NMO.HTL.RMT.DBL" Occupancy="1/1/0">DOBLE CAMA KING SIZE</Room>
                 </Rooms>
                 <Board Code="14">SOLO HABITACIÓN</Board>
                 <RatePrices>
                   <RatePrice Currency="ARS" Type="NMO.GBL.RPT.GRS">2065.36</RatePrice>
                   <RatePrice Currency="ARS" Type="NMO.HTL.RPT.NET">2062.36</RatePrice>
                 </RatePrices>
               </Rate>
               <Rate TripProductID="o0JPTM0RiqYxODY1MjejMi0wwgEDBQQCzQISzy.qSgnC1+Dd:2SJhN2Q5MDk2Yzg1M2Q5NmY5Mjk2ODkwMjccODdlYzhiY0AyzgHj.wY." PossiblyNonRefundable="false">
                 <Rooms>
                   <Room Availability="CNF" Type="NMO.HTL.RMT.DBL" Occupancy="2/1/0">DOBLE TWIN</Room>
                   <Room Availability="CNF" Type="NMO.HTL.RMT.DBL" Occupancy="1/1/0">DOBLE TWIN</Room>
                 </Rooms>
                 <Board Code="3">ALOJAMIENTO Y DESAYUNO</Board>
                 <RatePrices>
                   <RatePrice Currency="ARS" Type="NMO.GBL.RPT.GRS">2413.8</RatePrice>
                   <RatePrice Currency="ARS" Type="NMO.HTL.RPT.NET">2410.8</RatePrice>
                 </RatePrices>
               </Rate>
             </Rates>
             <Rating Code="NMO.HTL.RTN.3ST" Type="NMO.HTL.RTT.STR">
               <Value>5.0</Value>
             </Rating>
             <Address>
               <Line>Bv Oroño 950</Line>
               <Line>Rosario</Line>
             </Address>
             <TripAdvisor>
              <LocationId>228521</LocationId>
              <ImagePath>http://www.tripadvisor.com/img/cdsi/img2/ratings/traveler/4.0-26812-5.png</ImagePath>
              <CategoryValue>4.0</CategoryValue>
              <Reviews>2000</Reviews>
             </TripAdvisor>
           </Hotel>
           <Hotel HotelDetailId="V2D-2CDT-4G8" Code="155879" Name="Esplendor Savoy Rosario" Longitude="-60.636577" Latitude="-32.94456">
             <DestinationDetails>
               <Destination Code="5735" Type="NMO.HTL.DST.CTY"/>
             </DestinationDetails>
             <Rates>
               <Rate TripProductID="o0JPTM0RiqYxODY1MjejMi0wwgEDBQQCzQISzy.qSgnC1+Dd:2SJhN2Q5MDk2Yzg1M2Q5NmY5Mjk2ODnnMjllODdlYzhiY0AyzgHj.wY." PossiblyNonRefundable="false">
                 <Rooms>
                   <Room Availability="CNF" Type="NMO.HTL.RMT.DBL" Occupancy="2/1/0">DOBLE MATRIMONIAL-CONCEPT-SUPERIOR</Room>
                   <Room Availability="CNF" Type="NMO.HTL.RMT.DBL" Occupancy="1/1/0">DOBLE MATRIMONIAL-CONCEPT-SUPERIOR</Room>
                 </Rooms>
                 <Board Code="3">ALOJAMIENTO Y DESAYUNO</Board>
                 <RatePrices>
                   <RatePrice Currency="ARS" Type="NMO.GBL.RPT.GRS">3631.98</RatePrice>
                   <RatePrice Currency="ARS" Type="NMO.HTL.RPT.NET">3628.98</RatePrice>
                 </RatePrices>
               </Rate>    
               <Rate TripProductID="o0JPTM0RiqYxODY1MjejMi0wwgEDBQQCzQISzy.qSgnC1+Dd:2SJhN2Q5MDk2Aeg1M2Q5NmY5Mjk2ODkwMjllODdlYzhiY0AyzgHj.wY." PossiblyNonRefundable="false">
                 <Rooms>
                   <Room Availability="CNF" Type="NMO.HTL.RMT.DBL" Occupancy="2/1/0">DOBLE CONCEPT-SUPERIOR-TWIN</Room>
                   <Room Availability="CNF" Type="NMO.HTL.RMT.DBL" Occupancy="1/1/0">DOBLE MATRIMONIAL-CONCEPT-SUPERIOR</Room>
                 </Rooms>
                 <Board Code="3">ALOJAMIENTO Y DESAYUNO</Board>
                 <RatePrices>
                   <RatePrice Currency="ARS" Type="NMO.GBL.RPT.GRS">3631.98</RatePrice>
                   <RatePrice Currency="ARS" Type="NMO.HTL.RPT.NET">3628.98</RatePrice>
                 </RatePrices>
               </Rate>               
               <Rate TripProductID="o0JPTM0RiqYxODY1MjejMi0wwgEDBQQCzQISzy.qSgnC1+Dd:2SJhN2Q5MDk2Yzg1M2Q5aqY5Mjk2ODkwMjllODdlYzhiY0AyzgHj.wY." PossiblyNonRefundable="false">
                 <Rooms>
                   <Room Availability="CNF" Type="NMO.HTL.RMT.DBL" Occupancy="2/1/0">DOBLE MATRIMONIAL-CONCEPT</Room>
                   <Room Availability="CNF" Type="NMO.HTL.RMT.DBL" Occupancy="1/1/0">DOBLE MATRIMONIAL-CONCEPT</Room>
                 </Rooms>
                 <Board Code="3">ALOJAMIENTO Y DESAYUNO</Board>
                 <RatePrices>
                   <RatePrice Currency="ARS" Type="NMO.GBL.RPT.GRS">5809.44</RatePrice>
                   <RatePrice Currency="ARS" Type="NMO.HTL.RPT.NET">5806.44</RatePrice>
                 </RatePrices>
               </Rate>
               <Rate TripProductID="o0JPTM0RiqYxODY1MjejMi0wwgEDBQQCzQISzy.qSgnC1+Dd:2SJhN2Q5MDk2YzagM2Q5NmY5Mjk2ODkwMjllODdlYzhiY0AyzgHj.wY." PossiblyNonRefundable="false">
                 <Rooms>
                   <Room Availability="CNF" Type="NMO.HTL.RMT.DBL" Occupancy="2/1/0">DOBLE MATRIMONIAL-CONCEPT</Room>
                   <Room Availability="CNF" Type="NMO.HTL.RMT.DBL" Occupancy="1/1/0">DOBLE MATRIMONIAL-CONCEPT-SUPERIOR</Room>
                 </Rooms>
                 <Board Code="3">ALOJAMIENTO Y DESAYUNO</Board>
                 <RatePrices>
                   <RatePrice Currency="ARS" Type="NMO.GBL.RPT.GRS">5809.44</RatePrice>
                   <RatePrice Currency="ARS" Type="NMO.HTL.RPT.NET">5806.44</RatePrice>
                 </RatePrices>
               </Rate>              
             </Rates>
             <Rating Code="NMO.HTL.RTN.5ST" Type="NMO.HTL.RTT.STR">
               <Value>4.0</Value>
             </Rating>
             <Address>
               <Line>San Lorenzo 1022</Line>
               <Line>Rosario</Line>
             </Address>
             <HotelRecommendation RecommendationType="5">No te vas a arrepentir, el lugar es un paraíso y el servicio es increíble</HotelRecommendation>
             <TripAdvisor>
              <LocationId>228521</LocationId>
              <ImagePath>http://www.tripadvisor.com/img/cdsi/img2/ratings/traveler/4.0-26812-5.png</ImagePath>
              <CategoryValue>4.0</CategoryValue>
              <Reviews>2000</Reviews>
             </TripAdvisor>
           </Hotel>
           <Hotel HotelDetailId="V77-277U-778" Code="171732" Name="Plaza Real" Longitude="-60.6639400497079" Latitude="-32.9377402737737">
             <DestinationDetails>
               <Destination Code="5735" Type="NMO.HTL.DST.CTY"/>
             </DestinationDetails>
             <Rates>
               <Rate TripProductID="o0JPTM0RiqYxODY1MjejMi0wwgEDBQQCzQISzy.qSgnC1+Dd:2SJhN2Q5MDk2Yzg1M2Q5NmY5Mjk2ODkwMjllODdlBahiY0AyzgHj.wY." PossiblyNonRefundable="false">
                 <Rooms>
                   <Room Availability="CNF" Type="NMO.HTL.RMT.DBL" Occupancy="2/1/0">DOBLE EJECUTIVO</Room>
                   <Room Availability="CNF" Type="NMO.HTL.RMT.DBL" Occupancy="1/1/0">DOBLE EJECUTIVO</Room>
                 </Rooms>
                 <Board Code="3">ALOJAMIENTO Y DESAYUNO</Board>
                 <RatePrices>
                   <RatePrice Currency="ARS" Type="NMO.GBL.RPT.GRS">2751.42</RatePrice>
                   <RatePrice Currency="ARS" Type="NMO.HTL.RPT.NET">2748.42</RatePrice>
                 </RatePrices>
               </Rate>
               <Rate TripProductID="o0JPTM0RiqYxODY1MjejMi0wwgEDBQQCzQISzy.qSgnC1+Dd:2SJhN2Q5MDk2Yzg1M2Q5NmY5Mjk2ODkwMjllOBcdlYzhiY0AyzgHj.wY." PossiblyNonRefundable="false">
                 <Rooms>
                   <Room Availability="CNF" Type="NMO.HTL.RMT.DBL" Occupancy="2/1/0">DOBLE EJECUTIVO</Room>
                   <Room Availability="CNF" Type="NMO.HTL.RMT.DBL" Occupancy="1/1/0">DOBLE ESPECIAL</Room>
                 </Rooms>
                 <Board Code="3">ALOJAMIENTO Y DESAYUNO</Board>
                 <RatePrices>
                   <RatePrice Currency="ARS" Type="NMO.GBL.RPT.GRS">2886.87</RatePrice>
                   <RatePrice Currency="ARS" Type="NMO.HTL.RPT.NET">2883.87</RatePrice>
                 </RatePrices>
               </Rate>
               <Rate TripProductID="o0JPTM0RiqYxODY1MjejMi0wwgEDBQQCzQISzy.qSgnC1+Dd:2SJhN2Q5MDk2Yzg1M2Q5NmY5Mjk2ODkwBdllODdlYzhiY0AyzgHj.wY." PossiblyNonRefundable="false">
                 <Rooms>
                   <Room Availability="CNF" Type="NMO.HTL.RMT.DBL" Occupancy="2/1/0">DOBLE EJECUTIVO</Room>
                   <Room Availability="CNF" Type="NMO.HTL.RMT.DBL" Occupancy="1/1/0">DOBLE LUXURY</Room>
                 </Rooms>
                 <Board Code="3">ALOJAMIENTO Y DESAYUNO</Board>
                 <RatePrices>
                   <RatePrice Currency="ARS" Type="NMO.GBL.RPT.GRS">3815.94</RatePrice>
                   <RatePrice Currency="ARS" Type="NMO.HTL.RPT.NET">3812.94</RatePrice>
                 </RatePrices>
               </Rate>
               <Rate TripProductID="o0JPTM0RiqYxODY1MjejMi0wwgEDBQQCzQISzy.qSgnC1+Dd:2SJhN2Q5MDk2Yzg1M2Q5NmY5Mjk2ODkwMjllOBflYzhiY0AyzgHj.wY." PossiblyNonRefundable="false">
                 <Rooms>
                   <Room Availability="CNF" Type="NMO.HTL.RMT.DBL" Occupancy="2/1/0">DOBLE LUXURY</Room>
                   <Room Availability="CNF" Type="NMO.HTL.RMT.DBL" Occupancy="1/1/0">DOBLE EJECUTIVO</Room>
                 </Rooms>
                 <Board Code="3">ALOJAMIENTO Y DESAYUNO</Board>
                 <RatePrices>
                   <RatePrice Currency="ARS" Type="NMO.GBL.RPT.GRS">3815.94</RatePrice>
                   <RatePrice Currency="ARS" Type="NMO.HTL.RPT.NET">3812.94</RatePrice>
                 </RatePrices>
               </Rate>       
             </Rates>
             <Rating Code="NMO.HTL.RTN.5ST" Type="NMO.HTL.RTT.STR">
               <Value>4.0</Value>
             </Rating>
             <Address>
               <Line>Santa Fe 1632</Line>
               <Line>Rosario</Line>
             </Address>
             <TripAdvisor>
              <LocationId>228521</LocationId>
              <ImagePath>http://www.tripadvisor.com/img/cdsi/img2/ratings/traveler/4.0-26812-5.png</ImagePath>
              <CategoryValue>4.0</CategoryValue>
              <Reviews>2000</Reviews>
             </TripAdvisor>
           </Hotel>
         </Hotels>
       </HotelsAvailability>
     </Trip>
   </Trips>
   <Passengers>
     <Passenger AgeType="NMO.GBL.AGT.ADT" RoomSequence="1"/>
     <Passenger AgeType="NMO.GBL.AGT.CHD" RoomSequence="1">
       <Age>10</Age>
     </Passenger>
     <Passenger AgeType="NMO.GBL.AGT.ADT" RoomSequence="2"/>
     <Passenger AgeType="NMO.GBL.AGT.ADT" RoomSequence="2"/>
     <Passenger AgeType="NMO.GBL.AGT.INF" RoomSequence="2">
       <Age>1</Age>
     </Passenger>
   </Passengers>
 </Details>

</AvailabilityQueryRS>

Parámetro	Obligatorio	Descripción
Notifications	No
Notification	Si	Nodo que informa cuando ocurre algún error o excepción. En el atributo TripNumber se indica el trip al cual se refiere la notificación.
NotificationId	Si	Identificador de la notificación. Las mismas serán provistas por Nemo.
NotificationType	Si	Tipo de notificación.
NotificationMessage	Si	Mensaje de notificación.
ErrorQualifier	No	Subtipo de error. Atributos: Code: código del error Valores posibles: E01 -> "There are no providers for the destination xxx in the contract yyy" E02 -> "Timeout (xx seg) for all providers" E03 -> "There are no avaibility for the destination" E04 -> "The currency of the user: xx does not match the contract: yy"
Echo	No	En este nodo se envía una copia de la consulta realizada.
Details	Si
Trips	Si
Hotel	No	Hotel recomendado por el sistema como mejor compra para el tramo. Atributos: SupplerID: Id del proveedor Code: código del hotel, de los provistos por Nemo. Name: nombre del hotel Longitude y Latitude (opcionales): coordenadas para la ubicación del hotel en un mapa.
Amenities	No	Amenidades del hotel.
Rates	Si	Se informan las habitaciones, regímenes y tarifas.
Rating	Si	Categoría del hotel.
HotelRecommendation	No	Informacion referida a HotelRecommendation
TripAdvisor	No	Informacion referida a TripAdvisor
HotelsAvailability	No	Retorna un conjunto de hoteles para el destino buscado. Se informará el nodo Amenities, DestinationDetails, Rates y Rating.
Exceptions	No	Si no se puede armar el nodo Details se arma un nodo Exceptions con las notificaciones correspondientes.

Item Hotel (Estructura):

<Hotel Code="173905" Name="1495 Apart" Longitude="0.0" Latitude="0.0">

  <DestinationDetails>
    <Destination Code="5735" Type="NMO.HTL.DST.CTY"/>
  </DestinationDetails>
  <Rates>
     <Rate TripProductID="o0JPTM0RiqYxODY1MjejMi0wwgEDBQQCzQISzy.qSgnC1+Dd:2SJhN2Q5MDk2Yzg1M2Q5NmY5Mjk2OMnwMjllODdlYzhiY0AyzgHj.wY." PossiblyNonRefundable="false">
        <Rooms>
           <Room Availability="CNF" Type="NMO.HTL.RMT.DBL" Occupancy="2/1/0">DOBLE DELUXE</Room>
           <Room Availability="CNF" Type="NMO.HTL.RMT.DBL" Occupancy="1/1/0">DOBLE DELUXE</Room>
        </Rooms>
  <Board Code="3">ALOJAMIENTO Y DESAYUNO</Board>
  <RatePrices>
       <RatePrice Type="NMO.GBL.RPT.GRS" Currency="ARS">3873.9</RatePrice>
       <RatePrice Type="NMO.HTL.RPT.NET" Currency="ARS">3870.9</RatePrice>
     </RatePrices>
   </Rate>
 </Rates>
 <Rating Code="NMO.HTL.RTN.4ST" Type="NMO.HTL.RTT.STR">
   <Value>3.0</Value>
 </Rating>
 <Address>
   <Line>Mendoza 1495</Line>
   <Line>Rosario</Line>
 </Address>
 <HotelRecommendation RecommendationType="5">No te vas a arrepentir, el lugar es un paraíso y el servicio es increíble</HotelRecommendation>
 <TripAdvisor>
  <LocationId>228521</LocationId>
  <ImagePath>http://www.tripadvisor.com/img/cdsi/img2/ratings/traveler/4.0-26812-5.png</ImagePath>
  <CategoryValue>4.0</CategoryValue>
  <Reviews>2000</Reviews>
</TripAdvisor>

</Hotel>

Parámetro	Descripción
Hotel	Cada item Hotel con sus descripciones y tarifas. Atributos: Code: valor numérico correspondiente al código Nemo del hotel. Name: nombre del hotel. Longitude: atributo de geoposicionamiento. Latitude: atributo de geoposicionamiento.
Destination	Código y tipo del destino del hotel. Atributos: Code: valor numérico correspondiente al código del destino. Type: valor correspondiente al tipo de destino. Valores posibles: "NMO.HTL.DST.CTY", "NMO.HTL.DST.AIR"
Rate	Tarifas Atributos: TripProductID: identificador único para la tarifa reservable. Su tamaño es variable, pudiendo tener como mínimo 30 caracteres (sin máximo). Tentativamente podría indicarse un máximo de 500 caracteres, dependiendo de las tarifas enviadas del proveedor. PossiblyNonRefundable: Tarifa probablemente no-reembolsable (true / false)
Room	Descripción de la habitación. Atributos: Availability: código de la disponibilidad. Valores posibles: "ALL"(Cualquier Disponibilidad) - "CNF"(Confirmacion Inmediata) - "ORQ"(Bajo Peticion) Type: código del tipo de habitación. Los room types que se retornan en la respuesta son los "tipos de room" completos (ej: "NMO.HTL.RMT.DBL"). Estos son los room types que se deben usar en la reserva. Occupancy: código que corresponde al tipo de ocupación.
Board	Tipo de alojamiento y descripción. Atributos: Code: Código del board. Tabla de Códigos: Tipos de Pensiones Nota: la descripcion del board es la que retorna el proveedor
RatePrice	Precio de la habitación. Atributos: Type: tipo de precio. Valores por default: NMO.GBL.RPT.GRS (Precio de venta o PVP) NMO.HTL.RPT.NET (Precio neto)
Rating	Estrellas Atributos: Code: Código de la estrella. Tabla de Códigos Type: Tipo de estrella. Tabla de Códigos
HotelRecommendation	Informacion sobre HotelRecommendation RecommendationType: 0-Sin Recomendación \| 1-No visualizar \| 2-No Recomendado \| 3-Poco Recomendable \| 4-Recomendado \| 5-Altamente Recomendado
TripAdvisor	Informacion sobre TripAdvisor Atributos: LocationId - ImagePath - CategoryValue - Reviews
Address	Dirección del hotel compuesto por varias líneas. Atributos: Line: Cada una de las líneas de texto correspondiente a la dirección.

Nodo Responset

Para obtener la información adicional, deberán agregar un Query Param con nombre hideNewInfo y con valor false, debiendo tener en cuenta que si el Query Param no es agregado ( ?hideNewInfo=false ), el WebService no devolverá la nueva información.

Ejemplo: http://service.psurfer.net/pricesurfer/catalog/products/search?hideNewInfo=false

  <Details>
     <Trips>
        <Trip>
           <HotelsAvailability>
              <Responset>
                 <Filters>
                    <Supplier Code="TOH" Description="Tourico Holidays V3" Quantity="43"/>
                    <Supplier Code="GTA" Description="Gullivers Travel Associated" Quantity="39"/>
                    <Supplier Code="BOL" Description="HotelBeds" Quantity="185"/>
                    <Rating Code="1" Description="" Quantity="2"/>
                    <Rating Code="2" Description="" Quantity="16"/>
                    <Rating Code="3" Description="" Quantity="124"/>
                    <Rating Code="4" Description="" Quantity="90"/>
                    <Rating Code="5" Description="" Quantity="35"/>
                    <Amenity Code="LOC:14" Description="Bungalows" Quantity="5"/>
                    <Amenity Code="FCL:96" Description="Baloncesto" Quantity="5"/>
                    <Amenity Code="HTR:18" Description="Cafetera / Tetera" Quantity="124"/>
                    <Amenity Code="HTL:14" Description="Ascensores" Quantity="39"/>
                    <Amenity Code="HTR:23" Description="Enmoquetado/a" Quantity="79"/>
                    <Amenity Code="HTR:14" Description="Nevera" Quantity="65"/>
                    <Amenity Code="DST:14" Description="Campo de golf" Quantity="55"/>
                    <Amenity Code="HTL:18" Description="Piscina al aire libre" Quantity="36"/>
                    <Amenity Code="FCL:10" Description="Quiosco" Quantity="48"/>
                    <Amenity Code="HTL:10" Description="Gimnasio" Quantity="30"/>
                    <Amenity Code="LOC:10" Description="Junior Suites" Quantity="27"/>
                    <Amenity Code="HTR:10" Description="Acceso a internet" Quantity="130"/>
                    <TripAdvisor Code="4" Description="" Quantity="8"/>
                    <Zone Code="G8" Description="Área suburbana" Quantity="4"/>
                    <Zone Code="09" Description="Ocean Drive/Art Deco District" Quantity="1"/>
                    <Zone Code="G2" Description="Aeropuerto y Cercanías" Quantity="11"/>
                    <Zone Code="G9" Description="Cerca del centro" Quantity="38"/>
                    <Zone Code="G3" Description="Cercano a estación de omnibus o trenes" Quantity="1"/>
                    <Zone Code="04" Description="Downtown Miami" Quantity="5"/>
                    <Zone Code="G1" Description="Centro" Quantity="13"/>
                    <Zone Code="02" Description="North Miami" Quantity="1"/>
                    <Zone Code="01" Description="Coconut Grove & Coral Gables" Quantity="2"/>
                    <Zone Code="G5" Description="Cercano al mar" Quantity="54"/>
                    <Board Code="1" Description="Sólo Alojamiento" Quantity="223"/>
                    <Board Code="2" Description="Sólo Desayuno" Quantity="84"/>
                    <Board Code="5" Description="Media pensión" Quantity="86"/>
                    <Board Code="8" Description="Otras Opciones!!!" Quantity="91"/>
                    <Tags Code="offer" Description="offer" Quantity="9"/>
                    <Tags Code="recommended" Description="recommended" Quantity="0"/>
                    <Tags Code="Refundable" Description="Refundable" Quantity="2"/>
                 </Filters>
                 <SortingCriteria>
                    <SortField SortType="ASC" SortFieldName="price"/>
                 </SortingCriteria>
                 <Pagination>
                    <CurrentPage>0</CurrentPage>
                    <ItemPerPage>0</ItemPerPage>
                    <TotalItems>267</TotalItems>
                 </Pagination>
                 <RateRange CurrencyCode="USD">
                    <MinimumValue>101</MinimumValue>
                    <MaximumValue>9980</MaximumValue>
                 </RateRange>
              </Responset>
              <Hotels>

Parámetro	Descripción
Responset	Nodo que contiene informacion con información sumarizada de los resultados (cantidad de tarifas por proveedor, por categoría del hotel, por cantidad de estrellas de TripAdvisor, por Zona, por Régimen).
Pagination	Nodo que contiene informacion de la paginacion. En caso de estar realizando busquedas paginadas: CurrentPage: valor numerico que indica la pagina solicitada ItemPerPage: valor numerico que define el tamaño del conjunto de datos retornado TotalItems: valor numerico que define el tamaño total del conjunto de datos disponible

Nodos adicionales (utilizando el Query Param ?hideNewInfo=false)

 <DestinationDetails>
   <Destination Code="4490" Type="NMO.HTL.DST.CTY"/>
 </DestinationDetails>
 <Rates>
   <Rate TripProductID="o1RPSM0RiqYxODcxNT.jMi0wwgEDBQQCzQHNzyNsjx82n2NI:q1JBe2JmeHRCfTMyzgHj.wY." PossiblyNonRefundable="false">
     <Rooms>
       <Room Type="NMO.HTL.RMT.DBL" Availability="CNF" Occupancy="2/0/0">Estándar + desayuno - 2 paxs in 1 beds</Room>
     </Rooms>
     <Board Code="2">Desayuno buffet</Board>
     <RatePrices>
       <RatePrice Type="NMO.GBL.RPT.GRS" Currency="USD">461.47</RatePrice>
       <RatePrice Type="NMO.HTL.RPT.NET" Currency="USD">369.18</RatePrice>
     </RatePrices>
     <Offers>
       <Offer>Acuerdo Exclusivo</Offer>
     </Offers>
     <Comments>Resort Fee: USD 24.00. At Property.</Comments>
     <Comments>**There is a resort fee payable by the guest. German citizens are exempt of this fee**</Comments>
   </Rate>
 </Rates>
 <Rating Type="NMO.HTL.RTT.STR" Code="NMO.HTL.RTN.3ST">
   <Value>3.0</Value>
 </Rating>
 <Address>
   <Line>2440 STATE ROAD 84</Line>
   <Line>PORT EVERGLADES AREA</Line>
   <Line>FORT LAUDERDALE</Line>
   <Line>FLORIDA</Line>
 </Address>
 <Images>
   <Image>VE0/9/B/9B16A73ED56250CAD03DEF012007BC30.jpg</Image>
 </Images>

</Hotel>

Parámetro	Descripción
Offer	Ofertas que tiene dicha tarifa (*)
Comments	Comentarios importantes del proveedor respecto de la tarifa (*)
Images/Image	Imagen con el path relativo de la Imagen principal del hotel
Amenities	Informacion referida a los amenities más comunes tiene el Hotel (Acceso a internet,Aparcamiento, Bar, Piscina, Nevera, Spa y otros)

(*) Retorno no obligatorio y sujeto a que los proveedores envien dicha info

Información reducida de hoteles para mejorar tiempos de respuesta

Opcionalmente, para el cliente que lo requiera, los nodos Rating y Address pueden devolverse de la siguiente forma:

 ..................
 ..................
 ..................
 <Details>
   <Trips>
     <Trip>
       <HotelsAvailability>
         <Hotels>
           <Hotel HotelDetailId="VED-2CGU-3G8" Code="93316" Name="Pullman City Center Rosario" Longitude="-60.6629" Latitude="-33.0111">
             <DestinationDetails>
               <Destination Code="5735" Type="NMO.HTL.DST.CTY"/>
             </DestinationDetails>
             <Rates>
               <Rate TripProductID="o0JPTM0RiqYxODY1MjejMi0wwgEDBQQCzQISzy.qSgnC1+Dd:2SJhN2Q5MDk2Yzg1M2Q5NmY5Mjk2ODkwMjllODdlYzhiY0AyabHj.wY." PossiblyNonRefundable="false">
                 <Rooms>
              ...................
              ...................
              ...................
             <Rating>
               <Value>5.0</Value>
             </Rating>
             <Address>
               <Line>No disponible</Line>
             </Address>
             <TripAdvisor>
          ..................
          ..................
          ..................
 </Details>

</AvailabilityQueryRS>

Se devolverá para Rating sólo el valor numérico de la categoría:

      <Rating>
          <Value>5.0</Value>
      </Rating>

Para Address no se devolverá la dirección real sino que será un valor genérico:

       <Address>
           <Line>No disponible</Line>
       </Address>

Diferencia entre revisiones de «API Reference: Búsqueda de Disponibilidad de Hoteles»

Revisión actual del 12:53 30 jul 2024

Búsqueda de Disponibilidad de Hoteles (AvailabilityQuery)

Menú de navegación

Acciones de página

Acciones de página

Herramientas personales

Navegación

Buscar

Herramientas

@@ Línea 245: / Línea 245: @@
 '''RoomSequence''': En hoteles, indicar todos los pasajeros con su correspondiente identificador de habitación ''RoomSequence''.
 Por ejemplo para dos habitaciones dobles colocar dos pasajeros con ''RoomSequence=1'' y otros dos pasajeros con ''RoomSequence=2''.
+Nota: Busquedas limitadas hasta 4 menores por room, con un maximo de 2 infantes (ej: 2 Adultos + 3 Child + 1 Infante)
 |-
 | Age || No || Edad del pasajero. Sólo obligatorio para pasajeros Child o Infante. La edad del infante debe informarse como 1 año. La edad del child deberá ser de 2 a 17 años inclusive. (Algunos proveedores consideran child hasta 12, 13 o 17 años, las tarifas dependerán de la edad del child y del proveedor involucrado) Si las edades no corresponden los resultados serán inesperados. <span class="ps-alert">Importante: La edad enviada debe ser la edad del pasajero al momento del Check-In</span>
@@ Línea 843: / Línea 846: @@
-'''Información reducida de información de hoteles para mejorar tiempos de respuesta'''
+'''Información reducida de hoteles para mejorar tiempos de respuesta'''
 Opcionalmente, para el cliente que lo requiera, los nodos Rating y Address pueden devolverse de la siguiente forma:
-<code xml>
 <AvailabilityQueryRS TransactionId="9c8ac0a3_3e12_4fc5_ad86_6a774def52b6" TransactionMode="Synchronous">
    ..................
@@ Línea 879: / Línea 881: @@
    </Details>
 </AvailabilityQueryRS>
-</code>
 Se devolverá para Rating sólo el valor numérico de la categoría:
@@ Línea 887: / Línea 888: @@
 Para Address no se devolverá la dirección real sino que será un valor genérico:
-<code>
          <Address>
              <Line>No disponible</Line>
          </Address>
-</code>