SUBSECRETARÍA
MINISTERIO
INSPECCIÓN GENERAL DE
DE FOMENTO FOMENTO
SUBDIRECCIÓN GENERAL
DE TECNOLOGÍAS DE LA
INFORMACIÓN Y
ADMINISTRACIÓN
ELECTRÓNICA
Interfaces para la información sobre el derecho de la
bonificación a los viajes de pasajeros a/desde
las Islas Canarias, Islas Baleares, Ceuta y Melilla
Febrero 2018
Versión 1.5
Página 1
SUBSECRETARÍA
MINISTERIO
INSPECCIÓN GENERAL DE
DE FOMENTO FOMENTO
SUBDIRECCIÓN GENERAL
DE TECNOLOGÍAS DE LA
INFORMACIÓN Y
ADMINISTRACIÓN
ELECTRÓNICA
1. Introducción
Este documento define el interfaz técnico del servicio web que ofrece el Ministerio de
Fomento para informar sobre los derechos a bonificaciones del transporte a viajeros
(regulados por el Real Decreto 1316/2001 modificado por el Real Decreto 1340/2007)
realizado a o desde las Islas Canarias, Baleares, Ceuta y Melilla. También se hace
una descripción de la aplicación web que dará acceso, para situaciones
excepcionales, a la misma información.
2. Servicios web del Ministerio de Fomento para
bonificaciones del transporte
Este servicio de información se desarrolla como un WS-SOAP sobre protocolo HTTPS.
En los siguientes párrafos se definen:
o Las prescripciones de seguridad bajo las cuales va a funcionar y debe ser
invocado el servicio web. Se definen las validaciones y autorizaciones
necesarias para acceder al servicio.
o Las prescripciones funcionales del servicio, incluyendo los datos de entrada
y de salida.
3. Prescripciones de acceso al servicio web
Para el acceso al servicio web y como garantía de comunicación segura se definen las
siguientes prescripciones de seguridad:
3.1 Solicitud de acceso al servicio
La solicitud del acceso al servicio web se realizará mediante la firma y envío de un
formulario de solicitud en papel que será proporcionado por la Dirección General de
Aviación Civil para el caso de tráfico aéreo y por la Dirección General de la Marina
Mercante para el caso del tráfico aeroportuario.
3.2. Cifrado del canal de comunicación mediante protocolo SSL
Para garantizar la confidencialidad del canal se usará comunicación SSL en las
llamadas al servicio web.
3.3. Filtrado de IP
Será necesario que los solicitantes de acceso al servicio indiquen su IP o rango de IPs
desde donde se realizará la invocación al servicio web, ya que por configuración se
permitirá el acceso únicamente desde estos puntos. La dirección desde la que se
acceda al servicio en cada momento quedará registrada en la auditoría de seguridad
del Ministerio de Fomento.
Página 2
SUBSECRETARÍA
MINISTERIO
INSPECCIÓN GENERAL DE
DE FOMENTO FOMENTO
SUBDIRECCIÓN GENERAL
DE TECNOLOGÍAS DE LA
INFORMACIÓN Y
ADMINISTRACIÓN
ELECTRÓNICA
3.4. Autenticación del cliente mediante certificado
Las peticiones que se realicen al servicio web deberán encontrarse firmadas mediante
un certificado de sello electrónico válido que contenga los datos del agente externo
que realiza la invocación. Además estos certificados deben ser emitidos por los
prestadores incluidos en la "Lista de confianza de prestadores de servicios de
certificación" (TSL) establecidos en España y publicada en la sede electrónica del
Ministerio de Industria, Energía y Turismo:
https://sedeaplicaciones2.minetur.gob.es/prestadores/
Para que el Ministerio de Fomento pueda cotejar la validez de la firma de la petición,
durante el proceso de solicitud de alta de acceso a este servicio, el agente externo
tendrá que remitir la parte pública del certificado (archivo *.cer) para su configuración
en los sistemas de Fomento a la siguiente dirección de correo electrónico:
[email protected]Solo los certificados registrados y autorizados en el Ministerio de Fomento accederán
al servicio web.
IMPORTANTE: Cualquier cambio en el certificado electrónico que el agente externo
utilice para firmar las peticiones enviadas al servicio web tendrá que ser notificado al
Ministerio, siendo necesario remitir nuevamente la parte pública del nuevo certificado
para proceder a la configuración del nuevo certificado. Cualquier cambio no notificado
en el certificado electrónico utilizado para firmar la petición provocará que el servicio
deje de funcionar.
4. Definición funcional del servicio
Se presentan los datos necesarios en la llamada al servicio web.
Datos de entrada:
o Datos Solicitante:
o TipoDoc (obligatorio): Tipo de documento identificativo. A elegir entre:
DNI o NIE
o NumDoc (obligatorio): Número del documento.
o Nombre (obligatorio): Tal y como aparece en el documento
identificativo.
o Apellido1 (obligatorio): Tal y como aparece en el documento
identificativo.
o Apellido2 (obligatorio cuando exista): Tal y como aparece en el
documento identificativo.
o Datos del viaje (obligatorios)
o Código del puerto o aeropuerto (Código según anexo III)
o Código del puerto o aeropuerto destino. (Código según anexo III)
No se verifica el trayecto, el único objetivo de esta información es
comprobar que el puerto/aeropuerto origen o el puerto/aeropuerto destino
se encuentra en la Comunidad Autónoma en la que está empadronado el
pasajero (Real Decreto 1316/2001 modificado por el Real Decreto
1340/2007).
Página 3
SUBSECRETARÍA
MINISTERIO
INSPECCIÓN GENERAL DE
DE FOMENTO FOMENTO
SUBDIRECCIÓN GENERAL
DE TECNOLOGÍAS DE LA
INFORMACIÓN Y
ADMINISTRACIÓN
ELECTRÓNICA
o Modo de transporte (obligatorio). Codifica el modo del viaje. Admite 2
valores: 1 (Modo aéreo). 2 (Modo marítimo).
o Número de billete / localizador (Obligatorio. Se comprobará que el campo no
se envía ni vacío ni en blanco). Número único del billete para el que se
solicita la información de la bonificación.
o Precio del Billete abonado por el pasajero por el billete completo (sin incluir
las tasas de infraestructura y seguridad para el caso del transporte aéreo, ni
gastos de remisión ni penalizaciones u otros conceptos no subvencionables
cualesquiera que sea el modo) expresado en céntimos de euro, sin comas ni
puntos (Obligatorio). Se comprobará que el campo no se envía ni vacío ni en
blanco y que no contengan caracteres alfanuméricos. Se admite el valor
cero.
Datos de salida:
o Respuesta sobre la bonificación. Las respuestas sobre la bonificación tendrá
tres siguientes valores
Código de
DESCRIPCION
respuesta
000 NO constan las condiciones de bonificación
001 SI constan las condiciones de bonificación
002 ERROR: “Motivo del error”
003 Plataforma de Intermediación no disponible
El código de respuesta 002 se refiere a errores técnicos del interfaz de
acceso del servicio. En la descripción de la respuesta se especificará el
motivo del error, pudiendo ser:
o El Solicitante no tiene permiso para consultar en la aplicación.
o La entidad DatosSolicitante es null.
o El campo Nombre de la entidad DatosSolicitante está vacío.
o El Apellido1 de la entidad DatosSolicitante está vacío.
o El TipoDoc es vacío.
o El TipoDoc solo puede ser DNI o NIE.
o El NumDoc está vacío.
o El DNI no es válido.
o El NIE no es válido.
o El Modo de Transporte está vacío.
o El campo ModoTransporte solo acepta valores '1' o '2'.
o La entidad DatosViaje es null.
o El campo Origen de la entidad DatosViaje está vacío.
o El campo Destino de la entidad DatosViaje está vacío.
o El origen no puede ser igual que el destino.
o El campo CodigoBillete no puede enviarse vacío o en blanco.
o El PrecioBillete no puede enviarse vacío o en blanco.
o El formato del PrecioBillete introducido no es correcto.
o La entidad ServicioBonificacionSalida es null.
Página 4
SUBSECRETARÍA
MINISTERIO
INSPECCIÓN GENERAL DE
DE FOMENTO FOMENTO
SUBDIRECCIÓN GENERAL
DE TECNOLOGÍAS DE LA
INFORMACIÓN Y
ADMINISTRACIÓN
ELECTRÓNICA
El código de respuesta 003 hace referencia a la imposibilidad de conectar
con la Plataforma de Intermediación que presta los servicios de consulta de
identidad, residencia o residencia legal al Ministerio de Fomento, motivo por
el que no se pueden comprobar si constan las condiciones de bonificación o
no.
o Código de verificación de la respuesta: Este valor será único para los datos
de entrada/salida y servirá tanto a la empresa que tramita el billete como al
Ministerio de Fomento para comprobar que efectivamente se realizó la
consulta y el resultado de la misma. La forma de cálculo se realizará en base
al código hash generado sobre la solicitud y códigos de control de éste. Este
código siempre acompañará a la respuesta.
Los datos retornados serán los aquí consignados como de salida junto con los
recibidos en la petición. Se recoge un esquema de estos datos en el anexo I. El
esquema WSDL y sus XSD asociados están recogidos en el anexo II.
5. Soporte técnico
Pueden remitir cualquier duda técnica durante el proceso de integración a la dirección
de correo electrónico [email protected].
Por otra parte, las caídas del servicio en el entorno de producción que se detecten
podrán comunicarse para ser contrastadas al buzón [email protected],
donde se atenderán en horario 24x7.
Página 5
SUBSECRETARÍA
MINISTERIO
INSPECCIÓN GENERAL DE
DE FOMENTO FOMENTO
SUBDIRECCIÓN GENERAL
DE TECNOLOGÍAS DE LA
INFORMACIÓN Y
ADMINISTRACIÓN
ELECTRÓNICA
Anexos
Anexo I. Esquema de los bloques de datos de entrada y salida
Página 6
SUBSECRETARÍA
MINISTERIO
INSPECCIÓN GENERAL DE
DE FOMENTO FOMENTO
SUBDIRECCIÓN GENERAL
DE TECNOLOGÍAS DE LA
INFORMACIÓN Y
ADMINISTRACIÓN
ELECTRÓNICA
Anexo II Definición técnica del servicio web
WCFServicioBonificacion.wsdl (WSDL)
WSDL_ServicioBonif
icacion.wsdl
ServicioBonificacionFaultContract.xsd
FaultMessage.xsd
ServicioBonificacionDataContract.xsd
DataContract.xsd
Serialization.xsd
Serialization.xsd
Página 7
SUBSECRETARÍA
MINISTERIO
INSPECCIÓN GENERAL DE
DE FOMENTO FOMENTO
SUBDIRECCIÓN GENERAL
DE TECNOLOGÍAS DE LA
INFORMACIÓN Y
ADMINISTRACIÓN
ELECTRÓNICA
Anexo III. Códigos de Puertos y aeropuertos que son orígenes y/o
destinos de trayectos susceptibles de bonificación
Codificación IATA de aeropuertos
Código Nombre
ACE LANZAROTE
AGP MALAGA
FUE FUERTEVENTURA
GMZ LA GOMERA
IBZ IBIZA
JCU CEUTA
LPA GRAN CANARIA
MAH MENORCA
MLN MELILLA
PMI PALMA DE MALLORCA
SPC LA PALMA
TCI TENERIFE
TFN TENERIFE NORTE
TFS TENERIFE SUR
VDE EL HIERRO
XRY JEREZ
SVQ SEVILLA
El resto de aeropuertos se codificarán de igual forma con su código IATA.
Codificación de puertos de la DGMM
Código Nombre
ACE ARRECIFE DE LANZAROTE
AGA AGAETE
AGP MÁLAGA
ALC ALICANTE
ALD ALCUDIA
ALG ALGECIRAS
BCN BARCELONA
CAD CÁDIZ
CHR LA GRACIOSA
CLR CALA-RATJADA
CBS CALASABINA
CEU CEUTA
DNA DENIA
Página 8
SUBSECRETARÍA
MINISTERIO
INSPECCIÓN GENERAL DE
DE FOMENTO FOMENTO
SUBDIRECCIÓN GENERAL
DE TECNOLOGÍAS DE LA
INFORMACIÓN Y
ADMINISTRACIÓN
ELECTRÓNICA
FOR FORMENTERA
FUE PUERTO DEL ROSARIO
GTL GRAN TARAJAL
HIE HIERRO
HUV HUELVA
IBZ IBIZA
LCR LOS CRISTIANOS
LEI ALMERÍA
LPA LAS PALMAS
MAH MAHÓN
MAR MORROJABLE
MLN MELILLA
MOT MOTRIL
OZL ORZOLA
PMI PALMA DE MALLORCA
QFU CORRALEJO
QIU CIUDADELA
QLY PLAYA BLANCA
SAA SAN ANTONIO
SCT SANTA CRUZ DE TENERIFE
SPC SANTA CRUZ DE LA PALMA
SSG SAN SEBASTIÁN DE LA GOMERA
VDH VALVERDE
VLC VALENCIA
Página 9
