Está en la página 1de 34

Documentacin XML Web Service

Versin 5.1
XML Hoteles


24/09/2013
Transhotel
Departamento de interfaces








Copyright 2013 - Grupo TransHotel Departamento de Interfaces 2
Tabla de contenido
1 INTRODUCCIN ............................................................................................................................................ 4
1.1 CMO FUNCIONA EL XML WEB SERVICE DE TRANSHOTEL ........................................................................................... 4
1.2 REQUERIMIENTOS COMERCIALES ............................................................................................................................. 5
2 CARACTERSTICAS GENERALES ..................................................................................................................... 5
3 CONEXIN AL WEB SERVICE DE TRANSHOTEL .............................................................................................. 6
4 ESQUEMA PROCESO DE RESERVA. ................................................................................................................ 7
4.1 BSQUEDA DE HOTEL (GETAVAILACCOMADVANCED) .................................................................................................. 8
4.1.1 Estructura bsicos de la peticin ........................................................................................................... 9
4.1.2 Informacin y peculiaridades de la llamada .......................................................................................... 9
4.1.3 Etiquetas de la peticin ......................................................................................................................... 9
4.2 PRE-RESERVA DE HOTEL (MAKERESERVATIONADVANCED) .......................................................................................... 12
4.2.1 Estructura bsicas de la peticin ......................................................................................................... 12
4.2.2 Informacin y peculiaridades de la llamada ........................................................................................ 12
4.2.3 Etiquetas de la peticin ....................................................................................................................... 12
4.2.4 Informacin adicional (LEVEL A) .......................................................................................................... 13
4.3 CONFIRMACIN DE LA RESERVA (CONFIRMRESERVATION) ........................................................................................ 135
4.3.1 Estructura bsicas de la peticin ....................................................................................................... 145
4.3.2 Informacin y peculiaridades de la llamada ...................................................................................... 145
4.3.3 Etiquetas de la peticin ..................................................................................................................... 156
5 ESPECIFICACIONES Y CARACTERSTICAS ADICIONALES. ............................................................................... 17
5.1 CARACTERSTICAS AGENCIAS PREPAGO .................................................................................................................... 17
5.2 CREACIN DE INTEGRACIN EN VARIOS IDIOMAS ...................................................................................................... 17
5.3 OPCIONES ADICIONALES DE BSQUEDA. ................................................................................................................. 17
5.4 RESERVAS EN PETICIN. ....................................................................................................................................... 18
5.5 GESTIN DE ACOMPAANTES. .............................................................................................................................. 18
5.6 BSQUEDAS EN ALREDEDORES. ............................................................................................................................. 18
5.7 HOTELES CON PVP OBLIGATORIO .......................................................................................................................... 18
5.7.1 PROCESO DE RESERVA ............................................................................................................................... 18
5.7.1.1 BSQUEDA DE HOTEL (GETAVAILACCOMADVANCED) ......................................................................... 19
5.7.2 PROCESO DE PRERESERVA ......................................................................................................................... 19
5.7.2.1 PRE-RESERVA DE HOTEL (MAKERESERVATIONADVANCED) ................................................................... 19
5.7.2.2 RECALCROOMPRICE (OPCIONAL) ......................................................................................................... 19
5.7.3 RECOGIDA DE INFORMACIN ...................................................................................................................... 20
5.7.3.1 DETALLES DE LA HABITACIN (GETROOMDETAILS)...................................................................... 20
5.8 INCLUDEADVRESERVATIONINFO INFORMACIN ADICIONAL (LEVEL A). ............................................................ 21

6 RESTO DE LLAMADAS. ................................................................................................................................. 27
6.1 PROCESO DE RESERVA ......................................................................................................................................... 27
6.1.1 GetAvailAccomAdvanced. .................................................................................................................... 27
6.1.2 MakeReservationAdvanced. ................................................................................................................ 27
6.1.3 ConfirmReservation. ............................................................................................................................ 27
6.2 GESTIN DE RESERVAS ........................................................................................................................................ 27
6.2.1 CancelReservation. .............................................................................................................................. 27
6.2.2 GetIssuedInvoices. ............................................................................................................................... 27
6.2.3 GetReservationDetails. ........................................................................................................................ 28


Copyright 2013 - Grupo TransHotel Departamento de Interfaces 3
6.2.4 ConfirmPayment. ................................................................................................................................. 28
6.2.5 PaymentManager. ............................................................................................................................. 288
6.2.6 GetReservationsMade. ........................................................................................................................ 28
6.2.7 UndoMakeReservation28
6.3 MODIFICACIN DE RESERVAS ................................................................................................................................ 28
6.3.1 ModifyReservationRooms.................................................................................................................... 28
6.3.2 MakeModifyReservationRooms ......................................................................................................... 298
6.3.3 ConfirmModifyReservationRooms. ...................................................................................................... 28
6.3.4 ModifyReservationDates. .................................................................................................................... 29
6.3.5 ConfirmModifyReservationDates. ....................................................................................................... 29
6.4 RECOGIDA DE INFORMACIN ................................................................................................................................ 29
6.4.1 GetCancellationCost. ........................................................................................................................... 29
6.4.2 GetCancellationPolicy. ......................................................................................................................... 29
6.4.3 GetCountryDetails. .............................................................................................................................. 29
6.4.4 GetErrors. ............................................................................................................................................ 29
6.4.5 GetHotels. ............................................................................................................................................ 29
6.4.6 BuildSearchForm. ................................................................................................................................ 30
6.4.7 GetGeneralData................................................................................................................................... 30
6.4.8 SearchCityByName. ............................................................................................................................. 30
6.4.9 SearchCityByName. ............................................................................................................................. 30
6.4.10 GetAllRoomsDetails. ....................................................................................................................... 30
6.4.11 GetHotelDetails. ............................................................................................................................. 30
6.4.12 GetHotelExtraServices. ................................................................................................................... 30
6.4.13 GetRoomDetails .............................................................................................................................. 30
6.4.14 GetVoucherObservations. ............................................................................................................... 31
7 COMO OBTENER XML. ................................................................................................................................. 32
8 PROCESO DE CERTIFICACIN. ...................................................................................................................... 34



Copyright 2013 - Grupo TransHotel Departamento de Interfaces 4
1 Introduccin

El XML Web Services de Transhotel es un servicio de Internet que permite a las agencias poder integrar
un servicio de reservas de hoteles, traslados y visitas.

Este documento especifica los requerimientos y procesos necesarios para implementar el XML Web
Services 5.1 de Transhotel.

As mismo le informar de cmo implementar el sistema en su pgina Web usando las llamadas XML
para ofrecer la reserva online a clientes finales.

Esta versin, la 5.1 del XML de Transhotel est basada en la anterior, aunque implementando nuevas
funcionalidades que ampliarn y mejorarn el rendimiento del sistema.

La principal diferencia con el XML anterior es la introduccin de diferentes formas de pago: Transhotel
(TH), Pago directo en el hotel (BE) y Tarjeta Hotelplus (HP).

Adems, esta nueva versin, permite visualizar todas las tarifas disponibles del hotel en la bsqueda de
disponibilidad, potenciando la respuesta de disponibilidad.

1.1 Cmo funciona el XML Web Service de Transhotel

El XML Web Services de Transhotel trabaja con datos en XML. La agencia enva una peticin XML y
Transhotel manda la respuesta, tambin en formato XML.
Todas las llamadas al servidor de Transhotel se realizan mediante parmetros pXML y pCall. A
continuacin mostramos un grfico del funcionamiento:













Copyright 2013 - Grupo TransHotel Departamento de Interfaces 5
1.2 Requerimientos comerciales

Para poder implementar el XML Web Services de Transhotel ser necesario alcanzar un acuerdo
comercial con Transhotel. Si su agencia no tiene acuerdo comercial con Transhotel, por favor, contacte
con el departamento comercial comercial@transhotel.com

