Diferencia entre revisiones de «Price Surfer - Web Services»

De Wiki PriceSurfer
Ir a la navegaciónIr a la búsqueda
Línea 46: Línea 46:
 
:media types:  
 
:media types:  
 
::''application/xml''
 
::''application/xml''
−
::''application/json''
 
  
 
'''Response Body'''
 
'''Response Body'''
 
:media types:  
 
:media types:  
 
::''application/xml''
 
::''application/xml''
−
::''application/json''
 
  
  

Revisión del 11:38 19 dic 2013

Sumario

Price Surfer - Mensajes de Web Services

Introducción

El servicio Web de Price Server permite a sus agentes conectarse de manera transparente a la aplicación a través de un conjunto de funciones que pueden ser llamadas, desde las páginas web de sus sitios. Para lograr esto, se proveerá una Interfaz de Programación de Aplicaciones (API) para permitir que varios tipos de sistemas clientes se conecten al sistema propio de Nemo utilizando un juego de mensajes XML que han sido publicados y definidos en conformidad a los Estándares de Esquemas XML. La interfaz que provee servicios de búsquedas, reservas, etc. será entonces accesible vía una interfaz basada en XML y disponible para clientes registrados.

A través del servicio web un agente podrá consultar disponibilidad en hoteles para los proveedores asociados a su contrato, solicitar información sobre hoteles, gestionar reservas y cancelaciones. Todo a través de una interfaz única basada en el intercambio de documentos XML, que será descripta en esta guía de uso.

Propósito del presente documento

La función del documento es la de remarcar la estructura de la ya mencionada API, las funciones estándares que se proveen y aquellas funciones específicas que son dispuestas mediante la misma.

Implementación

Para poder iniciar la implementación y hacer pruebas a nuestro servidor de test, necesitará una serie de credenciales para utilizar durante el proceso de integración del servicio con su aplicación web, Las credenciales son: un "token" para el acceso al web service y un usuario y contraseña para acceder a la aplicación de Price Surfer y al Backoffice de configuración.

Luego de completada la integración deberá contactarnos nuevamente para solicitar una revisión para la certificación final de su sitio. Además de las credenciales provistas recibirá una descripción de los servicios provistos bajo WADL, el equivalente REST del Lenguaje de Descripción de Web Services (WSDL). Nuestro servicio es un servicio web estándar basado en REST para el intercambio de documentos XML, la seguridad es controlada a través de cabeceras WSS donde deberá incluir un Token de Autenticación.

Interfaz Cliente simplificada

La API publicada ofrece protocolos estándares de HTTPS que habilitan al servicio a través de solicitudes HTTPS bajo POST permitiendo así las siguientes ventajas:

  • Protocolos estándares de acuerdo a la Industria
  • No hay necesidad de establecer un middleware como componente adicional (ej. MQ Series)
  • Seguridad establecida a través del uso de SSL
  • Se provee un mecanismo más eficiente para el manejo de mensajes asíncronos mediante la tecnología “Push”


API REFERENCE - Operaciones

Las siguientes operaciones están disponibles en la API del servicio, para búsquedas y reservas de Hoteles.

/catalog/products/search
/catalog/product/detail
/catalog/product/validate
/catalog/product/book
/booking/cancellation/fees
/booking/detail
/booking/cancel

Todas las operaciones tienen un POST con el siguiente esquema:

POST

Request Body

media types:
application/xml

Response Body

media types:
application/xml


Cada operación de la API necesita un xml según el mensaje que corresponda. A continuación se presentarán los XML necesarios para cada operación. Este xml va adjuntado como "raw" en el POST del http.

Por ejemplo, desde la consola podemos probar la conexión y los parámetros necesarios haciendo: 


 curl -i -H "Accept: application/xml" -H "Content-Type: application/xml" \
  -H "X-PS-AUTHTOKEN:xxxxxxxxxxxxxxxxxxxxxxxxxxx" \
  -d "`cat AvailabilityQueryRQ.xml`" \
  -o "result.xml" -v \
  -X POST "http://#url-servicio-psurfer#/pricesurfer/catalog/products/search"

Esto conectará al Web Service y hará un pedido de disponibilidad de productos.

Deberá existir el archivo AvailabilityQueryRQ.xml que contendrá un xml como por ejemplo el presentado más abajo.

La respuesta se guardará en el archivo result.xml.

El valor X-PS-AUTHTOKEN:xxxxxxxxxxxxxxxxxxxxxxxxxxx es un token de seguridad que será suministrado por Soporte de Price Surfer cuando se les entreguen los usuarios correspondientes en el alta del servicio.


Se recomienda utilizar contenido comprimido, agregando a la cabecera el encoding: -H "Accept-Encoding: gzip" \

Lista de Mensajes XML por cada Operación

Están disponibles los esquemas XSD de PriceSurfer: http://wiki.psurfer.net/resources/pscev-schema.zip


O si desea la documentación online: http://wiki.psurfer.net/resources/PSCEV-doc/pscev.html


Documentación generada automáticamente por el servicio: http://wiki.psurfer.net/resources/REST-doc/index.html


Búsqueda de Disponibilidad de Hoteles (AvailabilityQueryRQ)

Consulta de disponibilidad de tarifas de hoteles para un set de habitaciones, con una configuración de pasajeros, 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.

Operación: /catalog/products/search

Recibe AvailabilityQueryRQ

Retorna AvailabilityQueryRS

Confirmación de Disponibilidad de una Tarifa obtenida en una Búsqueda Anterior (AvailabilityValidation)

Confirma la vigencia de una tarifa provista por una consulta de disponibilidad previa.

Operación: /catalog/product/validate

Recibe AvailabilityValidationRQ

Retorna AvailabilityValidationRS

Consulta de Información de un Hotel (AdditionalInfoQuery)

Consulta la información y detalles para un hotel provisto por el proveedor.

Operación: /catalog/product/detail

Recibe AditionalInfoQueryRQ

Retorna AditionalInfoQueryRS

Consulta de Gastos de Cancelación para una o varias Tarifas ó Reservas (CancellationFeesQuery)

Consulta de condiciones de gastos de cancelación sobre una o más tarifas o reservas reportadas.

Operación: /booking/cancellation/fees

Recibe CancellationFeesQueryRQ

Retorna CancellationFeesQueryRS

Reserva de Tarifa (BookingProducts)

Solicitud de reserva para una o varias tarifas de hoteles.

Operación: /catalog/product/book

Recibe BookingProductsRQ

Retorna BookingProductsRS

Consulta de Reserva (BookingQuery)

Consulta de información y detalles sobre una o varias reservas realizadas.

Operación: /booking/detail

Recibe BookingQueryRQ

Retorna BookingQueryRS

Cancelación de Reserva (BookingCancellation)

Solicitud de cancelación de una o varias reservas realizadas.

Operación: /booking/cancel

Recibe BookingCancellationRQ

Retorna BookingCancellationRS

Escenario básico de una operación de reserva

Bookingwikijpg1 v1.jpg

Especificación de documentos XML

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

Response: AvailabilityQueryRS

Ejemplo de uso:

      • Solicitud:

<AvailabilityQueryRQ TransactionId="da9a0fcc_7bd9_48f9_8386_4079a7a6c66c" 

   TransactionMode="Synchronous" 
   xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">

<GeneralParameters> <PreferedLanguage LanguageCode="es"/> <PreferedCurrency CurrencyCode="ARS"/> </GeneralParameters> <Trips > <Trip > <Destination>2757</Destination> <ProductsParameters> <HotelsParameters> <Criterion> <Rooms > <Room RoomType="NMO.HTL.RMT.SGL" RoomSequence="1"/> </Rooms> <CheckIn>2014-02-20</CheckIn> <CheckOut>2014-02-22</CheckOut> </Criterion> </HotelsParameters> </ProductsParameters> </Trip> </Trips> <Passengers > <Passenger AgeType="NMO.GBL.AGT.ADT" RoomSequence="1"/> </Passengers> </AvailabilityQueryRQ>


Parámetro Obligatorio Descripción
TransactionId Si Deberá contener solo letras, números o "_" y lo genera el cliente para identificar un único ID de transacción entre todos los mensajes del fujo de reserva.
TransactionMode Si 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 Si
PreferedLanguage Si 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 Si Establece la moneda requerida para la respuesta.

Atributos:

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

Trip
Destination Si Ciudad para la que se realiza la consulta de disponibilidad de tarifas.
ProductsParameters Si
HotelsParameters Si Parámetros específicos de hoteles.
Criterion Si Indica los distintos parámetros de la búsqueda.
CheckIn Si Fecha de inicio de la estadía. Formato 'YYYY/MM/DD'.
CheckOut Si Fecha de fin de la estadía. Formato 'YYYY/MM/DD'.
Rooms Si Información sobre las habitaciones solicitadas.
Room Si 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. Los tipos de habitación admitidos corresponden a los provistos por Nemo. Es opcional porque 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í.

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

Passenger Si Establece los pasajeros para la búsqueda realizada. El atributo AgeType indica el tipo de pasajero de acuerdo a la edad, dentro de los provistos por Nemo (chl, adt, inf). 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.
PersonNames No
PersonName Si Nombres de la persona. Cada elemento PersonName tiene tipo y secuencia lo que permite construir los nombres con N cantidad de elementos y siguiendo cualquier orden según las distintas culturas.
NameType No Tipo de nombre (primer nombre, segundo nombre, apellido).
BirthDate No Fecha de nacimiento.
      • Respuesta:

<AvailabilityQueryRS TransactionId="da9a0fcc_7bd9_48f9_8386_4079a7a6c66c" TransactionMode="Synchronous" 

   xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" >

