Diferencia entre revisiones de «API Reference: Consulta de Información de un Hotel»

De Wiki PriceSurfer
Ir a la navegaciónIr a la búsqueda
(Página creada con '=== Consulta de Información de un Hotel (AdditionalInfoQuery) === Mensaje que permite consultar la información detallada de un hotel. La información a devolver será la obt...')
 
Línea 3: Línea 3:
 
Mensaje que permite consultar la información detallada de un hotel. La información a devolver será la obtenida de los respectivos proveedores.  
 
Mensaje que permite consultar la información detallada de un hotel. La información a devolver será la obtenida de los respectivos proveedores.  
  
Request: AdditionalInfoQueryRQ
+
Request: AdditionalInfoQueryRQ ([http://wiki.psurfer.net/resources/PSCEV-doc/pscev_AdditionalInfoQueryRQ.html Estructura del Documento])
  
Response: AdditionalInfoQueryRS  
+
Response: AdditionalInfoQueryRS ([http://wiki.psurfer.net/resources/PSCEV-doc/pscev_AdditionalInfoQueryRS.html Estructura del Documento])
  
 
Ejemplo de uso:
 
Ejemplo de uso:

Revisión del 14:14 26 mar 2014

Consulta de Información de un Hotel (AdditionalInfoQuery)

Mensaje que permite consultar la información detallada de un hotel. La información a devolver será la obtenida de los respectivos proveedores.

Request: AdditionalInfoQueryRQ (Estructura del Documento)

Response: AdditionalInfoQueryRS (Estructura del Documento)

Ejemplo de uso:

      • Solicitud:

<AdditionalInfoQueryRQ>

 <GeneralParameters>
   <PreferedLanguage LanguageCode="es"/>
   <PreferedCurrency CurrencyCode="ARS"/>
 </GeneralParameters>
 <Products>
   <Hotels>
     <Hotel TripProductID="addad55c-57fd-4ae9-8dfe-4d34a4f9c0bd"/>
   </Hotels>
 </Products>

</AdditionalInfoQueryRQ>


Parámetro Obligatorio Descripción
PreferedLanguage 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 Establece la moneda requerida para la respuesta.

Atributos:

CurrencyCode: Código de moneda correspondiente a los códigos de moneda estándar provistos. No está habilitado el uso de multimoneda. La moneda utilizada será la configurada en el contrato.

Hotels No
Hotel Se envía el id del hotel a consultar mediante el atributo TripProductID.


      • Respuesta:

<?xml version="1.0" encoding="UTF-8"?> <AdditionalInfoQueryRS>

 <Details>
   <Products>
     <Hotels>
       <Hotel HotelCode="2411" SupplierID="BOL" Sequence="1">
         <HotelName>725 Continental Hotel</HotelName>
         <HotelDescriptions>
           <HotelDescription HotelDescriptionType="General">Emblemático y único en su tipo, con su mezcla de diseño, tradición y vanguardismo el hotel tiene un vestí­bulo con recepción 24 horas, un bar, restaurante, salas de conferencias, servicio de habitaciones 24 horas y aparcamiento.</HotelDescription>
         </HotelDescriptions>
         <Amenities ItemsCount="18">
           <Amenity Fee="No" Sequence="1">
             <AmenityGroup AmenityGroupCode="NMO.HTL.AMT.HTT">Tipo de Hotel</AmenityGroup>
             <Description AmenityCode="1">Hotel de ciudad</Description>
           </Amenity>
           <Amenity Fee="No" Sequence="2">
             <AmenityGroup AmenityGroupCode="NMO.HTL.AMT.HTR">Habitación</AmenityGroup>
             <Description AmenityCode="1">Baño</Description>
           </Amenity>
           <Amenity Fee="Yes" Sequence="3">
             <AmenityGroup AmenityGroupCode="NMO.HTL.AMT.HTR">Habitación</AmenityGroup>
             <Description AmenityCode="5">Teléfono de lí­nea directa</Description>
           </Amenity>
           <Amenity Fee="No" Sequence="4">
             <AmenityGroup AmenityGroupCode="NMO.HTL.AMT.HTR">Habitación</AmenityGroup>
             <Description AmenityCode="7">TV ví­a satélite / TV por cable</Description>
           </Amenity>
           <Amenity Fee="No" Sequence="5">
             <AmenityGroup AmenityGroupCode="NMO.HTL.AMT.HTR">Habitación</AmenityGroup>
             <Description AmenityCode="13">Minibar</Description>
           </Amenity>
           <Amenity Fee="No" Sequence="6">
             <AmenityGroup AmenityGroupCode="NMO.HTL.AMT.HTR">Habitación</AmenityGroup>
             <Description AmenityCode="19">Lavadora</Description>
           </Amenity>
           <Amenity Fee="No" Sequence="7">
             <AmenityGroup AmenityGroupCode="NMO.HTL.AMT.HTR">Habitación</AmenityGroup>
             <Description AmenityCode="24">Aire acondicionado Central</Description>
             <ImageLink>
               <ImageDescription ImageDisplayType="NMO.GBL.IMG.IMG">Aire acondicionado Central</ImageDescription>
               <ImageURL>ic_aireac.gif</ImageURL>
             </ImageLink>
           </Amenity>
           <Amenity Fee="No" Sequence="8">
             <AmenityGroup AmenityGroupCode="NMO.HTL.AMT.HTR">Habitación</AmenityGroup>
             <Description AmenityCode="28">Caja de seguridad</Description>
           </Amenity>
           <Amenity Fee="No" Sequence="9">
             <AmenityGroup AmenityGroupCode="NMO.HTL.AMT.FCL">Instalaciones</AmenityGroup>
             <Description AmenityCode="1">Aire acondicionado en zonas comunes</Description>
           </Amenity>
           <Amenity Fee="No" Sequence="10">
             <AmenityGroup AmenityGroupCode="NMO.HTL.AMT.FCL">Instalaciones</AmenityGroup>
             <Description AmenityCode="2">Hall Recepción</Description>
           </Amenity>
           <Amenity Fee="No" Sequence="11">
             <AmenityGroup AmenityGroupCode="NMO.HTL.AMT.FCL">Instalaciones</AmenityGroup>
             <Description AmenityCode="4">Servicio de recepción 24 horas</Description>
           </Amenity>
           <Amenity Fee="No" Sequence="12">
             <AmenityGroup AmenityGroupCode="NMO.HTL.AMT.FCL">Instalaciones</AmenityGroup>
             <Description AmenityCode="14">Bar-es</Description>
             <ImageLink>
               <ImageDescription ImageDisplayType="NMO.GBL.IMG.IMG">Bar-es</ImageDescription>
               <ImageURL>ic_bar.gif</ImageURL>
             </ImageLink>
           </Amenity>
           <Amenity Fee="No" Sequence="13">
             <AmenityGroup AmenityGroupCode="NMO.HTL.AMT.FCL">Instalaciones</AmenityGroup>
             <Description AmenityCode="18">Sala de conferencias</Description>
           </Amenity>
           <Amenity Fee="No" Sequence="14">
             <AmenityGroup AmenityGroupCode="NMO.HTL.AMT.FCL">Instalaciones</AmenityGroup>
             <Description AmenityCode="24">Restaurante -s</Description>
           </Amenity>
           <Amenity Fee="No" Sequence="15">
             <AmenityGroup AmenityGroupCode="NMO.HTL.AMT.FCL">Instalaciones</AmenityGroup>
             <Description AmenityCode="46">Piscina de agua dulce</Description>
             <ImageLink>
               <ImageDescription ImageDisplayType="NMO.GBL.IMG.IMG">Piscina de agua dulce</ImageDescription>
               <ImageURL>ic_piscina.gif</ImageURL>
             </ImageLink>
           </Amenity>
           <Amenity Fee="No" Sequence="16">
             <AmenityGroup AmenityGroupCode="NMO.HTL.AMT.FCL">Instalaciones</AmenityGroup>
             <Description AmenityCode="54">Sauna</Description>
           </Amenity>
           <Amenity Fee="Yes" Sequence="17">
             <AmenityGroup AmenityGroupCode="NMO.HTL.AMT.FCL">Instalaciones</AmenityGroup>
             <Description AmenityCode="58">Masaje</Description>
           </Amenity>
           <Amenity Fee="No" Sequence="18">
             <AmenityGroup AmenityGroupCode="NMO.HTL.AMT.FCL">Instalaciones</AmenityGroup>
             <Description AmenityCode="60">Gimnasio</Description>
             <ImageLink>
               <ImageDescription ImageDisplayType="NMO.GBL.IMG.IMG">Gimnasio</ImageDescription>
               <ImageURL>ic_gimnasio.gif</ImageURL>
             </ImageLink>
           </Amenity>
         </Amenities>
         <Addresses>
           <Address>
             <AddressLines>
               <AddressLine>PTE. ROQUE SANEZ PEÑA 725</AddressLine>
               <AddressLine>C1035AAC - BUENOS AIRES</AddressLine>
               <AddressLine>Buenos Aires</AddressLine>
             </AddressLines>
             <TelephoneNumbers>
               <TelephoneNumber>
                 <TelephoneNumberType TelephoneNumberType="NMO.GBL.TLT.TE1">phoneHotel</TelephoneNumberType>
                 <TelephoneNumberValue>541141318000</TelephoneNumberValue>
               </TelephoneNumber>
               <TelephoneNumber>
                 <TelephoneNumberType TelephoneNumberType="NMO.GBL.TLT.OFF">phoneBooking</TelephoneNumberType>
                 <TelephoneNumberValue>541141318028</TelephoneNumberValue>
               </TelephoneNumber>
               <TelephoneNumber>
                 <TelephoneNumberType TelephoneNumberType="NMO.GBL.TLT.CTC">phoneMang</TelephoneNumberType>
                 <TelephoneNumberValue>541141318000</TelephoneNumberValue>
               </TelephoneNumber>
             </TelephoneNumbers>
             <PostalCode CountryCode="AR">C1035AAC</PostalCode>
             <Destinations>
               <Destination DestinationType="NMO.HTL.DST.CTY" DestinationCode="5694">Buenos Aires</Destination>
               <Destination DestinationType="NMO.HTL.DST.CTR" DestinationCode="202">Argentina</Destination>
               <Destination DestinationType="NMO.HTL.DST.CNT" DestinationCode="15">América del Sur</Destination>
               <Destination DestinationType="NMO.HTL.DST.ALL" DestinationCode="1">Planeta Tierra</Destination>
             </Destinations>
           </Address>
         </Addresses>
         <Position>
           <Latitude>34.6060222222222</Latitude>
           <Longitude>-58.3768777777778</Longitude>
         </Position>
         <HotelRating HotelRatingCode="NMO.HTL.RTN.5ST" HotelRatingType="NMO.HTL.RTT.STR">
           <RatingDescription>5 Estrellas</RatingDescription>
           <RatingValue>5.0</RatingValue>
         </HotelRating>
         <ImageLinks ItemsCount="4">
           <ImageLink Sequence="1">
             <ImageDescription ImageDisplayType="NMO.GBL.IMG.IMG">General</ImageDescription>
             <DisplayOrder>1</DisplayOrder>
             <ImageHeight UnitOfMeasureCode="9">46</ImageHeight>
             <ImageWidth UnitOfMeasureCode="9">70</ImageWidth>
             <ImageURL>6/1/61C147492531CF4BB1CACB2A4EB3CFB0.jpg</ImageURL>
             <ThumbnailURL>7/2/72305C04BDDD0306D4382C6E769DA9ED.jpg</ThumbnailURL>
           </ImageLink>
           <ImageLink Sequence="2">
             <ImageDescription ImageDisplayType="NMO.GBL.IMG.IMG">Habitación</ImageDescription>
             <DisplayOrder>2</DisplayOrder>
             <ImageHeight UnitOfMeasureCode="9">44</ImageHeight>
             <ImageWidth UnitOfMeasureCode="9">70</ImageWidth>
             <ImageURL>A/B/ABA09A903CF78396C69266D883EAB44D.jpg</ImageURL>
             <ThumbnailURL>8/3/83FD71DF95D39D0949473B310672836B.jpg</ThumbnailURL>
           </ImageLink>
           <ImageLink Sequence="3">
             <ImageDescription ImageDisplayType="NMO.GBL.IMG.IMG">Habitación</ImageDescription>
             <DisplayOrder>3</DisplayOrder>
             <ImageHeight UnitOfMeasureCode="9">46</ImageHeight>
             <ImageWidth UnitOfMeasureCode="9">70</ImageWidth>
             <ImageURL>A/B/AB97AF5C98C1D4F70036769D92F1593B.jpg</ImageURL>
             <ThumbnailURL>7/2/72FDCB6C47755FEF3B079E846B91EEAA.jpg</ThumbnailURL>
           </ImageLink>
           <ImageLink Sequence="4">
             <ImageDescription ImageDisplayType="NMO.GBL.IMG.IMG">Habitación</ImageDescription>
             <DisplayOrder>4</DisplayOrder>
             <ImageHeight UnitOfMeasureCode="9">46</ImageHeight>
             <ImageWidth UnitOfMeasureCode="9">70</ImageWidth>
             <ImageURL>0/6/0606A6FF937B2F6ACF77B22502A97FBC.jpg</ImageURL>
             <ThumbnailURL>A/E/AE9A5F311477F13E85B8C64E26B94D5F.jpg</ThumbnailURL>
           </ImageLink>
         </ImageLinks>
         <LocationDetails ItemsCount="1">
           <Location Sequence="1" LocationCode="G1">Centro</Location>
         </LocationDetails>
       </Hotel>
     </Hotels>
   </Products>
 </Details>

</AdditionalInfoQueryRS>


Parámetro Obligatorio Descripción
Notifications No
Notification 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 Identificador de la notificación. Las mismas serán provistas por Nemo.
NotificationType Tipo de notificación.
NotificationMessage Mensaje de notificación.
Echo No En este nodo se envía una copia de la consulta realizada.
Details
Products
Hotels No
Hotel Información de un Hotel reportada por el proveedor asociado.

Atributos:

HotelCode: Código del hotel de los provistos por Nemo.

SupplierID: Código del proveedor correspondiente a los códigos de proveedor estándar provistos por Nemo.

HotelName Nombre del hotel.
AccomodationType No Indica si es hotel, hostel, camping, etc.
HotelDescriptions No
HotelDescription No Descripción del hotel.

Atributos:

HotelDescriptionType: Tipo de descripción correspondiente a los tipos de descripción estándar provistos.

LocationDetails No
Location No Descripción del área en la que se localiza el hotel.

Atributos:

LocationCode: Código de área provisto por el proveedor.

Amenities || Sí || Lista de amenidades brindadas por el hotel.

Amenity Amenidad brindada por el hotel.

Atributos:

Fee: Bandera que indica si la amenidad tiene cargo por huésped o no.

AmenityGroup Descripción del tipo de amenidad.

Atributos:

AmenityGroupCode: Código del tipo de amenidad correspondiente a los códigos de tipo de amenidad estándar provistos por Nemo.

Description Descripción de la amenidad ofrecida por el hotel.

Atributos:

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

Address Dirección del hotel
AddressLines Líneas que componen la dirección del hotel.
AddressLine Indica la dirección del hotel.
TelephoneNumbers No Lista de números telefónicos disponibles para el hotel.
TelephoneNumber
TelephoneNumberType Tipo de número telefónico.

Atributos:

TelephoneNumberType: Tipo de número telefónico correspondiente a los tipos de números telefónicos estándar provistos por Nemo.

TelephoneNumberValue Número telefónico.
Destination Localización geográfica detallada del hotel.

Atributos:

DestinationType: Tipo de destino(continente, país, región/provincia/estado, ciudad) correspondiente a los tipos de destino estándar provistos.

DestinationCode: Código de destino correspondiente a los códigos de destino estándar provistos.

Position No Coordenadas del hotel: Latitud y Longitud.
HotelRating Categoría del hotel.

Atributos:

HotelRatingCode: código de la categoría correspondiente a los códigos de categoría estándar provistos por Nemo.

HotelRatingType: Tipo de la categoría correspondiente a los tipos de categoría estándar provistos por Nemo.

RatingValue Valoración de la categoría del hotel expresada en el tipo de categoría indicado en el nodo padre.
ImageLinks Conjunto de imágenes del hotel
ImageLink No
ImageDescription Descripción de la imagen

ImageDisplayType: Tipo de imagen correspondiente a los tipos de imágenes estándar provistos por Nemo.

DisplayOrder || No || Orden del la imagen.

ImageURL URL de la imagen
AreaDetails No
AreaDetail No Referencia al área en el que se localiza el hotel
HotelRoomTypeDescriptions No Detalle de los tipos de habitación con los que cuenta el hotel.
Copyright No Declaración de derechos de autor del proveedor de la información del hotel.
Fares Datos de tarifas
FareType No Tipo de tarifas, ej. Tarifa web, precio de agencia
Prices Precios, con valor y moneda
Exceptions Si no se puede armar el nodo Details se arma un nodo Exceptions con las notificaciones correspondientes.