Diferencia entre revisiones de «Price Surfer - Web Services»

De Wiki PriceSurfer
Ir a la navegaciónIr a la búsqueda
 
(No se muestran 217 ediciones intermedias de 6 usuarios)
Línea 6: Línea 6:
 
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.
 
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.  
+
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.
 +
 
 +
 
 +
'''IMPORTANTE:
 +
 
 +
'''A partir de Octubre 2022 es requerida una lista de IPs habilitadas para poder operar, las IP que no sean informadas como autorizadas serán bloqueadas impidiendo la operatoria.
  
 
== Propósito del presente documento ==
 
== Propósito del presente documento ==
Línea 12: Línea 17:
  
 
== Implementación ==  
 
== Implementación ==  
Con este manual usted recibirá de Price Surfer una serie de credenciales de prueba para utilizar durante el proceso de integración del servicio con su aplicación web, usted deberá proveernos además las IP públicas desde las que se conectará al servicio para autorizarlas ya que este validará su IP contra esas credenciales recibidas con cada mensaje. Luego de completada la integración deberá contactarnos nuevamente para solicitar una revisión para la certificación final de su sitio.
+
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,
Además de las credenciales provistas junto con los ejemplos de implementación recibirá una descripción de los servicios provistos bajo WADL, el equivalente REST del Lenguaje de Descripción de Web Services (WSDL). Dependiendo el lenguaje con el que implemente la interfaz de integración podrá utilizar esta descripción para generar los mensajes en base a una jerarquía de clases auto-generada. En los ejemplos provistos encontrará implementaciones con Java - XMLBeans.
+
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.
 
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.
 +
 +
El uso de dichas credenciales excluye la posibilidad de aplicarlas para otros fines como trabajar con un robot que realice búsquedas de disponibilidad para obtener tarifas y almacenarlas u otra tarea no especificada en este documento; reservando a Price Surfer el derecho de deshabilitar dicho usuario.
 +
Cualquier cambio que se desee realizar deberá ser notificado y aprobado con anticipación.
 +
 +
Documentos de Certificacion a utilizar en los Webservices de hoteles se encuentran disponibles:
 +
* Idioma español: http://wiki.psurfer.net/resources/CertificacionWS.docx
 +
* Idioma ingles: http://wiki.psurfer.net/resources/Certification_WS_en.docx
  
 
== Interfaz Cliente simplificada ==
 
== Interfaz Cliente simplificada ==
Línea 24: Línea 39:
 
* Se provee un mecanismo más eficiente para el manejo de mensajes asíncronos mediante la tecnología “Push”
 
* Se provee un mecanismo más eficiente para el manejo de mensajes asíncronos mediante la tecnología “Push”
  
 +
== API REFERENCE - Entornos y Operaciones ==
  
== Lista de Mensajes Soportados por el Servicio ==
+
Los entornos disponibles son:
  
=== Búsqueda de Disponibilidad de Hoteles (AvailabilityQueryRQ) ===
+
* Produccion: http://service.psurfer.net/pricesurfer/
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.
 
Recibe AvailabilityQueryRQ, retorna AvailabilityQueryRS.
 
  
=== Confirmación de Disponibilidad de una Tarifa obtenida en una Búsqueda Anterior (AvailabilityValidation) ===
+
* Certificacion: http://service-cert.psurfer.net/pricesurfer/
Confirma la vigencia de una tarifa provista por una consulta de disponibilidad previa.
 
Recibe AvailabilityQueryRQ, retorna AvailabilityQueryRS.
 
  
=== Consulta de Información de un Hotel (AdditionalInfoQuery) ===
 
Consulta la información y detalles para un hotel provisto por el proveedor.
 
Recibe  AditionalInfoQueryRQ, retorna  AditionalInfoQueryRS.
 
  
=== Consulta de Gastos de Cancelación para una o varias Tarifas ó Reservas (CancellationFeesQuery) ===
+
Las siguientes operaciones están disponibles en la API del servicio, para búsquedas y reservas de Hoteles:
Consulta de condiciones de gastos de cancelación sobre una o más tarifas o reservas reportadas.
+
* /catalog/products/search
Recibe CancellationFeesQueryRQ , retorna CancellationFeesQueryRS.
+
* /catalog/product/detail
 +
* /catalog/product/validate
 +
* /catalog/product/book
 +
* /booking/cancellation/fees
 +
* /booking/detail
 +
* /booking/cancel
  
=== Reserva de Tarifa (BookingProducts) ===
 
Solicitud de reserva para una o varias tarifas de hoteles.
 
Recibe BookingProductsRQ, retorna BookingProductsRS
 
  
=== Consulta de Reserva (BookingQuery) ===
+
Ejemplo de endpoint de busqueda en Entorno de Certificacion:
Consulta de información y detalles sobre una o varias reservas realizadas.
+
* http://service-cert.psurfer.net/pricesurfer/catalog/products/search
Recibe hotelBookingServiceDetailRQ, retorna hotelBookingServiceDetailRS
 
  
=== Cancelación de Reserva (BookingCancellation) ===
 
Solicitud de cancelación de una o varias reservas realizadas.
 
Recibe BookingCancellationRQ, retorna BookingCancellationRS.
 
  
== Escenario básico de una operación de reserva ==
+
Todas las operaciones tienen un POST con el siguiente esquema:
  
[[Archivo:bookingwikijpg1_v1.jpg]]
+
'''POST'''
  
== Especificación de documentos XML ==
+
'''Request Body'''
 +
:media types:
 +
::''application/xml''
  
=== Búsqueda de Disponibilidad de Hoteles (AvailabilityQuery) ===
+
'''Response Body'''
 +
:media types:
 +
::''application/xml''
  
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
+
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.
  
Ejemplo de uso:
+
Por ejemplo, en linux desde la consola con bash podemos probar la conexión y los parámetros necesarios haciendo:
  
*** Solicitud:
 
<syntaxhighlight lang="xml">
 
<AvailabilityQueryRQ TransactionId="da9a0fcc_7bd9_48f9_8386_4079a7a6c66c" TransactionMode="Synchronous">
 
<GeneralParameters>
 
<PreferedLanguage LanguageCode="es"/>
 
<PreferedCurrency CurrencyCode="ARS"/>
 
</GeneralParameters>
 
<Trips ItemsCount="2">
 
<Trip Sequence="1">
 
<Destination>2757</Destination>
 
<ProductsParameters>
 
<HotelsParameters>
 
<Criterion>
 
<Rooms ItemsCount="2">
 
<Room RoomType="NMO.HTL.RMT.SGL" Sequence="1"/>
 
</Rooms>
 
<CheckIn>2013-12-20</CheckIn>
 
<CheckOut>2013-12-22</CheckOut>
 
</Criterion>
 
</HotelsParameters>
 
</ProductsParameters>
 
</Trip>
 
</Trips>
 
<Passengers ItemsCount="1">
 
<Passenger AgeType="NMO.GBL.AGT.ADT" Sequence="1" RoomSequence="1"/>
 
</Passengers>
 
</AvailabilityQueryRQ>
 
</syntaxhighlight>   
 
  
 +
<code>
 +
  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"
 +
</code>
  
 +
Esto conectará al Web Service y hará un pedido de disponibilidad de productos.
  
{| class="wikitable sortable"
+
Deberá existir el archivo AvailabilityQueryRQ.xml que contendrá un xml como por ejemplo el presentado más abajo.
|-
 
! 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:
+
La respuesta se guardará en el archivo result.xml.
  
LanguageCode: Código de lenguaje correspondiente a los códigos de lenguaje estándar provistos por Nemo.
+
El valor la cabecera '''X-PS-AUTHTOKEN''' 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.
|-
 
| 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.
+
Para aumentar la velocidad de respuesta desde el servidor del WebService hasta el cliente, se recomienda agregar en la cabecera HTTP la solicitud de compresión de la respuesta, en el ejemplo con ''curl'' anterior se agregaría:
|-
+
<code>-H "Accept-Encoding: gzip" \</code>
| 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 entrada de la estadía.
 
|-
 
| CheckOut || Si || Fecha de salida de la estadía
 
|-
 
| Rooms || Si || Información sobre las habitaciones solicitadas.
 
|-
 
| Room || Si || Identifica una habitación en los parámetros de la búsqueda.
 
  
Atributos:
 
  
RoomType: Tipo de habitación. Los tipos de habitación admitidos corresponden a los provistos por Nemo.
+
=== Flujo de Mensajes para la correcta implementación del Servicio ===
|-
 
| 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).
 
|-
 