<Echo TransactionId="da9a0fcc_7bd9_48f9_8386_4079a7a6c66c" TransactionMode="Synchronous"> <GeneralParameters> <PreferedLanguage LanguageCode="es"/> <PreferedCurrency CurrencyCode="ARS"/> </GeneralParameters> <Trips> <Trip> <Destination>2757</Destination> <ProductsParameters> <HotelsParameters> <Criterion> <Rooms> <Room RoomType="NMO.HTL.RMT.SGL" RoomSequence="1"/> </Rooms> <CheckIn>2013-12-20</CheckIn> <CheckOut>2013-12-22</CheckOut> </Criterion> </HotelsParameters> </ProductsParameters> </Trip> </Trips> <Passengers> <Passenger AgeType="NMO.GBL.AGT.ADT" RoomSequence="1"/> </Passengers> </Echo> <Details> <Trips> <Trip> <HotelsAvailability> <Hotels> <Hotel Code="7590" Name="Days Hotel London North" Featured="false" SupplierID="MIK" Longitude="-0.26438" Latitude="51.634681" Sequence="1"> <Amenities> <Amenity Code="14" GroupCode="NMO.HTL.AMT.HTL"/> <Amenity Code="5" GroupCode="NMO.HTL.AMT.FCL"/> <Amenity Code="32" GroupCode="NMO.HTL.AMT.HTL"/> <Amenity Code="7" GroupCode="NMO.HTL.AMT.FCL"/> <Amenity Code="18" GroupCode="NMO.HTL.AMT.FCL"/> <Amenity Code="117" GroupCode="NMO.HTL.AMT.HTL"/> <Amenity Code="4" GroupCode="NMO.HTL.AMT.HTR"/> <Amenity Code="34" GroupCode="NMO.HTL.AMT.HTR"/> <Amenity Code="237" GroupCode="NMO.HTL.AMT.HTR"/> <Amenity Code="8" GroupCode="NMO.HTL.AMT.HTR"/> </Amenities> <DestinationDetails> <Destination Code="2757" Type="NMO.HTL.DST.CTY"/> <Destination Code="143" Type="NMO.HTL.DST.CTR"/> <Destination Code="12" Type="NMO.HTL.DST.CNT"/> <Destination Code="1" Type="NMO.HTL.DST.ALL"/> </DestinationDetails> <Rates> <Rate Offer="false" RateID="3727c45dbdafe53764a781ea39d8bd28#0" TripProductID="fef501f1-962d-40e8-84eb-42373a0e343f"> <Rooms> <Room Availability="CNF" Type="SGL" RoomSequence="1">Simple</Room> </Rooms> <Board Code="60">Desayuno incluido</Board> <RatePrices> <RatePrice Currency="USD" Type="NMO.GBL.RPT.GRS">389.82</RatePrice> </RatePrices> </Rate> </Rates> <Rating Code="NMO.HTL.RTN.4ST" Type="NMO.HTL.RTT.STR"> <Value>3.0</Value> </Rating> <Address> <Line>London Gateway, Services</Line> <Line>London</Line> <Line>U.k.</Line> </Address> <LocationDetails> <Location LocationCode="G8">Area suburbana</Location> </LocationDetails> <ImageLinks> <ImageLink> <ImageDescription ImageDisplayType="NMO.GBL.IMG.IMG">Exterior view</ImageDescription> <ImageHeight UnitOfMeasureCode="9">46.0</ImageHeight> <ImageWidth UnitOfMeasureCode="9">70.0</ImageWidth> <ImageURL>B/6/B6E5222965FCD939B8967908EE909116.jpg</ImageURL> <ThumbnailURL>4/3/43081546B80C1F2361A934E91E0B83F4.jpg</ThumbnailURL> </ImageLink> <ImageLink> <ImageDescription ImageDisplayType="NMO.GBL.IMG.IMG">Standard bedroom</ImageDescription> <ImageHeight UnitOfMeasureCode="9">46.0</ImageHeight> <ImageWidth UnitOfMeasureCode="9">70.0</ImageWidth> <ImageURL>B/A/BA1FE7678A1DBABF62BB877A92B31404.jpg</ImageURL> <ThumbnailURL>D/2/D2CEAE049DA3A5D2D1F8C6CC1F911B67.jpg</ThumbnailURL> </ImageLink> <ImageLink> <ImageDescription ImageDisplayType="NMO.GBL.IMG.IMG">Standard bedroom</ImageDescription> <ImageHeight UnitOfMeasureCode="9">46.0</ImageHeight> <ImageWidth UnitOfMeasureCode="9">70.0</ImageWidth> <ImageURL>F/7/F73A5A01DACC93E47CC6ECA33071A1A5.jpg</ImageURL> <ThumbnailURL>9/1/914733863EFF6EC19D48A23ED5AE697C.jpg</ThumbnailURL> </ImageLink> <ImageLink> <ImageDescription ImageDisplayType="NMO.GBL.IMG.IMG">Standard bedroom</ImageDescription> <ImageHeight UnitOfMeasureCode="9">46.0</ImageHeight> <ImageWidth UnitOfMeasureCode="9">70.0</ImageWidth> <ImageURL>5/E/5EBE1CC8E1840C121C4BF0FBF40B6DCB.jpg</ImageURL> <ThumbnailURL>2/E/2EA36573BCE916FAFC09A32A590DBF1E.jpg</ThumbnailURL> </ImageLink> <ImageLink> <ImageDescription ImageDisplayType="NMO.GBL.IMG.IMG">Restaurant</ImageDescription> <ImageHeight UnitOfMeasureCode="9">46.0</ImageHeight> <ImageWidth UnitOfMeasureCode="9">70.0</ImageWidth> <ImageURL>F/0/F07D742D7500E4C1315EA73B6449861E.jpg</ImageURL> <ThumbnailURL>E/A/EA1A7F0CE29E848589485A346F35B81F.jpg</ThumbnailURL> </ImageLink> <ImageLink> <ImageDescription ImageDisplayType="NMO.GBL.IMG.IMG">Bar</ImageDescription> <ImageHeight UnitOfMeasureCode="9">46.0</ImageHeight> <ImageWidth UnitOfMeasureCode="9">70.0</ImageWidth> <ImageURL>F/5/F577413868BD10E0413F903462BFEA4B.jpg</ImageURL> <ThumbnailURL>4/9/491197FA9F74F1DE30FB7D0FBBE29348.jpg</ThumbnailURL> </ImageLink> </ImageLinks> </Hotel> <Hotel Code="173240" Name="Cranley" Featured="false" SupplierID="MIK" Longitude="-86.751351" Latitude="21.138497" Sequence="1"> <Amenities> <Amenity Code="52" GroupCode="NMO.HTL.AMT.HTL"/> <Amenity Code="7" GroupCode="NMO.HTL.AMT.FCL"/> <Amenity Code="1" GroupCode="NMO.HTL.AMT.FCL"/> </Amenities> <DestinationDetails> <Destination Code="2757" Type="NMO.HTL.DST.CTY"/> <Destination Code="143" Type="NMO.HTL.DST.CTR"/> <Destination Code="12" Type="NMO.HTL.DST.CNT"/> <Destination Code="1" Type="NMO.HTL.DST.ALL"/> </DestinationDetails> <Rates> <Rate Offer="false" RateID="3727c45dbdafe53764a781ea39d8bd28#16" TripProductID="23dfd49b-3239-42f6-8b24-1a2ee5301098"> <Rooms> <Room RoomSequence="1" Availability="CNF" Type="SGL">Simple</Room> </Rooms> <Board Code="97">Desayuno Buffet Continental</Board> <RatePrices> <RatePrice Currency="USD" Type="NMO.GBL.RPT.GRS">1987.6</RatePrice> </RatePrices> </Rate> </Rates> <Rating Code="NMO.HTL.RTN.5ST" Type="NMO.HTL.RTT.STR"> <Value>4.0</Value> </Rating> <Address> <Line>10-12 Bina Gardens</Line> <Line>London</Line> <Line>United Kingdom</Line> </Address> <LocationDetails> <Location LocationCode="G1000">General</Location> </LocationDetails> </Hotel> </Hotels> </HotelsAvailability> </Trip> </Trips> <Passengers> <Passenger AgeType="NMO.GBL.AGT.ADT" RoomSequence="1"/> </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.
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 Si Amenidades del hotel.
Rates Si Se informan las habitaciones, regímenes y tarifas.
Rating Si Categoría del hotel.
HotelsAvailability No Retorna un conjunto de hoteles para el destino buscado. Se informará el nodo Amenities, DestinationDetails, Rates y Rating.

Se agregó el nodo ResponsetFilters:

  • PriceRange: Rango de precio de las tarifas
  • HotelRatings: Rango de categoría de hotel
  • HotelName
Exceptions Si Si no se puede armar el nodo Details se arma un nodo Exceptions con las notificaciones correspondientes.

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

Response: AdditionalInfoQueryRS

Ejemplo de uso:

      • Solicitud:

<AdditionalInfoQueryRQ xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="net.nemogroup.pricesurfer.messaging ..\PSCEV.xsd" xmlns="net.nemogroup.pricesurfer.messaging"> <GeneralParameters> <PreferedLanguage LanguageCode="es"/> <PreferedCurrency CurrencyCode="ARS"/> </GeneralParameters> <Products> <Hotels> <Hotel TripProductID="fef501f1-962d-40e8-84eb-42373a0e343f"/> </Hotels> </Products> </AdditionalInfoQueryRQ>


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

Atributos:

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

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


      • Respuesta:

<AdditionalInfoQueryRS xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="net.nemogroup.pricesurfer.messaging ..\PSCEV.xsd" xmlns="net.nemogroup.pricesurfer.messaging"> <Details> <Products> <Hotels> <Hotel HotelCode="7590" SupplierID="MIK" xmlns:ns="http://www.nemogroup.net/hcev/2008/04"> <HotelName>Days Hotel London North</HotelName> <HotelDescriptions> <HotelDescription HotelDescriptionType="General">Este hotel de 3 estrellas esta situado a las 

afueras  de London y el año de apertura fue 2002. Esta a poca distancia en coche de Wembley Stadium y la estación más

cercana es Edgware. El hotel tiene un restaurante, un bar, un salón de convenciones y una cafeteria. Las 193 habitaciones estan equipadas con secador de pelo, caja de seguridad y aire acondicionado.</HotelDescription> </HotelDescriptions> <Amenities> <Amenity Fee="No"> <AmenityGroup AmenityGroupCode="NMO.HTL.AMT.HTL">Hotel</AmenityGroup> <Description AmenityCode="14">Ascensores</Description> <ImageLink> <ImageDescription ImageDisplayType="NMO.GBL.IMG.IMG">Ascensores</ImageDescription> <ImageURL>ic_elevador.gif</ImageURL> </ImageLink> </Amenity> <Amenity Fee="No"> <AmenityGroup AmenityGroupCode="NMO.HTL.AMT.FCL">Instalaciones</AmenityGroup> <Description AmenityCode="5">Caja de seguridad</Description> </Amenity> <Amenity Fee="No"> <AmenityGroup AmenityGroupCode="NMO.HTL.AMT.HTL">Hotel</AmenityGroup> <Description AmenityCode="32">Tiro al Arco</Description> </Amenity> <Amenity Fee="No"> <AmenityGroup AmenityGroupCode="NMO.HTL.AMT.FCL">Instalaciones</AmenityGroup> <Description AmenityCode="7">Guardarropa</Description> <Value>193</Value> </Amenity> <Amenity Fee="No"> <AmenityGroup AmenityGroupCode="NMO.HTL.AMT.FCL">Instalaciones</AmenityGroup> <Description AmenityCode="18">Sala de conferencias</Description> </Amenity> <Amenity Fee="No"> <AmenityGroup AmenityGroupCode="NMO.HTL.AMT.HTL">Hotel</AmenityGroup> <Description AmenityCode="117">Se permite animales domésticos</Description> </Amenity> <Amenity Fee="No"> <AmenityGroup AmenityGroupCode="NMO.HTL.AMT.HTR">Habitación</AmenityGroup> <Description AmenityCode="4">Secador</Description> </Amenity> <Amenity Fee="No"> <AmenityGroup AmenityGroupCode="NMO.HTL.AMT.HTR">Habitación</AmenityGroup> <Description AmenityCode="34">Aire acondicionado</Description> <ImageLink> <ImageDescription ImageDisplayType="NMO.GBL.IMG.IMG">Aire acondicionado</ImageDescription> <ImageURL>ic_aireac.gif</ImageURL> </ImageLink> </Amenity> <Amenity Fee="No"> <AmenityGroup AmenityGroupCode="NMO.HTL.AMT.HTR">Habitación</AmenityGroup> <Description AmenityCode="237">television</Description> </Amenity> <Amenity Fee="No"> <AmenityGroup AmenityGroupCode="NMO.HTL.AMT.HTR">Habitación</AmenityGroup> <Description AmenityCode="8">Radio</Description> </Amenity> </Amenities> <Addresses> <Address AddressType="ABC"> <AddressLines> <AddressLine>London Gateway, Services</AddressLine> <AddressLine>London</AddressLine> <AddressLine>U.k.</AddressLine> </AddressLines> <TelephoneNumbers> <TelephoneNumber> <TelephoneNumberType TelephoneNumberType="NMO.GBL.TLT.TE1"/> <TelephoneNumberValue>020 89067000</TelephoneNumberValue> </TelephoneNumber> <TelephoneNumber> <TelephoneNumberType TelephoneNumberType="NMO.GBL.TLT.FAX"/> <TelephoneNumberValue>020 89067011</TelephoneNumberValue> </TelephoneNumber> </TelephoneNumbers> <Destinations> <Destination DestinationType="NMO.HTL.DST.CTY" DestinationCode="2757">Londres</Destination> <Destination DestinationType="NMO.HTL.DST.CTR" DestinationCode="143">Reino Unido</Destination> <Destination DestinationType="NMO.HTL.DST.CNT" DestinationCode="12">Europa</Destination> <Destination DestinationType="NMO.HTL.DST.ALL" DestinationCode="1">Planeta Tierra</Destination> </Destinations> </Address> </Addresses> <Position> <Latitude>51.634681</Latitude> <Longitude>-0.26438</Longitude> </Position> <HotelRating HotelRatingCode="NMO.HTL.RTN.3ST" HotelRatingType="NMO.HTL.RTT.STR"> <RatingDescription>3 Estrellas</RatingDescription> <RatingValue>3.0</RatingValue> </HotelRating> <ImageLinks> <ImageLink> <ImageDescription ImageDisplayType="NMO.GBL.IMG.IMG">Exterior view</ImageDescription> <ImageHeight UnitOfMeasureCode="9">46</ImageHeight> <ImageWidth UnitOfMeasureCode="9">70</ImageWidth> <ImageURL>B/6/B6E5222965FCD939B8967908EE909116.jpg</ImageURL> <ThumbnailURL>4/3/43081546B80C1F2361A934E91E0B83F4.jpg</ThumbnailURL> </ImageLink> <ImageLink> <ImageDescription ImageDisplayType="NMO.GBL.IMG.IMG">Standard bedroom</ImageDescription> <ImageHeight UnitOfMeasureCode="9">46</ImageHeight> <ImageWidth UnitOfMeasureCode="9">70</ImageWidth> <ImageURL>B/A/BA1FE7678A1DBABF62BB877A92B31404.jpg</ImageURL> <ThumbnailURL>D/2/D2CEAE049DA3A5D2D1F8C6CC1F911B67.jpg</ThumbnailURL> </ImageLink> <ImageLink> <ImageDescription ImageDisplayType="NMO.GBL.IMG.IMG">Standard bedroom</ImageDescription> <ImageHeight UnitOfMeasureCode="9">46</ImageHeight> <ImageWidth UnitOfMeasureCode="9">70</ImageWidth> <ImageURL>F/7/F73A5A01DACC93E47CC6ECA33071A1A5.jpg</ImageURL> <ThumbnailURL>9/1/914733863EFF6EC19D48A23ED5AE697C.jpg</ThumbnailURL> </ImageLink> <ImageLink> <ImageDescription ImageDisplayType="NMO.GBL.IMG.IMG">Standard bedroom</ImageDescription> <ImageHeight UnitOfMeasureCode="9">46</ImageHeight> <ImageWidth UnitOfMeasureCode="9">70</ImageWidth> <ImageURL>5/E/5EBE1CC8E1840C121C4BF0FBF40B6DCB.jpg</ImageURL> <ThumbnailURL>2/E/2EA36573BCE916FAFC09A32A590DBF1E.jpg</ThumbnailURL> </ImageLink> <ImageLink> <ImageDescription ImageDisplayType="NMO.GBL.IMG.IMG">Restaurant</ImageDescription> <ImageHeight UnitOfMeasureCode="9">46</ImageHeight> <ImageWidth UnitOfMeasureCode="9">70</ImageWidth> <ImageURL>F/0/F07D742D7500E4C1315EA73B6449861E.jpg</ImageURL> <ThumbnailURL>E/A/EA1A7F0CE29E848589485A346F35B81F.jpg</ThumbnailURL> </ImageLink> <ImageLink> <ImageDescription ImageDisplayType="NMO.GBL.IMG.IMG">Bar</ImageDescription> <ImageHeight UnitOfMeasureCode="9">46</ImageHeight> <ImageWidth UnitOfMeasureCode="9">70</ImageWidth> <ImageURL>F/5/F577413868BD10E0413F903462BFEA4B.jpg</ImageURL> <ThumbnailURL>4/9/491197FA9F74F1DE30FB7D0FBBE29348.jpg</ThumbnailURL> </ImageLink> </ImageLinks> <LocationDetails> <Location LocationCode="G8">Area suburbana</Location> </LocationDetails> </Hotel> </Hotels> </Products> </Details> </AdditionalInfoQueryRS>


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.
Echo No En este nodo se envía una copia de la consulta realizada.
Details Si
Products Si
Hotels No
Hotel Si 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 Si 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 || Si || Lista de amenidades brindadas por el hotel.