Tanto la conexin a Transhotel a travs del Web Service, como el soporte de dicha herramienta son
gratuitos.

Antes de pasar al entorno real de venta del producto de Transhotel, ser necesario superar un
Proceso de validacin por parte del departamento tcnico de Transhotel. Puede encontrar ms
informacin sobre este proceso en el punto 8 de este manual.

2 Caractersticas Generales

A continuacin presentamos las nuevas funcionalidades del XML Web Service 5.1 Hoteles, as como
las ltimas funcionalidades introducidas:

Respuesta de disponibilidad, (GetAvailAccomAdvanced) con la posibilidad de recibir todas las
tarifas disponibles de los hoteles.

Formas de pago. La nueva interface permite efectuar el pago a Transhotel, el pago directo en el
Hotel, o usar la Tarjeta Hotelplus para el pago de la reserva. Al igual que nuestra herramienta
TOR System, se podr elegir recibir disponibilidad de hoteles en una sola forma de pago o
combinar las tres dependiendo de la configuracin de la agencia.

Las agencias con precios Comisionables podrn combinar todas las formas
de pago en la misma peticin. Por el contrario las agencias netas no podrn
combinar las peticiones de pago TH con Pago Directo (BE) u HotelPlus (HP).

El Web Service de Transhotel permite dar de alta reservas de hoteles, traslados y visitas, as
como la cancelacin de las mismas. Tambin modificaciones de (Fechas, Habitaciones y
Nombres de pasajeros).

Desde la ltima versin, Transhotel ofrece la posibilidad de hacer reservas a travs del Web
Service a las agencias Crdito como Prepago, ofreciendo las mismas vas de pago que las
usadas en la herramienta interna TOR System. Puede consultar las formas de pago en el punto
6.1 de este documento.

Recordamos que el XML Web Service de Transhotel es una plataforma multi-idioma y multi-
divisa.

Transhotel, en su afn por facilitar la consolidacin de datos estticos de las integraciones,
facilita todos estos datos de sus hoteles a travs de su plataforma FTP y del propio Web Service.
Consulte webservice.transhotel.com para ms informacin acerca del acceso al FTP. Los datos
estticos debern actualizarse mensualmente (mnimamente) a travs del servidor FTP. El
acceso al servidor FTP se proporcionara cuando se haya superado el proceso de certificacin y
se enviara el acceso junto con las credenciales para el entorno de produccin.

El XML Web Service incorpora la posibilidad de consolidar los datos de las reservas hechas en
Transhotel con los sistemas de BackOffice de las agencias. Para obtener ms informacin,
contacte con el departamento de Interfaces.


Copyright 2013 - Grupo TransHotel Departamento de Interfaces 6
3 Conexin al Web Service de Transhotel

Una vez realizadas todas las acciones comerciales, para conectarnos al Web Service, el departamento
de Interfaces de Transhotel nos facilitar las credenciales de acceso: usuario, password y URL del
entorno de pruebas de Transhotel. Estos tres parmetros son bsicos para llevar a cabo con xito la
conexin al Web Service.

Para realizar la comunicacin con el Web Service, el XML a enviar debe estar compuesto de un
parmetro pXML, que contiene el documento XML y un parmetro pCall que llevar el nombre de la
llamada.

Es muy importante enviar el pXML como primer parmetro en la peticin y el pCall despus. Los
parmetros deben ser enviados por POST, el mtodo GET no es vlido.

Todas las llamadas son validadas por un schema XML antes de procesarla. Estos schemas son
llamadas con el nombre seguido de la extensin .xsd. Los schemas XML muestran la estructura XML
de la entrada (Nombre_Llamada.xsd) y salida (Nombre_LLamadaOutput.xsd). Puede descargar todos
los schemas del XML de Transhotel en el siguiente enlace:
http://interfaces.transhotel.com/interfaces/schemas/xml_schemas.zip

El XML Web Services tambin es utilizado para el uso interno de aplicaciones. Por lo tanto el XML podra
contener llamadas o etiquetas que no estn incluidas en la documentacin. Se recomienda usar
solamente las etiquetas incluidas en la documentacin.





















Copyright 2013 - Grupo TransHotel Departamento de Interfaces 7
4 Esquema proceso de reserva.
1.Es imprescindible el uso de la compresin de Gzip
2. Uso obligado de HTTPS en las siguientes llamadas para todos los
desarrollos nuevos y aquellos que se actualice:

-Login.
- ConfirmReservation (cuando hay datos de pago en el xml.)
- AddAmountCardHPlus
- GetNifInvoices
- NifAgencyReservations
- NifHotelReservations
- BuildSearchForm
- LoginRQ
- LoginB2B
- CreateAgency
- NifActivitiesReservations
- GetActivitiesProvider
- NifTransfersReservations
- GetTransfersProvider
- LoginHPlus
- UserLogInHPlus

*Leyenda tabla de campos.
Campos obligatorios
1 campo del grupo obligatorio
Campos opcionales
La siguiente informacin es un esquema bsico del flujo de datos de un proceso de reserva elemental.
En el punto 5 de esta documentacin existe informacin detallada de estas y otras llamadas.
El uso de un IDsession es exclusivo de un solo proceso de reserva, no pudiendo ser reutilizado para otro
proceso de reserva.




Copyright 2013 - Grupo TransHotel Departamento de Interfaces 8
4.1 Bsqueda de hotel (GetAvailAccomAdvanced)

4.1.1 Estructura bsica de la peticin
Datos bsicos a enviar
Lugar: (A elegir uno entre los cinco tipos)
o Hotel
o Grupo hotel (Un mismo hotel fsico puede tener dos IDs de hotel por lo que es
recomendable realizar las peticiones de un hotel por IDgroup en lugar de por IDhotel.)
o Ciudad
o IATA
o rea
Fechas
Nmero de pasajeros
Rgimen (No es obligatorio. Si no se indica, se devolver el ms barato en cada caso).
Forma de pago (Dependiendo de la configuracin de la agencia, se permite ms de una forma
de pago en la misma peticin).
o TH Estndar Transhotel
o BE Pago directo en el hotel
o HP Hotel Plus
Filtros
Categora del hotel (1 Estrella, 2, 3)
Servicios (Piscina, Gimnasio, Restaurante)
Tipo de producto (Montaa, Nieve, Urbano)
Datos Opcionales
Habitaciones opcionales.
Regmenes opcionales.
Informacin del hotel.


4.1.2 Informacin y peculiaridades de la llamada

La respuesta de la bsqueda devuelve todos los hoteles, tarifas y habitaciones disponibles que coincidan
con los datos bsicos y los filtros recibidos.

La estructura de la respuesta es la siguiente.

<Hotel>
<Rates>
<Rate>
<Rooms>
<Room></Room>
</Rooms>
</Rate>
</Rates>
</Hotel>

Existen varias peculiaridades en la respuesta de disponibilidad de Transhotel.


Copyright 2013 - Grupo TransHotel Departamento de Interfaces 9

Existe la posibilidad de recibir el IDgroup para agrupar los IDs de hotel que pertenezcan al
mismo hotel fsico. Transhotel puede tener ms de un ID hotel perteneciente al mismo hotel
fsico debido a la recepcin de los mismos desde distintos canales.

Una respuesta de disponibilidad puede incluir un rgimen igual o superior al solicitado en
cualquier da de la reserva. Siempre se devuelve el rgimen ms barato disponible.

Si el rgimen est incluido solo algunos das de la reserva, se recibir la etiqueta <Days> con
valor S = Some days (Algunos das).

Es posible diferenciar las tarifas disponibles con la etiqueta IDRate devuelto dentro de cada
tarifa.

Si la peticin de disponibilidad incluye nios, la edad indicada de estos deber coincidir con la
edad de los nios indicada en la confirmacin de la reserva.

La etiqueta TotalPrice (Precio calculado teniendo en cuenta suplementos, descuentos)
pertenece exclusivamente a la habitacin con la etiqueta <Quantity> distinta de cero de la
primera tarifa devuelta (la ms barata). Para todas las dems etiquetas <Price>, se deber
recalcular el precio teniendo en cuenta suplementos, descuentos