| 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:
+
[[Archivo:Flujo.jpg|722px]]
<syntaxhighlight lang="xml">
 
<AvailabilityQueryRS TransactionId="da9a0fcc_7bd9_48f9_8386_4079a7a6c66c" TransactionMode="Synchronous">
 
  <Echo TransactionId="da9a0fcc_7bd9_48f9_8386_4079a7a6c66c" TransactionMode="Synchronous">
 
      <GeneralParameters>
 
        <PreferedLanguage LanguageCode="es"/>
 
        <PreferedCurrency CurrencyCode="ARS"/>
 
      </GeneralParameters>
 
      <Trips ItemsCount="2">
 
        <Trip Sequence="1">
 
            <Destination>2757</Destination>
 
            <ProductsParameters>
 
              <HotelsParameters>
 
                  <Criterion>
 
                    <Rooms ItemsCount="2">
 
                        <Room RoomType="NMO.HTL.RMT.SGL" Sequence="1"/>
 
                    </Rooms>
 
                    <CheckIn>2013-12-20</CheckIn>
 
                    <CheckOut>2013-12-22</CheckOut>
 
                  </Criterion>
 
              </HotelsParameters>
 
            </ProductsParameters>
 
        </Trip>
 
      </Trips>
 
      <Passengers ItemsCount="1">
 
        <Passenger AgeType="NMO.GBL.AGT.ADT" Sequence="1" RoomSequence="1"/>
 
      </Passengers>
 
  </Echo>
 
  <Details>
 
      <Trips ItemsCount="1">
 
        <Trip Sequence="1">
 
            <HotelsAvailability>
 
              <Responset>
 
                  <Pagination>
 
                    <CurrentPage>1</CurrentPage>
 
                    <ItemPerPage>2</ItemPerPage>
 
                    <TotalItems>2</TotalItems>
 
                  </Pagination>
 
              </Responset>
 
              <Summary>
 
                  <Locations ItemsCount="2">
 
                    <Location Sequence="1" LocationCode="G1000">General</Location>
 
                    <Location Sequence="2" LocationCode="G8">Area suburbana</Location>
 
                  </Locations>
 
              </Summary>
 
              <Hotels ItemsCount="2">
 
                  <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" Sequence="1"/>
 
                        <Amenity Code="5" GroupCode="NMO.HTL.AMT.FCL" Sequence="2"/>
 
                        <Amenity Code="32" GroupCode="NMO.HTL.AMT.HTL" Sequence="3"/>
 
                        <Amenity Code="7" GroupCode="NMO.HTL.AMT.FCL" Sequence="4"/>
 
                        <Amenity Code="18" GroupCode="NMO.HTL.AMT.FCL" Sequence="5"/>
 
                        <Amenity Code="117" GroupCode="NMO.HTL.AMT.HTL" Sequence="6"/>
 
                        <Amenity Code="4" GroupCode="NMO.HTL.AMT.HTR" Sequence="7"/>
 
                        <Amenity Code="34" GroupCode="NMO.HTL.AMT.HTR" Sequence="8"/>
 
                        <Amenity Code="237" GroupCode="NMO.HTL.AMT.HTR" Sequence="9"/>
 
                        <Amenity Code="8" GroupCode="NMO.HTL.AMT.HTR" Sequence="10"/>
 
                    </Amenities>
 
                    <DestinationDetails ItemsCount="4">
 
                        <Destination Code="2757" Type="NMO.HTL.DST.CTY" Sequence="1"/>
 
                        <Destination Code="143" Type="NMO.HTL.DST.CTR" Sequence="2"/>
 
                        <Destination Code="12" Type="NMO.HTL.DST.CNT" Sequence="3"/>
 
                        <Destination Code="1" Type="NMO.HTL.DST.ALL" Sequence="4"/>
 
                    </DestinationDetails>
 
                    <Rates ItemsCount="1">
 
                        <Rate Offer="false" RateID="3727c45dbdafe53764a781ea39d8bd28#0" Sequence="1"
 
TripProductID="fef501f1-962d-40e8-84eb-42373a0e343f">
 
                          <Rooms>
 
                              <Room Availability="CNF" Sequence="1" Type="SGL">Simple</Room>
 
                          </Rooms>
 
                          <Boards ItemsCount="1">
 
                              <Board Sequence="1" Type="Basis" Code="60">Desayuno incluido</Board>
 
                          </Boards>
 
                          <RatePrices ItemsCount="1">
 
                              <RatePrice Sequence="1" 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 Sequence="1">London Gateway, Services</Line>
 
                        <Line Sequence="2">London</Line>
 
                        <Line Sequence="3">U.k.</Line>
 
                    </Address>
 
                    <LocationDetails>
 
                        <Location Sequence="1" LocationCode="G8">Area suburbana</Location>
 
                    </LocationDetails>
 
                    <ImageLinks>
 
                        <ImageLink Sequence="1">
 
                          <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 Sequence="2">
 
                          <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 Sequence="3">
 
                          <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 Sequence="4">
 
                          <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 Sequence="5">
 
                          <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 Sequence="6">
 
                          <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="2">
 
                    <Amenities>
 
                        <Amenity Code="52" GroupCode="NMO.HTL.AMT.HTL" Sequence="1"/>
 
                        <Amenity Code="7" GroupCode="NMO.HTL.AMT.FCL" Sequence="2"/>
 
                        <Amenity Code="1" GroupCode="NMO.HTL.AMT.FCL" Sequence="3"/>
 
                    </Amenities>
 
                    <DestinationDetails ItemsCount="4">
 
                        <Destination Code="2757" Type="NMO.HTL.DST.CTY" Sequence="1"/>
 
                        <Destination Code="143" Type="NMO.HTL.DST.CTR" Sequence="2"/>
 
                        <Destination Code="12" Type="NMO.HTL.DST.CNT" Sequence="3"/>
 
                        <Destination Code="1" Type="NMO.HTL.DST.ALL" Sequence="4"/>
 
                    </DestinationDetails>
 
                    <Rates ItemsCount="1">
 
                        <Rate Offer="false" RateID="3727c45dbdafe53764a781ea39d8bd28#16" Sequence="1"
 
TripProductID="23dfd49b-3239-42f6-8b24-1a2ee5301098">
 
                          <Rooms>
 
                              <Room Availability="CNF" Sequence="1" Type="SGL">Simple</Room>
 
                          </Rooms>
 
                          <Boards ItemsCount="1">
 
                              <Board Sequence="1" Type="Basis" Code="97">Desayuno Buffet Continental</Board>
 
                          </Boards>
 
                          <RatePrices ItemsCount="1">
 
                              <RatePrice Sequence="1" 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 Sequence="1">10-12 Bina Gardens</Line>
 
                        <Line Sequence="2">London</Line>
 
                        <Line Sequence="3">United Kingdom</Line>
 
                    </Address>
 
                    <LocationDetails>
 
                        <Location Sequence="1" LocationCode="G1000">General</Location>
 
                    </LocationDetails>
 
                  </Hotel>
 
              </Hotels>
 
            </HotelsAvailability>
 
        </Trip>
 
      </Trips>
 
      <Passengers ItemsCount="1">
 
        <Passenger AgeType="NMO.GBL.AGT.ADT" Sequence="1" RoomSequence="1"/>
 
      </Passengers>
 
  </Details>
 
</AvailabilityQueryRS>
 
</syntaxhighlight>
 
  
  
 +
<span class="ps-alert">Atención: Para los productos hoteles, si su operador tiene el módulo de CANCELACION AUTOMATICA activado deberá disparar una [[API Reference: Consulta de una Reserva - Hoteles|Consulta de una Reserva]] inmediatamente luego del booking cuando éste quede en estado Confirmada o Pendiente de Confirmación; de esta forma se creará correctamente la tarea de autocancelación para la reserva.</span>
  