Amenity Si Amenidad brindada por el hotel.

Atributos:

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

AmenityGroup Si 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 Si 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 Si Dirección del hotel
AddressLines Si Líneas que componen la dirección del hotel.
AddressLine Si Indica la dirección del hotel.
TelephoneNumbers No Lista de números telefónicos disponibles para el hotel.
TelephoneNumber Si
TelephoneNumberType Si 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 Si Número telefónico.
Destination Si 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 Si 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 Si Valoración de la categoría del hotel expresada en el tipo de categoría indicado en el nodo padre.
ImageLinks Si Conjunto de imágenes del hotel
ImageLink No
ImageDescription Si 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 Si 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 Si Datos de tarifas
FareType No Tipo de tarifas, ej. Tarifa web, precio de agencia
Prices Si Precios, con valor y moneda
Exceptions Si Si no se puede armar el nodo Details se arma un nodo Exceptions con las notificaciones correspondientes.

Confirmación de Disponibilidad de una Tarifa obtenida en una Búsqueda Anterior (AvailabilityValidation)

Confirma la vigencia de una tarifa provista por una consulta de disponibilidad previa


Request: AvailabilityQueryRQ

Response: AvailabilityQueryRS

Ejemplo de uso:

      • Solicitud:

<AvailabilityValidationRQ xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="net.nemogroup.pricesurfer.messaging ..\PSCEV.xsd" xmlns="net.nemogroup.pricesurfer.messaging"> <GeneralParameters> <PreferedLanguage LanguageCode="es"/> <PreferedCurrency CurrencyCode="ARS"/> </GeneralParameters> <Products> <Hotels> <Hotel TripProductID="fef501f1-962d-40e8-84eb-42373a0e343f"/> </Hotels> </Products> </AvailabilityValidationRQ>


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

Atributos:

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

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


      • Respuesta:



<AvailabilityValidationRS xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="net.nemogroup.pricesurfer.messaging ..\PSCEV.xsd" xmlns="net.nemogroup.pricesurfer.messaging"> <Details> <Products> <Hotels> <Rate RateID="3727c45dbdafe53764a781ea39d8bd28#0" HotelCode="7590" SupplierId="MIK" TripProductID="fef501f1-962d-40e8-84eb-42373a0e343f"> <Rooms> <Room Type="NMO.HTL.RMT.SGL" Availability="NMO.HTL.AVB.CNF" RoomDescription="Simple"> <Occupancy> <Guests> <Guest PassengerSequence="1"/> </Guests> </Occupancy> </Room> </Rooms> <Board Code="60">Desayuno incluido</Board> <RatePrices> <RatePrice Currency="ARS" Type="NMO.HTL.RPT.NET">389.81860737273263</RatePrice> <RatePrice Currency="EUR" Type="NMO.HTL.RPT.NBC">66.62</RatePrice> <RatePrice Currency="ARS" Type="NMO.GBL.RPT.GRS">389.81860737273263</RatePrice> </RatePrices> <Passengers> <Passenger AgeType="NMO.GBL.AGT.ADT"/> </Passengers> <Destinations> <Destination DestinationType="NMO.HTL.DST.CTY" DestinationCode="2757"/> </Destinations> <Rating Code="NMO.HTL.RTN.3ST" Type="NMO.HTL.RTT.STR"> <Value>3.0</Value> <Description>3 Estrellas</Description> </Rating> <CheckIn>2013-12-20</CheckIn> <CheckOut>2013-12-22</CheckOut> </Rate> </Hotels> </Products> </Details> </AvailabilityValidationRS>


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.
Echo No En este nodo se envía una copia de la consulta realizada.
Details Si
Products Si
Hotels No
Hotel Si Información de un Hotel reportada por el proveedor asociado.

Atributos:

TripProductId: identificador del producto.

Offer: indica si es una oferta.

Featured: indica si es un producto recomendado.

Rooms No Información sobre las habitaciones.
Room Si Identifica una habitación en los parámetros de la búsqueda.

Atributos:

Type: tipo de habitación.

Availability: indica la disponibilidad de la habitación.

Occupancy Si Se informa la distribución de pasajeros en la habitación.
Guests Si Lista de huespedes de la habitación con su información.
Boards No
Board Si Regímenes asociados a la habitación.

Atributos:

Type: Tipo de régimen correspondiente a los tipos de régimen estándar provistos por Nemo.

Code: Código del régimen correspondiente a los códigos de régimen estándar provistos.

RatePrices No Se informan las tarifas de la habitación.
Passengers Si Pajeros incluidos en la tarifa hotelera.
Fares Si Datos de tarifas
FareType No Tipo de tarifas, ej. Tarifa web, precio de agencia
Prices Si Precios, con valor y moneda

Consulta de Gastos de Cancelación para una o varias Tarifas ó Reservas (CancellationFeesQuery)

Consulta de condiciones de gastos de cancelación sobre una o más tarifas o reservas reportadas.


Request: CancellationFeesQueryRQ

Response: CancellationFeesQueryRS

Ejemplo de uso:

      • Solicitud:

<syntaxhighlight lang="xml"> <CancellationFeesQueryRQ> <GeneralParameters> <PreferedLanguage LanguageCode="es"/> <PreferedCurrency CurrencyCode="ARS"/> </GeneralParameters> <Products> <Hotels ItemsCount="1"> <Hotel Sequence="1" TripProductID="fef501f1-962d-40e8-84eb-42373a0e343f"/> </Hotels> </Products> </CancellationFeesQueryRQ> </syntaxhighlight>


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

Atributos:

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

Products Si
Hotels No
Hotel Si Atributos:

- TripProductId: Identificador del producto


      • Respuesta:

<syntaxhighlight lang="xml"> <CancellationFeesQueryRS> 

  <Details>
     <Products>
        <Hotels ItemsCount="1">
           <Hotel Sequence="1" HotelCode="7590" SupplierID="MIK">
              <Hotel Sequence="1" SupplierID="MIK" HotelCode="7590">
                 <HotelName>Days Hotel London North</HotelName>
                 <HotelDescriptions ItemsCount="1">
                    <HotelDescription Sequence="1" HotelDescriptionType="General">Este hotel de 3 estrellas esta situado a las afueras de London y el año de apertura fue 2002. Esta a poca distancia en coche de Wembley Stadium y la estación más cercana es Edgware. El hotel tiene un restaurante, un bar, un salón de convenciones y una cafeteria. Las 193 habitaciones estan equipadas con secador de pelo, caja de seguridad y aire acondicionado.</HotelDescription>
                 </HotelDescriptions>
                 <LocationDetails ItemsCount="1">
                    <Location Sequence="1" LocationCode="G8">Area suburbana</Location>
                 </LocationDetails>
                 <Amenities ItemsCount="10">
                    <Amenity Fee="No" Sequence="1">
                       <AmenityGroup AmenityGroupCode="NMO.HTL.AMT.HTL">Hotel</AmenityGroup>
                       <Description AmenityCode="14">Ascensores</Description>
                       <ImageLink>
                          <ImageDescription ImageDisplayType="NMO.GBL.IMG.IMG">Ascensores</ImageDescription>
                          <ImageURL>ic_elevador.gif</ImageURL>
                       </ImageLink>
                    </Amenity>
                    <Amenity Fee="No" Sequence="2">
                       <AmenityGroup AmenityGroupCode="NMO.HTL.AMT.FCL">Instalaciones</AmenityGroup>
                       <Description AmenityCode="5">Caja de seguridad</Description>
                    </Amenity>
                    <Amenity Fee="No" Sequence="3">
                       <AmenityGroup AmenityGroupCode="NMO.HTL.AMT.HTL">Hotel</AmenityGroup>
                       <Description AmenityCode="32">Tiro al Arco</Description>
                    </Amenity>
                    <Amenity Fee="No" Sequence="4">
                       <AmenityGroup AmenityGroupCode="NMO.HTL.AMT.FCL">Instalaciones</AmenityGroup>
                       <Description AmenityCode="7">Guardarropa</Description>
                       <Value>193</Value>
                    </Amenity>
                    <Amenity Fee="No" Sequence="5">
                       <AmenityGroup AmenityGroupCode="NMO.HTL.AMT.FCL">Instalaciones</AmenityGroup>
                       <Description AmenityCode="18">Sala de conferencias</Description>
                    </Amenity>
                    <Amenity Fee="No" Sequence="6">
                       <AmenityGroup AmenityGroupCode="NMO.HTL.AMT.HTL">Hotel</AmenityGroup>
                       <Description AmenityCode="117">Se permite animales domésticos</Description>
                    </Amenity>
                    <Amenity Fee="No" Sequence="7">
                       <AmenityGroup AmenityGroupCode="NMO.HTL.AMT.HTR">Habitación</AmenityGroup>
                       <Description AmenityCode="4">Secador</Description>
                    </Amenity>
                    <Amenity Fee="No" Sequence="8">
                       <AmenityGroup AmenityGroupCode="NMO.HTL.AMT.HTR">Habitación</AmenityGroup>
                       <Description AmenityCode="34">Aire acondicionado</Description>
                       <ImageLink>
                          <ImageDescription ImageDisplayType="NMO.GBL.IMG.IMG">Aire acondicionado</ImageDescription>
                          <ImageURL>ic_aireac.gif</ImageURL>
                       </ImageLink>
                    </Amenity>
                    <Amenity Fee="No" Sequence="9">
                       <AmenityGroup AmenityGroupCode="NMO.HTL.AMT.HTR">Habitación</AmenityGroup>
                       <Description AmenityCode="237">television</Description>
                    </Amenity>
                    <Amenity Fee="No" Sequence="10">
                       <AmenityGroup AmenityGroupCode="NMO.HTL.AMT.HTR">Habitación</AmenityGroup>
                       <Description AmenityCode="8">Radio</Description>
                    </Amenity>
                 </Amenities>
                 <Addresses ItemsCount="1">
                    <Address Sequence="1">
                       <AddressLines ItemsCount="3">
                          <AddressLine Sequence="1">London Gateway, Services</AddressLine>
                          <AddressLine Sequence="2">London</AddressLine>
                          <AddressLine Sequence="3">U.k.</AddressLine>
                       </AddressLines>
                       <TelephoneNumbers ItemsCount="2">
                          <TelephoneNumber Sequence="1">
                             <TelephoneNumberType TelephoneNumberType="NMO.GBL.TLT.TE1"/>
                             <TelephoneNumberValue>020 89067000</TelephoneNumberValue>
                          </TelephoneNumber>
                          <TelephoneNumber Sequence="2">
                             <TelephoneNumberType TelephoneNumberType="NMO.GBL.TLT.FAX"/>
                             <TelephoneNumberValue>020 89067011</TelephoneNumberValue>
                          </TelephoneNumber>
                       </TelephoneNumbers>
                       <Destinations ItemsCount="4">
                          <Destination Sequence="1" DestinationType="NMO.HTL.DST.CTY" DestinationCode="2757">Londres</Destination>
                          <Destination Sequence="2" DestinationType="NMO.HTL.DST.CTR" DestinationCode="143">Reino Unido</Destination>
                          <Destination Sequence="3" DestinationType="NMO.HTL.DST.CNT" DestinationCode="12">Europa</Destination>
                          <Destination Sequence="4" DestinationType="NMO.HTL.DST.ALL" DestinationCode="1">Planeta Tierra</Destination>
                       </Destinations>
                    </Address>
                 </Addresses>
                 <Position>
                    <Latitude>51.634681</Latitude>
                    <Longitude>-0.26438</Longitude>
                 </Position>
                 <HotelRating HotelRatingCode="NMO.HTL.RTN.3ST" HotelRatingType="NMO.HTL.RTT.STR">
                    <RatingDescription>3 Estrellas</RatingDescription>
                    <RatingValue>3.0</RatingValue>
                 </HotelRating>
                 <ImageLinks ItemsCount="6">
                    <ImageLink Sequence="1">
                       <ImageDescription ImageDisplayType="NMO.GBL.IMG.IMG">Exterior view</ImageDescription>
                       <ImageHeight UnitOfMeasureCode="9">46</ImageHeight>
                       <ImageWidth UnitOfMeasureCode="9">70</ImageWidth>
                       <ImageURL>B/6/B6E5222965FCD939B8967908EE909116.jpg</ImageURL>
                       <ThumbnailURL>4/3/43081546B80C1F2361A934E91E0B83F4.jpg</ThumbnailURL>
                    </ImageLink>
                    <ImageLink Sequence="2">
                       <ImageDescription ImageDisplayType="NMO.GBL.IMG.IMG">Standard bedroom</ImageDescription>
                       <ImageHeight UnitOfMeasureCode="9">46</ImageHeight>
                       <ImageWidth UnitOfMeasureCode="9">70</ImageWidth>
                       <ImageURL>B/A/BA1FE7678A1DBABF62BB877A92B31404.jpg</ImageURL>
                       <ThumbnailURL>D/2/D2CEAE049DA3A5D2D1F8C6CC1F911B67.jpg</ThumbnailURL>
                    </ImageLink>
                    <ImageLink Sequence="3">
                       <ImageDescription ImageDisplayType="NMO.GBL.IMG.IMG">Standard bedroom</ImageDescription>
                       <ImageHeight UnitOfMeasureCode="9">46</ImageHeight>
                       <ImageWidth UnitOfMeasureCode="9">70</ImageWidth>
                       <ImageURL>F/7/F73A5A01DACC93E47CC6ECA33071A1A5.jpg</ImageURL>
                       <ThumbnailURL>9/1/914733863EFF6EC19D48A23ED5AE697C.jpg</ThumbnailURL>
                    </ImageLink>
                    <ImageLink Sequence="4">
                       <ImageDescription ImageDisplayType="NMO.GBL.IMG.IMG">Standard bedroom</ImageDescription>
                       <ImageHeight UnitOfMeasureCode="9">46</ImageHeight>
                       <ImageWidth UnitOfMeasureCode="9">70</ImageWidth>
                       <ImageURL>5/E/5EBE1CC8E1840C121C4BF0FBF40B6DCB.jpg</ImageURL>
                       <ThumbnailURL>2/E/2EA36573BCE916FAFC09A32A590DBF1E.jpg</ThumbnailURL>
                    </ImageLink>
                    <ImageLink Sequence="5">
                       <ImageDescription ImageDisplayType="NMO.GBL.IMG.IMG">Restaurant</ImageDescription>
                       <ImageHeight UnitOfMeasureCode="9">46</ImageHeight>
                       <ImageWidth UnitOfMeasureCode="9">70</ImageWidth>
                       <ImageURL>F/0/F07D742D7500E4C1315EA73B6449861E.jpg</ImageURL>
                       <ThumbnailURL>E/A/EA1A7F0CE29E848589485A346F35B81F.jpg</ThumbnailURL>
                    </ImageLink>
                    <ImageLink Sequence="6">
                       <ImageDescription ImageDisplayType="NMO.GBL.IMG.IMG">Bar</ImageDescription>
                       <ImageHeight UnitOfMeasureCode="9">46</ImageHeight>
                       <ImageWidth UnitOfMeasureCode="9">70</ImageWidth>
                       <ImageURL>F/5/F577413868BD10E0413F903462BFEA4B.jpg</ImageURL>
                       <ThumbnailURL>4/9/491197FA9F74F1DE30FB7D0FBBE29348.jpg</ThumbnailURL>
                    </ImageLink>
                 </ImageLinks>
              </Hotel>
              <DestinationDetails ItemsCount="4">
                 <Destination Sequence="1" DestinationType="NMO.HTL.DST.CTY" DestinationCode="2757">Londres</Destination>
                 <Destination Sequence="2" DestinationType="NMO.HTL.DST.CTR" DestinationCode="143">Reino Unido</Destination>
                 <Destination Sequence="3" DestinationType="NMO.HTL.DST.CNT" DestinationCode="12">Europa</Destination>
                 <Destination Sequence="4" DestinationType="NMO.HTL.DST.ALL" DestinationCode="1">Planeta Tierra</Destination>
              </DestinationDetails>
              <CheckIn>2013-12-20</CheckIn>
              <CheckOut>2013-12-22</CheckOut>
              <Rate RateID="3727c45dbdafe53764a781ea39d8bd28#0" TripProductID="fef501f1-962d-40e8-84eb-42373a0e343f">
                 <Rooms ItemsCount="1">
                    <Room Sequence="1">
                       <RoomDescription RoomType="NMO.HTL.RMT.SGL">Simple</RoomDescription>
                       <Occupancy>
                          <AdultsCount>1</AdultsCount>
                          <ChildrenCount>0</ChildrenCount>
                          <InfantCount>0</InfantCount>
                          <RoomsCount>1</RoomsCount>
                          <Passengers ItemsCount="1">
                             <Passenger Sequence="1" AgeType="NMO.GBL.AGT.ADT"/>
                          </Passengers>
                       </Occupancy>
                       <Availability AvailabilityCode="NMO.HTL.AVB.CNF">Confirmación Inmediata</Availability>
                    </Room>
                 </Rooms>
                 <Boards ItemsCount="1">
                    <Board Sequence="1" BoardType="BreakfastDescription" BoardCode="60" AppliableDays="A">Desayuno incluido</Board>
                 </Boards>
                 <RatePrices ItemsCount="3">
                    <RatePrice Sequence="1" Currency="ARS" Type="NMO.HTL.RPT.NET">389.81860737273263</RatePrice>
                    <RatePrice Sequence="2" Currency="EUR" Type="NMO.HTL.RPT.NBC">66.62</RatePrice>
                    <RatePrice Sequence="3" Currency="ARS" Type="NMO.GBL.RPT.GRS">389.81860737273263</RatePrice>
                 </RatePrices>
                 <ChargeConditions ItemsCount="2">
                    <ChargeCondition Sequence="1">
                       <ChargeDescription ChargeType="NMO.HTL.CHT.CAN">Gastos de cancelación</ChargeDescription>
                       <DateRangeWithDays>
                          <DateFrom>0</DateFrom>
                          <DateTo>2</DateTo>
                       </DateRangeWithDays>
                       <RatePrices ItemsCount="3">
                          <RatePrice Sequence="1" Currency="ARS" Type="NMO.HTL.RPT.NET">194.90930368636631</RatePrice>
                          <RatePrice Sequence="2" Currency="EUR" Type="NMO.HTL.RPT.NBC">33.31</RatePrice>
                          <RatePrice Sequence="3" Currency="ARS" Type="NMO.GBL.RPT.GRS">194.90930368636631</RatePrice>
                       </RatePrices>
                    </ChargeCondition>
                    <ChargeCondition Sequence="2">
                       <ChargeDescription ChargeType="NMO.HTL.CHT.CAN">Gastos de cancelación</ChargeDescription>
                       <DateRangeWithDays>
                          <DateFrom>0</DateFrom>
                          <DateTo>1</DateTo>
                       </DateRangeWithDays>
                       <RatePrices ItemsCount="3">
                          <RatePrice Sequence="1" Currency="ARS" Type="NMO.HTL.RPT.NET">389.81860737273263</RatePrice>
                          <RatePrice Sequence="2" Currency="EUR" Type="NMO.HTL.RPT.NBC">66.62</RatePrice>
                          <RatePrice Sequence="3" Currency="ARS" Type="NMO.GBL.RPT.GRS">389.81860737273263</RatePrice>
                       </RatePrices>
                    </ChargeCondition>
                 </ChargeConditions>
                 <Deadline>
                    <Date>2013-12-15T00:00:00.000-03:00</Date>
                 </Deadline>
              </Rate>
           </Hotel>
        </Hotels>
     </Products>
  </Details>

</CancellationFeesQueryRS> </syntaxhighlight>


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.
Details Si
Hotel No Contiene toda la información del hotel.
HotelName Si Nombre del hotel.
AccomodationType No Indica si es hotel, hostel, camping, etc, los tipos serán provistos por Nemo.
HotelDescriptions No
HotelDescription Si Descripción del hotel.

Atributos:

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

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 No
Amenity No Código de amenidad admitido.

Atributos:

AmenityGroupCode: Tipo de amenidad. Los tipos de amenidad admitidos corresponden a los provistos por Nemo.

AmenityCode: Código de amenidad. Los códigos de amenidad admitidos corresponden a los provistos.

Address Si Dirección del hotel
AddressLines Si Líneas que componen la dirección del hotel.
AddressLine Si Indica la dirección del hotel.
Position No Coordenadas del hotel: Latitud y Longitud.
HotelRating Si 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 Si Valoración de la categoría del hotel expresada en el tipo de categoría indicado en el nodo padre.
ImageLinks Si Conjunto de imágenes del hotel
ImageLink No
ImageDescription Si 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 Si URL de la imagen
DestinationDetails Si Atributos:

DestinationType: tipo de destino de los provistos por Nemo.

Destination Code: código del destino a buscar, de los provistos por Nemo.

