Copyright Grupo TransHotel Departamento de Interfaces 2

Transcripción

1

2 &!"##$%! "#$%$&#'(#)*!##)" (+#$, )#-#)!!# (#)!"$#(, #' '#( )#'*(( '( + #!($'(,( -#(( '!( % (."('/!#(!( (( -'0, '.(-#"#+#$/0#"*"!$""*" #1, 2)#3)#(#)*"#+#$/"4#)#(#)*"! "*" #1,!)"! #$")#(#)*"/!))#(#)*"! 1 (/(#1#'#!(2#' '#( )#''#!'(+ 5 ")"#)6(!"("0#!"(2)#2"0 5!( #+#$#("0)2"(, 5 )#"! #! #0)"! # *")!(!!"( 5 5, 2! #("!! "$#(#'.(-#" 5 55 )#(#)*"(# 2#!! 5 5 0#(! #"2"7" #(5 58 '.(-#"(# "$)##)#( 59! )"! "!! "$/$#*#$"1 0 (!('''3 2)#(#)#(#)*"9!"#" "# $%&#"# ' (&#' & &) ' * +$%&#' 0#(! #)#(#)*"(: ( &#'!# '!&#,' ()' * )$-!&#$!!"! #)#(#)*"( $&#& $%$&#& Copyright Grupo TransHotel Departamento de Interfaces 2

