Notificación de modificaciones en reservas para Proveedores

Protocolo público para notificación de modificaciones en reservas, dirigido a Proveedores Xml de circuitos

V 1.0 Marzo 2020

Introducción y contacto

Esta documentación describe el conjunto de métodos del servicio web desarrollado por Ofimática Jaén SL con el objetivo de sincronizar información de reservas de paquetes de un cliente de OfiTour y su proveedor de paquetes xml.

Para cualquier duda y aspecto a comentar durante su uso, puede contactar con nosotros de Lunes a Viernes, desde las 09:00 hasta las 14:00 y de 16:00 a 19:00 en el siguiente número de teléfono 953 280 144.

Webservice

  • Métodos utilizados en el flujo de reservas
  • Las operaciones disponibles son los siguientes:

    Servicio Descripción
    NotifyDepartureClosureInformation Este método permite a la empresa proveedora del circuito, cuando ésta realiza el cierre de la salida, notificar a la empresa cliente del circuito el detalle de hoteles del confirmados del paquete, así como la información relativa a los traslados, para que ésta pueda notificar estos datos al cliente final de la reserva.
    ConfirmExtraNights Mediante este método la empresa proveedora del paquete puede notificar a la empresa cliente la aceptación o el rechazo de las noches extras solicitadas en la reserva. En caso de rechazar dichas noches, la empresa proveedora deberá enviar el desglose de costes del paquete, con esas noches extras ya quitadas de la reserva para que la empresa cliente actúe en consecuencia con su reserva y re-calcular el precio la reserva
    NotifyCancellation Método para la notificación de la cancelación de la reserva por parte de la empresa proveedora
    SetBookingAsOffline Método para notificar que se ha realizado una modificación manual en la reserva de la empresa proveedora de forma que se informa que la reserva deja de estar sincronizada Online y hay que solucionar las diferencias de forma manual.
Entorno Url o "Endpoint"
LIVE http://DOMINIO-DEL-CLIENTE/OfiTourBookingInformationNotificationService.svc?wsdl

NotifyDepartureClosureInformation

En este apartado se describe la petición y la respuesta de la notificación de los hoteles confirmados y datos de los traslados tras el cierre de la salida de una reserva.

Request

Campo Cardinalidad Descripción
NotifyDepartureClosureInformationRequest 1 Elemento root de la petición de búsqueda de actividades
1. ReservationCode 1 Identificar el código de la reserva
2. Hotels 0..1 Datos de los hoteles confirmados de la reserva
2.1 Name 1 Nombre del hotel
2.2. Destination 1 Destino del hotel
2.3. Address 1 Dirección del hotel
2.4. Phone 1 Teléfono del hotel
2.5. Website 1 Dirección web del hotel
3. Transfers 0..1 Datos de los traslados incluidos en la reserva
3.1 Flight 1 Código del vuelo
3.2. DepartureDate 1 Fecha y hora de salida del vuelo
3.3. ArrivalDate 1 Fecha y hora de llegada del vuelo
3.4. DepartureAirportIataCode 1 Código IATA del aeropuerto de origen
3.5. ArrivalAirportIataCode 1 Código IATA del aeropuerto de destino
3.4. TypeTransfer 1 Tipo de traslado, entrada o salida (E=Entrada S=Salida)
4. Login 1 Identificación
4.1 Username 1 Nombre de usuario
4.2 Password 1 Contraseña

Response

Campo Cardinalidad Descripción
NotifyDepartureClosureInformationResponse 1 Elemento root de la respuesta
1. Success 1 True si OK, False si hay algún error

ConfirmExtraNights

En este apartado se describe la petición y la respuesta de la petición para confirmar la aceptación o rechazo de noches extras solicitadas.

Request

Campo Cardinalidad Descripción
ConfirmExtraNightsRequest 1 Elemento root de la petición
1. Login 1 Identificación
1.1 Username 1 Nombre de usuario
1.2 Password 1 Contraseña
2. ReservationCode 1 Identificador de la reserva
3. ExtraNightsConfirmationIn 1 Información relativa a las noches extras de entrada
3.1 Accepted 1 Indica si las noches extras se han aceptado o no
3.2 DetailsPrices 0..N En caso de no aceptarse las noches extras, se debe indicar aquí el desglose de costes
3.3 Description 1 Descripción del concepto del coste de la reserva
3.4 Amount 1 Importe
3.5 Badge 1 Código de la divisa
3.6 DetailPrice 0..N Desglose del coste de la reserva
3.6.1 Description 1 Descripción del concepto en el desglose de la reserva
3.6.2 Amount 1 Importe
3.6.3 Quantity 1 Número de unidades
3.6.4 Code 1 Código del concepto
3.6.5 ExtraNightConcept 1 Indica si el concepto se trata del concepto por noche extra
3.6.5 IsSeniorsConcept 1 Indica si el concepto se trata del concepto por seniors en la reserva

Response

Campo Cardinalidad Descripción
ConfirmExtraNightsResponse 1 Elemento root de la respuesta
1. Success 1 True si OK, False si hay algún error

NotifyCancellation

En este apartado se describe la petición y la respuesta del método para indicar la cancelación de la reserva.

Request

Campo Cardinalidad Descripción
NotifyCancellationRequest 1 Elemento root de la petición
1. Login 1 Identificación
1.1 Username 1 Nombre de usuario
1.2 Password 1 Contraseña
2. ReservationCode 1 Identificador de la reserva

Response

Campo Cardinalidad Descripción
NotifyCancellationResponse 1 Elemento root de la respuesta
1. Success 1 True si OK, False si hay algún error

SetBookingAsOffline

En este apartado se describe la petición y la respuesta del método para marcar una reserva como offline, y notificar que debe ser gestionada de forma manual.

Request

Campo Cardinalidad Descripción
SetBookingAsOfflineRequest 1 Elemento root de la petición
1. Login 1 Identificación
1.1 Username 1 Nombre de usuario
1.2 Password 1 Contraseña
2. ReservationCode 1 Identificador de la reserva

Response

Campo Cardinalidad Descripción
SetBookingAsOfflineResponse 1 Elemento root de la respuesta
1. Success 1 True si OK, False si hay algún error