Se debe comprobar siempre el precio final de la reserva con la etiqueta
TotalPrice de la llamada MakeReservationAdvanced antes de confirmar.


4.1.3 Etiquetas de la peticin
Etiqueta Descripcin
Login
Login --> Username Nombre de usuario
Login --> Password Contrasea
Login --> Language
Idioma (ENG, SPA, FRE, POR, ITA, GER, DUT, SWE, DKK, PL, CR,
CH, GR, NOR)

Modificacin del Markup para agencias Netas (Opcional)
OverrideMarkup
Se sustituye el Mark-up existente en la configuracin de la
agencia
OverrideMarkup --> MarkupType Tipo de Mark-up a aadir: P = Porcentaje, I = Importe
OverrideMarkup -->
MarkupFixedAmount
Importe
OverrideMarkup -->
MarkupPercentage
Porcentaje
OverrideMarkup -->
MarkupMinimumAmount
Importe mnimo en caso de que el markup sea un porcentaje



Copyright 2013 - Grupo TransHotel Departamento de Interfaces 10
Radio de bsqueda (Opcional)
SearchWithIn
Radio alrededor de la ciudad indicada en el que se buscan
hoteles
AcceptsRequests La respuesta incluye hoteles en peticin Y/N
GetAccomLocation -->
SearchWithin --> DistanceType
Tipo de distancia K = Kilmetros
GetAccomLocation -->
SearchWithin --> Distance
Distancia

Caractersticas de la bsqueda
GetAccomLocation --> IDcity Bsqueda por ID ciudad
GetAccomLocation --> IDgroup Bsqueda por ID grupo de hoteles
GetAccomLocation --> IDhotel Bsqueda por ID hotel
GetAccomLocation --> IDiata Bsqueda por Cdigo IATA
GetAccomLocation --> IDarea Bsqueda por ID rea
GetDates --> CheckIn Fecha de entrada
GetDates --> CheckOut Fecha de salida
GetRoomDetails --> Room -->
RoomQuantity
Nmero de habitaciones
GetRoomDetails --> Room -->
NumAdults
Nmero de adultos por habitacin
GetRoomDetails --> Room -->
NumChildren
Nmero de nios por habitacin
GetRoomDetails --> Room -->
FirstChildAge
Edad del primer nio
GetRoomDetails --> Room -->
SecondChildAge
Edad del segundo nio
GetRoomDetails --> Room -->
ThirdChildAge
Edad del tercer nio
GetRoomDetails --> Room -->
InclBoardType
Rgimen mnimo incluido en la habitacin

Tarifas opcionales
PaymentOptions -->
IDPaymentOption
Formas de pago TH = Transhotel, BE = Pago directo en el hotel,
HP = Hotel plus


Informacin Adicional


Copyright 2013 - Grupo TransHotel Departamento de Interfaces 11
GetAdvancedOptions
Puede encontrar las categoras, servicios, etc en la llamada
BuildSearchform o en nuestro FTP
GetAdvancedOptions -->
AccomType
Tipo de establecimiento
(BuildSearchForm --> GetParams --> Param (ACCOM_TYPE))
GetAdvancedOptions -->
AccomCategory
Categora, la respuesta ser la categora seleccionada o superior
(BuildSearchForm --> GetParams --> Param (CATEGORIES))
GetAdvancedOptions -->
AccomLocation
Localizacin
(BuildSearchForm --> GetParams --> Param
(ACCOM_LOCATION))
GetAdvancedOptions -->
AccomServices
Servicios
(BuildSearchForm --> GetParams --> Param (ACCOM_SERVICES))

Datos opcionales
ReturnedDataOptions Datos opcionales. Se mostrarn o no segn valor (Y,N)
ReturnedDataOptions -->
IncludeOptionalRooms
Habitaciones opcionales para cada distribucin (Y,N)
ReturnedDataOptions -->
IncludeAddHotelInfo
Incluir informacin adicional del hotel
ReturnedDataOptions -->
IncludeOptionalBoards
Mostrar regmenes opcionales disponibles
ReturnedDataOptions -->
IncludeRoomDays
Mostrar desglose de precios por da
ReturnedDataOptions -->
IncludeOptionalBoardsDays
Muestra el precio por da de los regmenes opcionales
ReturnedDataOptions -->
IncludeHotelsGuest
Muestra los hoteles que solicitan de forma obligatoria los
nombres de los acompaantes
ReturnedDataOptions -->
ReduceView
Obligatorio valor a Y Muestra una vista reducida de los datos
de cada Hotel/tarifa/habitacin
ReturnedDataOptions -->
GroupHotel
Muestra el ID del grupo de hotel
ReturnedDataOptions -->
IncludeParentBoard
Incluye el ID genrico de rgimen (DE = Desayuno, ME = Media
pensin, PC = Pensin completa y TI = Todo incluido)
ReturnedDataOptions -->
IncludeAdvReservationInfo
Devuelve las polticas de cancelacin y comisin de agencia
ReturnedDataOptions -->
FixedRatesHotels
Devuelve hoteles con PVP fijo





Copyright 2013 - Grupo TransHotel Departamento de Interfaces 12
4.2 Pre-reserva de hotel (MakeReservationAdvanced)

4.2.1 Estructura bsicas de la peticin

Datos bsicos de la peticin
ID sesin
ID habitacin
N de habitaciones seleccionadas
Datos opcionales
Rgimen

4.2.2 Informacin y peculiaridades de la llamada
La pre-reserva consiste en el bloqueo del cupo de la habitacin seleccionada en la bsqueda, con
la finalidad de no perder la disponibilidad de la habitacin mientras el usuario de la aplicacin/Web
revisa los datos del hotel y rellena los datos necesarios para confirmar la reserva. Existen varias
peculiaridades en la respuesta de pre-reserva de Transhotel.
La Etiqueta IDroom se genera a partir de los datos de la respuesta de disponibilidad. Esta
etiqueta es vlida exclusivamente para una sesin.
La habitacin se bloquea durante 30 minutos
Las polticas de cancelacin se refieren en todo momento a hora local de Espaa GTM +2 o +1
dependiendo de la poca del ao.

4.2.3 Etiquetas de la peticin
Etiqueta Descripcin
Principal
IDsession
Sesin devuelta en la respuesta de la llamada
GetAvailaAccomAdvanced necesaria para continuar con
el flujo de reserva.
Rooms --> Room --> IDroom
ID o Ids de habitacin "elegidos" en la respuesta de la
llamada GetAvailAccomAdvanced
Rooms --> Room --> Quantity
Nmero de habitaciones solicitadas para el IDroom
correspondiente. Nunca superior al quantity Solicitado
para esa distribucin en GetAvailAccomAdvanced.

Opciones adicionales
Rooms --> Room --> IDBoardType
Rgimen opcional seleccionado. Debe ser un ID de
rgimen no incluido por defecto en la habitacin
(Included=N). Si el board ya est incluido
(Included=Y), no se debe enviar este parmetro.
IDPaymentOption Tipo de pago seleccionado TH/BE/HP

Informacin extra


Copyright 2013 - Grupo TransHotel Departamento de Interfaces 13
Level
La opcin A en la etiqueta Level. Devuelve varias
etiquetas opcionales (Nuevo)
4.2.4 Informacin Adicional (Level A).
Solicitando en la pre-reserva (MakeReservationAdvanced) la etiqueta <Level>A<Level> Se devuelve
informacin adicional sobre la reserva, hotel, precios

ETIQUETA BREVE DESCRIPCIN
<IDhotel> ID de hotel.
<IDgroup> ID de grupo.
<Days> y <Day> para el
desglose por da
Deber mostrar las mismas etiquetas incluidas en el desglose
por da correspondientes a la llamada GetRoomDetails.

