API Reference: Consulta de Información de un Hotel
De Wiki PriceSurfer
Revisión del 14:25 11 feb 2015 de Ariel.giri (discusión | contribuciones) (→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. 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 | 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 | Sí | 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 | 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. |
- 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 | Sí | 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 | Sí | Identificador de la notificación. Las mismas serán provistas por Nemo. |
| NotificationType | Sí | Tipo de notificación. |
| NotificationMessage | Sí | Mensaje de notificación. |
| Echo | No | En este nodo se envía una copia de la consulta realizada. |
| Details | Sí | |
| Products | Sí | |
| Hotels | No | |
| Hotel | Sí | 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 | Sí | 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 | Sí | Lista de servicios e instalaciones brindadas por el hotel. |
| Amenity | Sí | 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 | Sí | Descripción del grupo de servicio/instalación.
Atributos: AmenityGroupCode: Código del tipo de servicio/instalación. Tabla de Códigos |
| Description | Sí | Descripción del servicio/instalación ofrecida por el hotel.
Atributos: AmenityCode: Código de servicio/instalación. Tabla de Códigos |
| Address | Sí | Dirección del hotel |
| AddressLines | Sí | Líneas que componen la dirección del hotel. |
| AddressLine | Sí | Indica la dirección del hotel. |
| TelephoneNumbers | No | Lista de números telefónicos disponibles para el hotel. |
| TelephoneNumber | Sí | |
| TelephoneNumberType | Sí | Tipo de número telefónico.
Atributos: TelephoneNumberType: Tipo de número telefónico. Tabla de Códigos |
| TelephoneNumberValue | Sí | Número telefónico. |
| Destination | Sí | 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 | Sí | 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 | Sí | Valoración de la categoría del hotel expresada en el tipo de categoría indicado en el nodo padre. |
| ImageLinks | Sí | Conjunto de imágenes del hotel |
| ImageLink | No | |
| ImageDescription | Sí | 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 | Sí | 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. |
