Protocolo de actuacion parkings sept 18šltima...2019/01/03 · • Fichero: ubicación del fichero...
Transcript of Protocolo de actuacion parkings sept 18šltima...2019/01/03 · • Fichero: ubicación del fichero...
MADRID CENTRAL 1
VERSIÓN 3.12
PROCEDIMIENTO DE REGISTRO DE PARKINGS Y DE COMUNICACIÓN DE
ACCESOS ENTRE PARKINGS Y LA PLATAFORMA DE GESTIÓN DEL SERVICIO
PÚBLICO DE CONTROL A LA ZONA DE BAJAS EMISIONES
“MADRID CENTRAL” Septiembre 2018
MADRID CENTRAL 2
Contenido Contenido ............................................................................................................................... 2
Control de Versiones .............................................................................................................. 4
PROCEDIMIENTO DE SOLICITUD DE PARKINGS PARA SU INTEGRACIÓN EN EL SISTEMA DE CONTROL DE ACCESOS EN MC .............................................................................................. 5
1. MC - MANUAL DE USUARIO/A ...................................................................................... 7
1.1. Introducción ............................................................................................................... 8
1.1.1. Objetivo ................................................................................................................................ 8
1.1.2. Descripción de la aplicación ................................................................................................ 8
1.2. Descripción de las pantallas de la aplicación .......................................................... 11
1.2.1. Login ............................................................................................................................. 11
1.2.2. Menú principal de la aplicación......................................................................................... 12
1.2.3. Rotación ............................................................................................................................. 12
1.2.4. Abonados/as ...................................................................................................................... 18
1.2.5. Transferir ficheros de accesos de vehículos de rotación para los parkings sin sistema de
captación automática de matrículas ........................................................................................... 21
1.2.6. Actividad ............................................................................................................................ 22
1.2.7. Detalle de movimientos de carga de vehículos por día de acceso ................................... 24
1.2.8. Revisión y validación de matrículas cargadas ................................................................... 27
1.2.9. Detalle de error .................................................................................................................. 30
1.2.10. Consulta de vehículos cargados por matrícula ............................................................... 30
1.3. Consideraciones sobre las cargas automáticas realizadas mediante Servicio Web . 33
1.4. Consideraciones sobre los ficheros de movimientos empleados en las cargas manuales .............................................................................................................................. 33
1.5. Notificaciones electrónicas enviadas a los responsables de los parkings ................ 34
2. MC - ROTACIÓN - INTEGRACIÓN PARKINGS MEDIANTE SERVICIO WEB ................... 36
2.1. INTRODUCCIÓN ..................................................................................................................... 37
2.2. ACCESO AL SERVICIO ............................................................................................................. 37
2.3. DESCRIPCIÓN GENERAL ......................................................................................................... 37
2.3.1. Descripción del método putMovimientoParking .......................................................... 37
MADRID CENTRAL 3
2.3.2. Descripción y formato de los parámetros de entrada al servicio ................................. 38
2.3.3. Validación de los parámetros de entrada ..................................................................... 39
2.3.4. Ejemplo de los parámetros de entrada ........................................................................ 41
2.3.5. Descripción y formato de los parámetros de salida del servicio .................................. 42
2.3.6. Ejemplo de los parámetros de salida ............................................................................ 43
2.4. CÓDIGOS DE RESPUESTA .................................................................................................. 44
2.5. DEFINICIÓN DEL WSDL ...................................................................................................... 45
3. MC - ROTACIÓN - INTEGRACIÓN PARKINGS MEDIANTE FICHERO ............................. 48
3.1. OBJETIVO ....................................................................................................................... 49
3.2. DEFINICIÓN DEL FICHERO ............................................................................................. 49
3.2.1 Campos del fichero .............................................................................................................. 49
3.2.2 Ejemplo de fichero ............................................................................................................... 49
3.3. CÓDIGOS DE RESPUESTA DE LA CARGA DE FICHEROS.................................................. 50
3.4. CÓDIGOS DE RESPUESTA DE LOS DATOS DE FICHEROS ................................................ 50
4. MC - ABONADOS - INTEGRACIÓN PARKINGS MEDIANTE FICHERO ........................... 51
4.1. OBJETIVO ....................................................................................................................... 52
4.2. DEFINICIÓN DEL FICHERO ............................................................................................. 52
4.2.1 Campos del fichero .............................................................................................................. 52
4.2.2. Ejemplo de fichero .............................................................................................................. 52
4.3. CÓDIGOS DE RESPUESTA DE LA CARGA DE FICHEROS.................................................. 53
4.4 CÓDIGOS DE RESPUESTA DE LOS DATOS DEL FICHERO ................................................. 53
MADRID CENTRAL 4
Control de Versiones
Versión Descripción del cambio y apartados afectados
1 Versión inicial del documento.
2 Adaptación a permisos permanentes/abonados
MADRID CENTRAL 5
PROCEDIMIENTO DE SOLICITUD DE PARKINGS PARA SU INTEGRACIÓN EN EL SISTEMA DE CONTROL DE ACCESOS EN MC Todos los parkings (bien sean de rotación, de abonados o mixtos; bien sean de uso público o privado) ubicados en el Distrito Centro de la Ciudad de Madrid que estén interesados en adherirse al sistema de gestión de acceso de sus usuarios a la Zona de Bajas Emisiones denominada Madrid Central, deberán seguir el siguiente procedimiento para solicitar su integración:
1. Vía web del Ayuntamiento (a través de “Mi Carpeta” o “en línea”) se deberá registrar el parking en el sistema, debiendo facilitar la siguiente información y documentación:
a. Datos de identificación del parking (CIF, razón social, domicilio social de la empresa, representante legal y ubicación del parking)
b. Datos del representante legal del parking (nombre y apellidos, Correo Electrónico y Teléfono)
c. Datos de la persona de contacto (nombre y apellidos, Correo Electrónico, Teléfono fijo y móvil)
d. Documentación acreditativa de la actividad de parking y del número de plazas (escrituras, planos, documentos administrativos, …) de abonados y de rotación.
e. Escrito firmado por el representante del parking indicando el Gálibo y si dispone de un sistema de captación automática de matrículas de entrada y salida.
Los parkings ya dados de alta en el sistema de gestión de acceso a las APR, puesto que se migran todos los datos, para adherirse al nuevo sistema tan solo tendrán que cumplimentar los campos obligatorios de la web y facilitar el dato del gálibo y, si el parking no dispone de sistema de captación automática de matrículas, indicar, en su caso, el número de plazas de rotación y de abonados (no tendrán que aportar el resto de la documentación indicada) o cualquier dato que actualice la información o documentación facilitada hasta la fecha por el parking al Ayuntamiento.
2. La Subdirección General de Gestión de la Movilidad del Ayuntamiento de Madrid analizará esa información y documentos y contestará a dicha solicitud validándola o rechazándola.
3. En caso de validación, le serán remitidos los usuarios y contraseñas del entorno de
pruebas del MC para comenzar los desarrollos y pruebas para su integración con los sistemas de información de la Zona de Bajas Emisiones MC y los mecanismos
MADRID CENTRAL 6
descritos en este documento. Una vez superadas las pruebas se dará una nueva contraseña y se podrá empezar a operar en real.
4. En caso de rechazo, se pedirá la subsanación de la documentación y/o información
al parking, pudiéndose requerir información adicional. El parking cualquier duda o información que precise sobre el proceso de integración puede hacerlo en esta dirección de correo [email protected]
MADRID CENTRAL 7
1. MC - MANUAL DE USUARIO/A
“Sistema de gestión de
accesos dentro de Madrid
Central a vehículos a
parkings”
MADRID CENTRAL 8
1.1. Introducción
1.1.1. Objetivo
En este apartado se detallan las tareas y funcionalidades que pueden realizar los/las
administradores/gestores administradoras/gestoras de los parkings, tanto de uso público como de
uso privado, situados dentro de los límites de Madrid Central (en adelante MC) para permitir al
acceso a MC a los vehículos de sus clientes.
1.1.2. Descripción de la aplicación
La aplicación se encarga en esencia de comunicar las matrículas de los vehículos de los
clientes de los parkings al sistema de permisos de acceso de MC. Cada matrícula recibida en dicho
sistema generará un permiso, bien sea puntual (permiso asociado a plazas de rotación) bien sea
permanente (permisos asociadas a las plazas de abonados), siempre que el vehículo cumpla los
requisitos definidos en la Ordenanza de Movilidad Sostenible y en la norma que desarrolle el
régimen de gestión y funcionamiento de MC.
En el registro en el sistema de cada uno de los parking se dará de alta, entre otros datos, el
número de plazas totales del parking y el número de plazas de abonados de un parking (cuando
proceda). El número de plazas de abonados sólo aplica a los parkings de carga manual (sin sistema
de captación automática de matrículas); el cambio de condición, a través de la correspondiente
incidencia desde soporte-MC, de parking de carga manual a de captación automática implica la baja
lógica de las plazas de abonados y sus permisos generados.
Por cada plaza de rotación de un parking se podrá enviar un máximo de cuatro permisos puntuales por día.
Por cada plaza de abonado se generará un único permiso permanente. Los permisos para las plazas de rotación tendrán vigencia únicamente para el día de acceso
al parking ─ permiso puntual ─, mientras que los permisos de las plazas de abonados tendrán vigencia indefinida – permiso permanente ─ mientras dure su condición de abonado del parking, pudiéndose modificar la matrícula cuando cambie el abonado.
MADRID CENTRAL 9
Los parkings del interior de MC contarán con dos formas de comunicar las matrículas de sus
clientes cuando accedan a los mismos para aparcar sus vehículos:
1. Parkings CON sistemas de captación automática de matrículas:
o Procedimiento estándar:
� Se envían los movimientos de los vehículos mediante la invocación al
Servicio Web Registro de Accesos a Parkings (en adelante SW). Véase el
apartado 2 de este documento con referencia “MC-ROTACIÓN -
INTEGRACIÓN PARKINGS MEDIANTE SERVICIO WEB”, para más
información sobre la integración con el SW.
� Estos parkings no están sujetos a cuotas diarias de vehículos.
� El plazo máximo para comunicar las matrículas es de cinco días
naturales siguientes al día en que tenga lugar el acceso, es decir, si el
acceso es un lunes hasta el sábado de la misma semana.
o Procedimiento de contingencia previsto cuando el sistema de captación
automática no esté operativo:
� Será posible enviar las matrículas adjuntando un fichero a través de un
formulario de la aplicación. Al ser un procedimiento de contingencia el
fichero podrá ser auditado por la Subdirección General de Gestión de la
Movilidad del Ayuntamiento de Madrid. Véase el apartado 3 del
presente documento con referencia “MC-ROTACIÓN - INTEGRACIÓN
PARKINGS MEDIANTE FICHERO” para más información sobre el formato
de los ficheros a adjuntar.
� El plazo máximo para comunicar las matrículas es de cinco días
naturales siguientes al día en que tenga lugar el acceso, es decir, si el
acceso es un lunes hasta el sábado de la misma semana.
La inserción de matrículas a través de sistemas de captación automática generará siempre un permiso puntual.
MADRID CENTRAL 10
2. Parkings SIN sistemas de captación automática de matrículas:
Si el parking no tiene implementado el proceso de captación automática de matrículas la carga de matrículas responderá a una de las siguientes casuísticas, en función de si la tipología del parking es de rotación o de abonados. En el caso de parkings de tipología mixta tendrán que proceder a la carga de matrículas por ambos métodos.
o Procedimiento estándar de carga de matrículas de parkings de rotación
(permisos puntuales diarios):
� Las matrículas se comunicarán adjuntando un fichero desde un
formulario de la aplicación. Véase el apartado 3 con referencia “MC-
ROTACIÓN - INTEGRACIÓN PARKINGS MEDIANTE FICHERO” para más
información sobre el formato del fichero.
� Estos parkings de tipología “parking de rotación” contarán con unas
cuotas diarias de vehículos (cuotas puntuales). Por defecto cuatro
permisos diarios por plaza, ampliables con la justificación de una mayor
rotación por plaza. Los ficheros podrán ser auditados por la
Subdirección General de Gestión de la Movilidad del Ayuntamiento de
Madrid.
� El plazo máximo para comunicar las matrículas es de cinco días tras el
acceso, es decir, si el acceso es un lunes hasta el sábado de la misma
semana.
o Procedimiento estándar de carga de matrículas de parkings de abonados
(permisos permanentes):
� Las matrículas se comunicarán adjuntando un fichero desde un
formulario de la aplicación. Véase el apartado 4 con referencia “MC -
ABONADOS - INTEGRACIÓN PARKINGS MEDIANTE FICHERO” para más
información sobre el formato del fichero.
� Estos parkings de tipología “parking de abonados” contarán con una
cuota de abonados (cuotas permanentes) de vehículos. Esta cuota será
igual al número de plazas del parking destinadas a vehículos de
abonados (en el caso de que se tratase de un parking de tipología
exclusiva de “parking de abonados” coincidirá, obviamente, con el
número total de plazas)
� Los ficheros podrán ser auditados por la Subdirección General de
Gestión de la Movilidad del Ayuntamiento de Madrid.
Hay que reseñar que para la carga de matrículas de abonados basta con realizar la subida una vez, siempre y cuando los abonados no cambien. En caso de cambio de abonados habrá que dar de baja a las matrículas asociadas a los abonados que hayan perdido tal condición y proceder al alta de las nuevas matrículas a través de la carga de un nuevo fichero.
MADRID CENTRAL 11
1.2. Descripción de las pantallas de la aplicación
A continuación se muestra el listado de funcionalidades que estarán disponibles en el
acceso a la aplicación Web de Madrid Central. A modo ilustrativo, se acompaña cada funcionalidad
con unos prototipos de pantallas para su mayor entendimiento.
1.2.1. Login
En esta pantalla se realiza la autenticación del usuario/a administrador/a gestor/a del
parking:
Ilustración 1. Pantalla de Login
Una vez introducidos el/la usuario/a y la clave1 (Password) que identifican al/a la
administrador/gestor administradora/gestora del parking dentro del sistema y pulsado el botón
‘Entrar’, se accede a la pantalla de inicio de la aplicación. Si no recuerda la clave de acceso
(password) podrá recuperarse siguiendo el enlace “Restablecer contraseña”, disponible en la misma
pantalla; el sistema mostrará un formulario en el que, indicando la dirección de correo asociada al
1 Tanto el/la usuario/a como la clave de acceso son proporcionados por el Ayuntamiento.
MADRID CENTRAL 12
usuario/a de la aplicación, se forzará el envío de un correo con las instrucciones para cambiar la
contraseña.
Si un/a usuario/a tampoco recuerda el correo electrónico asociado a su cuenta podrá, en última
instancia, notificar la incidencia al equipo de soporte de MC.
1.2.2. Menú principal de la aplicación
Menú con las opciones de navegación disponibles:
- Rotación
- Abonados
- Consulta de movimientos por matrícula
- Ayuda
1.2.3. Rotación
Una vez autenticado el/la usuario/a del parking en el sistema se accede a la pantalla de
“Rotación”, en la cual se pueden consultar el número de vehículos de rotación cargados en MC. Esta
pantalla es accesible desde el menú principal de la aplicación.
El detalle del grid de accesos refleja los accesos de vehículos de rotación con su
correspondiente fecha de acceso. La consulta de datos de Rotación es accesible a través de la opción
de menú de “Rotación” y/o desde el link a tal efecto:
El grid de errores muestra el registro de errores agrupados por tipología.
MADRID CENTRAL 13
A continuación se describen todos los campos de esta pantalla:
• En la cabecera se identifica el parking que ha accedido con su nombre.
MADRID CENTRAL 14
• Debajo hay un formulario donde puede introducirse un rango de fechas de acceso como criterio
de búsqueda de lotes procesados. Por defecto serán visibles los totales correspondientes a los
últimos siete días.
• Una vez introducido el rango de fechas de acceso, al pulsar el botón ‘Buscar’ se mostrará en las
tablas de resultados el número de matrículas cargadas ordenadas descendentemente por la
fecha de acceso al parking. La tabla de errores mostrará los errores acumulados.
MADRID CENTRAL 15
• Los campos de la tabla de accesos son los siguientes:
- Fecha de inserción: fecha en la que se registró el acceso.
- Fecha de acceso: fecha en la que los vehículos accedieron al parking.
- Cargadas con éxito: total de matrículas que accedieron en la fecha indicada y que han
sido cargadas correctamente.
- Matrículas Nacionales: vehículos de matriculación nacional cargados el día en cuestión.
- Matrículas Extranjeras/especiales: matrículas que no se corresponden con el formato
nacional.
- Acciones: permite navegar a la pantalla de “Detalle de movimientos de carga” de la fila
donde ha clicado.
MADRID CENTRAL 16
• Los campos de la tabla de errores son los siguientes:
- Fecha de inserción: fecha en la que se registró el error.
- Fecha de acceso: fecha en la que los vehículos accedieron al parking.
- Errores: número de matrículas cuya transmisión ha sido errónea
- Tipo de error: tipología del error (matrícula incorrecta, fecha incorrecta, fuera de plazo
y movimiento duplicado).
• Acciones que puede realizar el/la usuario/a en esta pantalla (estas acciones se explicarán a lo
largo de este apartado 1):
1- Búsqueda: se podrá seleccionar un rango de fechas.
2- Consultar listados detallados de vehículos cargados por fecha de acceso:
haciendo clic en una fila de la tabla el/la usuario/a navegará a la pantalla de
“Detalle de movimientos de carga” de la fila donde ha clicado para el caso del
grid de “accesos registrados”.
En el caso del grid de “errores insertados” navegará al detalle de error del día
señalado por la fecha de inserción de la fila que ha clicado.
MADRID CENTRAL 17
3- Acceder a la pantalla de Abonados. Si se pulsa sobre el literal “Pinche aquí” se
navegará a la pantalla de Abonados. Este texto y su enlace asociado sólo serán
visibles si se trata de un parking de carga manual de matrículas, y siempre y
cuando tenga dadas de alta en el sistema plazas de abonados.
4- Acceder a la pantalla de consulta de operaciones de carga: pulsando el botón
‘Ver actividad’ se navegará a la pantalla “Actividad”.
5- Acceder al detalle de accesos: pulsando el botón ‘Ver detalle’ navegará a la
pantalla “Detalle de movimientos de carga de vehículos por día de acceso”.
6- Acceder a la pantalla de cargas manuales: pulsando el botón ‘Subir fichero’
navegará a la pantalla “Transferir ficheros de movimientos / Carga manual de
vehículos”.
Si se trata de un parking de captación automática al pulsar el botón se le
solicitará confirmación, recordándole que la carga manual del fichero es sólo
una solución de contingencia para cuando el servicio de captación automática
está caído, comunicándole además que se generará una irregularidad al
respecto.
MADRID CENTRAL 18
7- Exportar el listado: en formato CSV o Excel.
8- Existe paginación por si el número de resultados de la búsqueda realizada es
muy elevado.
1.2.4. Abonados/as
Esta pantalla permite al administrador/a del parking consultar y gestionar las altas y bajas de los
vehículos abonados. Esta pantalla es accesible desde el menú principal de la aplicación, si bien tal
opción aparecerá deshabilitada para los parkings registrados sólo como de captación automática.
MADRID CENTRAL 19
• Los campos de la tabla son los siguientes:
- Matrícula: matrícula del vehículo abonado.
- Fecha de alta: fecha en la que se ha generado el alta del vehículo abonado.
- Fecha de baja: fecha en la que se ha revocado la condición de abonado del vehículo.
- Respuesta MC: una vez que se da de alta un/a abonado/a se genera un permiso con
carácter permanente - indefinido mientras la condición de abonado siga vigente - para
el vehículo en cuestión, siempre que éste cumpla los requisitos medioambientales
definidos en la Ordenanza de Movilidad Sostenible y en la norma que desarrolle el
régimen de gestión y funcionamiento de MC. Si no es así figurará el estado “Rechazado”
y “tramitado” (permiso permanente generado, en cualquier otro caso).
MADRID CENTRAL 20
- Distintivo ambiental. Muestra el distintivo ambiental de cada una de las matrículas
registradas como abonados.
- Dar de baja. Se mostrará un icono de una papelera, posibilitando la baja de los vehículos
abonados desde el propio grid.
Bajo el grid de resultados se muestra también el estado de la cuota de abonados.
• Acciones que puede realizar el/la usuario/a en esta pantalla (estas acciones se explicarán a lo
largo de este apartado 1):
1 - Dar de baja un abonado. Se solicitará confirmación del administrador antes
de proceder a la baja. Los registros con fecha de baja no tienen disponible esta
opción, obviamente.
2 - Exportar el listado: en formato CSV o Excel.
3 - Existe paginación por si el número de resultados de la búsqueda realizada es
muy elevado.
4 – Añadir Abonado Único. Desde aquí se permite al administrador la carga
individual de una única matrícula de abonado, a través de una ventana en pop-up.
5 – Cargar Fichero de Abonados. Desde este botón el administrador podrá adjuntar
directamente nuevos ficheros con el formato correcto para su registro como
vehículos de abonados, cargándose automáticamente en el grid de resultados una
vez finalizada con éxito la carga. El sistema procesará la información del fichero
registrando las matrículas, siempre y cuando el fichero cumpla las condiciones de
formato exigidas (las condiciones vienen especificadas en el apartado 4)
MADRID CENTRAL 21
1.2.5. Transferir ficheros de accesos de vehículos de rotación para los
parkings sin sistema de captación automática de matrículas
Esta pantalla, accesible a través del botón “Subir fichero” de la pantalla de “Rotación”,
permite adjuntar ficheros de movimientos de matrículas y transferirlos al sistema de MC; está
prevista para parkings sin sistemas de captación automática de matrículas, y excepcionalmente
como método de contingencia para parkings que sí cuentan con dichos sistemas, pero
eventualmente los tienen fuera de servicio.
El formato del fichero aparece explicado en el apartado 3 del presente documento.
A continuación se muestran todos los campos de esta pantalla:
• Fichero: ubicación del fichero en el ordenador del/de la usuario/a (obligatorio). El/la usuario/a
podrá utilizar el botón ’Examinar’ para buscar el fichero con las matriculas en su ordenador. Una
vez seleccionado el fichero y pulsado el botón ’Cargar’, el sistema procesará la información del
fichero registrando las matrículas, siempre y cuando el fichero cumpla las condiciones de formato
exigidas (las condiciones vienen especificadas en el apartado 3)
MADRID CENTRAL 22
• Al finalizar el proceso aparecerá un mensaje informativo indicando el resultado final de la carga:
correcta, si todo ha ido bien, o incorrecta, si no se ha podido cargar en ese momento el fichero.
• Si la carga ha sido correcta el sistema mostrará un resumen de los vehículos tramitados:
- Total en fichero: número total de matrículas o filas que se encuentran en el fichero.
- Vehículos cargados con éxito: número de matrículas que se han cargado correctamente
en el sistema MC.
- Vehículos no cargados por duplicidad: el sistema solamente permite un movimiento
por matrícula y momento de acceso.
- Errores: registros o matrículas con errores, por tener algún dato incorrecto respecto al
formato del fichero.
• Si la carga ha devuelto algún resultado erróneo aparecerá el botón de “Descargar detalle
errores”. Clicando sobre él se puede descargar un fichero en formato CSV con el detalle de los
errores fila a fila del fichero origen.
1.2.6. Actividad
Esta pantalla muestra el registro de todos los intercambios de información realizados entre
el sistema de MC y el parking, con el fin de auditar los procesos de transmisión de matrículas y
corregir los errores que se puedan producir.
MADRID CENTRAL 23
La pantalla cuenta con un formulario donde podemos introducir los siguientes criterios de
búsqueda: matrícula, respuesta del sistema tras el proceso de carga, y rango de fechas de acceso.
Al pulsar el botón ‘Buscar’ se mostrará un listado de las matrículas que ha procesado el sistema de
acuerdo a los criterios introducidos. Los campos de la tabla resultado son los siguientes:
- Fecha de acceso: fecha de acceso del vehículo al parking.
- Matrícula: matrícula del vehículo cargado.
- Fecha de envío: es la fecha de la carga del fichero almacenado en MC.
- Respuesta de MC: respuesta del SW o del proceso de carga para el vehículo.
- Observaciones: el motivo del error si lo hubiere.
Acciones que puede realizar el usuario en esta pantalla:
1- Búsqueda: se podrá seleccionar un rango de fechas.
2- Exportar el listado: en formato CSV o Excel.
MADRID CENTRAL 24
3- Existe paginación por si el número de resultados de la búsqueda realizada es muy
elevado.
1.2.7. Detalle de movimientos de carga de vehículos por día de acceso En esta pantalla se pueden consultar todos los movimientos de vehículos cargados
correctamente en el sistema MC para una fecha de acceso determinada.
MADRID CENTRAL 25
Es posible filtrar la información por el tipo de matrícula del vehículo y el estado del movimiento.
- Tipo de matrícula:
o Matrículas nacionales ordinarias: matrículas que el sistema identifica con un
formato común usado en España. La matrícula ordinaria actual está compuesta
por cuatro dígitos y tres letras consonantes (excepto Ñ y Q). Además, incluye la
banda azul europea en el lateral. Anteriormente, los sistemas que aplicaban
eran: el provincial numérico y el provincial alfanumérico.
o Matrículas nacionales especiales o extranjeras: matrículas que el sistema no
identifica con un formato común usado en España; pueden ser nacionales
especiales (matrícula de vehículo histórico, vehículos pertenecientes al Estado,
vehículos de Administraciones Autonómicas, matrícula diplomática, matrícula
turística, … ) o extranjeras.
- Estado: los movimientos pueden encontrarse en alguno de los siguientes estados:
o Pendiente de tramitar: el movimiento se ha subido correctamente a través de
ficheros de carga manual de rotación.
o No validado: el movimiento es correcto pero no ha sido aún revisado por el
responsable del parking.
o Validado: el responsable del parking ha verificado que la matrícula ha sido
correctamente captada por el sistema automático.
o Corregido: el responsable del parking ha corregido un error de captación en la
matrícula.
o Tramitado: el sistema ha creado un permiso puntual para el movimiento; en
este estado el movimiento deja de ser editable, esto es, no podrá corregirse la
matrícula si es incorrecta.
o Rechazado: el vehículo no cumple los requisitos tecnológicos y
medioambientales para obtener un permiso puntual.
MADRID CENTRAL 26
Los datos que se muestran en la tabla de resultados son los siguientes:
- Hora de registro: la hora concreta del registro del vehículo por el sistema de captación;
dependiendo de la ubicación de la cámara puede ser la hora de entrada o de salida del
vehículo.
- Matrícula
- Tipo de matrícula
- Cámara: identificador de la cámara que registró al vehículo (no se aplica cuando la carga ha
sido manual).
- Carril: situación de la cámara (no se aplica cuando la carga ha sido manual).
- Número de fotografías: número de imágenes enviadas (no se aplica cuando la carga ha sido
manual).
- Estado: estado en el que se encuentra el movimiento.
- Tipo de acceso: «Entrada», «Salida» o «Desconocido», cuando el mismo dispositivo de
captación registra tanto las entradas como las salidas, o cuando se carguen desde fichero.
- Fecha de envío: fecha en la que el parking realizó la carga.
Acciones que puede realizar el usuario en esta pantalla:
1- Filtrar por el detalle de movimientos de diferentes días de acceso y las
diferentes fechas de envío.
Se permite elegir un día concreto mediante un calendario, teniendo a ambos
lados dos botones para navegar al día anterior y al día posterior,
respectivamente.
2- Exportar el listado: en formato CSV o Excel.
3- Revisar y validar las matrículas cargadas: el botón ‘Revisar todas las matriculas’
conlleva revisar todos los movimientos en estado «No validado» del más
antiguo al más reciente. La pantalla de revisión de matrículas solamente está
MADRID CENTRAL 27
disponible si el parking cuenta con un sistema de captación automática de
matrículas.
4- Acceder a la pantalla “Revisión y validación de matrículas cargadas”: haciendo
clic sobre un movimiento concreto se accede a la pantalla de revisión de dicho
movimiento; dependiendo de su estado se podrá corregir la matrícula o
solamente visualizar los detalles.
1.2.8. Revisión y validación de matrículas cargadas
Esta pantalla solamente está disponible para los parkings con sistemas automáticos de
captación de matrículas.
Es muy recomendable que el/la responsable del parking compruebe todas las matrículas
que su sistema de captación automática ha enviado a través del SW; una mala lectura no corregida
puede provocar que sus clientes sean sancionados, con el trastorno que esa situación representa
para todos los implicados.
Desde la pantalla de “Detalle de movimientos de carga de vehículos” se accede a la pantalla
“Revisión y validación de matrículas cargadas”:
MADRID CENTRAL 28
Los datos que se muestran en la pantalla son los siguientes:
• Fecha de acceso: fecha de captación de la matrícula.
• Cámara: identificador de la cámara que registró al vehículo.
• Foto de la matrícula: foto de la matrícula captada por la cámara.
• Matrícula: texto de la matrícula enviado por la cámara en la captación automática.
El/la responsable del parking podrá compararla con la foto anterior y corregirla, si
es preciso.
• Tipo de acceso: indica si el vehículo realiza una entrada o una salida del parking.
• Fecha de envío:
MADRID CENTRAL 29
• Estado:
Acciones que puede realizar el/la usuario/a en esta pantalla:
1.- Validar movimientos: cuando el/la responsable del parking haya contrastado la
matrícula de la foto y la del texto, o la haya corregido si es necesario, podrá marcar el
movimiento como «Validado» pulsando el botón ‘Validar’. Cuando un movimiento es
validado en la pantalla se carga automáticamente el siguiente movimiento que se encuentre
pendiente de validación.
2.- Navegar por los movimientos a revisar: pulsando los botones ‘Primero’, ‘Anterior’,
‘Siguiente’ y ‘Último’ el/la usuario/a podrá moverse libremente por los movimientos
pendientes de validación.
3.- Salir: pulsando el botón ‘Salir’ el/la usuario/a cierra la pantalla de revisión de matrículas.
MADRID CENTRAL 30
1.2.9. Detalle de error A esta pantalla se accede desde la pantalla de rotación, clicando sobre la lupa de las filas de
grid de errores insertados. Muestra cada uno de los errores insertados para la fecha seleccionada.
Los datos que se muestran en la pantalla son los siguientes:
- Fecha de inserción. La fecha en la que se realizó la inserción del registro erróneo, bien vía
fichero, bien vía web service.
- Fecha de acceso. La fecha de acceso del registro erróneo. En el caso de tratarse de un error
de fecha este campo aparecerá vacío.
- Matrícula
- Tipo de error. Tipología del error (error de fecha, de matrícula, movimiento duplicado en
fichero, movimiento ya registrado en BBDD o movimiento fuera de plazo)
- Dato erróneo. Se muestra el dato inválido que ha generado el registro erróneo. En caso de
registros duplicados aparecerá especificado como tal.
1.2.10. Consulta de vehículos cargados por matrícula
En esta pantalla se pueden consultar todos los movimientos de un vehículo en concreto a
partir de su matrícula. Esta pantalla es accesible desde el menú principal de la aplicación.
MADRID CENTRAL 31
Los datos que se muestran en la pantalla son los siguientes:
Filtro de búsqueda:
La búsqueda devolverá dos grid de resultados, cuando sea el caso de que la matrícula tenga
movimientos de rotación y condición de abonado (activa o inactiva), mostrando los movimientos
de la matrícula en cuestión para los últimos 365 días.
Sobre las grid de resultados (movimientos de la matrícula de rotación y alta de condición de
abonado) aparecerá un mensaje de texto informando de si se trata de una matrícula de rotación o
de abonado:
“Se visualizan los resultados correspondientes a la matrícula de abonado/rotación XXXXXX
en los últimos 365 días”
Tabla de resultados grid de movimientos de rotación:
MADRID CENTRAL 32
- Fecha de acceso: fecha y hora de entrada o salida del vehículo al parking
- Matrícula
- Cámara: identificador de la cámara que registró al vehículo. (los registros de rotación
cargados manualmente no dispondrán de esa información).
- Carril: situación de la cámara. (los registros de rotación cargados manualmente no
dispondrán de esa información).
- Estado: estado en el que se encuentra el movimiento.
- Tipo de acceso: indica si el vehículo realiza una entrada o una salida del parking. (los
registros de rotación cargados manualmente no dispondrán de esa información).
Tabla de resultados grid de condición de abonados:
- Matrícula
- Fecha de alta de abonado: fecha y hora fecha de alta como abonado
- Fecha de baja de abonado: fecha y hora de baja de la condición de abonado.
(si se trata de un vehículo de abonado se mostrará su fecha de alta como abonado)
Acciones que puede realizar el/la usuario/a en esta pantalla:
1.- Cuando se clique sobre una fila de la tabla que se corresponda con un movimiento de
captación automática aparecerá la pantalla de “Revisión y validación de matrículas
cargadas”, pudiendo ver el detalle del movimiento.
2.- Exportar el listado: en formato CSV o Excel.
3.- Existe paginación por si el número de resultados de la búsqueda realizada es muy
elevado.
MADRID CENTRAL 33
1.3. Consideraciones sobre las cargas automáticas realizadas mediante
Servicio Web
Plazo máximo de transferencia de movimientos:
Los movimientos se deberán enviar, como máximo, hasta cinco días naturales después
del día del acceso del vehículo, por lo que las matrículas cargadas mediante SW no generan
permisos de acceso de manera inmediata, sino transcurridos cinco días naturales
siguientes al del día de acceso del vehículo al parking. El/la responsable del parking cuenta
con cinco días naturales desde el día del acceso del vehículo al parking para validar/corregir
la matrícula en la aplicación. Transcurridos cinco días naturales desde el día siguiente del
acceso del vehículo al parking, esto es, el sexto día desde el acceso, el sistema MC generará
el permiso puntual correspondiente, siempre que los datos que se generen del vehículo
cumpla los requisitos definidos en las normas de control y funcionamiento de MC
aprobadas por el Ayuntamiento de Madrid.
Número máximo de movimientos que pueden enviarse en un mismo día:
No existe número máximo de movimientos que puedan enviarse en un mismo día.
1.4. Consideraciones sobre los ficheros de movimientos empleados en las
cargas manuales
Plazo máximo de transferencia de ficheros de permisos puntuales/rotación:
Los movimientos se deberán enviar, como máximo, hasta cinco días naturales después
del día del acceso del vehículo. Las matrículas cargadas manualmente mediante un fichero
no generan permisos de acceso de manera inmediata, sino transcurridos cinco días
naturales después del día siguiente al del acceso del vehículo al parking. El/la responsable
del parking cuenta con cinco días naturales desde el día del acceso del vehículo al parking
para validar/corregir la matrícula en la aplicación. Transcurridos cinco días naturales desde
el día siguiente del acceso del vehículo al parking, esto es, el sexto día desde el acceso, el
sistema MC generará el permiso puntual correspondiente, siempre que el vehículo cumpla
los requisitos definidos en las normas de control y funcionamiento de MC aprobadas por el
Ayuntamiento de Madrid.
MADRID CENTRAL 34
Plazo máximo de transferencia de ficheros de permisos permanentes/abonados:
Este concepto no aplica para los permisos permanentes. Las matrículas de
abonados cargadas manualmente sí generan un permiso permanente con carácter
inmediato. Este permiso seguirá vigente mientras la condición de abonado asociada a la
matrícula no sea revocada a través de una “baja de abonado”.
Número máximo de ficheros que pueden adjuntarse un mismo día:
No existe límite en el número de ficheros diario, aunque es necesario controlar el
número de matrículas incluido en cada uno de ellos (el tope máximo es de 1.000 matrículas
por fichero).
1.5. Notificaciones electrónicas enviadas a los responsables de los parkings
El sistema MC realizará un control sobre las matrículas recibidas a través de carga manual
de ficheros puntuales/permisos de rotación y a través de captación automática, no así para el caso
de matrículas de abonados. El sistema enviará correos electrónicos de advertencia por los siguientes
motivos:
1. Si al llegar al cuarto día natural desde el día siguiente de la fecha de acceso el
parking no ha enviado los accesos de dicho día, se le comunicará mediante un
correo electrónico que faltan los accesos del día detectado y que tiene dos días
naturales como plazo máximo para llevarlo a cabo, o de lo contrario se tendrá que
poner en contacto con la Subdirección General de Gestión de la Movilidad de la
Dirección General de Sostenibilidad y Control Ambiental del Ayuntamiento de
Madrid, para solventar el problema.
2. Si al llegar al quinto día natural desde la fecha de acceso el parking sigue sin enviar
los accesos de dicho día, se le comunicará mediante un correo electrónico que
faltan los accesos del día detectado y que todavía tiene un día como plazo máximo
para llevarlo a cabo, o de lo contrario se tendrá que poner en contacto con la
Subdirección General de Gestión de la Movilidad de la Dirección General de
Sostenibilidad y Control Ambiental del Ayuntamiento de Madrid, para solventar el
problema.
3. Si al llegar al sexto día natural desde la fecha de acceso el parking todavía no ha
enviado los accesos de dicho día, se le comunicará mediante un correo electrónico
que ha expirado el plazo de comunicación de movimientos, instándole a ponerse en
MADRID CENTRAL 35
contacto con la Subdirección General de Gestión de la Movilidad de la Dirección
General de Sostenibilidad y Control Ambiental del Ayuntamiento de Madrid, para
solventar el problema. La Subdirección General de Gestión de la Movilidad adoptará
las medidas oportunas con objeto de que no vuelva a suceder esta clase de
incidente, debiendo el propio parking asumir las consecuencias.
4. Control volumétrico: si el parking envía los movimientos de vehículos de un día en
concreto y tiene menos de un 25 % de las matrículas que carga habitualmente, en
el plazo máximo de 4 días naturales desde el del acceso, través de un correo
electrónico se le advertirá la situación, recomendando a la persona responsable del
parking que revise las matrículas enviadas.
MADRID CENTRAL 36
2. MC - ROTACIÓN - INTEGRACIÓN
PARKINGS MEDIANTE SERVICIO
WEB
Interfaz de servicio:
MovimientosParking
MC_INT_WS
MADRID CENTRAL 37
2.1. INTRODUCCIÓN
El objetivo del presente apartado 2 es servir de guía en el uso del Servicio Web Registro de
Accesos a Parkings, tanto de uso público como de uso privado, para los programadores que vayan
a desarrollar aplicaciones cliente que hagan uso de los mismos.
Este servicio permite a los parkings integrados en la Plataforma de Gestión del servicio de
control de accesos a MC proporcionar en tiempo real información de los vehículos que acceden y
abandonan los parkings.
2.2. ACCESO AL SERVICIO
Para todas las operaciones de este servicio se requiere autenticación con usuario y
contraseña, , conforme al estándar Password Digest; se codificará en base64 el sha1 de la
concatenación del nonce , más una fecha de contraste, más el token proporcionado.
2.3. DESCRIPCIÓN GENERAL
El servicio web ofrece una funcionalidad/operación/método: putMovimientoParking
2.3.1. Descripción del método putMovimientoParking
Envía al sistema central la información de cada movimiento de entrada o salida producido
en el parking.
MADRID CENTRAL 38
2.3.2. Descripción y formato de los parámetros de entrada al servicio
Está compuesto por dos campos o ítems: el identificador del parking (IdParking) y la
estructura movimientos, que contiene a su vez varios campos.
La llamada contiene una lista con los movimientos producidos, por lo que el método puede utilizarse para enviar un movimiento (en el caso de enviar cada movimiento en tiempo real), o varios a la vez (llamadas periódicas, reenvío de información tras una caída de comunicaciones, etcétera), con un límite de movimientos máximo por envío.
Detalle de los parámetros de entrada:
Campo Descripción Tipo de dato Obligatoriedad Cardinalidad Posibles valores
IdParking Identificador del
parking
Int Sí 1 Ej. 005
Estructura movimiento - La cardinalidad de esta estructura es: 1-50
idTransaccion Identificador de
cada
movimiento
Se compone de:
identificador de
parking +
matrícula +
momento de la
captación
String Sí
(Tiene que ser
único para cada
movimiento y
generado por el
parking en la
llamada)
1 Ej.
0051840CDV20180412223001
MADRID CENTRAL 39
Campo Descripción Tipo de dato Obligatoriedad Cardinalidad Posibles valores
action Tipo de
movimiento
String(1) Sí 1 (“E”, «Entrada» |
“S”, «Salida» |
“D”, «Desconocido»)
plate Matrícula del
vehículo
String(12) Sí 1
moment Fecha y hora del
momento en el
que se produce
la captación
String
(yyyyMMddHHmmss)
Sí 1 La hora debe ser informada y
debe ser la hora local de
Madrid.
Ej. 20180312122316
idCamara Identificador
para las cámaras
del parking
Integer Sí 1
photo1 Foto contexto.
Imagen
correspondiente
a la captura de la
entrada o salida
del vehículo
Base64Binary
(hasta 50 Kb)
Sí 1
photo2 Recorte de
matrícula.
Imagen
correspondiente
a la captura de la
entrada o salida
del vehículo
Base64Binary
(hasta 50 Kb)
Sí 1
2.3.3. Validación de los parámetros de entrada
Las validaciones que se realizarán por parte del sistema de MC son las siguientes:
- Identificador de la transacción:
o Comprobar el formato: 3 caracteres de parking + 5 a 12 caracteres matrícula +
yyyyMMddHHmmss.
o Comprobar que no esté previamente en el sistema: debe ser único por movimiento.
MADRID CENTRAL 40
- Parking sobre el que se está informando: identificado por id.
o Comprobar que el id del parking existe.
o Comprobar que el id del parking está asociado al usuario del servicio web.
- Momento en el que se produce la captación: fecha y hora completa.
o Comprobar que el formato de la fecha y hora son válidos.
o Comprobar que la recepción se produce dentro de los límites temporales
establecidos por las normas de control y funcionamiento de MC.
- Tipo de operación.
o Comprobar que los valores están dentro de los posibles: “E”, “S” o “D”, para
entrada, salida y desconocido, respectivamente.
- Un identificador del vehículo (su matrícula).
o Que el formato de la matrícula es válido: no se aceptarán matrículas de menos de
5 ni más de 12 caracteres, ni con caracteres especiales o espacios en blanco.
- Un identificador para las cámaras del parking (solo se comprueba su existencia, pues es algo
propio de cada parking).
- Fotografía 1 (contexto).
o Comprobar que el parámetro contiene una imagen.
o Comprobar que el formato es válido.
o Comprobar que el tamaño de la imagen está en los límites establecidos (< 50 Kb)
- Fotografía 2 (recorte de matrícula).
o Comprobar que el parámetro contiene una imagen.
o Comprobar que el formato es válido.
o Comprobar que el tamaño de la imagen está en los límites establecidos (< 50 Kb)
- El número de estructuras movimientos es de 1-n, siendo el número de movimientos cómo
máximo: 50
MADRID CENTRAL 41
2.3.4. Ejemplo de los parámetros de entrada
</so<?xmlversion="1.0" encoding="utf-8"?>
<soap:Envelope xmlns:soap="http://www.w3.org/2003/05/soap-envelope"
xmlns:tram="http://tramitesMC.madmovilidad.es/">
<soap:Header>
<wsse:Security soap:mustUnderstand="0" xmlns:wsse="http://docs.oasis-
open.org/wss/2004/01/oasis-200401-wss-wssecurity-secext-1.0.xsd">
<wsse:UsernameToken>
<wsse:Username>TEVA</wsse:Username>
<wsse:Password Type="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-username-
token-profile-1.0#PasswordText">teva</wsse:Password>
</wsse:UsernameToken>
</wsse:Security>
</soap:Header>
<soap:Body>
<tram:PutMovimientoParking>
<tram:idparking>1</tram:idparking>
<!--1 or more repetitions:-->
<tram:movimientos>
<tram:parametrosdemovimiento>
<tram:idTransaccion>0014444LLL20180706141800</tram:idTransaccion>
<tram:action>E</tram:action>
<tram:plate>4444LLL</tram:plate>
<tram:moment>20180706141800</tram:moment>
<tram:idcamara>1</tram:idcamara>
<tram:photo1>cid:961885450459</tram:photo1>
<tram:photo2>cid:1467772132682</tram:photo2>
</tram:parametrosdemovimiento>
</tram:movimientos>
</tram:PutMovimientoParking>
</soap:Body>
</soap:Envelope>ap12:Envelope>
MADRID CENTRAL 42
2.3.5. Descripción y formato de los parámetros de salida del servicio
La respuesta del WS será un array con tantos movimientos como envió el parking en el
momento de invocarlo.
Campo Descripción Tipo de dato Obligatoriedad Cardinalidad Posibles valores
Estructura responseMovimientoParking - La cardinalidad de esta estructura es: 1-50
Code Código de
respuesta
Integer Sí
Véase la tabla Códigos
de respuesta en este
documento.
message Mensaje de
respuesta
String Sí 1 Véase la tabla Códigos
de respuesta en este
documento.
FechaRespuesta Momento en el
que el
movimiento ha
sido procesado
DateTime
Sí 1
idTransaccion Identificador
de la
transacción
enviado por el
parking en la
llamada al
servicio
String Sí 1
platetype Tipo de
matrícula
Integer Sí 1 (0, «Desconocido» | 1,
«Nacional» | 2,
«Extranjera/Especial»)
MADRID CENTRAL 43
2.3.6. Ejemplo de los parámetros de salida
<?xmlversion="1.0" encoding="utf-8"?>
<soap:Envelope xmlns:soap="http://www.w3.org/2003/05/soap-envelope">
<soap:Body>
<PutMovimientoParkingResponse xmlns="http://tramitesMC.madmovilidad.es/">
<PutMovimientoParkingResult>
<responseMovimientoParking>
<responsemovimientom>
<code>0</code>
<message>Movimiento registrado correctamente. Correcto.</message>
<FechaRespuesta>2018-08-13T21:42:47.739+02:00</FechaRespuesta>
<idTransaccion>0014444LLL20180706141800</idTransaccion>
<platetype>1</platetype>
</responsemovimientom>
</responseMovimientoParking>
</PutMovimientoParkingResult>
</PutMovimientoParkingResponse>
</soap:Body>
</soap:Envelope>
MADRID CENTRAL 44
2.4. CÓDIGOS DE RESPUESTA
Código Mensaje Descripción
0 Correcto. Movimiento registrado correctamente.
1 Identificador de parking no válido. El identificador del parking no existe o no es válido para
el/la usuario/a.
2 Matrícula no válida. Debe comprobar que no haya espacios ni caracteres
especiales y que tenga un mínimo de 5 y un máximo de
12 caracteres.
3 Fecha incorrecta. Formato de fecha no válido.
4 Comunicación fuera de plazo. Se ha superado el plazo marcado en las normas de
control y funcionamiento de MC para la transmisión de
movimientos.
5 Fecha u hora posteriores a la actual. Revise el momento de la captación del movimiento.
6 Tipo de movimiento no válido. Revise el campo acción.
7 Formato de imagen no válido Revise el formato de la imagen.
8 Tamaño de imagen no válido Revise el tamaño de la imagen.
9 Identificador único de movimiento no válido. Revise el formato del identificador de la transacción.
10 Registro ya existente. El identificador de la transacción ya está registrado en
el sistema.
11 Número máximo de movimientos excedido. Se ha superado el número máximo de movimientos que
se pueden enviar por llamada.
12 Envío no autorizado. No está autorizado a transferir las matrículas a través
de Web Service. Póngase en contacto con soporte-MC si
quiere cambiar su método de entrada de datos.
17 Usuario y/o contraseña erróneos
MADRID CENTRAL 45
2.5. DEFINICIÓN DEL WSDL
WSDL: <wsdl:definitions xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:wsdl="http://schemas.xmlsoap.org/wsdl/"
xmlns:tns="MovimientosParking" xmlns:soap12="http://schemas.xmlsoap.org/wsdl/soap12/" xmlns:ns2="http://schemas.xmlsoap.org/soap/http" xmlns:ns1="http://tramitesMC.madmovilidad.es/" name="MovimientosParking" targetNamespace="MovimientosParking"> <wsdl:import location="http://192.168.243.19:8080/WSSERV/services/MovimientosParking?wsdl=MovimientosParkingSoap.wsdl" namespace="http://tramitesMC.madmovilidad.es/"> </wsdl:import> <wsdl:binding name="MovimientosParkingSoapBinding" type="ns1:MovimientosParkingSoap"> <soap12:binding style="document" transport="http://schemas.xmlsoap.org/soap/http"/> <wsdl:operation name="PutMovimientoParking"> <soap12:operation soapAction="http://tramitesMC.madmovilidad.es/PutMovimientoParking" style="document"/> <wsdl:input name="PutMovimientoParking"> <soap12:body use="literal"/> </wsdl:input> <wsdl:output name="PutMovimientoParkingResponse"> <soap12:body use="literal"/> </wsdl:output> </wsdl:operation> </wsdl:binding> <wsdl:service name="MovimientosParking"> <wsdl:port binding="tns:MovimientosParkingSoapBinding" name="MovimientosParkingImpl"> <soap12:address location="http://192.168.243.19:8080/WSSERV/services/MovimientosParking"/> </wsdl:port> </wsdl:service> </wsdl:definitions>
Definiciones: <wsdl:definitions xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:wsdl="http://schemas.xmlsoap.org/wsdl/" xmlns:ns1="http://tramitesMC.madmovilidad.es/" name="MovimientosParkingSoap" targetNamespace="http://tramitesMC.madmovilidad.es/"> <wsdl:types> <xs:schema xmlns:xs="http://www.w3.org/2001/XMLSchema" xmlns:tns="http://tramitesMC.madmovilidad.es/" elementFormDefault="qualified" targetNamespace="http://tramitesMC.madmovilidad.es/" version="1.0"> <xs:element name="PutMovimientoParking"> <xs:complexType> <xs:sequence> <xs:element name="idparking" type="xs:int"/> <xs:element maxOccurs="unbounded" name="movimientos" type="tns:param"/> </xs:sequence> </xs:complexType> </xs:element> <xs:element name="PutMovimientoParkingResponse"> <xs:complexType>
MADRID CENTRAL 46
<xs:sequence> <xs:element name="PutMovimientoParkingResult" type="tns:ArrayOfResponseMovimientoParking"/> </xs:sequence> </xs:complexType> </xs:element> <xs:complexType name="param"> <xs:sequence> <xs:element name="parametrosdemovimiento" type="tns:paramMovimientoP"/> </xs:sequence> </xs:complexType> <xs:complexType name="paramMovimientoP"> <xs:sequence> <xs:element name="idTransaccion" type="xs:string"/> <xs:element name="action" type="xs:string"/> <xs:element name="plate" type="xs:string"/> <xs:element name="moment" type="xs:string"/> <xs:element name="idcamara" type="xs:int"/> <xs:element name="photo1" type="xs:base64Binary"/> <xs:element name="photo2" type="xs:base64Binary"/> </xs:sequence> </xs:complexType> <xs:complexType name="ArrayOfResponseMovimientoParking"> <xs:sequence> <xs:element maxOccurs="unbounded" name="responseMovimientoParking" type="tns:responseMovimientoParking"/> </xs:sequence> </xs:complexType> <xs:complexType name="responseMovimientoParking"> <xs:sequence> <xs:element name="responsemovimientom" type="tns:response"/> </xs:sequence> </xs:complexType> <xs:complexType name="response"> <xs:sequence> <xs:element name="code" type="xs:int"/> <xs:element name="message" type="xs:string"/> <xs:element name="FechaRespuesta" type="xs:dateTime"/> <xs:element name="idTransaccion" type="xs:string"/> <xs:element name="platetype" type="xs:int"/> </xs:sequence> </xs:complexType> </xs:schema> </wsdl:types> <wsdl:message name="PutMovimientoParkingResponse"> <wsdl:part element="ns1:PutMovimientoParkingResponse" name="parameters"> </wsdl:part> </wsdl:message> <wsdl:message name="PutMovimientoParking"> <wsdl:part element="ns1:PutMovimientoParking" name="parameters"> </wsdl:part> </wsdl:message> <wsdl:portType name="MovimientosParkingSoap"> <wsdl:operation name="PutMovimientoParking"> <wsdl:input message="ns1:PutMovimientoParking" name="PutMovimientoParking"> </wsdl:input>
MADRID CENTRAL 47
<wsdl:output message="ns1:PutMovimientoParkingResponse" name="PutMovimientoParkingResponse"> </wsdl:output> </wsdl:operation> </wsdl:portType> </wsdl:definitions>
MADRID CENTRAL 48
3. MC - ROTACIÓN - INTEGRACIÓN
PARKINGS MEDIANTE FICHERO
MC_INT_Fichero
MADRID CENTRAL 49
3.1. OBJETIVO
El objetivo de este apartado 3 es describir el fichero usado para comunicar las matrículas de los vehículos que acceden a plazas de rotación de los parkings dentro de MC a la aplicación “Sistema de gestión de accesos dentro de Madrid Central de vehículos a parkings”. Este fichero se utiliza cuando el parking no tiene instalado un sistema de captación automático de matrículas, o como procedimiento de contingencia cuando sí lo tiene.
3.2. DEFINICIÓN DEL FICHERO
Este apartado define cómo debe ser el fichero.
3.2.1 Campos del fichero El fichero tiene los siguientes campos:
Nombre Descripción Formato
1 MATRÍCULA Matrícula String
2 FECHA_MOVIMIENTO Fecha del movimiento yyyymmdd
3 HORA_MOVIMIENTO Hora del movimiento (por defecto 000000) hhmmss
Las validaciones que realizará el sistema serán las siguientes:
• Matrícula: solamente se aceptan matrículas con una longitud entre 5 y 12 caracteres y
sin caracteres especiales (guiones, espacios, etcétera). • Fecha de movimiento: se valida el formato de fecha. • Hora de movimiento: se valida el formato de hora. • Los campos van separados por el carácter punto y coma «;» • La codificación del fichero es UTF-8 sin BOM. • Se podrán insertar ficheros que contengan hasta 1 000 matrículas, una en cada línea.
Cuando un fichero exceda dicho número saldrá un mensaje indicando que el fichero no se ha podido cargar por ese motivo.
3.2.2 Ejemplo de fichero
Se muestra un ejemplo del contenido del fichero a enviar para dos coches:
• Coche 1: matrícula 1123DNW; accede al parking el día ocho de enero de 2018 a las 12:30 horas.
MADRID CENTRAL 50
• Coche 2: matrícula M6579GL; abandona el parking el día cinco de enero de 2018 a las 20:41:35 horas.
El contenido del fichero sería el siguiente:
11123DNW;20180108;123000 M6579GL;20180105;204135
3.3. CÓDIGOS DE RESPUESTA DE LA CARGA DE FICHEROS
3.4. CÓDIGOS DE RESPUESTA DE LOS DATOS DE FICHEROS
Código Mensaje Descripción
1 Correcto. Operación registrada correctamente.
2 Fichero con más de 1 000 matrículas.
Se ha excedido el número máximo de matrículas permitidas por fichero.
3 Fichero sin matrículas. El fichero facilitado está vacío.
4 Formato de fichero incorrecto El fichero facilitado no tiene la estructura esperada
Código Mensaje Descripción
11 Correcto. Operación registrada correctamente.
12 Fecha incorrecta. El formato de fecha no es válido.
13 Registro ya existente.
Se repite el registro de la transacción (registro duplicado
en la carga)
14 Matrícula no válida. Debe comprobar que no haya espacios ni caracteres
especiales y que tenga un mínimo de 5 y un máximo de
12 caracteres.
15 Comunicación fuera de plazo.
Se ha superado el plazo marcado en las normas de
control y funcionamiento de MC para la transmisión de
movimientos.
16 Fecha u hora posteriores a la actual.
Revise el momento de la captación del movimiento.
17 Registrado con anterioridad
El movimiento ya está registrado con anterioridad en el
sistema (registro ya existente en BBDD)
MADRID CENTRAL 51
4. MC - ABONADOS - INTEGRACIÓN
PARKINGS MEDIANTE FICHERO
MC_INT_Fichero_Abonados
MADRID CENTRAL 52
4.1. OBJETIVO
El objetivo de este documento es describir el fichero usado para comunicar las matrículas de los vehículos de abonados que acceden a los parkings dentro de Madrid Central a la aplicación “Sistema de gestión de accesos dentro de Madrid Central de vehículos a parkings”.
4.2. DEFINICIÓN DEL FICHERO
Este apartado define cómo debe ser el fichero.
4.2.1 Campos del fichero
El fichero tiene los siguientes campos:
Nombre Descripción Formato
1 MATRÍCULA Matrícula String
Las validaciones que realizará el sistema serán las siguientes: • Matrícula: solamente se aceptan matrículas con una longitud entre 5 y 12 caracteres y
sin caracteres especiales (guiones, espacios, etcétera). • El contenido del fichero se validará comprobando que se incluye exclusivamente una
cadena de caracteres con el formato matrícula por línea. En cualquier otro caso
devolverá un mensaje de formato incorrecto.
• La codificación del fichero es UTF-8 sin BOM.
• Se podrán insertar ficheros que contengan hasta 1000 matrículas, una en cada línea.
Cuando un fichero exceda dicho número saldrá un mensaje indicando que el fichero no
se ha podido cargar por ese motivo.
• No se podrá insertar ficheros que generen un exceso en la cuota de abonados.
4.2.2. Ejemplo de fichero
A continuación se muestra un ejemplo del contenido del fichero a enviar para dos coches:
• Coche 1: matrícula 1123DNW; registrado como abonado en el parking.
MADRID CENTRAL 53
• Coche 2: matrícula M6579GL; registrado como abonado en el parking.
El contenido del fichero sería el siguiente:
11123DNW M6579GL
4.3. CÓDIGOS DE RESPUESTA DE LA CARGA DE FICHEROS
4.4 CÓDIGOS DE RESPUESTA DE LOS DATOS DEL FICHERO
Código Mensaje Descripción
1 Correcto. Operación registrada correctamente.
2 Fichero con más de 1 000 matrículas.
Se ha excedido el número máximo de matrículas permitidas por fichero.
3 Fichero sin matrículas. El fichero facilitado está vacío.
4 Formato de fichero incorrecto El fichero facilitado no tiene la estructura esperada
5 Cuota de abonados excedida El fichero no puede cargarse ya que su inserción provocaría un exceso de cuota. Revise su cuota y sus abonados activos.
Código Mensaje Descripción
11 Correcto. Operación registrada correctamente.
13 Registro ya existente.
Se repite el registro de la transacción.
14 Matrícula no válida. Debe comprobar que no haya espacios ni caracteres
especiales y que tenga un mínimo de 5 y un máximo de
12 caracteres.