<TotalAmount>
Importe en la moneda de la reserva de los gastos de
cancelacin.
<Supplements> Todos los Suplementos de la reserva.
<Supplement>
Desglose de cada suplemento con sus correspondientes
etiquetas Description y Amount.
<Discounts> Todos los Descuentos de la reserva.
<Discount>
Desglose de cada descuento con sus correspondientes
etiquetas Description y Amount.
<Description> Descripcin del Suplemento o Descuento.

<Amount> Importe del Suplemento o Descuento.
<TimeZoneGMT> Indica e l GMT CET. Puede tener valor +1 +2.
<VoucherObservations>
Debe incluir toda la informacin que se muestra en el Debe
Saber de la respuesta de disponibilidad del TOR System.
<TermsConditions>
URL de trminos y condiciones generales y particulares que
salen en el TOR.









Copyright 2013 - Grupo TransHotel Departamento de Interfaces 14

4.3 Confirmacin de la reserva (ConfirmReservation)

4.2.5 Estructura bsicas de la peticin

Datos bsicos de la peticin
ID sesin
Nombre, apellido, correo electrnico, titulo
Datos opcionales

Preferencias
Pago directo.
Datos acompaantes
Detalles de factura

4.2.6 Informacin y peculiaridades de la llamada

Existen varias peculiaridades en la llamada de confirmacin de Transhotel. En primer lugar tendrs que
indicarnos el titular de la reserva por un lado y el resto de huspedes de la habitacin/es en otro.

<ConfirmReservation>

<FirstName>John</FirstName>
<LastName>Smith</LastName>
<Titulation>1</Titulation>

<Guest>
<Adults>
<Adult>
<FirstName>John i</FirstName>
<LastName>Smith</LastName>
<Titulation>1</Titulation>
</Adult>
</Adults>
</Guest>

Existen distintas opciones de confirmacin dependiendo del tipo de Agencia crdito o prepago y en el
caso de las agencias en prepago. Existen diferencias dependiendo del pas.









Copyright 2013 - Grupo TransHotel Departamento de Interfaces 15

4.2.7 Etiquetas de la peticin

Etiqueta Descripcin
Principal
Idsession
ID o IDs de habitacin "elegidos" en la respuesta de la
llamada GetAvailAccomAdvanced
FirstName Nombre del titular de la reserva.
LastName Apellido del titular de la reserva
Titulation Sr, Sra titulo del cliente.

Opcionales
ClientEmail Email del cliente
AgencyReference Referencia interna de la agencia que realiza las reservas
Preferences --> Idpreference preferencias seleccionables para la habitacin

Informacin pago
DirectPayment --> CreditCardType
Tipo de tarjeta para realizar el pago (1 = Visa, 2
Mastercard...)
DirectPayment --> CreditCardNumber Nmero de la tarjeta de crdito
DirectPayment --> CVV Cdigo CVC tarjeta
DirectPayment --> ExpiryMonth Mes de caducidad de la tarjeta.
DirectPayment --> ExpiryYear Ao de caducidad de la carga
DirectPayment --> CardHolder Nombre del propietario de la tarjeta de crdito
DirectPayment --> MakeInvoice. solicitar factura Y/N
DirectPayment --> InvoiceDetails -->
NameOrCompany
Nombre de la empresa
DirectPayment --> InvoiceDetails --> Address Direccin de facturacin
DirectPayment --> InvoiceDetails -->
PostalCode
Cdigo postal de la agencia
DirectPayment --> InvoiceDetails --> City Ciudad de facturacin
DirectPayment --> InvoiceDetails --> Country pas de facturacin
DirectPayment --> InvoiceDetails --> VAT No Numero NIF de la empresa
DirectPayment --> InvoiceDetails -->
InvoiceEmail
Correo electrnico de la empresa







Copyright 2013 - Grupo TransHotel Departamento de Interfaces 16

5 Especificaciones y caractersticas adicionales.

5.1 Caractersticas agencias prepago

Transhotel ofrece la posibilidad de hacer reserva a aquellas agencias que su forma de pago sea
Prepago. Para poder usar este mtodo de pago.

A la hora de confirmar una reserva con una agencia Prepago, es necesario pasar los parmetros
necesarios dependiendo de la forma de pago escogida. Recordamos que las formas de pago para cada
reserva son devueltas en la respuesta a MakeReservationAdvanced, y dependiendo de la localizacin en
su pas y configuracin de agencia usted se encontrara con algunos de los siguientes mtodos de pago.

Pago Directo Agencia: Transhotel cobrar el importe Neto de una reserva, por lo que pueden usarlo tanto
agencias Netas o Comisionables. Dentro de estas formas de pago nos encontramos con pago Inmediato
como Aplazado. El pago Inmediato cobra la reserva antes de confirmarla, mientras que el Aplazado lo
realiza antes de entrar la reserva en gastos.

Los elementos a pasar en la confirmacin son: IdPaymentMethod: PDTA PaymentMethod: I (Inmediato).

Transferencia: La agencia de viajes deber realizar una transferencia del importe Neto de la reserva.
Esta forma de pago est disponible para reserva que no tienen gastos de cancelacin.

IdPaymentMethod: TRANS

Gestor de Pagos: La agencia de viajes domiciliar la reserva a travs de XML o TOR System. Si la
reserva entra en gastos de cancelacin en el momento de realizar la reserva, se deber domiciliarla
reserva antes de confirmarla en la propia llamada ConfirmReservation.

IdPaymentMethod: GPAG PaymentMethod: I (Inmediato) y D (Aplazado)


5.2 Creacin de integracin en varios idiomas.
La sesin se crea en el idioma por defecto de la integracin, pero es posible cambiar desde el Login o
Bsqueda de disponibilidad el idioma, para poder recibir los resultados del proceso de reserva en el
idioma deseado.

<Login>
<Username>username</Username>
<Password>password</Password>
<Language>SPA</Language>
</Login>

5.3 Opciones adicionales de bsqueda.

La llamada GetAvailAccomAdvanced ofrece varios criterios para poder definir an ms la bsqueda
como por ejemplo, tipo de establecimiento (hotel, motel, hostal, etc.), categora (1, 2, 3, 4 o 5 estrellas,
etc.), situacin del establecimiento (centro ciudad, aeropuerto, etc.), y servicios (parking incluido,
gimnasio, etc.)



Copyright 2013 - Grupo TransHotel Departamento de Interfaces 17
5.4 Reservas en peticin.

Por defecto la bsqueda de resultados cuando buscamos disponibilidad en Alojamientos, Visitas y
Traslados retorna nicamente resultados con disponibilidad.
No obstante, es posible incluir un parmetro en la bsqueda para recibir resultados en peticin. Es muy
importante que la agencia tenga una infraestructura para manejar estos tipos de reserva.
Para activar las reservas en peticin es muy importante ponerse en contacto con el departamento de
interfaces para poder realizar este tipo de reservas.
El panel de administracin de la integracin muestra si estn activadas o no este tipo de reservas.

5.5 Gestin de Acompaantes.

Hemos adaptado el XML, para poder realizar reservas en hoteles de Estados Unidos y otras regiones. En
estas regiones se debe enviar los datos de todos los de los pasajeros que se vayan a alojar en el hotel.
Si alguna agencia, debido a su programacin no pueda enviarnos estos datos, es posible filtrar estos
hoteles desde la bsqueda de disponibilidad con la etiqueta.
<ReturnedDataOptions>
<IncludeHotelsGuest>Y</IncludeHotelsGuest>
</ReturnedDataOptions>

5.6 Bsquedas en alrededores.

La bsqueda de disponibilidad da la posibilidad de buscar en los alrededores de una ciudad, para ello
facilitamos la etiqueta SearchWithin en la bsqueda de disponibilidad, ya sea en kilmetros o en horas.

5.7 Hoteles con PVP Obligatorio

Con el fin de ampliar el inventario de hoteles disponibles ofrecido a nuestros clientes B2C, Transhotel proporciona
tambin hoteles con un PVP mnimo de obligado cumplimiento.