{| class="wikitable sortable"
+
Nota:
|-
+
Se recomienda disparar una [[API Reference: Consulta de una Reserva - Hoteles|Consulta de una Reserva]] luego de realizar un booking ya que brinda el estado final en el sistema.
! 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:
+
== Lista de Mensajes XML por cada Operación ==
  
SupplerID: Id del proveedor
+
Están disponibles los esquemas XSD de PriceSurfer: http://wiki.psurfer.net/resources/pscev-schema.zip
  
Code: código del hotel, de los provistos por Nemo.
+
Documentación online: http://wiki.psurfer.net/resources/PSCEV-doc/pscev.html
  
Name: nombre del hotel
+
Proyecto SoapUI para desarrollo (guia incluida): [https://wiki.psurfer.net/images/e/eb/PS_WebServices-soapui-project.xml.zip PS_WebServices-soapui-project.xml.zip]
  
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:
+
'''Mensajes xml:'''
  
* PriceRange: Rango de precio de las tarifas
+
* ''Operación: /catalog/products/search'' [http://wiki.psurfer.net/resources/PSCEV-doc/pscev_AvailabilityQueryRQ.html AvailabilityQueryRQ]  [http://wiki.psurfer.net/resources/PSCEV-doc/pscev_AvailabilityQueryRS.html AvailabilityQueryRS]
  
* HotelRatings: Rango de categoría de hotel
+
Búsqueda de Disponibilidad de Hoteles: 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.
  
* 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) ===
+
* ''Operación: /catalog/product/detail'' [http://wiki.psurfer.net/resources/PSCEV-doc/pscev_AdditionalInfoQueryRQ.html AditionalInfoQueryRQ] [http://wiki.psurfer.net/resources/PSCEV-doc/pscev_AdditionalInfoQueryRS.html AditionalInfoQueryRS]
  
Mensaje que permite consultar la información detallada de un hotel. La información a devolver será la obtenida de los respectivos proveedores.  
+
Consulta de Información de un Hotel: Consulta la información y detalles de los hoteles provistos por el proveedor.
  
Request: AdditionalInfoQueryRQ
 
  
Response: AdditionalInfoQueryRS
+
* ''Operación: /catalog/product/validate'' [http://wiki.psurfer.net/resources/PSCEV-doc/pscev_AvailabilityValidationRQ.html AvailabilityValidationRQ] [http://wiki.psurfer.net/resources/PSCEV-doc/pscev_AvailabilityValidationRS.html AvailabilityValidationRS]
  
Ejemplo de uso:
+
Confirmación de Disponibilidad de una Tarifa obtenida en una Búsqueda Anterior: Confirma la vigencia de una tarifa provista por una consulta de disponibilidad previa.
  
*** Solicitud:
 
<syntaxhighlight lang="xml">
 
<AdditionalInfoQueryRQ>
 
<GeneralParameters>
 
<PreferedLanguage LanguageCode="es"/>
 
<PreferedCurrency CurrencyCode="ARS"/>
 
</GeneralParameters>
 
<Products>
 
<Hotels ItemsCount="1">
 
<Hotel Sequence="1" TripProductID="fef501f1-962d-40e8-84eb-42373a0e343f"/>
 
</Hotels>
 
</Products>
 
</AdditionalInfoQueryRQ>
 
</syntaxhighlight>
 
  
 +
* ''Operación: /booking/cancellation/fees'' [http://wiki.psurfer.net/resources/PSCEV-doc/pscev_CancellationFeesQueryRQ.html CancellationFeesQueryRQ] [http://wiki.psurfer.net/resources/PSCEV-doc/pscev_CancellationFeesQueryRS.html CancellationFeesQueryRS]
  
{| class="wikitable sortable"
+
Consulta de Gastos de Cancelación para una Tarifa ó Reserva: Consulta de condiciones de gastos de cancelación sobre una tarifa o reserva reportada.
|-
 
! 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:
+
* ''Operación: /catalog/product/book'' [http://wiki.psurfer.net/resources/PSCEV-doc/pscev_BookingProductsRQ.html BookingProductsRQ] [http://wiki.psurfer.net/resources/PSCEV-doc/pscev_BookingProductsRS.html BookingProductsRS]
  
CurrencyCode: Código de moneda correspondiente a los códigos de moneda estándar provistos.
+
Reserva de Tarifa: Solicitud de reserva para una tarifa de hotel.
|-
 
|Hotels || No ||
 
|-
 
|Hotel || Si || Se envía el id del hotel a consultar mediante el atributo TripProductID.
 
|}
 
  
  
*** Respuesta:
+
* ''Operación: /booking/detail'' [http://wiki.psurfer.net/resources/PSCEV-doc/pscev_BookingQueryRQ.html BookingQueryRQ] [http://wiki.psurfer.net/resources/PSCEV-doc/pscev_BookingQueryRS.html BookingQueryRS]
<syntaxhighlight lang="xml">
 
<AdditionalInfoQueryRS>
 
  <Details>
 
      <Products>
 
        <Hotels>
 
            <Hotel HotelCode="7590" SupplierID="MIK" Sequence="1" xmlns:ns="http://www.nemogroup.net/hcev/2008/04">
 
              <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>
 
              <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>
 
              <LocationDetails ItemsCount="1">
 
                  <Location Sequence="1" LocationCode="G8">Area suburbana</Location>
 
              </LocationDetails>
 
            </Hotel>
 
        </Hotels>
 
      </Products>
 
  </Details>
 
</AdditionalInfoQueryRS>
 
</syntaxhighlight>
 
  
 +
Consulta de Reserva: Consulta de información y detalles sobre una reserva realizada. Es necesario para obtener el detalle final de la reserva confirmada en el sistema.
  
  
{| class="wikitable sortable"
+
* ''Operación: /booking/cancel'' [http://wiki.psurfer.net/resources/PSCEV-doc/pscev_BookingCancellationRQ.html BookingCancellationRQ]  [http://wiki.psurfer.net/resources/PSCEV-doc/pscev_BookingCancellationRS.html BookingCancellationRS]
|-
 
! 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:
+
Cancelación de Reserva: Solicitud de cancelación de una reserva realizada.
  
HotelCode: Código del hotel de los provistos por Nemo.
+
== Especificación de documentos XML ==
  
SupplierID: Código del proveedor correspondiente a los códigos de proveedor estándar provistos por Nemo.
+
=== Búsqueda de Disponibilidad de Hoteles (AvailabilityQuery) ===
|-
+
[[API Reference: Búsqueda de Disponibilidad de Hoteles]]
| HotelName || Si || Nombre del hotel.
 
|-
 
| AccomodationType || No || Indica si es hotel, hostel, camping, etc.
 
|-
 
| HotelDescriptions || No ||
 
|-
 
| HotelDescription || No || Descripción del hotel.
 
  
Atributos:
+
=== Consulta de Información de un Hotel (AdditionalInfoQuery) ===
 
 
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.
+
[[API Reference: Consulta de Información de un Hotel]]
|-
 
| 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) ===  
 
=== 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
 
  
 +
[[API Reference: Confirmación de Disponibilidad de una Tarifa]]
  
Request: AvailabilityQueryRQ
+
===  Consulta de Gastos de Cancelación para una Tarifa ó Reserva (CancellationFeesQuery) ===
  
Response: AvailabilityQueryRS
+
Operación exclusiva para Hoteles. Devuelve las condiciones de gastos de cancelación para una Tarifa ó una Reserva.
  
Ejemplo de uso:
+
Request: CancellationFeesQueryRQ ([http://wiki.psurfer.net/resources/PSCEV-doc/pscev_CancellationFeesQueryRQ.html Estructura del Documento])
  
*** Solicitud:
+
Response: CancellationFeesQueryRS ([http://wiki.psurfer.net/resources/PSCEV-doc/pscev_CancellationFeesQueryRS.html Estructura del Documento])
<syntaxhighlight lang="xml">
 
<AvailabilityValidationRQ>
 
<GeneralParameters>
 
<PreferedLanguage LanguageCode="es"/>
 
<PreferedCurrency CurrencyCode="ARS"/>
 
</GeneralParameters>
 
<Products>
 
<Hotels ItemsCount="1">
 
<Hotel Sequence="1" TripProductID="fef501f1-962d-40e8-84eb-42373a0e343f"/>
 
</Hotels>
 
</Products>
 
</AvailabilityValidationRQ>
 
</syntaxhighlight>
 
  
 +
'''Se pueden consultar de dos formas:'''
  
{| class="wikitable sortable"
+
* [[API Reference: Consulta de Gastos de Cancelación de un Producto - Hotel|Con el TripProductId de una búsqueda]]
|-
+
* [[API Reference: Consulta de Gastos de Cancelación de una Reserva - Hotel|Con el BookingReference de una reserva]]
! Parámetro !! Obligatorio !! Descripción
 
|-
 
| GeneralParameters || Si ||
 
|-
 
| PreferedLanguage || Si || Establece el lenguaje requerido para la respuesta.
 
  
Atributos:
+
=== Reserva de Tarifa (BookingProducts) ===
  
LanguageCode: Código de lenguaje correspondiente a los códigos de lenguaje estándar provistos por Nemo.
+
Solicitud de reserva para una tarifa.
|-
 
| PreferedCurrency || Si || Establece la moneda requerida para la respuesta.
 
  
Atributos:
+
Request: BookingProductsRQ ([http://wiki.psurfer.net/resources/PSCEV-doc/pscev_BookingProductsRQ.html Estructura del Documento])
  
CurrencyCode: Código de moneda correspondiente a los códigos de moneda estándar provistos.
+
Response: BookingProductsRS ([http://wiki.psurfer.net/resources/PSCEV-doc/pscev_BookingProductsRS.html Estructura del Documento])
|-
 
| Hotels || No ||
 
|-
 
| Hotel || Si || Se envía el id del hotel a consultar mediante el atributo TripProductID.
 
|}
 
  
 +
Detalles y ejemplos:
 +
[[API Reference: Reserva de una Tarifa - Hoteles|Reserva de una Tarifa - Hoteles]]
  
*** Respuesta:
+
=== Cancelación de Reserva (BookingCancellation) ===
<syntaxhighlight lang="xml">
 
<AvailabilityValidationRS>
 
  <Details>
 
      <Products>
 
        <Hotels ItemsCount="1">
 
            <Rate RateID="3727c45dbdafe53764a781ea39d8bd28#0" Sequence="1" HotelCode="7590" SupplierId="MIK"
 
TripProductID="fef501f1-962d-40e8-84eb-42373a0e343f">
 
              <Rooms ItemsCount="1">
 
                  <Room Sequence="1" Type="NMO.HTL.RMT.SGL" Availability="NMO.HTL.AVB.CNF" RoomDescription="Simple">
 
                    <Occupancy>
 
                        <Guests ItemsCount="1">
 
                          <Guest Sequence="1" PassengerSequence="1"/>
 
                        </Guests>
 
                    </Occupancy>
 
                  </Room>
 
              </Rooms>
 
              <Boards ItemsCount="1">
 
                  <Board Sequence="1" Code="60" Type="BreakfastDescription">Desayuno incluido</Board>
 
              </Boards>
 
              <RatePrices ItemsCount="3">
 
                  <RatePrice Currency="ARS" Sequence="1" Type="NMO.HTL.RPT.NET">389.81860737273263</RatePrice>
 
                  <RatePrice Currency="EUR" Sequence="2" Type="NMO.HTL.RPT.NBC">66.62</RatePrice>
 
                  <RatePrice Currency="ARS" Sequence="3" Type="NMO.GBL.RPT.GRS">389.81860737273263</RatePrice>
 
              </RatePrices>
 
              <Passengers ItemsCount="1">
 
                  <Passenger Sequence="1" AgeType="NMO.GBL.AGT.ADT"/>
 
              </Passengers>
 
              <Destinations ItemsCount="1">
 
                  <Destination Sequence="1" 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>
 
</syntaxhighlight>
 
  
 +
Solicitud de cancelación de una reserva confirmada.
  
  
{| class="wikitable sortable"
+
Request: BookingCancellationRQ ([http://wiki.psurfer.net/resources/PSCEV-doc/pscev_BookingCancellationRQ.html Estructura del Documento])
|-
 
! 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:
+
Response: BookingCancellationRS ([http://wiki.psurfer.net/resources/PSCEV-doc/pscev_BookingCancellationRS.html Estructura del Documento])
  
TripProductId: identificador del producto.
+
Detalles y ejemplos:
 +
[[API Reference: Cancelación de una Reserva - Hoteles|Cancelación de una Reserva - Hoteles]]
  
Offer: indica si es una oferta.
+
=== Consulta de Reserva (BookingQuery) ===
  
Featured: indica si es un producto recomendado.
+
Consulta de información y detalles sobre una reserva.
|-
 
| Rooms || No || Información sobre las habitaciones.
 
|-
 
| Room || Si || Identifica una habitación en los parámetros de la búsqueda.
 
  
Atributos:
+
Request: BookingQueryRQ ([http://wiki.psurfer.net/resources/PSCEV-doc/pscev_BookingQueryRQ.html Estructura del Documento])
  
Type: tipo de habitación.
+
Response: BookingQueryRS ([http://wiki.psurfer.net/resources/PSCEV-doc/pscev_BookingQueryRS.html Estructura del Documento])
  
Availability: indica la disponibilidad de la habitación.
+
Detalles y ejemplos:
|-
+
[[API Reference: Consulta de una Reserva - Hoteles|Consulta de una Reserva - Hoteles]]
| 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:
+
== Lenguaje de Descripción de la Aplicación Web (WADL) ==
  
Type: Tipo de régimen correspondiente a los tipos de régimen estándar provistos por Nemo.
+
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.
  
Code: Código del régimen correspondiente a los códigos de régimen estándar provistos.
+
En Produccion -> http://service.psurfer.net/pricesurfer/application.wadl
|-
 
| 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) ===
+
En Staging -> http://service-cert.psurfer.net/pricesurfer/application.wadl
  
Consulta de condiciones de gastos de cancelación sobre una o más tarifas o reservas reportadas.
+
= Especificaciones y recomendaciones =
  
 +
== Administracion de los TripProductIDs ==
  
Request: CancellationFeesQueryRQ
+
Para evitar inconvenientes respecto de expiración de tarifas cuando el tiempo del flujo de reserva es elevado, recomendamos utilizar siempre el TripProductID obtenido en cada mensaje previo del flujo de reserva y que no siempre es el mismo que se obtuvo en la búsqueda original:
  
Response: CancellationFeesQueryRS
+
1- En el mensaje AvailabilityValidationRQ (Validación de Tarifa) utilizar el TripProductID que se responde en el AvailabilityQueryRS (respuesta de la Búsqueda)
  
Ejemplo de uso:
+
2- En el mensaje CancellationFeesQueryRQ (Politica de Gastos) utilizar el TripProductID que se responde en el AvailabilityValidationRS (respuesta de Validación de Tarifas)
  
*** Solicitud:
+
3- En el mensaje BookingProductsRQ (Reserva) utiliza el TripProductID que se responde en el CancellationFeesQueryRS (respuesta de Política de Cancelación)
<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>
 
  
 +
== Autorización y otras cabeceras necesarias ==
  
{| class="wikitable sortable"
+
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.
|-
 
! Parámetro !! Obligatorio !! Descripción
 
|-
 
| GeneralParameters || Si ||
 
|-
 
| PreferedLanguage || Si || Establece el lenguaje requerido para la respuesta.
 
  
Atributos:
+
Además de la cabecera para la autorización deben enviarse las cabeceras estandars
 +
* '''Accept''' con valor '''''application/xml'''''
 +
* '''Accept-Encoding''' con valor '''''gzip,deflate''''' (solicitar la compresión de la respuesta para acelerar el tiempo de llegada de la misma)
  
LanguageCode: Código de lenguaje correspondiente a los códigos de lenguaje estándar provistos por Nemo.
+
== Ejemplo de cabecera ==
|-
 
| PreferedCurrency || Si || Establece la moneda requerida para la respuesta.
 
  
Atributos:
+
* Solicitud (entorno de Cert)
  
- CurrencyCode: Código de moneda correspondiente a los códigos de moneda estándar provistos.
+
POST http://service-cert.psurfer.net/pricesurfer/catalog/products/search HTTP/1.1
|-
 
| Products || Si ||
 
|-
 
| Hotels || No ||
 
|-
 
| Hotel || Si || Atributos:
 
  
- TripProductId: Identificador del producto
+
Accept-Encoding: gzip,deflate
|}
 
  
 +
Accept: application/xml
  
*** Respuesta:
+
Content-Type: application/xml
<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>
 
  
 +
X-PS-AUTHTOKEN: 981d284d_bc57_c429_91b9_178fg07f78f0
  
 +
Content-Length: 770
  
{| class="wikitable sortable"
+
Host: http://service-cert.psurfer.net
|-
 
! 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:
+
Connection: Keep-Alive
  
HotelDescriptionType: Tipo de descripción correspondiente a los tipos de descripción estándar provistos por Nemo.
+
User-Agent: Apache-HttpClient/4.1.1 (java 1.5)
|-
 
| 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.
+
* Respuesta
|-
 
| Amenities || No ||
 
|-
 
| Amenity || No || Código de amenidad admitido.
 
  
Atributos:
+
HTTP/1.1 200 OK
  
AmenityGroupCode: Tipo de amenidad. Los tipos de amenidad admitidos corresponden a los provistos por Nemo.
+
X-Powered-By: Servlet/3.0
  
AmenityCode: Código de amenidad. Los códigos de amenidad admitidos corresponden a los provistos.
+
Server: GlassFish Server Open Source Edition 3.0.1
|-
 
| 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:
+
Content-Type: application/xml
  
HotelRatingCode: código de la categoría correspondiente a los códigos de categoría estándar provistos por Nemo.
+
Transfer-Encoding: chunked
  
HotelRatingType: Tipo de la categoría correspondiente a los tipos de categoría estándar provistos por Nemo.
+
Content-Encoding: gzip
|-
 
| 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.
+
Vary: Accept-Encoding
|-
 
| DisplayOrder || No || Orden del la imagen.
 
|-
 
| ImageURL || Si || URL de la imagen
 
|-
 
| DestinationDetails || Si || Atributos:
 
  
DestinationType: tipo de destino de los provistos por Nemo.
+
Date: Wed, 31 Jul 2013 10:39:32 GMT
  
Destination Code: código del destino a buscar, de los provistos por Nemo.
+
== TransactionMode ==
|-
 
| 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:
+
Solo es posible usar el modo Sincrónico:
  
AgeType: tipo de pasajero (chl, inf, adt).
+
TransactionMode="Synchronous"
  
Sequence: Este dato será asociado al PassengerSequence del nodo Guest en hoteles.
+
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.
|-
 
| 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:
+
Si algún proveedor supera el tiempo máximo permitido (timeout configurado por nosotros) no se devolverán resultados del mismo.
  
- ChargeType, tipo de cargo (Ej. NMO.HTL.CHT.CAN cancelación, NMO.HTL.CHT.AMD Modificación)
+
Puede ocurrir que los resultados retornados por el WS no sean los mismos que los resultados del sitio online de PriceSurfer.  
|-
+
Esto ocurre porque un proveedor que se interrumpe por timeout sigue guardando resultados en la cache de resultados, que están disponibles solo en la aplicación online, y no en el ws.
| ChargeDescription || Si || Descripción del gastos de cancelación
+
Por consiguiente si se interrumpe algún proveedor por timeout se perderán esos datos por 30 minutos, ya que quedarán ocultos por la caché del ws.
|-
 
| 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:
+
Aconsejamos ajustar el timeout en un tiempo no muy corto para no tener falta de tarifas.
  
- RatePriceType, tipo de precio
+
Contemplar las restricciones generales en la cantidad de peticiones de como máximo 10 peticiones cada 10 segundos.
|}
 
  
=== Reserva de Tarifa (BookingProducts) ===
+
== Sobre el pedido de información de hoteles ==  
 +
Para descargar las fichas con la información de los hoteles (Mensaje AdditionalInfoQuery: [[API Reference: Consulta de Información de un Hotel]]), recomendamos enfáticamente generar peticiones con hasta 20 HotelDetailIds (realizar pedidos en batch de hasta 20 HotelDetailsIds por vez). De esta forma se puede ir descargando la información de hoteles a lo largo de todo el día sin afectar a la performance.
 +
Contemplar las restricciones generales en la cantidad de peticiones de como maximo 10 peticiones cada 10 segundos.
  
Solicitud de reserva para una o varias tarifas de hoteles.
+
== Sobre las Imágenes - Hoteles ==
  
 +
* Recomendamos que tengan su propia librería de íconos para las amenities.
 +
* Para URL de las imágenes de los hoteles deben usar:
  
Request: BookingProductsRQ
+
'''Para el entorno de TEST:'''
 +
* http://psurfer-img.net/imagecache-cert/full/ (para las fotos en tamaño original)
 +
* http://psurfer-img.net/imagecache-cert/thumbnails/ (para las imágenes en miniatura)
  
Response: BookingProductsRS
+
'''Para el entorno de PRODUCCIÓN:'''
 +
* http://psurfer-img.net/imagecache-prod/full/ (para las fotos en tamaño original)
 +
* http://psurfer-img.net/imagecache-prod/thumbnails/ (para las imágenes en miniatura)
  
Ejemplo de uso:
+
'''Importante:'''
 +
* Las imágenes también están disponibles a través de una URL segura (indicar el protocolo '''''https''''' en lugar de ''http'')
 +
* Existen excepciones en algunos proveedores de hoteles, y algunas imágenes ya vienen con la URL completa, o sea, ya comienzan con http.....En estos casos no colocar la URL delante porque les fallaría.
 +
Ejemplo:
  
*** Solicitud:
+
- URL normalizada para imágenes: <ImageURL>IDJ/B/B/BB3898629BE8D3DB188164A6611AA350.jpg</ImageURL>
<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>
 
  
 +
- URL completa <ImageURL>http://psurfer-img.net/pathalaimagen/imagen.jpg</ImageURL>
  
{| class="wikitable sortable"
+
(En este caso por favor no pegar la URL base delante)
|-
 
! 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.
+
Ejemplos:
|-
+
Suponiendo que la respuesta a la consulta de información adicional de un hotel es
| PreferedCurrency || Si || Establece la moneda requerida para la respuesta.
+
<code xml>
 +
<AdditionalInfoQueryRS>
 +
  <Details>
 +
    <Products>
 +
      <Hotels>
 +
        <Hotel HotelCode="2444" SupplierID="HDO" Sequence="1" HotelDetailId="IDJ-1YT-4MO">
 +
          <HotelName>El Conquistador Hotel</HotelName>
 +
          <HotelDescriptions>
 +
            ...
 +
          </HotelDescriptions>
 +
          <Amenities>
 +
            ...
 +
          </Amenities>
 +
          <Addresses>
 +
            ...
 +
          </Addresses>
 +
          <Position>
 +
            ...
 +
          </Position>
 +
          <HotelRating HotelRatingCode="NMO.HTL.RTN.4ST" HotelRatingType="NMO.HTL.RTT.STR">
 +
            ...
 +
          </HotelRating>
 +
          <ImageLinks>
 +
            <ImageLink>
 +
              <ImageLink>
 +
              <ImageDescription ImageDisplayType="NMO.GBL.IMG.IMG"/>
 +
              <ImageHeight UnitOfMeasureCode="9">185</ImageHeight>
 +
              <ImageWidth UnitOfMeasureCode="9">250</ImageWidth>
 +
              <ImageURL>IDJ/B/B/BB3898629BE8D3DB188164A6611AA350.jpg</ImageURL>
 +
              <ThumbnailURL>IDJ/4/A/4A78390A062E3F504912F5E9ADEDBDB5.jpg</ThumbnailURL>
 +
            </ImageLink>
 +
          </ImageLinks>
 +
          <LocationDetails>
 +
            ...
 +
          </LocationDetails>
 +
        </Hotel>
 +
      </Hotels>
 +
    </Products>
 +
  </Details>
 +
</AdditionalInfoQueryRS>
 +
</code>
  
Atributos:
+
Entonces las URLs quedarían:
  
CurrencyCode: Código de moneda correspondiente a los códigos de moneda estándar provistos.
+
Si la respuesta fue del Web Service de TEST:
|-
+
* http://psurfer-img.net/imagecache-cert/full/IDJ/B/B/BB3898629BE8D3DB188164A6611AA350.jpg
| Hoteles || No ||
+
* http://psurfer-img.net/imagecache-cert/thumbnails/IDJ/4/A/4A78390A062E3F504912F5E9ADEDBDB5.jpg
|-
 
| 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:
+
Si la respuesta fue del Web Service de PRODUCCIÓN:
 +
* http://psurfer-img.net/imagecache-prod/full/IDJ/B/B/BB3898629BE8D3DB188164A6611AA350.jpg
 +
* http://psurfer-img.net/imagecache-prod/thumbnails/IDJ/4/A/4A78390A062E3F504912F5E9ADEDBDB5.jpg
  
AgeType: tipo de pasajero (chl, inf, adt).
+
== Sobre los tiempos de vida de los resultados de búsqueda en el Web Service ==
  
Sequence: Este dato será asociado al PassengerSequence del nodo Guest en hoteles.
+
Los resultados de búsqueda se mantienen cacheados en el servicio durante '''30 minutos''', por lo cual los clientes del Web Service podrán usar los [[API Reference: TripProductId|TripProductId]] devueltos por el mismo '''antes''' de los 30 minutos, caso contrario el Web Service podrá informar que los TripProductId ya no se encuentran disponibles o son inválidos.
|}
 
  
*** Respuesta:
+
== Sobre los comentarios del proveedor ==
<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>
 
  
 +
Los proveedores pueden llegar a enviar comentarios/remarks en dos instancias diferentes:
  
{| class="wikitable sortable"
+
La primera en el resultado de la búsqueda: Tag Item Comments del Rate [[API Reference: Búsqueda de Disponibilidad de Hoteles]]
|-
 
! 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>
 
  
 +
La segunda alternativa en la respuesta de la consulta de la reserva: SupplierComments [[API Reference: Consulta de una Reserva - Hoteles]]
  
 +
== Códigos de Error devueltos por el WebService ==
  
 
{| class="wikitable sortable"
 
{| class="wikitable sortable"
 
|-
 
|-
! Parámetro !! Obligatorio !! Descripción
+
! Código !! Descripción !! Significado
|-
 
| 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:
+
| 1000 || Unexepected Error || Ha ocurrido un error inesperado, por favor informe al Soporte de PriceSurfer
 
 
- 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 ||  
+
| 1015 || No credit for doing the booking. || El Contrato tiene establecido un límite de crédito que ha sido alcanzado, la reserva es rechazada por ese motivo.
 +
|-
 +
| 1101 || The TripProductId %s is not available || El TripProductId no fue encontrado. Este mensaje aparece cuando el rate no se encuentra disponible en el proveedor, porque ha cambiado alguno de los diferentes atributos del rate (regimen / precio / tipo de disponibilidad)
 +
Para estas situaciones, se debe cambiar a otro tripProductID, para chequear su disponibilidad en el proveedor.
 
|-
 
|-
| Hotel || Si ||  
+
| 1103 || The booking of this product has been rejected by configuration: the product has cancellation charges as of this moment || La reserva del producto ha sido rechazada porque, por configuración del contrato, el sistema rechazará las reservas que entren en Gastos de Cancelación al momento de realizarlas.
 
|-
 
|-
| BookingReference || Si || Atributos:
+
| 1104 || The system couldn't check the cancellation charges of the product || El sistema no pudo obtener los Gastos de Cancelación del producto.
 
+
|-
- ReferenceType: Tipo de referencia, por ejemplo  OLA.GBL.BRT.HTL – Referencia de reserva de hoteles.
+
| 1105 || The booking of this product has been rejected by deadline: the product has cancellation charges || El booking no se realizo ya que fue abortado el proceso (previo a la reserva) porque el contrato tiene activado el bloqueo para reservar items con "gastos de cancelacion".
 
+
|-
Valor: Identificador entregado en la respuesta de reserva
+
| 1106 || The booking of this product has been rejected because price has changed || El booking no se realizo ya que fue abortado el proceso porque la validacion pre-booking detecto que el precio ha cambiado.
 +
|-
 +
| 1107 || Rate's live time in cache has been expired || El tiempo de vida del rate en cache ha sido expirado.
 +
|-
 +
| 1108 || Connectivity error || Error de conectividad detectado en dicho momento. En dicha situacion se debe enviar nuevamente el mensaje del caso.
 +
|-
 +
| 1109 || Unable to Query Booking || Errores generados al consultar el Detalle de Reserva.
 +
|-  
 +
| 3000 || Request detail for current booking - Relationated with TripProductId: xxxyyy || Ante dicha situacion se debe realizar la consulta de detalle de reserva para recuperar la info detallada y actualizada de la reserva.
 +
|-
 +
| 5000 || No Availability for your request || No ha habido disponibilidad para los parámetros de búsqueda dados
 +
|-
 +
| 5010 || The TripProductId %s was not found || El [[API Reference: TripProductId|TripProductId]] dado no fue encontrado. Pudo haber expirado o es incorrecto (no corresponde a un TripProductId informado por el Web Service en una búsqueda)
 +
|-
 +
| 5011 || The TripProductId %s has expired || El [[API Reference: TripProductId|TripProductId]] dado ha expirado. [http://wiki.psurfer.net/index.php/Price_Surfer_-_Web_Services#Sobre_los_tiempos_de_vida_de_los_resultados_de_b.C3.BAsqueda_en_el_Web_Service Sobre la expiración de los resultados de búsqueda]
 +
|-
 +
| 5012 || The Search Results of your product have expired || Los Resultados de Búsqueda correspondientes al producto seleccionado han expirado. [http://wiki.psurfer.net/index.php/Price_Surfer_-_Web_Services#Sobre_los_tiempos_de_vida_de_los_resultados_de_b.C3.BAsqueda_en_el_Web_Service Sobre la expiración de los resultados de búsqueda]
 +
|-
 +
| 5020 || The Product is Invalid: %s || El Producto es Inválido (Cambió el Precio ó Incurría en gastos de Cancelación al momento de reservar)
 +
|-
 +
| 5100 || Invalid Request Document: %s || Se ha enviado un documento inválido. El mensaje contiene información sobre lo que es inválido en el documento.
 +
|-
 +
| 5120 || There are not availability when is booking || El rate no esta disponible para ser reservado.
 +
|-
 +
| 401 || Unauthorized || El Token de seguridad (X-PS-AUTHTOKEN) es inválido o no fue enviado
 
|}
 
|}
  
*** Respuesta:
+
== Importante: Información necesaria al reportar un error al Soporte de PriceSurfer ==
<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>
 
 
 
  
{| class="wikitable sortable"
+
Si necesita informar de un fallo al soporte de PriceSurfer incluya la siguiente información:
|-
+
* Fecha en que ocurrió la incidencia
! Parámetro !! Obligatorio !! Descripción
+
* Entorno (Test / Producción)
|-
+
* XML de Request enviado al Servicio
| Notifications || No ||
+
* XML de Response con que el Serivicio respondió
|-
+
* Si es una operación posterior a la Búsqueda de Disponibilidad (Validación de Disponibilidad, Solicitud de Información Adicional, Solicitud de Gastos de Cancelación, Solicitud de Reserva) por favor especificar también el DestinationId (destino) correspondiente al producto sobre el que se intentó la operación.
| 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:
+
= Archivos adicionales =
  
- BookingReference: identificador de la reserva.
+
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.
  
- BookingState: estado de la reserva
+
== Tablas de Códigos==
|-
 
| 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>
 
 
 
 
 
{| class="wikitable sortable"
 
|-
 
! 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>
 
  
  
 
{| class="wikitable sortable"
 
{| class="wikitable sortable"
 
|-
 
|-
! Parámetro !! Obligatorio !! Descripción
+
! Aplicable a !! Tabla
|-
 
| 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 ||  
+
| Hoteles || [[API Reference: Grupos de Servicios e Instalaciones|Códigos de Grupos de Servicios e Instalaciones]]
 
|-
 
|-
| Room || Si ||  
+
| Hoteles || [[API Reference: Códigos de Estrellas|Códigos de Estrellas]]
 
|-
 
|-
| Occupancy || Si || Indica la cantidad de adultos, niños e infantes por cada habitación.
+
| Reserva || [[API Reference: Estados de la Reserva|Estados de la Reserva]]
En el nodo Passengers se encuentran los datos de los pasajeros.
 
 
|-
 
|-
| Fares || Si || Datos de tarifas
+
| Hoteles || [[API Reference: Tipos de Alojamientos|Tipos de Alojamientos]]
 
|-
 
|-
| FareType || No || Tipo de tarifas, ej. Tarifa web, precio de agencia
+
| Hoteles || [[API Reference: Tipos de Descripciones de Hoteles|Tipos de Descripciones]]
 
|-
 
|-
| Prices || Si || Precios, con valor y moneda
+
| Destinos || [[API Reference: Tipos de Destinos|Tipos de Destinos]]
 
|-
 
|-
| BookingReferences || No || Identificadores de la reserva
+
| Hoteles || [[API Reference: Tipos de Estrellas|Tipos de Estrellas]]
 
|-
 
|-
| BookingState || Si || Estado de la reserva (del ítem). La codificación de los estados será provista por Nemo.
+
| Reserva || [[API Reference: Tipos de Gastos de Cancelación|Tipos de Gastos de Cancelación]]
 
 
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.
+
| Habitaciones || [[API Reference: Tipos de Habitaciones|Tipos de Habitaciones]]
 
|-
 
|-
| ChargeConditions || Si || Nodo de gastos de cancelación
+
| Pasajeros || [[API Reference: Tipos de Identificadores de Pasajeros|Tipos de Identificadores de Pasajeros]]
 
|-
 
|-
| ChargeCondition || Si || Gasto de Cancelación
+
| Hoteles || [[API Reference: Tipos de Imágenes|Tipos de Imágenes]]
 
 
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
+
| Reservas || [[API Reference: Tipos de Localizadores de la Reserva|Tipos de Localizadores (identificadores) de la Reserva]]
 
|-
 
|-
| DateRangeWithDays || No || Indica que el gasto de cancelación tiene un rango en base a días.
+
| Pasajeros || [[API Reference: Tipos de Nombres|Tipos de Nombres de Pasajeros]]
 
|-
 
|-
| DateFrom || Si || Fecha desde
+
| Pasajeros || [[API Reference: Tipos de Pasajeros|Tipos de Pasajeros]]
 
|-
 
|-
| DateTo || Si || Fecha hasta
+
| Tarifa || [[API Reference: Tipos de Pensiones|Tipos de Pensiones]]
 
|-
 
|-
| DateRangeWithDateType || No || Indica que el gasto de cancelación tiene un rango en base a fechas.
+
| Hoteles || [[API Reference: Tipos de Servicios e Instalaciones|Tipos de Servicios e Instalaciones (Amenities)]]
 
|-
 
|-
| DateFrom || Si || Fecha desde
+
| Hoteles || [[API Reference: Hoteles - Tipos de Teléfonos|Tipos de Teléfonos]]
 
|-
 
|-
| DateTo || Si || Fecha hasta
+
| General || [[API Reference: Tipos de Email|Tipos de Email]]
 
|-
 
|-
| RatePrices || Si ||  
+
| General || [[API Reference: Códigos de proveedores | Códigos de proveedores]]
 
|-
 
|-
| RatePrice || Si || Indica el importe del concepto de cancelación
+
| Tarifa || [[API Reference: Tipos de tarifa | Tipos de tarifa]]
 
 
Atributos:
 
 
 
RatePriceType, tipo de precio
 
 
|}
 
|}
  
== Lenguaje de Descripción de la Aplicación Web (WADL) ==
+
== Destinos ==
 
 
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:
+
Listado de destinos de Price Surfer:
{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.
+
* Español : https://wiki.psurfer.net/resources/DESTINATION_ES.zip
* 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.
+
* Inglés : https://wiki.psurfer.net/resources/DESTINATION_EN.zip
* CONTINUE: significa que hay más datos de disponibilidad de hoteles. Debe seguir haciendo peticiones en modo "ContinueAsync" para obtener más resultados.
+
* Portugués : https://wiki.psurfer.net/resources/DESTINATION_PT.zip

Revisión actual del 14:21 12 sep 2022

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.


IMPORTANTE:

A partir de Octubre 2022 es requerida una lista de IPs habilitadas para poder operar, las IP que no sean informadas como autorizadas serán bloqueadas impidiendo la operatoria.

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.

El uso de dichas credenciales excluye la posibilidad de aplicarlas para otros fines como trabajar con un robot que realice búsquedas de disponibilidad para obtener tarifas y almacenarlas u otra tarea no especificada en este documento; reservando a Price Surfer el derecho de deshabilitar dicho usuario. Cualquier cambio que se desee realizar deberá ser notificado y aprobado con anticipación.

Documentos de Certificacion a utilizar en los Webservices de hoteles se encuentran disponibles:

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 - Entornos y Operaciones

Los entornos disponibles son:


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


Ejemplo de endpoint de busqueda en Entorno de Certificacion:


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, en linux desde la consola con bash 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 la cabecera X-PS-AUTHTOKEN 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.


Para aumentar la velocidad de respuesta desde el servidor del WebService hasta el cliente, se recomienda agregar en la cabecera HTTP la solicitud de compresión de la respuesta, en el ejemplo con curl anterior se agregaría: -H "Accept-Encoding: gzip" \


Flujo de Mensajes para la correcta implementación del Servicio

Flujo.jpg


Atención: Para los productos hoteles, si su operador tiene el módulo de CANCELACION AUTOMATICA activado deberá disparar una Consulta de una Reserva inmediatamente luego del booking cuando éste quede en estado Confirmada o Pendiente de Confirmación; de esta forma se creará correctamente la tarea de autocancelación para la reserva.

Nota: Se recomienda disparar una Consulta de una Reserva luego de realizar un booking ya que brinda el estado final en el sistema.

Lista de Mensajes XML por cada Operación

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

Documentación online: http://wiki.psurfer.net/resources/PSCEV-doc/pscev.html

Proyecto SoapUI para desarrollo (guia incluida): PS_WebServices-soapui-project.xml.zip


Mensajes xml:

Búsqueda de Disponibilidad de Hoteles: 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.


Consulta de Información de un Hotel: Consulta la información y detalles de los hoteles provistos por el proveedor.


Confirmación de Disponibilidad de una Tarifa obtenida en una Búsqueda Anterior: Confirma la vigencia de una tarifa provista por una consulta de disponibilidad previa.


Consulta de Gastos de Cancelación para una Tarifa ó Reserva: Consulta de condiciones de gastos de cancelación sobre una tarifa o reserva reportada.


Reserva de Tarifa: Solicitud de reserva para una tarifa de hotel.


Consulta de Reserva: Consulta de información y detalles sobre una reserva realizada. Es necesario para obtener el detalle final de la reserva confirmada en el sistema.


Cancelación de Reserva: Solicitud de cancelación de una reserva realizada.

Especificación de documentos XML

Búsqueda de Disponibilidad de Hoteles (AvailabilityQuery)

API Reference: Búsqueda de Disponibilidad de Hoteles

Consulta de Información de un Hotel (AdditionalInfoQuery)

API Reference: Consulta de Información de un Hotel

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

API Reference: Confirmación de Disponibilidad de una Tarifa

Consulta de Gastos de Cancelación para una Tarifa ó Reserva (CancellationFeesQuery)

Operación exclusiva para Hoteles. Devuelve las condiciones de gastos de cancelación para una Tarifa ó una Reserva.

Request: CancellationFeesQueryRQ (Estructura del Documento)

Response: CancellationFeesQueryRS (Estructura del Documento)

Se pueden consultar de dos formas:

Reserva de Tarifa (BookingProducts)

Solicitud de reserva para una tarifa.

Request: BookingProductsRQ (Estructura del Documento)

Response: BookingProductsRS (Estructura del Documento)

Detalles y ejemplos: Reserva de una Tarifa - Hoteles

Cancelación de Reserva (BookingCancellation)

Solicitud de cancelación de una reserva confirmada.


Request: BookingCancellationRQ (Estructura del Documento)

Response: BookingCancellationRS (Estructura del Documento)

Detalles y ejemplos: Cancelación de una Reserva - Hoteles

Consulta de Reserva (BookingQuery)

Consulta de información y detalles sobre una reserva.

Request: BookingQueryRQ (Estructura del Documento)

Response: BookingQueryRS (Estructura del Documento)

Detalles y ejemplos: Consulta de una Reserva - Hoteles

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.

En Produccion -> http://service.psurfer.net/pricesurfer/application.wadl

En Staging -> http://service-cert.psurfer.net/pricesurfer/application.wadl

Especificaciones y recomendaciones

Administracion de los TripProductIDs

Para evitar inconvenientes respecto de expiración de tarifas cuando el tiempo del flujo de reserva es elevado, recomendamos utilizar siempre el TripProductID obtenido en cada mensaje previo del flujo de reserva y que no siempre es el mismo que se obtuvo en la búsqueda original:

1- En el mensaje AvailabilityValidationRQ (Validación de Tarifa) utilizar el TripProductID que se responde en el AvailabilityQueryRS (respuesta de la Búsqueda)

2- En el mensaje CancellationFeesQueryRQ (Politica de Gastos) utilizar el TripProductID que se responde en el AvailabilityValidationRS (respuesta de Validación de Tarifas)

3- En el mensaje BookingProductsRQ (Reserva) utiliza el TripProductID que se responde en el CancellationFeesQueryRS (respuesta de Política de Cancelación)

Autorización y otras cabeceras necesarias

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.

Además de la cabecera para la autorización deben enviarse las cabeceras estandars

  • Accept con valor application/xml
  • Accept-Encoding con valor gzip,deflate (solicitar la compresión de la respuesta para acelerar el tiempo de llegada de la misma)

Ejemplo de cabecera

  • Solicitud (entorno de Cert)

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)


  • Respuesta

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

TransactionMode

Solo es posible usar el modo 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.

Si algún proveedor supera el tiempo máximo permitido (timeout configurado por nosotros) no se devolverán resultados del mismo.

Puede ocurrir que los resultados retornados por el WS no sean los mismos que los resultados del sitio online de PriceSurfer. Esto ocurre porque un proveedor que se interrumpe por timeout sigue guardando resultados en la cache de resultados, que están disponibles solo en la aplicación online, y no en el ws. Por consiguiente si se interrumpe algún proveedor por timeout se perderán esos datos por 30 minutos, ya que quedarán ocultos por la caché del ws.

Aconsejamos ajustar el timeout en un tiempo no muy corto para no tener falta de tarifas.

Contemplar las restricciones generales en la cantidad de peticiones de como máximo 10 peticiones cada 10 segundos.

Sobre el pedido de información de hoteles

Para descargar las fichas con la información de los hoteles (Mensaje AdditionalInfoQuery: API Reference: Consulta de Información de un Hotel), recomendamos enfáticamente generar peticiones con hasta 20 HotelDetailIds (realizar pedidos en batch de hasta 20 HotelDetailsIds por vez). De esta forma se puede ir descargando la información de hoteles a lo largo de todo el día sin afectar a la performance. Contemplar las restricciones generales en la cantidad de peticiones de como maximo 10 peticiones cada 10 segundos.

Sobre las Imágenes - Hoteles

  • Recomendamos que tengan su propia librería de íconos para las amenities.
  • Para URL de las imágenes de los hoteles deben usar:

Para el entorno de TEST:

Para el entorno de PRODUCCIÓN:

Importante:

  • Las imágenes también están disponibles a través de una URL segura (indicar el protocolo https en lugar de http)
  • Existen excepciones en algunos proveedores de hoteles, y algunas imágenes ya vienen con la URL completa, o sea, ya comienzan con http.....En estos casos no colocar la URL delante porque les fallaría.

Ejemplo:

- URL normalizada para imágenes: <ImageURL>IDJ/B/B/BB3898629BE8D3DB188164A6611AA350.jpg</ImageURL>

- URL completa <ImageURL>http://psurfer-img.net/pathalaimagen/imagen.jpg</ImageURL>

(En este caso por favor no pegar la URL base delante)


Ejemplos: Suponiendo que la respuesta a la consulta de información adicional de un hotel es <AdditionalInfoQueryRS>

 <Details>
   <Products>
     <Hotels>
       <Hotel HotelCode="2444" SupplierID="HDO" Sequence="1" HotelDetailId="IDJ-1YT-4MO">
         <HotelName>El Conquistador Hotel</HotelName>
         <HotelDescriptions>
           ...
         </HotelDescriptions>
         <Amenities>
           ...
         </Amenities>
         <Addresses>
           ...
         </Addresses>
         <Position>
           ...
         </Position>
         <HotelRating HotelRatingCode="NMO.HTL.RTN.4ST" HotelRatingType="NMO.HTL.RTT.STR">
           ...
         </HotelRating>
         <ImageLinks>
           <ImageLink>
             <ImageLink>
             <ImageDescription ImageDisplayType="NMO.GBL.IMG.IMG"/>
             <ImageHeight UnitOfMeasureCode="9">185</ImageHeight>
             <ImageWidth UnitOfMeasureCode="9">250</ImageWidth>
             <ImageURL>IDJ/B/B/BB3898629BE8D3DB188164A6611AA350.jpg</ImageURL>
             <ThumbnailURL>IDJ/4/A/4A78390A062E3F504912F5E9ADEDBDB5.jpg</ThumbnailURL>
           </ImageLink>
         </ImageLinks>
         <LocationDetails>
           ...
         </LocationDetails>
       </Hotel>
     </Hotels>
   </Products>
 </Details>

</AdditionalInfoQueryRS>

Entonces las URLs quedarían:

Si la respuesta fue del Web Service de TEST:

Si la respuesta fue del Web Service de PRODUCCIÓN:

Sobre los tiempos de vida de los resultados de búsqueda en el Web Service

Los resultados de búsqueda se mantienen cacheados en el servicio durante 30 minutos, por lo cual los clientes del Web Service podrán usar los TripProductId devueltos por el mismo antes de los 30 minutos, caso contrario el Web Service podrá informar que los TripProductId ya no se encuentran disponibles o son inválidos.

Sobre los comentarios del proveedor

Los proveedores pueden llegar a enviar comentarios/remarks en dos instancias diferentes:

La primera en el resultado de la búsqueda: Tag Item Comments del Rate API Reference: Búsqueda de Disponibilidad de Hoteles

La segunda alternativa en la respuesta de la consulta de la reserva: SupplierComments API Reference: Consulta de una Reserva - Hoteles

Códigos de Error devueltos por el WebService

Código Descripción Significado
1000 Unexepected Error Ha ocurrido un error inesperado, por favor informe al Soporte de PriceSurfer
1015 No credit for doing the booking. El Contrato tiene establecido un límite de crédito que ha sido alcanzado, la reserva es rechazada por ese motivo.
1101 The TripProductId %s is not available El TripProductId no fue encontrado. Este mensaje aparece cuando el rate no se encuentra disponible en el proveedor, porque ha cambiado alguno de los diferentes atributos del rate (regimen / precio / tipo de disponibilidad)

Para estas situaciones, se debe cambiar a otro tripProductID, para chequear su disponibilidad en el proveedor.

1103 The booking of this product has been rejected by configuration: the product has cancellation charges as of this moment La reserva del producto ha sido rechazada porque, por configuración del contrato, el sistema rechazará las reservas que entren en Gastos de Cancelación al momento de realizarlas.
1104 The system couldn't check the cancellation charges of the product El sistema no pudo obtener los Gastos de Cancelación del producto.
1105 The booking of this product has been rejected by deadline: the product has cancellation charges El booking no se realizo ya que fue abortado el proceso (previo a la reserva) porque el contrato tiene activado el bloqueo para reservar items con "gastos de cancelacion".
1106 The booking of this product has been rejected because price has changed El booking no se realizo ya que fue abortado el proceso porque la validacion pre-booking detecto que el precio ha cambiado.
1107 Rate's live time in cache has been expired El tiempo de vida del rate en cache ha sido expirado.
1108 Connectivity error Error de conectividad detectado en dicho momento. En dicha situacion se debe enviar nuevamente el mensaje del caso.
1109 Unable to Query Booking Errores generados al consultar el Detalle de Reserva.
3000 Request detail for current booking - Relationated with TripProductId: xxxyyy Ante dicha situacion se debe realizar la consulta de detalle de reserva para recuperar la info detallada y actualizada de la reserva.
5000 No Availability for your request No ha habido disponibilidad para los parámetros de búsqueda dados
5010 The TripProductId %s was not found El TripProductId dado no fue encontrado. Pudo haber expirado o es incorrecto (no corresponde a un TripProductId informado por el Web Service en una búsqueda)
5011 The TripProductId %s has expired El TripProductId dado ha expirado. Sobre la expiración de los resultados de búsqueda
5012 The Search Results of your product have expired Los Resultados de Búsqueda correspondientes al producto seleccionado han expirado. Sobre la expiración de los resultados de búsqueda
5020 The Product is Invalid: %s El Producto es Inválido (Cambió el Precio ó Incurría en gastos de Cancelación al momento de reservar)
5100 Invalid Request Document: %s Se ha enviado un documento inválido. El mensaje contiene información sobre lo que es inválido en el documento.
5120 There are not availability when is booking El rate no esta disponible para ser reservado.
401 Unauthorized El Token de seguridad (X-PS-AUTHTOKEN) es inválido o no fue enviado

Importante: Información necesaria al reportar un error al Soporte de PriceSurfer

Si necesita informar de un fallo al soporte de PriceSurfer incluya la siguiente información:

  • Fecha en que ocurrió la incidencia
  • Entorno (Test / Producción)
  • XML de Request enviado al Servicio
  • XML de Response con que el Serivicio respondió
  • Si es una operación posterior a la Búsqueda de Disponibilidad (Validación de Disponibilidad, Solicitud de Información Adicional, Solicitud de Gastos de Cancelación, Solicitud de Reserva) por favor especificar también el DestinationId (destino) correspondiente al producto sobre el que se intentó la operación.

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.

Tablas de Códigos

Aplicable a Tabla
Hoteles Códigos de Grupos de Servicios e Instalaciones
Hoteles Códigos de Estrellas
Reserva Estados de la Reserva
Hoteles Tipos de Alojamientos
Hoteles Tipos de Descripciones
Destinos Tipos de Destinos
Hoteles Tipos de Estrellas
Reserva Tipos de Gastos de Cancelación
Habitaciones Tipos de Habitaciones
Pasajeros Tipos de Identificadores de Pasajeros
Hoteles Tipos de Imágenes
Reservas Tipos de Localizadores (identificadores) de la Reserva
Pasajeros Tipos de Nombres de Pasajeros
Pasajeros Tipos de Pasajeros
Tarifa Tipos de Pensiones
Hoteles Tipos de Servicios e Instalaciones (Amenities)
Hoteles Tipos de Teléfonos
General Tipos de Email
General Códigos de proveedores
Tarifa Tipos de tarifa

Destinos

Listado de destinos de Price Surfer: