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
Línea 1: Línea 1:
 
=== Consulta de Información de un Hotel (AdditionalInfoQuery) ===  
 
=== 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.  
+
Mensaje que permite consultar la información detallada de un hotel. Esta información es sensible al proveedor, por lo tanto '''la información a devolver será la obtenida de los respectivos proveedores.'''
 +
<p style="color: red">Esto es muy importante, ya que  un mismo hotel puede existir para varios proveedores.</p>
 +
 
 +
Por Ejemplo, el hotel identificado con <Hotel HotelCode="2411" SupplierID="GTA" Sequence="1">
 +
no contendrá la misma información que el hotel <Hotel HotelCode="2411" SupplierID="BOL" Sequence="1">
 +
ya que ambos son el mismo hotel pero de distintos proveedores.
 +
 
 +
''Les aconsejamos que nunca cambien la información de un hotel de un proveedor por la información del mismo hotel pero de otro proveedor.''
 +
 
  
 
Request: AdditionalInfoQueryRQ ([http://wiki.psurfer.net/resources/PSCEV-doc/pscev_AdditionalInfoQueryRQ.html Estructura del Documento])
 
Request: AdditionalInfoQueryRQ ([http://wiki.psurfer.net/resources/PSCEV-doc/pscev_AdditionalInfoQueryRQ.html Estructura del Documento])
Línea 19: Línea 27:
 
   <Products>
 
   <Products>
 
     <Hotels>
 
     <Hotels>
       <Hotel TripProductID="addad55c-57fd-4ae9-8dfe-4d34a4f9c0bd"/>
+
       <Hotel HotelDetailId="gNhePpbaUSyoyeKqxwdmbyL/UZYiPUsVgGLOQg0i8A4="/>
 
     </Hotels>
 
     </Hotels>
 
   </Products>
 
   </Products>
Línea 43: Línea 51:
 
|Hotels || No ||  
 
|Hotels || No ||  
 
|-
 
|-
|Hotel || Sí || Se envía el id del hotel a consultar mediante el atributo TripProductID devuelto por el WebService en el resultado de la búsqueda.
+
|Hotel || Sí || Se envía el id del hotel a consultar mediante el atributo HotelDetailId devuelto por el WebService en el resultado de la búsqueda.
 
|}
 
|}
  

Revisión del 14:25 11 feb 2015

Consulta de Información de un Hotel (AdditionalInfoQuery)

Mensaje que permite consultar la información detallada de un hotel. Esta información es sensible al proveedor, por lo tanto la información a devolver será la obtenida de los respectivos proveedores.

Esto es muy importante, ya que un mismo hotel puede existir para varios proveedores.

Por Ejemplo, el hotel identificado con <Hotel HotelCode="2411" SupplierID="GTA" Sequence="1"> no contendrá la misma información que el hotel <Hotel HotelCode="2411" SupplierID="BOL" Sequence="1"> ya que ambos son el mismo hotel pero de distintos proveedores.

Les aconsejamos que nunca cambien la información de un hotel de un proveedor por la información del mismo hotel pero de otro proveedor.


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 HotelDetailId="gNhePpbaUSyoyeKqxwdmbyL/UZYiPUsVgGLOQg0i8A4="/>
   </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 HotelDetailId devuelto por el WebService en el resultado de la búsqueda.


      • 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. Tabla de Códigos
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 Lista de servicios e instalaciones brindadas por el hotel.
Amenity Servicio/Instalación brindada por el hotel.

Atributos:

Fee: Bandera que indica si el servicio/instalación tiene cargo por huésped o no.

AmenityGroup Descripción del grupo de servicio/instalación.

Atributos:

AmenityGroupCode: Código del tipo de servicio/instalación. Tabla de Códigos

Description Descripción del servicio/instalación ofrecida por el hotel.

Atributos:

AmenityCode: Código de servicio/instalación. Tabla de Códigos

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. Tabla de Códigos

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). Tabla de Códigos

DestinationCode: Código de destino. Destinos

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

Atributos:

HotelRatingCode: Código de la categoría. Tabla de Códigos

HotelRatingType: Tipo de la categoría. Tabla de Códigos

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

Atributos:

-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.
Exceptions No Si no se puede armar el nodo Details se arma un nodo Exceptions con las notificaciones correspondientes.