3 ($&#& $&#, * ($&#,, )#0!"#! )"!!( (!( )!(,! *!. /0 12!!, 0 1(/3 ' 0 1(/3!"&,!.,!.40#!&,!5 16# 4!#"('#$'&& 3 /!#(!(#( 1#'#$&+ Copyright Grupo TransHotel Departamento de Interfaces 3

4 1 Introducción 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.0 de Transhotel. Así mismo le informará de como implementar el sistema en su página Web usando las llamadas XML para ofrecer la reserva online a clientes finales. Esta la versión 5.0 del XML de Transhotel está basada en la anterior, aunque implementando nuevas funcionalidades que ampliarán y mejorarán el rendimiento del sistema. La principal diferencia con el XML anterior es la introducción de diferentes formas de pago: Transhotel, Pago directo en el hotel y Tarjeta Hotelplus. Además esta nueva versión, permite visualizar todas las tarifas disponibles del hotel en la búsqueda de disponibilidad, potenciando la respuesta de disponibilidad. 1.1 Cómo funciona el XML Web Service de Transhotel El XML Web Services de Transhotel trabaja con datos en XML. La agencia envía una petición XML y Transhotel manda la respuesta, también en formato XML. Todas las llamadas al servidor de Transhotel se realizan mediante parámetros pxml y pcall. A continuación mostramos un gráfico del funcionamiento: 1.2 Requerimientos comerciales Para poder implementar el XML Web Services de Transhotel será necesario alcanzar un acuerdo comercial con Transhotel. Si vuestra agencia no tiene acuerdo comercial con Transhotel, por favor, contactar con el departamento comercial comercial@transhotel.com Además del acuerdo comercial, antes de comenzar el desarrollo del XML Web Services de Transhotel será necesario firmar un acuerdo de confidencialidad. Puede encontrar más información sobre el Acuerdo de confidencialidad en el punto 7 de este manual. Copyright Grupo TransHotel Departamento de Interfaces 4

5 Tanto la conexión a Transhotel a través del WebServices, como el soporte de dicha herramienta son totalmente gratuitos. Antes de pasar al entorno real de venta del producto de Transhotel, será necesario superar un Proceso de validación por parte del departamento técnico de Transhotel en el punto 8 de este manual. 2 Características Generales A continuación presentamos las nuevas funcionalidades del XML Web Service 4.5 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, pago directo en le Hotel, o usar la Tarjeta Hotelplus para el pago de la reserva. Al igual que nuestra herramienta TORSystem, se podrá elegir recibir disponibilidad de hoteles en una sola forma de pago o combinar las tres. Dependiendo de la configuración de la agencia. Las agencias con precios comisionables podrán combinar todas las formas de pago en la misma petición. Por el contrario las agencias netas, no podrán combinar las peticiones de pago TH con Pago Directo (BE) o HotelPlus (HP). El Webservices de Transhotel permite dar de alta reservas de hoteles, traslados y visitas, así como la cancelación y modificación de las mismas (Fechas, Habitaciones y Nombres de pasajeros). Desde la última versión, Transhotel ofrece la posibilidad de hacer reservas a través del Webservices a las agencias Crédito como Prepago, ofreciendo las mismas vías de pago que las usadas en la herramienta interna TORSystem. Puede consultar las formas de pago en el punto 6.1 de este documento. Recordamos, que el XML WebServices de Transhotel es una plataforma multi-idioma. Transhotel, en su afán por facilitar la consolidación de datos estáticos de las integraciones, facilita todos los datos estáticos de sus hoteles a través de su plataforma FTP como del mismo Webservices. Consulte webservice.transhotel.com para más información acerca del acceso al FTP. Por último indicar que el XML Webservices incorpora la posibilidad de consolidar los datos de las reservas hechas en Transhotel con los sistemas de backoffice de las agencias. Más información, contacten con el departamento de Interfaces. 3 Conexión al WebServices de Transhotel Una vez realizadas todas las acciones comerciales, para conectarnos al webservices, el departamento de Interfaces de Transhotel nos facilitará las credenciales de acceso: Usuario, Password y URL del entorno de pruebas de Transhotel. Estos tres parámetros son básicos para llevar a cabo con éxito la conexión al webservices. Copyright Grupo TransHotel Departamento de Interfaces 5

6 Para realizar la comunicación con el webservices, el XML a enviar debe estar compuesto de un parámetro pxml, que conlleva el documento XML y un parámetro pcall que llevará el nombre de la llamada. Es muy importante enviar el pxml como primer parámetro en la petición y el pcall después. Los parámetros deben ser enviados por POST. Todas las llamadas son validadas por un schema XML antes de procesarla. Estos schemas son llamadas con el nombre de la llamada seguido de la extensión.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: El XML Web Services también es utilizado para el uso interno de aplicaciones, por lo tanto el XML puede contener llamadas o etiquetas que no están incluidas en la documentación. Recomendamos usar solamente las llamadas incluidas en la documentación. Puedes revisar algunos de nuestros ejemplos de la estructura básica del XML de petición y respuesta. A continuación os mostramos ejemplos de conexión al servidor de Transhotel para el envío de las llamadas XML. Login PHP Login Java Login ASP Login ASPNET 4 Esquema proceso de reserva. *Leyenda tabla de campos. ;< < =;< La siguiente información es un esquema básico del flujo de datos de un proceso de reserva elemental. En el punto 5 de esta documentación existe información detallada de estas y otras llamadas. El uso de un IDsession es exclusivo de un proceso de reserva, no pudiendo ser reutilizado para otro proceso de reserva. 4.1 Búsqueda de hotel (GetAvailAccomAdvanced) Estructura básicos de la petición Datos básicos a enviar Copyright Grupo TransHotel Departamento de Interfaces 6

7 Lugar (A elegir uno entre los cinco tipos) o Hotel o Grupo hotel (Un mismo hotel físico puede tener dos IDs de hotel por lo que es recomendable realizar las peticiones por hotel al IDgroup en lugar del IDhotel.) o Ciudad o IATA o Área Fechas Número de pasajeros Régimen (No es obligatorio. Si no se indica, se devolverá el más barato en cada caso). Forma de pago (Dependiendo de la configuración de la agencia, se permite más de una forma de pago en la misma petición). o TH Estándar Transhotel o BE Pago directo en el hotel o HP Hotel Plus Filtros Categoría del hotel (1 Estrella, 2, 3 ) Servicios (Piscina, Gimnasio, Restaurante ) Tipo de producto (Montaña, Nieve, Urbano ) Datos Opcionales Habitaciones opcionales. Regímenes opcionales. Hotel Info Información y peculiaridades de la llamada La respuesta de la búsqueda devuelve todos los hoteles, tarifas y habitaciones disponibles que coincidan con los datos básicos 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. existe la posibilidad de recibir el IDgroup para agrupar los IDs de hotel que pertenezcan al mismo hotel físico. Transhotel puede tener más de un ID hotel perteneciente al mismo hotel físico debido a la recepción de los mismos desde distintos canales. Copyright Grupo TransHotel Departamento de Interfaces 7

8 Una respuesta de disponibilidad puede incluir un régimen igual o superior al solicitado en cualquier día de la reserva. Siempre se devuelve el régimen más barato disponible. Si el régimen está incluido solo algunos días. Recibirás la etiqueta <Days> con valor S = Some days (Algunos días) Es posible diferenciar las tarifas disponibles con el IDRate devuelto dentro de cada tarifa. La etiqueta TotalPrice (Precio calculado teniendo en cuenta suplementos, descuentos ) pertenece exclusivamente a la habitación con la etiqueta <Quantity> distinta de cero de la primera tarifa devuelta (la más barata). Para todas las demás etiquetas <Price>, se deberá recalcular el precio teniendo en cuenta suplementos, descuentos Se debe confirmar siempre el precio final de la reserva con la etiqueta TotalPrice de la llamada MakeReservationAdvanced antes de confirmar. Ver documento de ejemplo y esquema para ampliar información: # 1 89# Etiquetas de la petición (5 6 $<33> ; == $<33>2? 2? A=33> A=33> A=33> A=2 A=33> A=="= (BB A3=C<= D < A3=F G2H2 I!H!! I JK= A== I Copyright Grupo TransHotel Departamento de Interfaces 8

9 ( &! ")K= 0"$33> ( &33>E 0"$33> ( &33> ) =K=;= $ ==EDL 4H4D +H+ * 0"$33>!E 0"$33>!< = 0"$33>! 0"$33>! 0"$33>! 033>A! 033>A= 0)33>)33> )-=E 0)33>)33> ="= 0)33>)33> = 0)33>)33> "< 0)33>)33> ("< 0)33>)33> "< 0)33>)33>!' E 'MK=!= 'MK=!< = 'MK=! 'MK= D<!"" 'MK=!N M ; M = ;D M F ;D # F #<=F # F )O<J=;D 2E33>!2E <+H P'#H2< P +2H+=!" 0"@ 2= < '=( = 2 Copyright Grupo TransHotel Departamento de Interfaces 9