Este tipo de hoteles se reciben incluyendo en la peticin de disponibilidad del Web Service
(GetAvailAccomAdvanced) la etiqueta FixedRatesHotels con valor igual a Y dentro de la etiqueta
ReturnedDataOptions.

Transhotel muestra una etiqueta identificativa en aquellos hoteles con PVP mnimo e indica tanto los precios netos
como los PVP de todo el conjunto de etiquetas que afectan al precio total de la reserva (Precio Habitacin,
Regmenes, Suplementos, etc.).

Ejemplo: Despus de indicar el precio neto total de la reserva (etiqueta TotalPrice), se muestra tambin el PVP
mnimo de la reserva (etiqueta FixedTotalPrice).

Los hoteles sin esta caracterstica no sufren ningn cambio.

Las funcciones afectadas por este desarrollo en el proceso de reserva son GetAvailAccomAdvanced,
MakeReservationAdvanced, GetReservationDetails, GetRoomDetails y RecalcRoomPrice



Copyright 2013 - Grupo TransHotel Departamento de Interfaces 18
A continuacin, se indican las etiquetas aadidas en cada llamada:

5.7.1 PROCESO DE RESERVA

El PVP mnimo del servicio se muestra en los ejemplos de abajo en las etiquetas de color azul oscuro, mientras los
precios netos se muestran en las etiquetas de color azul claro.

5.7.1.1 BSQUEDA HOTEL:

<GetAvailAccomAdvanced>
<IDSession>
<Hotel>
<ID>29302</ID>

<AvailStatus>A</AvailStatus>
<TotalPrice>3.365,41</TotalPrice>
<FixedTotalPrice>3.565,41</FixedTotalPrice>
<Supplements/>
<FixedSuplements/>
<Currency>EUR</Currency>

<Price>2.521,59</Price>
<FixedRoomPrice>2.721,59</FixedRoomPrice>
<NumAdults>2</NumAdults>

</InclBoardType>
<Quantity>1</Quantity>
<AvailStatus>A</AvailStatus>
<Rate>1003518</Rate>
<Discount>504,33</Discount>
<FixedDiscount>604,33</FixedDiscount>
<BoardPrice>0</BoardPrice>
<Boards>
<Board>
<Price>0</Price>
<FixedBoardPrice>0</FixedBoardPrice>
<Included>Y</Included>
<Adults>

</Board>
</Boards>
</Room>


5.7.2 PRE-RESERVA

5.7.2.1 MakeReservationAdvanced

<MakeReservationAdvanced>
<Reservation>
<ID>63051815</ID>
<CheckIn>2012-12-28</CheckIn>


Copyright 2013 - Grupo TransHotel Departamento de Interfaces 19

<TotalPrice>2.017,26</TotalPrice>
<FixedTotalPrice>3.565,41</FixedTotalPrice>
<Supplements/>
<FixedSuplements/>
<ListDiscounts>
<Discount>
<Description>DISCOUNT</Description>
<Amount>504,33</Amount>
< FixedDiscounts >604,33</ FixedDiscounts>
</Discount>
</ListDiscounts>
<ListSupplements>
<Suplement>
<Description>DISCOUNT</Description>
<Amount>504,33</Amount>
<FixedDiscounts >604,33</ FixedDiscounts >
</Suplement>
<ListSupplements>
<Currency>EUR</Currency>
</Reservation>
<Hotel>
<Rooms>
<Room>
<IDRoomType>NDB1</IDRoomType>
<RoomType>Doble + 1 nio</RoomType>
<Price>2.521,59</Price>
<FixedRoomPrice>2.721,59</FixedRoomPrice>
<NumAdults>2</NumAdults>

<Rate>NR</Rate>
<Discount>504,33</Discount>
<FixedDiscount>604,33</FixedDiscount>
</Room>
</Rooms>
<CancellationPolicies>

</MakeReservationAdvanced>
5.7.2.2. RecalcRoomPrice (LLAMADA OPCIONAL)
<RecalcRoomPrice>
<Reservation>
<AvailStatus>A</AvailStatus>
<TotalPrice>491,02</TotalPrice>
<FixedTotalPrice>565,41</FixedTotalPrice>
<Supplements/>
<FixedSuplements/>
<Currency>EUR</Currency>
</Reservation>
<Rooms>
<Room>
<ID>MTYyNTk3I0RCM1AjQ1QjQ1QjMiMxMA==</ID>


Copyright 2013 - Grupo TransHotel Departamento de Interfaces 20
<IDRoomType>DB3P</IDRoomType>
<Description>Triple</Description>
<NumAdults>2</NumAdults>
<NumChildren>1</NumChildren>
<Quantity>1</Quantity>
<Days>
<Day>
<Date>2012-12-28</Date>
<PricePerDay>69,91</PricePerDay>
< FixedPricePerDay >72,59</ FixedPricePerDay >
<BoardPricePerDay>0</BoardPricePerDay>
< FixedBoardPricePerDay >0</ FixedBoardPricePerDay >
<AvailStatus>A</AvailStatus>
<InclBoardType>
<Adults>
<ID>CT</ID>
<Description>DESAYUNO CONTINENTAL</Description>
</Adults>
<Children>
<ID>CT</ID>
<Description>DESAYUNO CONTINENTAL</Description>
</Children>
</InclBoardType>
</Day>


</Day>
</Days>
</Room>
</Rooms>
</RecalcRoomPrice>

5.7.3 RECOGIDA DE INFORMACIN

El PVP mnimo del servicio se muestra en el ejemplo de abajo en las etiquetas de color azul oscuro, mientras el
precio netos se muestra en las etiquetas de color azul claro.

5.7.3.1 DETALLES HABITACIN

<GetRoomDetails>
<Room>
<ID>MTYyNTk3I0RCQ00jQ1QjKiMyIzAx</ID>
<IDRoomType>DBCM</IDRoomType>
<Description>Double (double bed)</Description>
<NumAdults>2</NumAdults>
<NumChildren>0</NumChildren>
<Days>
<Day>
<Date>2013-01-01</Date>
<PricePerDay>69,91</PricePerDay>
< FixedPricePerDay >72,59</ FixedPricePerDay >
<BoardPricePerDay>0</BoardPricePerDay>
< FixedBoardPricePerDay >0</ FixedBoardPricePerDay >


Copyright 2013 - Grupo TransHotel Departamento de Interfaces 21
<AvailStatus>A</AvailStatus>
<InclBoardType>
<Adults>
<ID>CT</ID>
<Description>CONTINENTAL BREAKFAST</Description>
</Adults>
<Children>
<ID/>
<Description/>
</Children>
</InclBoardType>
</Day>
<Day>

</Days>
</Room>
</GetRoomDetails>

5.8 IncludeAdvReservationInfo:
Introduciendo en la peticin de la bsqueda de disponibilidad la etiqueta IncludeAdvReservationInfo con valor
Y se devuelven en la respuesta las polticas de cancelacin y adicionalmente si la agencia est configurada en
modo comisionable tambin se devuelve la comisin que se va a aplicar. Ejemplo:


Llamada de disponibilidad con Multitarifa (Polticas de cancelacin en disponibilidad):

<?xml version="1.0" encoding="utf-8"?>
<GetAvailAccomAdvanced>
<Login>**** </Login>
<AcceptsRequests>N</AcceptsRequests>
<Currency>EUR</Currency>
<GetAccomLocation>
<IDhotel>21411</IDhotel>
</GetAccomLocation>
<GetDates>
<CheckIn>2013-12-22</CheckIn>
<CheckOut>2013-12-23</CheckOut>
</GetDates>
<GetRoomDetails>
<Room>
<RoomQuantity>1</RoomQuantity>
<NumAdults>2</NumAdults>
</Room>
</GetRoomDetails>
<PaymentOptions>
<IDPaymentOption>TH</IDPaymentOption>
<IDPaymentOption>BE</IDPaymentOption>
<IDPaymentOption>HP</IDPaymentOption>
</PaymentOptions>
<ReturnedDataOptions>
<IncludeHotelsGuest>Y</IncludeHotelsGuest>
<IncludeAdvReservationInfo>Y</IncludeAdvReservationInfo>


Copyright 2013 - Grupo TransHotel Departamento de Interfaces 22
</ReturnedDataOptions>
</GetAvailAccomAdvanced>


Respuesta de disponibilidad con Multitarifa (polticas de cancelacin):

En la respuesta a nivel de tarifa (entre <PaymentOptions> y <Rooms>) aparecer dicha etiqueta con el siguiente
formato separados por ;:

<TimeBeforeCancellationPenalty><![CDATA[HoursBeforeCheckInTime;CheckInTime;Percentage;PercetageOver
]]></TimeBeforeCancellationPenalty>

Donde cada uno significa:

HoursBefore horas antes del CheckInTime
CheckInTime Indica la hora exacta de Entrada
Percentage Porcentaje aplicado sobre PercentageOver
PercetageOver Indica si es A (Reserva Completa) o F (Primera noche)

Como nota importante mencionar que en aquellos casos en los que el hotel no nos facilite dicha poltica
devolveremos el valor -1

<>
- <Rates>
- <Rate>
- <IDRate>- <![CDATA[ 1003518 ]]> </IDRate>
- <Description>- <![CDATA[ ]]> </Description>
- <ModifyRate>- <![CDATA[ Y ]]> </ModifyRate>
- <ExtraServices>- <![CDATA[ N ]]> </ExtraServices>
- <PaymentOptions>
<PaymentOption>TH</PaymentOption>
<PaymentOption>BE</PaymentOption>
<PaymentOption>HP</PaymentOption>
</PaymentOptions>
- <TimeBeforeCancellationPenalty>- <![CDATA[ HoursBeforeCheckInTime;CheckInTime;Percentage;PercetageOver
]]> </TimeBeforeCancellationPenalty>
- <Rooms>
- <Room>
- <ID>- <![CDATA[ MjE0MTEjREJMRSMqIyojMiMwMCMw ]]> </ID>
- <IDRoomType>- <![CDATA[ DBLE ]]> </IDRoomType>
- <IndexRoom>- <![CDATA[ 1 ]]> </IndexRoom>
- <Description>- <![CDATA[ Doble ]]> </Description>
- <Price>- <![CDATA[ 800 ]]> </Price>
- <NumAdults>- <![CDATA[ 2 ]]> </NumAdults>
- <NumChildren>- <![CDATA[ 0 ]]> </NumChildren>
- <InclBoardType>
- <Adults>
<ID />
<Description />
- <Days>- <![CDATA[ A ]]> </Days>
</Adults>
- <Children>
<ID />
<Description />


Copyright 2013 - Grupo TransHotel Departamento de Interfaces 23
<Days />
</Children>
</InclBoardType>
- <Quantity>- <![CDATA[ 1 ]]> </Quantity>

Llamada de disponibilidad sin Multitarifa (Polticas de cancelacin en disponibilidad):

<?xml version="1.0" encoding="utf-8"?>
<GetAvailAccomAdvanced>
<Login>**** </Login>
<AcceptsRequests>N</AcceptsRequests>
<Currency>EUR</Currency>
<GetAccomLocation>
<IDhotel>21411</IDhotel>
</GetAccomLocation>
<GetDates>
<CheckIn>2013-12-22</CheckIn>
<CheckOut>2013-12-23</CheckOut>
</GetDates>
<GetRoomDetails>
<Room>
<RoomQuantity>1</RoomQuantity>
<NumAdults>2</NumAdults>
</Room>
</GetRoomDetails>
<ReturnedDataOptions>
<IncludeHotelsGuest>Y</IncludeHotelsGuest>
<IncludeAdvReservationInfo>Y</IncludeAdvReservationInfo>
</ReturnedDataOptions>

Respuesta de disponibilidad sin multitarifa (Polticas de cancelacin):

En la respuesta a nivel de hotel (entre <IsOffer> y <InclBoardType> que es donde aparece actualmente) aparecer
dicha etiqueta con el siguiente formato separados por ;:

<TimeBeforeCancellationPenalty><![CDATA[HoursBeforeCheckInTime;CheckInTime;Percentage;PercetageOver
]]></TimeBeforeCancellationPenalty>

Donde cada uno significa:

HoursBefore horas antes del CheckInTime
CheckInTime Indica la hora exacta de Entrada
Percentage Porcentaje aplicado sobre PercentageOver
PercetageOver Indica si es A (Reserva Completa) o F (Primera noche)

Como nota importante mencionar que en aquellos casos en los que el hotel no nos facilite dicha poltica
devolveremos el valor -1


<?xml version="1.0" encoding="UTF-8" ?>
- <GetAvailAccomAdvanced>
- <IDSession>- <![CDATA[***************]]> </IDSession>
- <Hotel>
- <ID>- <![CDATA[ 14411 ]]></ID>


