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

De Wiki PriceSurfer
Ir a la navegaciónIr a la búsqueda
Línea 843: Línea 843:
  
  
−
'''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:  
 
Opcionalmente, para el cliente que lo requiera, los nodos Rating y Address pueden devolverse de la siguiente forma:  

Revisión del 14:13 27 nov 2023

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.

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)

<Hotel Code="187156" Name="Rodeway Inn & Suites Airport/Cruise Port" Longitude="-80.17359584569931" Latitude="26.086895189468386" HotelDetailId="VE0-4CRB-3NA"> 

 <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:

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

 ..................
 ..................
 ..................
 <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>
Obtenido de «https://wiki.psurfer.net/index.php?title=API_Reference:_Búsqueda_de_Disponibilidad_de_Hoteles&oldid=286548»