CheckIn No Fecha de entrada de la estadía.
CheckOut No Fecha de salida de la estadía
Rate Si Tarifa a reservar, indicando con el atributo TripProductId el id del hotel a reservar.
Rooms No
Room Si
Occupancy Si Indica la cantidad de adultos, niños e infantes por cada habitación.

En el nodo Guest se encuentra el identificador del pasajero, atributo PassengerSequence. Este dato se obtiene del Sequence del nodo Passenger.

Passenger No Datos de los pasajeros.

Atributos:

AgeType: tipo de pasajero (chl, inf, adt).

Sequence: Este dato será asociado al PassengerSequence del nodo Guest en hoteles.

Exceptions Si Si no se puede armar el nodo Details se arma un nodo Exceptions con las notificaciones correspondientes.
ChargeConditions Si Nodo de gastos de cancelación
ChargeCondition Si Gasto de Cancelación

Atributo:

- ChargeType, tipo de cargo (Ej. NMO.HTL.CHT.CAN cancelación, NMO.HTL.CHT.AMD Modificación)

ChargeDescription Si Descripción del gastos de cancelación
DateRangeWithDays No Indica que el gasto de cancelación tiene un rango en base a días.
DateFrom Si Fecha desde
DateTo Si Fecha hasta
DateRangeWithDateType No Indica que el gasto de cancelación tiene un rango en base a fechas.
DateFrom Si Fecha desde
DateTo Si Fecha hasta
RatePrices Si
RatePrice Si Indica el importe del concepto de cancelación

Atributos:

- RatePriceType, tipo de precio

Reserva de Tarifa (BookingProducts)

Solicitud de reserva para una o varias tarifas de hoteles.


Request: BookingProductsRQ

Response: BookingProductsRS

Ejemplo de uso:

      • Solicitud:

<syntaxhighlight lang="xml"> <BookingProductsRQ> <GeneralParameters> <PreferedLanguage LanguageCode="es"/> <PreferedCurrency CurrencyCode="ARS"/> </GeneralParameters> <Products> <Hotels ItemsCount="2"> <Hotel Sequence="1" TripProductID="fef501f1-962d-40e8-84eb-42373a0e343f"> <Rooms ItemsCount="1"> <Room Sequence="1" RoomType="NMO.HTL.RMT.SGL"> <Guests ItemsCount="1"> <Guest Sequence="1" PassengerSequence="1"/> </Guests> </Room> </Rooms> </Hotel> </Hotels> <Passengers ItemsCount="1"> <Passenger AgeType="NMO.GBL.AGT.ADT" Sequence="1"> <PersonNames ItemsCount="2"> <PersonName Sequence="1" NameType="NMO.GBL.PNT.FIR">nombre</PersonName> <PersonName Sequence="2" NameType="NMO.GBL.PNT.LAS">apellido</PersonName> </PersonNames> </Passenger> </Passengers> </Products> </BookingProductsRQ> </syntaxhighlight>


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

Atributos:

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

Hoteles No
Hotel Si
Rate Si Tarifa a reservar, indicando con el atributo TripProductId el id del hotel a reservar.
Rooms No
Room Si
Occupancy Si Indica la cantidad de adultos, niños e infantes por cada habitación.

En el nodo Guest se encuentra el identificador del pasajero, atributo PassengerSequence. Este dato se obtiene del Sequence del nodo Passenger.

Passenger No Datos de los pasajeros.

Atributos:

AgeType: tipo de pasajero (chl, inf, adt).

Sequence: Este dato será asociado al PassengerSequence del nodo Guest en hoteles.

      • Respuesta:

<syntaxhighlight lang="xml"> <BookingProductsRS> 

  <Details>
     <BookingReference>QN_006OF</BookingReference>
     <BookingState>NMO.GBL.BST.CNF</BookingState>
     <Products>
        <Hotels ItemsCount="1">
           <Hotel Sequence="1" HotelCode="7590" SupplierID="MIK" LogID="162718">
              <BookingReferences ItemsCount="2">
                 <BookingReference Sequence="1" ReferenceType="NMO.HTL.RPT.MPH">QN_006OF-1</BookingReference>
                 <BookingReference Sequence="2" ReferenceType="NMO.HTL.RPT.PRS">E00166024</BookingReference>
              </BookingReferences>
              <BookingStatusList ItemsCount="1">
                 <BookingStatus Sequence="1">
                    <BookingStatusDescription BookingStatusCode="NMO.HTL.BST.CNF">Confirmado</BookingStatusDescription>
                    <BookingStatusTime>09:19:06.884-03:00</BookingStatusTime>
                 </BookingStatus>
              </BookingStatusList>
              <Hotel Sequence="1" SupplierID="MIK" HotelCode="7590">
                 <HotelName>Days Hotel London North</HotelName>
                 <HotelDescriptions ItemsCount="1">
                    <HotelDescription Sequence="1" HotelDescriptionType="General">Este hotel de 3 estrellas esta situado a las afueras de London y el año de apertura fue 2002. Esta a poca distancia en coche de Wembley Stadium y la estación más cercana es Edgware. El hotel tiene un restaurante, un bar, un salón de convenciones y una cafeteria. Las 193 habitaciones estan equipadas con secador de pelo, caja de seguridad y aire acondicionado.</HotelDescription>
                 </HotelDescriptions>
                 <LocationDetails ItemsCount="1">
                    <Location Sequence="1" LocationCode="G8">Area suburbana</Location>
                 </LocationDetails>
                 <Amenities ItemsCount="10">
                    <Amenity Fee="No" Sequence="1">
                       <AmenityGroup AmenityGroupCode="NMO.HTL.AMT.HTL">Hotel</AmenityGroup>
                       <Description AmenityCode="14">Ascensores</Description>
                       <ImageLink>
                          <ImageDescription ImageDisplayType="NMO.GBL.IMG.IMG">Ascensores</ImageDescription>
                          <ImageURL>ic_elevador.gif</ImageURL>
                       </ImageLink>
                    </Amenity>
                    <Amenity Fee="No" Sequence="2">
                       <AmenityGroup AmenityGroupCode="NMO.HTL.AMT.FCL">Instalaciones</AmenityGroup>
                       <Description AmenityCode="5">Caja de seguridad</Description>
                    </Amenity>
                    <Amenity Fee="No" Sequence="3">
                       <AmenityGroup AmenityGroupCode="NMO.HTL.AMT.HTL">Hotel</AmenityGroup>
                       <Description AmenityCode="32">Tiro al Arco</Description>
                    </Amenity>
                    <Amenity Fee="No" Sequence="4">
                       <AmenityGroup AmenityGroupCode="NMO.HTL.AMT.FCL">Instalaciones</AmenityGroup>
                       <Description AmenityCode="7">Guardarropa</Description>
                       <Value>193</Value>
                    </Amenity>
                    <Amenity Fee="No" Sequence="5">
                       <AmenityGroup AmenityGroupCode="NMO.HTL.AMT.FCL">Instalaciones</AmenityGroup>
                       <Description AmenityCode="18">Sala de conferencias</Description>
                    </Amenity>
                    <Amenity Fee="No" Sequence="6">
                       <AmenityGroup AmenityGroupCode="NMO.HTL.AMT.HTL">Hotel</AmenityGroup>
                       <Description AmenityCode="117">Se permite animales domésticos</Description>
                    </Amenity>
                    <Amenity Fee="No" Sequence="7">
                       <AmenityGroup AmenityGroupCode="NMO.HTL.AMT.HTR">Habitación</AmenityGroup>
                       <Description AmenityCode="4">Secador</Description>
                    </Amenity>
                    <Amenity Fee="No" Sequence="8">
                       <AmenityGroup AmenityGroupCode="NMO.HTL.AMT.HTR">Habitación</AmenityGroup>
                       <Description AmenityCode="34">Aire acondicionado</Description>
                       <ImageLink>
                          <ImageDescription ImageDisplayType="NMO.GBL.IMG.IMG">Aire acondicionado</ImageDescription>
                          <ImageURL>ic_aireac.gif</ImageURL>
                       </ImageLink>
                    </Amenity>
                    <Amenity Fee="No" Sequence="9">
                       <AmenityGroup AmenityGroupCode="NMO.HTL.AMT.HTR">Habitación</AmenityGroup>
                       <Description AmenityCode="237">television</Description>
                    </Amenity>
                    <Amenity Fee="No" Sequence="10">
                       <AmenityGroup AmenityGroupCode="NMO.HTL.AMT.HTR">Habitación</AmenityGroup>
                       <Description AmenityCode="8">Radio</Description>
                    </Amenity>
                 </Amenities>
                 <Addresses ItemsCount="1">
                    <Address Sequence="1">
                       <AddressLines ItemsCount="3">
                          <AddressLine Sequence="1">London Gateway, Services</AddressLine>
                          <AddressLine Sequence="2">London</AddressLine>
                          <AddressLine Sequence="3">U.k.</AddressLine>
                       </AddressLines>
                       <TelephoneNumbers ItemsCount="2">
                          <TelephoneNumber Sequence="1">
                             <TelephoneNumberType TelephoneNumberType="NMO.GBL.TLT.TE1"/>
                             <TelephoneNumberValue>020 89067000</TelephoneNumberValue>
                          </TelephoneNumber>
                          <TelephoneNumber Sequence="2">
                             <TelephoneNumberType TelephoneNumberType="NMO.GBL.TLT.FAX"/>
                             <TelephoneNumberValue>020 89067011</TelephoneNumberValue>
                          </TelephoneNumber>
                       </TelephoneNumbers>
                       <Destinations ItemsCount="4">
                          <Destination Sequence="1" DestinationType="NMO.HTL.DST.CTY" DestinationCode="2757">Londres</Destination>
                          <Destination Sequence="2" DestinationType="NMO.HTL.DST.CTR" DestinationCode="143">Reino Unido</Destination>
                          <Destination Sequence="3" DestinationType="NMO.HTL.DST.CNT" DestinationCode="12">Europa</Destination>
                          <Destination Sequence="4" DestinationType="NMO.HTL.DST.ALL" DestinationCode="1">Planeta Tierra</Destination>
                       </Destinations>
                    </Address>
                 </Addresses>
                 <Position>
                    <Latitude>51.634681</Latitude>
                    <Longitude>-0.26438</Longitude>
                 </Position>
                 <HotelRating HotelRatingCode="NMO.HTL.RTN.3ST" HotelRatingType="NMO.HTL.RTT.STR">
                    <RatingDescription>3 Estrellas</RatingDescription>
                    <RatingValue>3.0</RatingValue>
                 </HotelRating>
                 <ImageLinks ItemsCount="6">
                    <ImageLink Sequence="1">
                       <ImageDescription ImageDisplayType="NMO.GBL.IMG.IMG">Exterior view</ImageDescription>
                       <ImageHeight UnitOfMeasureCode="9">46</ImageHeight>
                       <ImageWidth UnitOfMeasureCode="9">70</ImageWidth>
                       <ImageURL>B/6/B6E5222965FCD939B8967908EE909116.jpg</ImageURL>
                       <ThumbnailURL>4/3/43081546B80C1F2361A934E91E0B83F4.jpg</ThumbnailURL>
                    </ImageLink>
                    <ImageLink Sequence="2">
                       <ImageDescription ImageDisplayType="NMO.GBL.IMG.IMG">Standard bedroom</ImageDescription>
                       <ImageHeight UnitOfMeasureCode="9">46</ImageHeight>
                       <ImageWidth UnitOfMeasureCode="9">70</ImageWidth>
                       <ImageURL>B/A/BA1FE7678A1DBABF62BB877A92B31404.jpg</ImageURL>
                       <ThumbnailURL>D/2/D2CEAE049DA3A5D2D1F8C6CC1F911B67.jpg</ThumbnailURL>
                    </ImageLink>
                    <ImageLink Sequence="3">
                       <ImageDescription ImageDisplayType="NMO.GBL.IMG.IMG">Standard bedroom</ImageDescription>
                       <ImageHeight UnitOfMeasureCode="9">46</ImageHeight>
                       <ImageWidth UnitOfMeasureCode="9">70</ImageWidth>
                       <ImageURL>F/7/F73A5A01DACC93E47CC6ECA33071A1A5.jpg</ImageURL>
                       <ThumbnailURL>9/1/914733863EFF6EC19D48A23ED5AE697C.jpg</ThumbnailURL>
                    </ImageLink>
                    <ImageLink Sequence="4">
                       <ImageDescription ImageDisplayType="NMO.GBL.IMG.IMG">Standard bedroom</ImageDescription>
                       <ImageHeight UnitOfMeasureCode="9">46</ImageHeight>
                       <ImageWidth UnitOfMeasureCode="9">70</ImageWidth>
                       <ImageURL>5/E/5EBE1CC8E1840C121C4BF0FBF40B6DCB.jpg</ImageURL>
                       <ThumbnailURL>2/E/2EA36573BCE916FAFC09A32A590DBF1E.jpg</ThumbnailURL>
                    </ImageLink>
                    <ImageLink Sequence="5">
                       <ImageDescription ImageDisplayType="NMO.GBL.IMG.IMG">Restaurant</ImageDescription>
                       <ImageHeight UnitOfMeasureCode="9">46</ImageHeight>
                       <ImageWidth UnitOfMeasureCode="9">70</ImageWidth>
                       <ImageURL>F/0/F07D742D7500E4C1315EA73B6449861E.jpg</ImageURL>
                       <ThumbnailURL>E/A/EA1A7F0CE29E848589485A346F35B81F.jpg</ThumbnailURL>
                    </ImageLink>
                    <ImageLink Sequence="6">
                       <ImageDescription ImageDisplayType="NMO.GBL.IMG.IMG">Bar</ImageDescription>
                       <ImageHeight UnitOfMeasureCode="9">46</ImageHeight>
                       <ImageWidth UnitOfMeasureCode="9">70</ImageWidth>
                       <ImageURL>F/5/F577413868BD10E0413F903462BFEA4B.jpg</ImageURL>
                       <ThumbnailURL>4/9/491197FA9F74F1DE30FB7D0FBBE29348.jpg</ThumbnailURL>
                    </ImageLink>
                 </ImageLinks>
              </Hotel>
              <DestinationDetails ItemsCount="4">
                 <Destination Sequence="1" DestinationType="NMO.HTL.DST.CTY" DestinationCode="2757">Londres</Destination>
                 <Destination Sequence="2" DestinationType="NMO.HTL.DST.CTR" DestinationCode="143">Reino Unido</Destination>
                 <Destination Sequence="3" DestinationType="NMO.HTL.DST.CNT" DestinationCode="12">Europa</Destination>
                 <Destination Sequence="4" DestinationType="NMO.HTL.DST.ALL" DestinationCode="1">Planeta Tierra</Destination>
              </DestinationDetails>
              <CheckIn>2013-12-20</CheckIn>
              <CheckOut>2013-12-22</CheckOut>
              <Rate RateID="3727c45dbdafe53764a781ea39d8bd28#0" TripProductID="971cf657-9cf4-4b7a-aeaa-32c7d354f71d">
                 <Rooms ItemsCount="1">
                    <Room Sequence="1">
                       <RoomDescription RoomType="NMO.HTL.RMT.SGL">Simple</RoomDescription>
                       <Occupancy>
                          <AdultsCount>1</AdultsCount>
                          <ChildrenCount>0</ChildrenCount>
                          <InfantCount>0</InfantCount>
                          <RoomsCount>1</RoomsCount>
                          <Passengers ItemsCount="1">
                             <Passenger Sequence="1" AgeType="NMO.GBL.AGT.ADT">
                                <PersonNames ItemsCount="2">
                                   <PersonName Sequence="1" NameType="NMO.GBL.PNT.FIR">nombre</PersonName>
                                   <PersonName Sequence="2" NameType="NMO.GBL.PNT.LAS">apellido</PersonName>
                                </PersonNames>
                             </Passenger>
                          </Passengers>
                       </Occupancy>
                       <Availability AvailabilityCode="NMO.HTL.AVB.CNF">Confirmación Inmediata</Availability>
                    </Room>
                 </Rooms>
                 <Boards ItemsCount="1">
                    <Board Sequence="1" BoardType="BreakfastDescription" BoardCode="60" AppliableDays="A">Desayuno incluido</Board>
                 </Boards>
                 <RatePrices ItemsCount="3">
                    <RatePrice Sequence="1" Currency="ARS" Type="NMO.HTL.RPT.NET">389.81860737273263</RatePrice>
                    <RatePrice Sequence="2" Currency="EUR" Type="NMO.HTL.RPT.NBC">66.62</RatePrice>
                    <RatePrice Sequence="3" Currency="ARS" Type="NMO.GBL.RPT.GRS">389.81860737273263</RatePrice>
                 </RatePrices>
              </Rate>
              <BookingCreationDT>2013-07-30T09:18:52.573-03:00</BookingCreationDT>
           </Hotel>
        </Hotels>
     </Products>
  </Details>

</BookingProductsRS> </syntaxhighlight>


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.
Details Si
Bookings Si
Booking Si Detalle de la reserva.

Atributos:

  • BookingReference: identificador de la reserva.
  • BookingState: estado de la reserva
Hotel Si
BookingReferences No Identificadores de la resera.
BookingStatusList No Estados del “ítem”.
BookingStatus Si
BookingStatusDescription Si Descripción del estado actual de la reserva.

BookingStatusCode: Código del estado de la reserva correspondiente a los códigos estándar de reserva provistos por Nemo.

Hotel No Contiene toda la información del hotel.
HotelName Si Nombre del hotel.
AccomodationType No Indica si es hotel, hostel, camping, etc, los tipos serán provistos por Nemo.
HotelDescriptions No
HotelDescription Si Descripción del hotel.

Atributos:

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

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 No
Amenity No Código de amenidad admitido.

Atributos:

AmenityGroupCode: Tipo de amenidad. Los tipos de amenidad admitidos corresponden a los provistos por Nemo.

AmenityCode: Código de amenidad. Los códigos de amenidad admitidos corresponden a los provistos.

Address Si Dirección del hotel
AddressLines Si Líneas que componen la dirección del hotel.
AddressLine Si Indica la dirección del hotel.
Position No Coordenadas del hotel: Latitud y Longitud.
HotelRating Si 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 Si Valoración de la categoría del hotel expresada en el tipo de categoría indicado en el nodo padre.
ImageLinks Si Conjunto de imágenes del hotel
ImageLink No
ImageDescription Si 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 Si URL de la imagen
DestinationDetails Si Atributos:

DestinationType: tipo de destino de los provistos por Nemo.

Destination Code: código del destino a buscar, de los provistos por Nemo.

CheckIn No Fecha de entrada de la estadía.
CheckOut No Fecha de salida de la estadía
Rate Si Tarifa a reservar, indicando con el atributo TripProductId el id del hotel a reservar.
Rooms No
Room Si
Occupancy Si Indica la cantidad de adultos, niños e infantes por cada habitación.

En el nodo Passengers se encuentran los datos de los pasajeros.

ImageDescription Si Descripción de la imagen

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

ImageHeight No Dimensiones de la imagen: alto
ImageWidht No Dimensiones de la imagen: Ancho
ImageURL Si URL de la imagen
ThumbnailURL No URL de la imagen miniatura
Fares Si Datos de tarifas
FareType No Tipo de tarifas, ej. Tarifa web, precio de agencia
Prices Si Precios, con valor y moneda
BookingState Si Estado de la reserva (del ítem). La codificación de los estados será provista por Nemo.

Atributos:

Code: Código del estado (confirmada, rechazada, etc)

ProductBookingExtraData No Nodo que se utiliza para registrar datos genéricos sobre una reserva. Luego al consultar la misma el sistema responderá con los datos registrados.
Exceptions Si Si no se puede armar el nodo Details se arma un nodo Exceptions con las notificaciones correspondientes.
ChargeConditions Si Nodo de gastos de cancelación
ChargeCondition Si Gasto de Cancelación

Atributo:

ChargeType, tipo de cargo (Ej. NMO.HTL.CHT.CAN cancelación, NMO.HTL.CHT.AMD Modificación)

ChargeDescription Si Descripción del gastos de cancelación
DateRangeWithDays No Indica que el gasto de cancelación tiene un rango en base a días.
DateFrom Si Fecha desde
DateTo Si Fecha hasta
DateRangeWithDateType No Indica que el gasto de cancelación tiene un rango en base a fechas.
DateFrom Si Fecha desde
DateTo Si Fecha hasta
RatePrices Si
RatePrice Si Indica el importe del concepto de cancelación

Atributos:

RatePriceType, tipo de precio

Cancelación de Reserva (BookingCancellation)

Solicitud de cancelación de una o varias reservas realizadas.


Request: BookingCancellationRQ

Response: BookingCancellationRS

Ejemplo de uso:

      • Solicitud:

<syntaxhighlight lang="xml"> <BookingCancellationRQ> <GeneralParameters> <PreferedLanguage LanguageCode="es"/> <PreferedCurrency CurrencyCode="ARS"/> </GeneralParameters> <Bookings ItemsCount="1"> <Booking BookingReference="QN_006OF" Sequence="1"/> </Bookings> </BookingCancellationRQ> </syntaxhighlight>


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

Atributos:

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

Products Si
BookingReference Si Atributos:

- ReferenceType: Tipo de referencia, por ejemplo OLA.GBL.BRT.HTL – Referencia de reserva de hoteles.

Valor: Identificador entregado en la respuesta de reserva

Hotels No
Hotel Si
BookingReference Si Atributos:

- ReferenceType: Tipo de referencia, por ejemplo OLA.GBL.BRT.HTL – Referencia de reserva de hoteles.

Valor: Identificador entregado en la respuesta de reserva

      • Respuesta:

<syntaxhighlight lang="xml"> <BookingCancellationRS> 

  <Details>
     <Bookings ItemsCount="1">
        <Booking>
           <BookingReference ReferenceType="NMO.GBL.BRT.NAV" Sequence="1">QN_006OF</BookingReference>
           <BookingState>NMO.GBL.BST.CAN</BookingState>
           <Products>
              <Hotels ItemsCount="1">
                 <Hotel Sequence="1">
                    <BookingReferences ItemsCount="1">
                       <BookingReference ReferenceType="NMO.GBL.BRT.NAV" Sequence="1">QN_006OF-1</BookingReference>
                    </BookingReferences>
                    <BookingState Code="NMO.HTL.BST.CAN">NMO.HTL.BST.CAN</BookingState>
                 </Hotel>
              </Hotels>
              <Passengers ItemsCount="0"/>
           </Products>
        </Booking>
     </Bookings>
  </Details>

</BookingCancellationRS> </syntaxhighlight>


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.
Details Si
Bookings Si
Booking Si Detalle de la reserva.

Atributos:

- BookingReference: identificador de la reserva.

- BookingState: estado de la reserva

ReceivedFrom Si Nombre de la persona que firma los cambios de la reserva.
BookingState No Estado de la reserva (del ítem). La codificación de los estados será provista por Nemo.
Hotels No
Hotel Si
BookingReferences No Identificadores de la resera.
BookingState No Estado actual de la reserva.

BookingStateCode: Código del estado de la reserva correspondiente a los códigos estándar de reserva provistos por Nemo.

Fares Si Datos de tarifas
FareType No Tipo de tarifas, ej. Tarifa web, precio de agencia
Prices Si Precios, con valor y moneda
BookingReferences No Identificadores de la reserva
BookingState Si Estado de la reserva (del ítem). La codificación de los estados será provista por Nemo.

Atributos:

Code: Código del estado (confirmada, rechazada, etc)

Passenger No Datos de los pasajeros.

Atributos:

AgeType: tipo de pasajero (chl, inf, adt).

Sequence: Este dato será asociado al PassengerSequence del nodo Guest en hoteles.

Exceptions Si Si no se puede armar el nodo Details se arma un nodo Exceptions con las notificaciones correspondientes.

Consulta de Reserva (BookingQuery)

Consulta de información y detalles sobre una o varias reservas realizadas. Request: BookingQueryRQ Response: BookingQueryRS

Ejemplo de uso:

      • Solicitud:

<syntaxhighlight lang="xml"> <BookingQueryRQ> <GeneralParameters> <PreferedLanguage LanguageCode="es"/> <PreferedCurrency CurrencyCode="ARS"/> </GeneralParameters> <Bookings ItemsCount="1"> <Booking BookingReference="QN_006OF" Sequence="1"/> </Bookings> </BookingQueryRQ> </syntaxhighlight>


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

Atributos:

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

Bookings Si Mediante el nodo Booking se cargan las reservas a consultar.

Atributos:

BookingReference: identificador de la reserva a consultar.

      • Respuesta:

<syntaxhighlight lang="xml"> <BookingQueryRS> 

  <Details>
     <Bookings ItemsCount="1">
        <Booking Sequence="1">
           <BookingReference>QN_006OF</BookingReference>
           <BookingState>NMO.GBL.BST.CAN</BookingState>
           <Products>
              <Hotels ItemsCount="1">
                 <Hotel Sequence="1" HotelCode="7590" SupplierID="MIK">
                    <BookingReferences ItemsCount="2">
                       <BookingReference Sequence="1" ReferenceType="NMO.HTL.RPT.MPH">QN_006OF-1</BookingReference>
                       <BookingReference Sequence="2" ReferenceType="NMO.HTL.RPT.PRS">E00166024</BookingReference>
                    </BookingReferences>
                    <BookingStatusList ItemsCount="1">
                       <BookingStatus Sequence="1">
                          <BookingStatusDescription BookingStatusCode="NMO.HTL.BST.CAN">Cancelado</BookingStatusDescription>
                          <BookingStatusTime>09:19:34.048-03:00</BookingStatusTime>
                          <RulesInfo ItemsCount="4">
                             <RuleInfo Sequence="1" Permit="true" RuleType="NMO.GBL.RBS.DET"/>
                             <RuleInfo Sequence="2" Permit="false" RuleType="NMO.GBL.RBS.VOU"/>
                             <RuleInfo Sequence="3" Permit="false" RuleType="NMO.GBL.RBS.CAN"/>
                             <RuleInfo Sequence="4" Permit="false" RuleType="NMO.GBL.RBS.PAY"/>
                          </RulesInfo>
                       </BookingStatus>
                    </BookingStatusList>
                    <Hotel Sequence="1" SupplierID="MIK" HotelCode="7590">
                       <HotelName>Days Hotel London North</HotelName>
                       <HotelDescriptions ItemsCount="1">
                          <HotelDescription Sequence="1" HotelDescriptionType="General">Este hotel de 3 estrellas esta situado a las afueras de London y el año de apertura fue 2002. Esta a poca distancia en coche de Wembley Stadium y la estación más cercana es Edgware. El hotel tiene un restaurante, un bar, un salón de convenciones y una cafeteria. Las 193 habitaciones estan equipadas con secador de pelo, caja de seguridad y aire acondicionado.</HotelDescription>
                       </HotelDescriptions>
                       <LocationDetails ItemsCount="1">
                          <Location Sequence="1" LocationCode="G8">Area suburbana</Location>
                       </LocationDetails>
                       <Amenities ItemsCount="10">
                          <Amenity Fee="No" Sequence="1">
                             <AmenityGroup AmenityGroupCode="NMO.HTL.AMT.HTL">Hotel</AmenityGroup>
                             <Description AmenityCode="14">Ascensores</Description>
                             <ImageLink>
                                <ImageDescription ImageDisplayType="NMO.GBL.IMG.IMG">Ascensores</ImageDescription>
                                <ImageURL>ic_elevador.gif</ImageURL>
                             </ImageLink>
                          </Amenity>
                          <Amenity Fee="No" Sequence="2">
                             <AmenityGroup AmenityGroupCode="NMO.HTL.AMT.FCL">Instalaciones</AmenityGroup>
                             <Description AmenityCode="5">Caja de seguridad</Description>
                          </Amenity>
                          <Amenity Fee="No" Sequence="3">
                             <AmenityGroup AmenityGroupCode="NMO.HTL.AMT.HTL">Hotel</AmenityGroup>
                             <Description AmenityCode="32">Tiro al Arco</Description>
                          </Amenity>
                          <Amenity Fee="No" Sequence="4">
                             <AmenityGroup AmenityGroupCode="NMO.HTL.AMT.FCL">Instalaciones</AmenityGroup>
                             <Description AmenityCode="7">Guardarropa</Description>
                             <Value>193</Value>
                          </Amenity>
                          <Amenity Fee="No" Sequence="5">
                             <AmenityGroup AmenityGroupCode="NMO.HTL.AMT.FCL">Instalaciones</AmenityGroup>
                             <Description AmenityCode="18">Sala de conferencias</Description>
                          </Amenity>
                          <Amenity Fee="No" Sequence="6">
                             <AmenityGroup AmenityGroupCode="NMO.HTL.AMT.HTL">Hotel</AmenityGroup>
                             <Description AmenityCode="117">Se permite animales domésticos</Description>
                          </Amenity>
                          <Amenity Fee="No" Sequence="7">
                             <AmenityGroup AmenityGroupCode="NMO.HTL.AMT.HTR">Habitación</AmenityGroup>
                             <Description AmenityCode="4">Secador</Description>
                          </Amenity>
                          <Amenity Fee="No" Sequence="8">
                             <AmenityGroup AmenityGroupCode="NMO.HTL.AMT.HTR">Habitación</AmenityGroup>
                             <Description AmenityCode="34">Aire acondicionado</Description>
                             <ImageLink>
                                <ImageDescription ImageDisplayType="NMO.GBL.IMG.IMG">Aire acondicionado</ImageDescription>
                                <ImageURL>ic_aireac.gif</ImageURL>
                             </ImageLink>
                          </Amenity>
                          <Amenity Fee="No" Sequence="9">
                             <AmenityGroup AmenityGroupCode="NMO.HTL.AMT.HTR">Habitación</AmenityGroup>
                             <Description AmenityCode="237">television</Description>
                          </Amenity>
                          <Amenity Fee="No" Sequence="10">
                             <AmenityGroup AmenityGroupCode="NMO.HTL.AMT.HTR">Habitación</AmenityGroup>
                             <Description AmenityCode="8">Radio</Description>
                          </Amenity>
                       </Amenities>
                       <Addresses ItemsCount="1">
                          <Address Sequence="1">
                             <AddressLines ItemsCount="3">
                                <AddressLine Sequence="1">London Gateway, Services</AddressLine>
                                <AddressLine Sequence="2">London</AddressLine>
                                <AddressLine Sequence="3">U.k.</AddressLine>
                             </AddressLines>
                             <TelephoneNumbers ItemsCount="2">
                                <TelephoneNumber Sequence="1">
                                   <TelephoneNumberType TelephoneNumberType="NMO.GBL.TLT.TE1"/>
                                   <TelephoneNumberValue>020 89067000</TelephoneNumberValue>
                                </TelephoneNumber>
                                <TelephoneNumber Sequence="2">
                                   <TelephoneNumberType TelephoneNumberType="NMO.GBL.TLT.FAX"/>
                                   <TelephoneNumberValue>020 89067011</TelephoneNumberValue>
                                </TelephoneNumber>
                             </TelephoneNumbers>
                             <Destinations ItemsCount="4">
                                <Destination Sequence="1" DestinationType="NMO.HTL.DST.CTY" DestinationCode="2757">Londres</Destination>
                                <Destination Sequence="2" DestinationType="NMO.HTL.DST.CTR" DestinationCode="143">Reino Unido</Destination>
                                <Destination Sequence="3" DestinationType="NMO.HTL.DST.CNT" DestinationCode="12">Europa</Destination>
                                <Destination Sequence="4" DestinationType="NMO.HTL.DST.ALL" DestinationCode="1">Planeta Tierra</Destination>
                             </Destinations>
                          </Address>
                       </Addresses>
                       <Position>
                          <Latitude>51.634681</Latitude>
                          <Longitude>-0.26438</Longitude>
                       </Position>
                       <HotelRating HotelRatingCode="NMO.HTL.RTN.3ST" HotelRatingType="NMO.HTL.RTT.STR">
                          <RatingDescription>3 Estrellas</RatingDescription>
                          <RatingValue>3.0</RatingValue>
                       </HotelRating>
                       <ImageLinks ItemsCount="6">
                          <ImageLink Sequence="1">
                             <ImageDescription ImageDisplayType="NMO.GBL.IMG.IMG">Exterior view</ImageDescription>
                             <ImageHeight UnitOfMeasureCode="9">46</ImageHeight>
                             <ImageWidth UnitOfMeasureCode="9">70</ImageWidth>
                             <ImageURL>B/6/B6E5222965FCD939B8967908EE909116.jpg</ImageURL>
                             <ThumbnailURL>4/3/43081546B80C1F2361A934E91E0B83F4.jpg</ThumbnailURL>
                          </ImageLink>
                          <ImageLink Sequence="2">
                             <ImageDescription ImageDisplayType="NMO.GBL.IMG.IMG">Standard bedroom</ImageDescription>
                             <ImageHeight UnitOfMeasureCode="9">46</ImageHeight>
                             <ImageWidth UnitOfMeasureCode="9">70</ImageWidth>
                             <ImageURL>B/A/BA1FE7678A1DBABF62BB877A92B31404.jpg</ImageURL>
                             <ThumbnailURL>D/2/D2CEAE049DA3A5D2D1F8C6CC1F911B67.jpg</ThumbnailURL>
                          </ImageLink>
                          <ImageLink Sequence="3">
                             <ImageDescription ImageDisplayType="NMO.GBL.IMG.IMG">Standard bedroom</ImageDescription>
                             <ImageHeight UnitOfMeasureCode="9">46</ImageHeight>
                             <ImageWidth UnitOfMeasureCode="9">70</ImageWidth>
                             <ImageURL>F/7/F73A5A01DACC93E47CC6ECA33071A1A5.jpg</ImageURL>
                             <ThumbnailURL>9/1/914733863EFF6EC19D48A23ED5AE697C.jpg</ThumbnailURL>
                          </ImageLink>
                          <ImageLink Sequence="4">
                             <ImageDescription ImageDisplayType="NMO.GBL.IMG.IMG">Standard bedroom</ImageDescription>
                             <ImageHeight UnitOfMeasureCode="9">46</ImageHeight>
                             <ImageWidth UnitOfMeasureCode="9">70</ImageWidth>
                             <ImageURL>5/E/5EBE1CC8E1840C121C4BF0FBF40B6DCB.jpg</ImageURL>
                             <ThumbnailURL>2/E/2EA36573BCE916FAFC09A32A590DBF1E.jpg</ThumbnailURL>
                          </ImageLink>
                          <ImageLink Sequence="5">
                             <ImageDescription ImageDisplayType="NMO.GBL.IMG.IMG">Restaurant</ImageDescription>
                             <ImageHeight UnitOfMeasureCode="9">46</ImageHeight>
                             <ImageWidth UnitOfMeasureCode="9">70</ImageWidth>
                             <ImageURL>F/0/F07D742D7500E4C1315EA73B6449861E.jpg</ImageURL>
                             <ThumbnailURL>E/A/EA1A7F0CE29E848589485A346F35B81F.jpg</ThumbnailURL>
                          </ImageLink>
                          <ImageLink Sequence="6">
                             <ImageDescription ImageDisplayType="NMO.GBL.IMG.IMG">Bar</ImageDescription>
                             <ImageHeight UnitOfMeasureCode="9">46</ImageHeight>
                             <ImageWidth UnitOfMeasureCode="9">70</ImageWidth>
                             <ImageURL>F/5/F577413868BD10E0413F903462BFEA4B.jpg</ImageURL>
                             <ThumbnailURL>4/9/491197FA9F74F1DE30FB7D0FBBE29348.jpg</ThumbnailURL>
                          </ImageLink>
                       </ImageLinks>
                    </Hotel>
                    <DestinationDetails ItemsCount="4">
                       <Destination Sequence="1" DestinationType="NMO.HTL.DST.CTY" DestinationCode="2757">Londres</Destination>
                       <Destination Sequence="2" DestinationType="NMO.HTL.DST.CTR" DestinationCode="143">Reino Unido</Destination>
                       <Destination Sequence="3" DestinationType="NMO.HTL.DST.CNT" DestinationCode="12">Europa</Destination>
                       <Destination Sequence="4" DestinationType="NMO.HTL.DST.ALL" DestinationCode="1">Planeta Tierra</Destination>
                    </DestinationDetails>
                    <CheckIn>2013-12-20-03:00</CheckIn>
                    <CheckOut>2013-12-22-03:00</CheckOut>
                    <Rate>
                       <Rooms ItemsCount="1">
                          <Room Sequence="1">
                             <RoomDescription RoomType="NMO.HTL.RMT.SGL">Simple</RoomDescription>
                             <Occupancy>
                                <AdultsCount>1</AdultsCount>
                                <ChildrenCount>0</ChildrenCount>
                                <InfantCount>0</InfantCount>
                                <RoomsCount>1</RoomsCount>
                                <Passengers ItemsCount="1">
                                   <Passenger Sequence="1" AgeType="NMO.GBL.AGT.ADT">
                                      <PersonNames ItemsCount="2">
                                         <PersonName Sequence="1" NameType="NMO.GBL.PNT.FIR">NOMBRE</PersonName>
                                         <PersonName Sequence="2" NameType="NMO.GBL.PNT.LAS">APELLIDO</PersonName>
                                      </PersonNames>
                                   </Passenger>
                                </Passengers>
                             </Occupancy>
                             <Availability AvailabilityCode="NMO.HTL.AVB.CNF">Confirmación Inmediata</Availability>
                          </Room>
                       </Rooms>
                       <Boards ItemsCount="1">
                          <Board Sequence="1" BoardType="BreakfastDescription" BoardCode="60">Desayuno incluido</Board>
                       </Boards>
                       <RatePrices ItemsCount="3">
                          <RatePrice Sequence="1" Currency="ARS" Type="NMO.HTL.RPT.NET">0.0</RatePrice>
                          <RatePrice Sequence="2" Currency="EUR" Type="NMO.HTL.RPT.NBC">0.0</RatePrice>
                          <RatePrice Sequence="3" Currency="ARS" Type="NMO.GBL.RPT.GRS">0.0</RatePrice>
                       </RatePrices>
                       <ChargeConditions ItemsCount="2">
                          <ChargeCondition Sequence="1">
                             <ChargeDescription ChargeType="NMO.HTL.CHT.CAN">Gastos de cancelación</ChargeDescription>
                             <DateRangeWithDays>
                                <DateFrom>0</DateFrom>
                                <DateTo>2</DateTo>
                             </DateRangeWithDays>
                             <RatePrices ItemsCount="3">
                                <RatePrice Sequence="1" Currency="ARS" Type="NMO.HTL.RPT.NET">194.90930368636631</RatePrice>
                                <RatePrice Sequence="2" Currency="EUR" Type="NMO.HTL.RPT.NBC">33.31</RatePrice>
                                <RatePrice Sequence="3" Currency="ARS" Type="NMO.GBL.RPT.GRS">194.90930368636631</RatePrice>
                             </RatePrices>
                          </ChargeCondition>
                          <ChargeCondition Sequence="2">
                             <ChargeDescription ChargeType="NMO.HTL.CHT.CAN">Gastos de cancelación</ChargeDescription>
                             <DateRangeWithDays>
                                <DateFrom>0</DateFrom>
                                <DateTo>1</DateTo>
                             </DateRangeWithDays>
                             <RatePrices ItemsCount="3">
                                <RatePrice Sequence="1" Currency="ARS" Type="NMO.HTL.RPT.NET">389.81860737273263</RatePrice>
                                <RatePrice Sequence="2" Currency="EUR" Type="NMO.HTL.RPT.NBC">66.62</RatePrice>
                                <RatePrice Sequence="3" Currency="ARS" Type="NMO.GBL.RPT.GRS">389.81860737273263</RatePrice>
                             </RatePrices>
                          </ChargeCondition>
                       </ChargeConditions>
                       <Deadline>
                          <Date>2013-12-15T00:00:00.000-03:00</Date>
                       </Deadline>
                    </Rate>
                    <BookingCreationDT>2013-07-30T09:18:52.000-03:00</BookingCreationDT>
                 </Hotel>
              </Hotels>
           </Products>
        </Booking>
     </Bookings>
  </Details>

</BookingQueryRS> </syntaxhighlight>


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.
Details Si
Bookings Si
Booking Si Detalle de la reserva.

Atributos:

  • BookingReference: identificador de la reserva.
  • BookingState: estado de la reserva
ReceivedFrom Si Nombre de la persona que firma los cambios de la reserva.
BookingState No Estado de la reserva (del ítem). La codificación de los estados será provista por Nemo.
Hotel Si
BookingReferences No Identificadores de la resera.
BookingStatusList No Estados del “ítem”.
BookingStatus Si
BookingStatusDescription Si Descripción del estado actual de la reserva.

BookingStatusCode: Código del estado de la reserva correspondiente a los códigos estándar de reserva provistos por Nemo.

Hotel No Contiene toda la información del hotel.
HotelName Si Nombre del hotel.
AccomodationType No Indica si es hotel, hostel, camping, etc, los tipos serán provistos por Nemo.
HotelDescriptions No
HotelDescription Si Descripción del hotel.

Atributos:

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

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 No
Amenity No Código de amenidad admitido.

Atributos:

AmenityGroupCode: Tipo de amenidad. Los tipos de amenidad admitidos corresponden a los provistos por Nemo.

AmenityCode: Código de amenidad. Los códigos de amenidad admitidos corresponden a los provistos.

Address Si Dirección del hotel
AddressLines Si Líneas que componen la dirección del hotel.
AddressLine Si Indica la dirección del hotel.
Position No Coordenadas del hotel: Latitud y Longitud.
HotelRating Si 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 Si Valoración de la categoría del hotel expresada en el tipo de categoría indicado en el nodo padre.
ImageLinks Si Conjunto de imágenes del hotel
ImageLink No
ImageDescription Si 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 Si URL de la imagen
DestinationDetails Si Atributos:

DestinationType: tipo de destino de los provistos por Nemo.

Destination Code: código del destino a buscar, de los provistos por Nemo.

CheckIn No Fecha de entrada de la estadía.
CheckOut No Fecha de salida de la estadía
Rate Si Tarifa a reservar, indicando con el atributo TripProductId el id del hotel a reservar.
Rooms No
Room Si
Occupancy Si Indica la cantidad de adultos, niños e infantes por cada habitación.

En el nodo Passengers se encuentran los datos de los pasajeros.

Fares Si Datos de tarifas
FareType No Tipo de tarifas, ej. Tarifa web, precio de agencia
Prices Si Precios, con valor y moneda
BookingReferences No Identificadores de la reserva
BookingState Si Estado de la reserva (del ítem). La codificación de los estados será provista por Nemo.

Atributos:

Code: Código del estado (confirmada, rechazada, etc)

Exceptions Si Si no se puede armar el nodo Details se arma un nodo Exceptions con las notificaciones correspondientes.
ChargeConditions Si Nodo de gastos de cancelación
ChargeCondition Si Gasto de Cancelación

Atributo:

ChargeType, tipo de cargo (Ej. NMO.HTL.CHT.CAN cancelación, NMO.HTL.CHT.AMD Modificación)

ChargeDescription Si Descripción del gastos de cancelación
DateRangeWithDays No Indica que el gasto de cancelación tiene un rango en base a días.
DateFrom Si Fecha desde
DateTo Si Fecha hasta
DateRangeWithDateType No Indica que el gasto de cancelación tiene un rango en base a fechas.
DateFrom Si Fecha desde
DateTo Si Fecha hasta
RatePrices Si
RatePrice Si Indica el importe del concepto de cancelación

Atributos:

RatePriceType, tipo de precio

Lenguaje de Descripción de la Aplicación Web (WADL)

Utilizando la especificación provista por Price Surfer los Clientes podrán acceder al catálogo de los servicios y recursos provistos en la API.

Especificaciones y recomendaciones

Autorización

Para acceder a las operaciones propias del servicio web será necesario el uso de credenciales por medio de un hash que actúa como Token de Autorización. El servicio utilizará para esto una cabecera especial denominada "X-PS-AUTHTOKEN" la cuál actuará como clave de seguridad interna para establecer la comunicación entre el sistema y el usuario.

Ejemplo de cabecera

  • Solicitud

<syntaxhighlight lang="xml"> POST http://service-cert.psurfer.net/pricesurfer/catalog/products/search HTTP/1.1 Accept-Encoding: gzip,deflate Accept: application/xml Content-Type: application/xml X-PS-AUTHTOKEN: 981d284d_bc57_c429_91b9_178fg07f78f0 Content-Length: 770 Host: http://service-cert.psurfer.net Connection: Keep-Alive User-Agent: Apache-HttpClient/4.1.1 (java 1.5) </syntaxhighlight>

  • Respuesta

<syntaxhighlight lang="xml"> HTTP/1.1 200 OK X-Powered-By: Servlet/3.0 Server: GlassFish Server Open Source Edition 3.0.1 Content-Type: application/xml Transfer-Encoding: chunked Content-Encoding: gzip Vary: Accept-Encoding Date: Wed, 31 Jul 2013 10:39:32 GMT </syntaxhighlight>

TransactionMode Sincrónico y Asincrónico

Este modo se utiliza para Hoteles.

  • Sincrónico: TransactionMode="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. Esta es el método que utiliza la plataforma de PriceSurfer hsata este momento.

  • Asincrónico: TransactionMode="StartAsync" y "ContinueAsync"

En este modo deberá iniciarse una búsqueda con el modo "StartAsync". La búsqueda termina cuando termine el primer proveedor, o sea el más rápido. El resto de los resultados se obtendrán con subsecuentes búsquedas pero con el modo "ContinueAsync".

Cada respuesta a este mensaje contiene un nodo "TransactionStatus" que se encuentra en la respuesta de Hoteles: {AvailabilityQueryRS//Details/Trips/TripList[n]/HotelsAvailabilityResponset/TransactionStatus} y su valor puede ser FINISHED, TIMEOUT o CONTINUE.

  • FINISHED: significa que no hay más datos. Ésta es la última respuesta.
  • TIMEOUT: significa que no hay más datos. Ésta es la última respuesta. La diferencia con FINISHED es que ha terminado con algún error en un proveedor y el mismo no pudo terminar el proceso.
  • CONTINUE: significa que hay más datos de disponibilidad de hoteles. Debe seguir haciendo peticiones en modo "ContinueAsync" para obtener más resultados.

Archivos adicionales

Para poder consultar disponibilidad en los hoteles necesitará de códigos de destinos, habitaciones, etc. Estos códigos son provistos por Price Surfer en esta sección.

Tipos de Habitaciones

Para indicar la ocupación en la búsqueda es necesario colocar un tipo de habitación.

Los tipos de habitaciones válidas son las siguientes:

  • NMO.HTL.RMT.SGL habitación simple, cantidad de pasajeros=1.
  • NMO.HTL.RMT.DBL habitación doble, cantidad de pasajeros=2.
  • NMO.HTL.RMT.DBL.TWN habitación doble twin, cantidad de pasajeros=2.
  • NMO.HTL.RMT.DBL.TSU habitación doble de uso individual, cantidad de pasajeros=1.
  • NMO.HTL.RMT.TPL habitación triple, cantidad de pasajeros=3.
  • NMO.HTL.RMT.QUA habitación para 4 pasajeros.
  • NMO.HTL.RMT.PEN habitación para 5 pasajeros.
  • NMO.HTL.RMT.HEX habitación para 6 pasajeros.
  • NMO.HTL.RMT.SEP habitación para 7 pasajeros.
  • NMO.HTL.RMT.OCT habitación para 8 pasajeros.
  • NMO.HTL.RMT.NON habitación para 9 pasajeros.


Algunos proveedores entregan un tipo de habitación diferente al propuesto en la búsqueda. Estoas tipos de habitaciones son traducidos a un tipo de Price Surfer.

El listado completo de tipos de habitación está disponible aquí:


Destinos

Listado de destinos de Price Surfer:

Obtenido de «https://wiki.psurfer.net/index.php?title=Price_Surfer_-_Web_Services&oldid=1681»