Copyright 2013 - Grupo TransHotel Departamento de Interfaces 24
- <IDAllRooms>- <![CDATA[ 2752743 ]]></IDAllRooms>
- <Name>- <![CDATA[ PLAZA BASILICA]]></Name>
- <HotelRemarks><Remark>14</Remark></HotelRemarks>
- <ProdType>- <![CDATA[ U ]]> </ProdType>
<IDCategory>3</IDCategory>
- <Category>- <![CDATA[ 3 Estrellas ]]></Category>
<IDAccomType>4</IDAccomType>
- <Description>- <![CDATA[ Situacin: en el area financiera, comercial, Avda. de Castellana y Estadio de Ftbol
Santiago Bernabeu. ]]> </Description>
- <Image>- <![CDATA[ http://estaticos.transhotel.com/img/fotos/hoteles/002752/hft002752743_001.jpg
]]></Image>
- <Map>- <![CDATA[ http://estaticos.transhotel.com/img/planos/hoteles/000014/hpl000014411_001.gif ]]>
</Map>
<IDCity>6396</IDCity>
- <City>- <![CDATA[ MADRID ]]></City>
- <Distance>- <![CDATA[ 0.0 ]]></Distance>
- <AvailStatus>- <![CDATA[ A ]]></AvailStatus>
- <TotalPrice>- <![CDATA[ 44,23 ]]></TotalPrice>
<Supplements />
- <Currency>- <![CDATA[ EUR ]]></Currency>
- <IsOffer>- <![CDATA[ N ]]></IsOffer>
- <TimeBeforeCancellationPenalty>- <![CDATA[HoursBeforeCheckInTime;CheckInTime;Percentage;PercetageOver
]]> </TimeBeforeCancellationPenalty>
- <InclBoardType>
<ID />
<Description />
- <Days>- <![CDATA[ A ]]> </Days>
</InclBoardType>
- <Rooms>
- <Room>
- <ID>- <![CDATA[ Mjc1Mjc0MyNFUzJDIyojKiMyIzAw ]]> </ID>
- <IDRoomType>- <![CDATA[ ES2C ]]> </IDRoomType>
- <IndexRoom>- <![CDATA[ 1 ]]> </IndexRoom>
- <Description>- <![CDATA[ Estudio doble cama matrimonio ]]> </Description>
- <Price>- <![CDATA[ 50,26 ]]> </Price>
- <NumAdults>- <![CDATA[ 2 ]]> </NumAdults>
- <NumChildren>- <![CDATA[ 0 ]]> </NumChildren>
- <InclBoardType>
- <Adults>
<ID />
<Description />
- <Days>- <![CDATA[ A ]]> </Days>
</Adults>
- <Children>
<ID />
<Description />
<Days />
</Children>
</InclBoardType>
- <Quantity><![CDATA[ 1 ]]></Quantity>
- <AvailStatus><![CDATA[ A ]]> </AvailStatus>
- <Rate><![CDATA[ 1003828 ]]></Rate>
- <Discount><![CDATA[ 6,03 ]]></Discount>
<BoardPrice />


Copyright 2013 - Grupo TransHotel Departamento de Interfaces 25
</Room>
</Rooms>
</Hotel>
</GetAvailAccomAdvanced>

Respuesta de disponibilidad para agencias Comisionables (Mostrando comisin):
Para agencias en modo comisionable, se mostrar tambin la comisin en la respuesta de disponibilidad al aadir
la etiqueta IncludeAdvReservationInfo. Dicha comisin se mostrar en la etiqueta <AgencyCommission>, donde se
mostrara la comisin correspondiente a la agencia para ese hotel.
Para recibir la comisin de agencia en la respuesta, la peticin de disponibilidad debe ser sin introducir Multitarifa.
Ejemplo:

- <GetAvailAccomAdvanced>
- <IDSession>
- <![CDATA[ ************************* ]]>
</IDSession>
- <Hotel>
- <ID>- <![CDATA[ 4906749 ]]> </ID>
- <IDAllRooms>- <![CDATA[ 4906749 ]]></IDAllRooms>
- <Name>- <![CDATA[ H2 CACERES ]]> </Name>
- <HotelRemarks> <Remark>28</Remark> </HotelRemarks>
- <ProdType>- <![CDATA[ U ]]></ProdType>
<IDCategory>2</IDCategory>
- <Category>- <![CDATA[ 2 Estrellas ]]></Category>
<IDAccomType>1</IDAccomType>
- <Description>- <![CDATA[ Situacin: en el centro de Cceres, ciudad declarada Patrimonio de la Humanidad, a
30 metros de la Plaza Mayor y a 100 metros del casco antiguo medieval. ]]> </Description>
- <Image>- <![CDATA[
http://estaticos.transhotel.com/img/fotos/hoteles/004906/hft004906749_001.jpg]]></Image>
- <Map>- <![CDATA[ http://estaticos.transhotel.com/img/planos/hoteles/004906/hpl004906749_001.gif]]>
</Map>
<IDCity>6430</IDCity>
- <City>- <![CDATA[ CCERES ]]></City>
- <Distance>- <![CDATA[ 0.0 ]]></Distance>
- <AvailStatus>- <![CDATA[ A ]]></AvailStatus>
- <TotalPrice>- <![CDATA[ 38,25 ]]> </TotalPrice>
<Supplements />
- <Currency>- <![CDATA[ EUR ]]></Currency>
- <IsOffer>- <![CDATA[ N ]]></IsOffer>
+ <AgencyCommission>- <![CDATA[ 10,5 ]]></AgencyCommission>
- <TimeBeforeCancellationPenalty>- <![CDATA[ 99999;00;100;A ]]></TimeBeforeCancellationPenalty>
- <InclBoardType>
<ID />
<Description />
- <Days>- <![CDATA[ A ]]></Days>
</InclBoardType>
- <Rooms>
- <Room>
- <ID>- <![CDATA[ NDkwNjc0OSNEQkx4IyojKiMyIzAw ]]></ID>
- <IDRoomType>- <![CDATA[ DBLx ]]></IDRoomType>
- <IndexRoom>- <![CDATA[ 1 ]]></IndexRoom>


Copyright 2013 - Grupo TransHotel Departamento de Interfaces 26
- <Description>- <![CDATA[ Doble (cama de matrimonio) ]]></Description>
- <Price>- <![CDATA[ 38,25 ]]></Price>
- <NumAdults>- <![CDATA[ 2 ]]></NumAdults>
- <NumChildren>- <![CDATA[ 0 ]]></NumChildren>
- <InclBoardType>
- <Adults>
<ID />
<Description />
- <Days>- <![CDATA[ A ]]></Days>
</Adults>
- <Children>
<ID />
<Description />
<Days />
</Children>
</InclBoardType>
- <Quantity>- <![CDATA[ 1 ]]></Quantity>
- <AvailStatus>- <![CDATA[ A]]></AvailStatus>
- <Rate>- <![CDATA[ 1003518]]></Rate>
<Discount />
<BoardPrice />
</Room>
</Rooms>
</Hotel>
- <Hotel>


















Copyright 2013 - Grupo TransHotel Departamento de Interfaces 27
6 Resto de llamadas.

A continuacin podris encontrar una breve descripcin del resto de llamadas. Para ver las etiquetas
disponibles en cada llamada recordad que estn disponibles los ficheros XSD de cada una de las
llamadas en el siguiente enlace.

http://interfaces.transhotel.com/interfaces/schemas/xml_schemas.zip

6.1 Proceso de reserva
Aqu se encuentran todas las llamadas relacionadas con el flujo bsico de alta de una reserva.
Recepcin de disponibilidad (GetAvailAccomAdvanced), Pre reserva(MakeReservationAdvanced), y
Confirmacin (ConfirmReservation)
6.1.1 GetAvailAccomAdvanced.
La llamada GetAvailAccomAdvanced, permite realizar la bsqueda de disponibilidad de hoteles.
Esta llamada devolver los hoteles disponibles con sus tarifas y habitaciones para reservar. La
peticin de disponibilidad permite realizar la bsqueda de hoteles en una ciudad, rea
Permite seleccionar (hotel, rea, IATA o ciudad), La fecha de entrada y salida, El nmero de
habitaciones y PAX, el rgimen y algunas otras opciones de filtrado para devolverte los hoteles,
habitaciones, etc. que estn disponibles.
6.1.2 MakeReservationAdvanced.
Est llamada realiza una pre reserva a nuestro sistema que bloquea la disponibilidad de la
habitacin.
6.1.3 ConfirmReservation.
Esta llamada confirma la reserva bloqueada anteriormente en MakeReservation. Esta llamada
debe realizarse como mximo 30 minutos despus del MakeReservation.
Es muy importante no confirmar la reserva con el cliente hasta que nosotros no confirmemos la
reserva.
Como novedad, XML trae dos nuevas funcionalidades importantes:
Se permite introducir todos los datos de las personas que se incluyen en la reserva. Cuando en
la consulta de disponibilidad se soliciten los hoteles con gestin de acompaantes
(IncludeHotelsGuest=Y), ser obligatorio pasar todos los nombres de las personas que se
hospedarn en el hotel.
Por defecto la respuesta de XML devuelve un bono en formato HTML formado por Transhotel. A
partir de esta nueva versin, es posible recibir los detalles de la reserva, es decir, la respuesta de
GetReservationDetails. Para ellos debemos utilizar la etiqueta GetVoucher con valor a N.


Copyright 2013 - Grupo TransHotel Departamento de Interfaces 28
6.2 Gestin de reservas
6.2.1 CancelReservation.
Permite la cancelacin de una reserva indicando el localizador de la reserva.
6.2.2 GetIssuedInvoices.
La llamada GetIssuedInvoices devuelve todas las facturas de una agencia en base a unos criterios
de bsqueda ID reserva, Fecha de alta...
6.2.3 GetReservationDetails.
La llamada GetReservationDetails devuelve todos los detalles de una reserva especfica. En la
respuesta de esta llamada se devuelve la etiqueta ResStatus que especifica el estado en el cual
se encuentra la reserva, puede devolver los siguientes valores:

C Cancelada
R En peticin
T En proceso
Q Reclamacin
N Inacabada
O Confirmada
I Facturada
6.2.4 ConfirmPayment.
La llamada ConfirmPayment permite realizar el pago de una reserva confirmada con mtodo de
pago GPAG (Gestor de pagos).
6.2.5 PaymentManager.
La llamada PaymentManager muestra las reservas pendientes de pago filtrando por fecha de
entrada o ID de reserva.
6.2.6 GetReservationsMade.
Devuelve una lista de todas las reservas realizadas con unos parmetros determinados.
6.2.7 UndoMakeReservation.
Desbloquea el cupo bloqueado por la pre reserva (MakeReservationAdvanced)

6.3 Modificacin de reservas
6.3.1 ModifyReservationRooms.
Permite solicitar una modificacin del nmero o tipo de habitaciones. Devolviendo todos los tipos
de habitacin del hotel para la nueva distribucin solicitada.


Copyright 2013 - Grupo TransHotel Departamento de Interfaces 29
6.3.2 MakeModifyReservationRooms.
Comprueba que las habitaciones seleccionadas de las devueltas en ModifyReservationRooms
estn disponibles.
6.3.3 ConfirmModifyReservationRooms.
Confirma la modificacin del tipo o nmero de habitaciones.
6.3.4 ModifyReservationDates.
Comprueba si es posible realizar el cambio de fecha solicitado para la reserva indicada.
6.3.5 ConfirmModifyReservationDates.
Confirma la modificacin de fechas solicitada en la llamada ModifyReservationDates.

6.4 Recogida de informacin
6.4.1 GetCancellationCost.
Esta llamada devuelve los gastos de cancelacin de una reserve especfica realizada en el
sistema de Transhotel.
6.4.2 GetCancellationPolicy.
Devuelve las polticas de cancelacin de la habitacin/es seleccionadas. Estas son las etiquetas
que se muestran en esta llamada:
DateBefore: ultimo da de cancelacin sin gastos.
TimeBefore: Indica la hora de entrada en gastos
PercentageCharged: tanto por ciento a aplicar sobre la etiqueta PercentageOf
PercentageOf: representa "F" para la primera noche y "A" para toda la reserva

Algunos hoteles puede que no devuelvan las polticas de cancelacin con esta llamada por lo que
se devolver un error controlado 464 que indica que ser necesario continuar con el proceso de
prereserva para ver las polticas de cancelacin.
6.4.3 GetCountryDetails.
Devuelve el listado de reas, Ciudades o provincias por pas.
6.4.4 GetErrors.
Esta llamada devuelve los posibles errores producidos por el XML Web Services de Transhotel.
6.4.5 GetHotels.
La llamada GetHotels devuelve una lista de los hoteles activos en la base de datos con unas
caractersticas especficas.
6.4.6 BuildSearchForm.
Devuelve los parmetros permitidos por algunas etiquetas de otras llamadas.


Copyright 2013 - Grupo TransHotel Departamento de Interfaces 30

Parmetros disponibles:
COUNTRIES
AREAS
PROVINCES
CITIES
CATEGORIES
WEB_CATEGORIES
ACCOM_TYPE
ACCOM_LOCATION
ACCOM_SERVICES
ACCOM_SERVICE_TYPES
EVENTS
CURRENCIES
BOARDTYPES
TITULATIONS
CREDIT_CARD_TYPES
ROOM_TYPES
WEEK_DAYS
RATES

6.4.7 GetGeneralData.
La llamada GetGeneralData devuelve las preferencias disponibles para una reserva.
Cliente llegar sin bono.
Cliente llegar tarde - Late Check-in.
Habitaciones contiguas, sujeto a disponibilidad.
6.4.8 SearchCityByName.
Esta llamada devuelve una o varias ciudades que contenga la cadena de texto especificada.
6.4.9 SearchCityByName.
La llamada SearchHotelByName devuelve los hoteles a partir de una cadena.
6.4.10 GetAllRoomsDetails.
La llamada GetAllRoomsDetails devuelve detalles de los precios y regmenes por da para todas
las habitaciones seleccionadas por defecto de un hotel (Quantity > 0).
6.4.11 GetHotelDetails.
La llamada GetHotelDetails devuelve los detalles de un hotel especfico. Puedes solicitar el
IDGroup con la etiqueta <GroupHotel>Y<GroupHotel>.
1 - Debers usar una nueva sesin por cada peticin de IDHotel solicitado en la llamada
GetHotelDetails.


Copyright 2013 - Grupo TransHotel Departamento de Interfaces 31
2 Si usas la misma sesin para recibir hoteles, por favor espera para lanzar la siguiente query
hasta que finalice la anterior. De cualquier otra manera, puede que la informacin del hotel
aparezca mezclada.
6.4.12 GetHotelExtraServices.
La llamada GetHotelExtraServices devuelve los servicios extra disponibles en el hotel separados
en tres categoras.
Instalaciones del hotel = I.
Servicios del hotel = S.
Servicios de la habitacin = H.
6.4.13 GetRoomDetails.
La llamada devuelve los detalles de un IDroom de GetAvailAccomAdvanced de la misma sesin.
6.4.14 GetVoucherObservations.
La llamada GetVoucherObservations devuelve todas las observaciones del bono en base a un
IDRoom devuelto por la respuesta de disponibilidad.
Es obligatorio mostrar las observaciones del bono en algn momento antes de la configuracin de
la reserva.















Copyright 2013 - Grupo TransHotel Departamento de Interfaces 32
7 Como Obtener XML.

Usted puede encontrar la informacin sobre nuestras integraciones Microsite o XML en la
pgina:

http://www.transhotel.com

Dentro del men Productos y Servicios Integraciones Para agencias.




Para solicitar una integracin Microsite o xml deben hacerlo a travs de la misma pgina:

Primero deben de logarse (Cdigo B2B, usuario y password)





Copyright 2013 - Grupo TransHotel Departamento de Interfaces 33
Una vez dentro de la pgina rellene la solicitud que encontrar en el men Otros
Solicitud de Integracin.





















Copyright 2013 - Grupo TransHotel Departamento de Interfaces 34
8 Proceso de certificacin.

Este proceso consiste en realizar la prueba detallada a continuacin para poder certificar el desarrollo y
entregar las claves XML de produccin.
Certificacin:
Informacin OBLIGATORIA a mostrar en la integracin.

1. Rgimen de cada Hotel en la bsqueda. (Teniendo en cuenta la etiqueta <days> que especifica
todos los das A o algunos das S).
2. Mostrar :
- Polticas de cancelacin (Incluido Etiqueta Remarks) en la prereserva
(MakeReservationAdvanced).
- Texto de la etiqueta <VoucherObservations> en la prereserva
(MakeReservationAdvanced).
- Mostrar logo y texto Reservado y Pagadero por Transhotel en el bono
(ConfirmReservation).
3. Implementar el Gzip y el protocolo de seguridad https en la llamada login y en confirmacin de la
reserva.
4. Tener la etiqueta <ReduceView> en la bsqueda con valor a Y
5. Asegurar que el precio final de la reserva corresponde con el importe del tag TotalPrice de
la llamada MakeReservationAdvanced
6. Tener en cuenta los descuentos y Suplementos (el proceso de reserva especificado ms
abajo contiene una casustica con estos datos)
Puntos a realizar

1. Informar de las direcciones IP que van a tener en el entorno productivo, para que nuestro
departamento de sistemas pueda ir configurando su acceso.
2. Capturas de pantalla del proceso de reserva especificado en el punto 3.
3. Realizar las siguientes acciones:
1. Reserva 2 adultos y 1 nio del 23 al 31 de Diciembre (Idhotel = 29757)
Nota: Debis enviar los XML de entrada y salida de todas las acciones, separados por carpetas y
a poder ser comprimido.
4. Facilitar datos estadsticos en estimacin de consultas por da y franja horaria.
5. Acceso a vuestra pgina Web para realizar alguna prueba adicional con las siguientes
caractersticas:
1. URL para acceder a la integracin apuntando a este entorno de certificacin.
2. Usuario y password en caso de ser necesario.
Una vez analizado todo el proceso y verificar que su integracin cumple con todos los requisitos, el
departamento de Interfaces le proporcionar los datos de acceso al entorno de Produccin, tambin se le
proporcionar acceso al servidor FTP de datos estticos. Cualquier tipo de duda o problema con el
proceso de certificacin deber comunicarlo al departamento de Interfaces de Transhotel.
Nota: Por favor enve los resultados a la direccin de correo electrnico interfaces@transhotel.com