10 "E "< E 0"@33> "$ 0"@33> ; < J # )= )= 33>!=) )= 33>!="+! )= 33>!=' )= 33>!=)E )= 33>!=' E )= 33>!=+0= )= 33> )=*? )= 33> 0 =+ )= 33>!=2 ' )= 33> C)+ * L ; ;=D!= D <J; < J = J <J = K= ;< ; F = =@ = + ;D =!< =!=E!<O O</#HE=P#H 4.2 Pre-reserva de hotel (MakeReservationAdvanced) Estructura básicas de la petición Datos básicos de la petición ID sesión ID habitación Nº de habitaciones seleccionadas Datos opcionales Copyright Grupo TransHotel Departamento de Interfaces 10

11 Régimen Información y peculiaridades de la llamada La pre-reserva consiste en el bloqueo del cupo de la habitación seleccionada en la búsqueda, con la finalidad de no perder la disponibilidad de la habitación mientras el usuario de la aplicación/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 válida exclusivamente para una sesión. La habitación se bloquea durante 30 minutos La hora de las políticas de cancelación está basada en el horario actual de España CET (Central European timezone) / CEST (Central European summer timezone) Etiquetas de la petición (5 6 $! )33>)33>! )33>)33>-=E (D@= = 0"@""@ = = 0"@""@ M ;! == K=E( ;=D0"@""@ )33>)33>!' E!2E )O<K= <+'#+2!% $@ $D"K=$@@=@@ K=/ =@1 Copyright Grupo TransHotel Departamento de Interfaces 11

12 4.3 Confirmación de la reserva (ConfirmReservation) Estructura básicas de la petición Datos básicos de la petición ID sesión Nombre, apellido, correo electrónico, titulo Datos opcionales Preferencias Pago directo. Datos acompañantes Detalles de factura Información y peculiaridades de la llamada Existen varias peculiaridades en la llamada de confirmación de Transhotel. En primer lugar tendras que indicarnos el titular de la reserva por un lado y el resto de huéspedes de la habitación/es en otro. Existen distintas opciones de confirmación dependiendo del tipo de Agencia crédito o prepago y en el caso de las agencias en prepago. Existen diferencias dependiendo del país. Puede ver más información acerca de estos datos. En el siguiente enlace. [REVISAR] Etiquetas de la petición (5 6 Copyright Grupo TransHotel Departamento de Interfaces 12

13 ! $!!;DB<B = 0"@""@ ; $ = ( P( Q= # # "<E) ) <K= 2 33>! ; ;D 2E33> E! I R </H*P 1 2E33> =; M I O 2E33>** D<* I 2E33>#C E = I 2E33>#C EL "F= < 2E33> + ; I O 2E33>A!@ = L 2E33>!@33> E 2E33>!@33>" 2E33>!@33> 2 ; D= D D<< 2E33>!@33>E == D 2E33>!@33>= E J= D 2E33>!@33>*" =! 2E33>!@33>!@# D 5 Especificaciones y características adicionales. 5.1 Características agencias prepago Transhotel ofrece la posibilidad de hacer reserva a aquellas agencias que su forma de pago sea Prepago. Para poder usar este método de pago. Copyright Grupo TransHotel Departamento de Interfaces 13

14 A la hora de confirmar una reserva con una agencia Prepago, es necesario pasar los parámetros 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 localización en su país y configuración de agencia usted se encontrara con algunos de los siguientes métodos 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 confirmación son: IdPaymentMethod: PDTA PaymentMethod: I (Inmediato). Pago Directo Cliente: Transhotel cobrará el Total de la reserva, solo podrán usarlo agencias 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. IdPaymentMethod: PDTC 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 cancelación. IdPaymentMethod: TRANS Gestor de Pagos: La agencia de viajes domiciliará la reserva a través de XML o TOR System. Si la reserva entra en gastos de cancelación en el momento de realizar la reserva, se deberá domiciliar la reserva antes de confirmarla en la propia llamada ConfirmReservation. IdPaymentMethod: GPAG PaymentMethod: I (Inmediato) y D (Aplazado) 5.2 IDs de hoteles agrupados. Desde ahora ya se pueden agrupar hoteles con el mismo nombre y diferente ID en un único IDGroup. Para obtener el IDGroup debemos incluir dentro de <ReturnedDataOptions> la etiqueta <GroupHotel>Y</GroupHotel>! ""# " $%$$%!!#!!! & ' & ' (#" ( )* (+,-+)* ( *.)/001021/+.).3/001021/2.3 * * Copyright Grupo TransHotel Departamento de Interfaces 14

15 4( 4( / * *3& &56&5 *3& A su vez, Transhotel le ofrece la posibilidad de solicitar de forma directa todos los hoteles pertenecientes al mismo ID agrupado usando en la llamada de disponibilidad la etiqueta IDGroup. Esta función devuelve todos los hoteles disponibles indicando el IDgroup al que pertenecen. 5.3 Creación de integración en varios idiomas. La sesión se crea en el idioma por defecto de la integración, pero es posible cambiar desde el Login o Búsqueda de disponibilidad el idioma, para poder recibir los resultados del proceso de reserva en el idioma deseado.! ""! $%&%$% 5.4 Opciones adicionales de búsqueda. La llamada GetAvailAccomAdvanced ofrece varios criterios para poder definir aún más la búsqueda como por ejemplo, tipo de establecimiento (hotel, motel, hostal, etc.), categoría (1, 2, 3, 4 o 5 estrellas, etc.), situación del establecimiento (centro ciudad, aeropuerto, etc.), y servicios (parking incluido, gimnasio, etc.) 5.5 Reservas en petición. Por defecto la búsqueda de resultados cuando buscamos disponibilidad en Alojamientos, Visitas y Traslados retorna únicamente resultados con disponibilidad. No obstante, es posible incluir un parámetro en la búsqueda para recibir resultados en petición. Es muy importante que la agencia tenga una infraestructura para manejar estos tipos de reserva. Para activar las reservas en petición es muy importante ponerse en contacto con el departamento de interfaces para poder realizar este tipo de reservas. El panel de administración de la integración muestra si están activadas o no este tipo de reservas. 5.6 Gestión de Acompañantes. 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. Copyright Grupo TransHotel Departamento de Interfaces 15

16 Si alguna agencia, debido a su programación no pueda enviarnos estos datos, es posible filtrar estos hoteles desde la búsqueda de disponibilidad con la etiqueta. *3& ) 56) 5 *3& 5.7 Búsquedas en alrededores. La búsqueda de disponibilidad da la posibilidad de buscar en los alrededores de una ciudad, para ello facilitamos la etiqueta SearchWithin en la búsqueda de disponibilidad, ya sea en kilómetros o en horas. 5.8 Información Adicional (Level A). Solicitando en la pre-reserva (MakeReservationAdvanced) la etiqueta <Level>A<Level> Se devuelve información adicional sobre la reserva, hotel, precios S!> S!< => (."('!!< =, (-((# /#$ SE>ESE> < J ; N K==< J 0) S"=> S(=> S(=> S=> S=> S D <== K= E"= <== K= E"= D(== S"=>! (== S*= S > ;= DK== T; (; U =;)(E )$O E< E = K= ) 5.9 Hoteles con PVP obligatorio. Copyright Grupo TransHotel Departamento de Interfaces 16

17 De cara a ampliar nuestra cartera hotelera, Transhotel incorpora contratos hoteleros en base a una tarifa de obligado cumplimiento. Para poder recibir este tipo de tarifas, tan solo será necesario añadir en la petición de disponibilidad del webservices (GetAvailAccomAdvanced) la etiqueta FixedRatesHoteles con valor a Y dentro de ReturnedDataOptions. Ejemplo: 789:;0:!9:1<:7! "" $%&%$%! )* (+=,0)* ( *.)/01010>.).3/ * * 4( 4( / * $(3& )*$(3&5)*$(3& $(3& *3& *3& Una vez incluida la etiqueta, la respuesta de disponibilidad contendrá los hoteles con tarifas Netas y los hoteles con tarifas de PVP Obligatorio. La manera de diferenciarlos es identificando la nueva etiqueta FixedRate. Las que tengan valor Y serán tarifas con PVP Obligatorio y con valor a N la tarifas Netas. Ejemplo: Ó )*)* 5 )*/-,/+)* # #3;;; ' $?@*@=00AA$ 5 )*)* Copyright Grupo TransHotel Departamento de Interfaces 17

18 5 )*/-,/+)* # #3 ;;; ' $?@*@=00AA$ 5 Os recordamos que las tarifas con PVP Obligatorio ya llevan incluida la comisión para la agencia, por lo que podremos ver el desglose de la comisión en la respuesta de la pre-reserva (MakeReservationAdvanced). Este desglose solo aparecerá en las reservas con tarifas de PVP Obligatorio y contiene, AgencyCommission, que es el porcentaje de comisión para la agencia, TotalTaxOfCommission, que son las tasas de la comisión y TotalCommission que sería el importe de la comisión sin las tasas. Ejemplo: B. )*?@*@>/,>0+>>AA)* ;;; $?@*@>0AA$! (0! ( 83/C283 2C2 ;;; B. 6 Resto de llamadas. A continuación podréis encontrar una breve descripción del resto de llamadas. Para ver las etiquetas disponibles en cada llamada recordad que están disponibles los ficheros XSD de cada una de las llamadas en el siguiente enlace Proceso de reserva Aquí se encuentran todas las llamadas relacionadas con el proceso de alta de una reserva. Recepcion de disponibilidad prerreserva, recalculo de precios GetAvailAccomAdvanced. La llamada GetAvailAccomAdvanced, permite realizar la búsqueda de disponibilidad de hoteles. Esta llamada devolverá los hoteles disponibles con sus tarifas y habitaciones para reservar. La petición de disponibilidad permite realizar la búsqueda de hoteles en una ciudad, área Permite seleccionar (hotel, área, IATA o ciudad), La fecha de entrada y salida, El número de habitaciones y PAX, el régimen y algunas otras opciones de filtrado para devolverte los hoteles, habitaciones, etc que están disponibles. Copyright Grupo TransHotel Departamento de Interfaces 18

19 6.1.2 MakeReservationAdvanced. Está llamada realiza una prerreserva a nuestro sistema que bloquea la disponibilidad de la habitación ConfirmReservation. Esta llamada confirma la reserva bloqueada anteriormente en MakeReservation. Esta llamada debe realizarse como máximo 30 minutos después 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 gestión de acompañantes (IncludeHotelsGuest= Y ), será obligatorio pasar todos los nombres de las personas que se hospedarán en el hotel. Por defecto la respuesta de XML devuelve un bono en formato HTML formado por Transhotel. A partir de esta nueva versión, 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 RecalcRoomPrice. Recalcula el precio de una reserva. Esta llamada es importante ya que recalcula el precio final de las habitaciones o regímenes opcionales UndoMakeReservation. Esta llamada desbloquea una prerreserva realizada con la llamada MakeReservation, con esto conseguimos liberar la ocupación que habíamos realizado. 6.2 Gestión de reservas CancelReservation. Permite la cancelación de una reserva indicando el localizador de la reserva GetIssuedInvoices. La llamada GetIssuedInvoices devuelve todas las facturas de una agencia en base a unos criterios de búsqueda ID reserva, Fecha de alta GetReservationDetails. La llamada GetReservationDetails devuelve todos los detalles de una reserva específica ConfirmPayment. La llamada ConfirmPayment permite realizar el pago de una reserva confirmada con método de pago GPAG (Gestor de pagos). Copyright Grupo TransHotel Departamento de Interfaces 19

20 6.2.5 PaymentManager. La llamada PaymentManager muestra las reservas pendientes de pago filtrando por fecha de entrada o ID de reserva GetReservationsMade. Devuelve una lista de todas las reservas realizadas con unos parámetros determinados. 6.3 Modificación de reservas ModifyReservationRooms. Permite solicitar una modificación del número o tipo de habitaciones. Devolviendo todos los tipos de habitación del hotel para la nueva distribución solicitada MakeModifyReservationRooms. Comprueba que las habitaciones seleccionadas de las devueltas en ModifyReservationRooms están disponibles ConfirmModifyReservationRooms. Confirma la modificación del tipo o número de habitaciones ModifyReservationDates. Comprueba si es posible realizar el cambio de fecha solicitado para la reserva indicada ConfirmModifyReservationDates. Confirma la modificación de fechas solicitada en la llamada ModifyReservationDates. 6.4 Recogida de información GetCancellationCost. Esta llamada devuelve los gastos de cancelación de una reserve específica realizada en el sistema de Transhotel GetCancellationPolicy. Devuelve las políticas de cancelación de la habitación/es seleccionadas GetCountryDetails. Devuelve el listado de Areas, Ciudades o provincias por país. Copyright Grupo TransHotel Departamento de Interfaces 20

21 6.4.4 GetErrors. Esta llamada devuelve los posibles errores producidos por el XML Web Services de Transhotel GetHotels. La llamada GetHotels devuelve una lista de los hoteles activos en la base de datos con unas características específicas BuildSearchForm. Devuelve los parámetros permitidos por algunas etiquetas de otras llamadas. Parámetros 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 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. Copyright Grupo TransHotel Departamento de Interfaces 21

22 6.4.8 SearchCityByName. Esta llamada devuelve una o varias ciudades que contenga la cadena de texto especificada SearchCityByName. La llamada SearchHotelByName devuelve los hoteles a partir de una cadena GetAllRoomsDetails. La llamada GetAllRoomsDetails devuelve detalles de los precios y regímenes por día para todas las habitaciones seleccionadas por defecto de un hotel (Quantity > 0) GetHotelDetails. La llamada GetHotelDetails devuelve los detalles de un hotel específico. Puedes solicitar el IDGroup con la etiqueta <GroupHotel>Y<GroupHotel>. 1 - Deberas usar una nueva sesión por cada petición de IDHotel solicitado en la llamada GetHotelDetails. 2 Si usas la misma sesion para recibir hoteles, por favor espera para lanzar la siguiente query hasta que finalice la anterior. De cualquier otra manera, puede que la información del hotel aparezca mezclada GetHotelExtraServices. La llamada GetHotelExtraServices devuelve los servicios extra disponibles en el hotel separados en tres categorías. Instalaciones del hotel = I. Servicios del hotel = S. Servicios de la habitación = H GetRoomDetails. La llamada devuelve los detalles de un IDroom de GetAvailAccomAdvanced de la misma sesión 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 algún momento antes de la configuración de la reserva. 7 Documentación NDA. Debido a la adaptación en nuestra compañía de las leyes de comercio electrónico (LSSICE) y de protección de datos (LOPD) necesitamos que su empresa nos devuelva firmado y cumplimentado el Copyright Grupo TransHotel Departamento de Interfaces 22

23 "Acuerdo de Confidencialidad y Uso" redactado por nuestra asesoría jurídica. Le rogamos descarguen el documento en su idioma preferido: Español: Inglés: Francés: Italiano: Portugués: Alemán: Lea detenidamente todos los puntos y cumplimente los campos del "anexo A" de las dos últimas páginas. IMPORTANTE! Le rogamos firmar todas las hojas y devolvernos el documento entero. Por favor, envíenos el documento una vez firmado y cumplimentado por a interfaces@transhotel.com 8 Proceso de certificación. El proceso de certificación XML Transhotel requiere realizar las pruebas detalladas a continuación en este documento. Para llevar a cabo el proceso de certificación, será necesario cambiar los parámetros de acceso a Transhotel. Por favor póngase en contacto con (interfaces@transhotel.com) para comunicarle los datos necesarios. Certificación: Información obligatoria a mostrar en la integración. 1. Régimen de cada Hotel en la búsqueda. (Teniendo en cuenta la etiqueta <days> que especifica todos los días A o algunos días S ). 2. Mostrar políticas de cancelación y el texto de la etiqueta <VoucherObservations> en la prerreserva (MakeReservation). La hora que aparece en las políticas de cancelación es hora local de España. CET (Central European timezone) / CEST (Central European summer timezone) 3. Mostrar logo y texto Pagadero por Transhotel en el bono (ConfirmReservation). Copyright Grupo TransHotel Departamento de Interfaces 23

24 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 de un proceso de reserva. 3. Realizar las siguientes acciones: 1. Reserva sólo adultos para un día. 2. Reserva adultos y niños para un día. 3. Reserva solo adultos para varios días y varias habitaciones. 4. Reserva adultos y niños para el mismo día de hacer la reserva. 5. Proceso de cancelación de reserva ( si está implementado por webservices). 6. Proceso de modificación de reservas (si está implementado por webservices). Nos debéis enviar los XML de entrada y salida de todas las acciones, separados por carpetas y a poder ser comprimido. 4. Rellenar la siguiente tabla con acciones y localizadores de reserva. Acción (Reserva, Modificación, Cancelación) Localizador 5. Facilitar datos estadísticos en estimación de consultas por día y franja horaria. 6. Acceso a vuestro página Web para realizar alguna prueba adicional con las siguientes características: 1. URL para acceder a la integración apuntando a este entorno de certificación. 2. Usuario y password en caso de ser necesario. Copyright Grupo TransHotel Departamento de Interfaces 24

25 Una vez analizado todo el proceso y verificar que su integración cumple con todos los requisitos, el departamento de Interfaces le proporcionará los datos de acceso al entorno de Producción. Cualquier tipo de duda o problema con el proceso de certificación deberá comunicarlo al departamento de Interfaces de Transhotel. Nota: Por favor envíe los resultados a la dirección de correo electrónico interfaces@transhotel.com Copyright Grupo TransHotel Departamento de Interfaces 25