protocolo de actuacion parkings sept 18šltima...2019/01/03  · • fichero: ubicación del fichero...

53
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

Upload: others

Post on 06-Aug-2020

0 views

Category:

Documents


0 download

TRANSCRIPT

Page 1: Protocolo de actuacion parkings sept 18šltima...2019/01/03  · • Fichero: ubicación del fichero en el ordenador del/de la usuario/a (obligatorio). El/la usuario/a podrá utilizar

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

Page 2: Protocolo de actuacion parkings sept 18šltima...2019/01/03  · • Fichero: ubicación del fichero en el ordenador del/de la usuario/a (obligatorio). El/la usuario/a podrá utilizar

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

Page 3: Protocolo de actuacion parkings sept 18šltima...2019/01/03  · • Fichero: ubicación del fichero en el ordenador del/de la usuario/a (obligatorio). El/la usuario/a podrá utilizar

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

Page 4: Protocolo de actuacion parkings sept 18šltima...2019/01/03  · • Fichero: ubicación del fichero en el ordenador del/de la usuario/a (obligatorio). El/la usuario/a podrá utilizar

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

Page 5: Protocolo de actuacion parkings sept 18šltima...2019/01/03  · • Fichero: ubicación del fichero en el ordenador del/de la usuario/a (obligatorio). El/la usuario/a podrá utilizar

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

Page 6: Protocolo de actuacion parkings sept 18šltima...2019/01/03  · • Fichero: ubicación del fichero en el ordenador del/de la usuario/a (obligatorio). El/la usuario/a podrá utilizar

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]

Page 7: Protocolo de actuacion parkings sept 18šltima...2019/01/03  · • Fichero: ubicación del fichero en el ordenador del/de la usuario/a (obligatorio). El/la usuario/a podrá utilizar

MADRID CENTRAL 7

1. MC - MANUAL DE USUARIO/A

“Sistema de gestión de

accesos dentro de Madrid

Central a vehículos a

parkings”

Page 8: Protocolo de actuacion parkings sept 18šltima...2019/01/03  · • Fichero: ubicación del fichero en el ordenador del/de la usuario/a (obligatorio). El/la usuario/a podrá utilizar

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.

Page 9: Protocolo de actuacion parkings sept 18šltima...2019/01/03  · • Fichero: ubicación del fichero en el ordenador del/de la usuario/a (obligatorio). El/la usuario/a podrá utilizar

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.

Page 10: Protocolo de actuacion parkings sept 18šltima...2019/01/03  · • Fichero: ubicación del fichero en el ordenador del/de la usuario/a (obligatorio). El/la usuario/a podrá utilizar

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.

Page 11: Protocolo de actuacion parkings sept 18šltima...2019/01/03  · • Fichero: ubicación del fichero en el ordenador del/de la usuario/a (obligatorio). El/la usuario/a podrá utilizar

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.

Page 12: Protocolo de actuacion parkings sept 18šltima...2019/01/03  · • Fichero: ubicación del fichero en el ordenador del/de la usuario/a (obligatorio). El/la usuario/a podrá utilizar

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.

Page 13: Protocolo de actuacion parkings sept 18šltima...2019/01/03  · • Fichero: ubicación del fichero en el ordenador del/de la usuario/a (obligatorio). El/la usuario/a podrá utilizar

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.

Page 14: Protocolo de actuacion parkings sept 18šltima...2019/01/03  · • Fichero: ubicación del fichero en el ordenador del/de la usuario/a (obligatorio). El/la usuario/a podrá utilizar

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.

Page 15: Protocolo de actuacion parkings sept 18šltima...2019/01/03  · • Fichero: ubicación del fichero en el ordenador del/de la usuario/a (obligatorio). El/la usuario/a podrá utilizar

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.

Page 16: Protocolo de actuacion parkings sept 18šltima...2019/01/03  · • Fichero: ubicación del fichero en el ordenador del/de la usuario/a (obligatorio). El/la usuario/a podrá utilizar

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.

Page 17: Protocolo de actuacion parkings sept 18šltima...2019/01/03  · • Fichero: ubicación del fichero en el ordenador del/de la usuario/a (obligatorio). El/la usuario/a podrá utilizar

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.

Page 18: Protocolo de actuacion parkings sept 18šltima...2019/01/03  · • Fichero: ubicación del fichero en el ordenador del/de la usuario/a (obligatorio). El/la usuario/a podrá utilizar

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.

Page 19: Protocolo de actuacion parkings sept 18šltima...2019/01/03  · • Fichero: ubicación del fichero en el ordenador del/de la usuario/a (obligatorio). El/la usuario/a podrá utilizar

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).

Page 20: Protocolo de actuacion parkings sept 18šltima...2019/01/03  · • Fichero: ubicación del fichero en el ordenador del/de la usuario/a (obligatorio). El/la usuario/a podrá utilizar

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)

Page 21: Protocolo de actuacion parkings sept 18šltima...2019/01/03  · • Fichero: ubicación del fichero en el ordenador del/de la usuario/a (obligatorio). El/la usuario/a podrá utilizar

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)

Page 22: Protocolo de actuacion parkings sept 18šltima...2019/01/03  · • Fichero: ubicación del fichero en el ordenador del/de la usuario/a (obligatorio). El/la usuario/a podrá utilizar

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.

Page 23: Protocolo de actuacion parkings sept 18šltima...2019/01/03  · • Fichero: ubicación del fichero en el ordenador del/de la usuario/a (obligatorio). El/la usuario/a podrá utilizar

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.

Page 24: Protocolo de actuacion parkings sept 18šltima...2019/01/03  · • Fichero: ubicación del fichero en el ordenador del/de la usuario/a (obligatorio). El/la usuario/a podrá utilizar

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.

Page 25: Protocolo de actuacion parkings sept 18šltima...2019/01/03  · • Fichero: ubicación del fichero en el ordenador del/de la usuario/a (obligatorio). El/la usuario/a podrá utilizar

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.

Page 26: Protocolo de actuacion parkings sept 18šltima...2019/01/03  · • Fichero: ubicación del fichero en el ordenador del/de la usuario/a (obligatorio). El/la usuario/a podrá utilizar

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á

Page 27: Protocolo de actuacion parkings sept 18šltima...2019/01/03  · • Fichero: ubicación del fichero en el ordenador del/de la usuario/a (obligatorio). El/la usuario/a podrá utilizar

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”:

Page 28: Protocolo de actuacion parkings sept 18šltima...2019/01/03  · • Fichero: ubicación del fichero en el ordenador del/de la usuario/a (obligatorio). El/la usuario/a podrá utilizar

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:

Page 29: Protocolo de actuacion parkings sept 18šltima...2019/01/03  · • Fichero: ubicación del fichero en el ordenador del/de la usuario/a (obligatorio). El/la usuario/a podrá utilizar

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.

Page 30: Protocolo de actuacion parkings sept 18šltima...2019/01/03  · • Fichero: ubicación del fichero en el ordenador del/de la usuario/a (obligatorio). El/la usuario/a podrá utilizar

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.

Page 31: Protocolo de actuacion parkings sept 18šltima...2019/01/03  · • Fichero: ubicación del fichero en el ordenador del/de la usuario/a (obligatorio). El/la usuario/a podrá utilizar

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:

Page 32: Protocolo de actuacion parkings sept 18šltima...2019/01/03  · • Fichero: ubicación del fichero en el ordenador del/de la usuario/a (obligatorio). El/la usuario/a podrá utilizar

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.

Page 33: Protocolo de actuacion parkings sept 18šltima...2019/01/03  · • Fichero: ubicación del fichero en el ordenador del/de la usuario/a (obligatorio). El/la usuario/a podrá utilizar

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.

Page 34: Protocolo de actuacion parkings sept 18šltima...2019/01/03  · • Fichero: ubicación del fichero en el ordenador del/de la usuario/a (obligatorio). El/la usuario/a podrá utilizar

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

Page 35: Protocolo de actuacion parkings sept 18šltima...2019/01/03  · • Fichero: ubicación del fichero en el ordenador del/de la usuario/a (obligatorio). El/la usuario/a podrá utilizar

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.

Page 36: Protocolo de actuacion parkings sept 18šltima...2019/01/03  · • Fichero: ubicación del fichero en el ordenador del/de la usuario/a (obligatorio). El/la usuario/a podrá utilizar

MADRID CENTRAL 36

2. MC - ROTACIÓN - INTEGRACIÓN

PARKINGS MEDIANTE SERVICIO

WEB

Interfaz de servicio:

MovimientosParking

MC_INT_WS

Page 37: Protocolo de actuacion parkings sept 18šltima...2019/01/03  · • Fichero: ubicación del fichero en el ordenador del/de la usuario/a (obligatorio). El/la usuario/a podrá utilizar

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.

Page 38: Protocolo de actuacion parkings sept 18šltima...2019/01/03  · • Fichero: ubicación del fichero en el ordenador del/de la usuario/a (obligatorio). El/la usuario/a podrá utilizar

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

Page 39: Protocolo de actuacion parkings sept 18šltima...2019/01/03  · • Fichero: ubicación del fichero en el ordenador del/de la usuario/a (obligatorio). El/la usuario/a podrá utilizar

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.

Page 40: Protocolo de actuacion parkings sept 18šltima...2019/01/03  · • Fichero: ubicación del fichero en el ordenador del/de la usuario/a (obligatorio). El/la usuario/a podrá utilizar

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

Page 41: Protocolo de actuacion parkings sept 18šltima...2019/01/03  · • Fichero: ubicación del fichero en el ordenador del/de la usuario/a (obligatorio). El/la usuario/a podrá utilizar

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>

Page 42: Protocolo de actuacion parkings sept 18šltima...2019/01/03  · • Fichero: ubicación del fichero en el ordenador del/de la usuario/a (obligatorio). El/la usuario/a podrá utilizar

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»)

Page 43: Protocolo de actuacion parkings sept 18šltima...2019/01/03  · • Fichero: ubicación del fichero en el ordenador del/de la usuario/a (obligatorio). El/la usuario/a podrá utilizar

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>

Page 44: Protocolo de actuacion parkings sept 18šltima...2019/01/03  · • Fichero: ubicación del fichero en el ordenador del/de la usuario/a (obligatorio). El/la usuario/a podrá utilizar

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

Page 45: Protocolo de actuacion parkings sept 18šltima...2019/01/03  · • Fichero: ubicación del fichero en el ordenador del/de la usuario/a (obligatorio). El/la usuario/a podrá utilizar

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>

Page 46: Protocolo de actuacion parkings sept 18šltima...2019/01/03  · • Fichero: ubicación del fichero en el ordenador del/de la usuario/a (obligatorio). El/la usuario/a podrá utilizar

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>

Page 47: Protocolo de actuacion parkings sept 18šltima...2019/01/03  · • Fichero: ubicación del fichero en el ordenador del/de la usuario/a (obligatorio). El/la usuario/a podrá utilizar

MADRID CENTRAL 47

<wsdl:output message="ns1:PutMovimientoParkingResponse" name="PutMovimientoParkingResponse"> </wsdl:output> </wsdl:operation> </wsdl:portType> </wsdl:definitions>

Page 48: Protocolo de actuacion parkings sept 18šltima...2019/01/03  · • Fichero: ubicación del fichero en el ordenador del/de la usuario/a (obligatorio). El/la usuario/a podrá utilizar

MADRID CENTRAL 48

3. MC - ROTACIÓN - INTEGRACIÓN

PARKINGS MEDIANTE FICHERO

MC_INT_Fichero

Page 49: Protocolo de actuacion parkings sept 18šltima...2019/01/03  · • Fichero: ubicación del fichero en el ordenador del/de la usuario/a (obligatorio). El/la usuario/a podrá utilizar

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.

Page 50: Protocolo de actuacion parkings sept 18šltima...2019/01/03  · • Fichero: ubicación del fichero en el ordenador del/de la usuario/a (obligatorio). El/la usuario/a podrá utilizar

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)

Page 51: Protocolo de actuacion parkings sept 18šltima...2019/01/03  · • Fichero: ubicación del fichero en el ordenador del/de la usuario/a (obligatorio). El/la usuario/a podrá utilizar

MADRID CENTRAL 51

4. MC - ABONADOS - INTEGRACIÓN

PARKINGS MEDIANTE FICHERO

MC_INT_Fichero_Abonados

Page 52: Protocolo de actuacion parkings sept 18šltima...2019/01/03  · • Fichero: ubicación del fichero en el ordenador del/de la usuario/a (obligatorio). El/la usuario/a podrá utilizar

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.

Page 53: Protocolo de actuacion parkings sept 18šltima...2019/01/03  · • Fichero: ubicación del fichero en el ordenador del/de la usuario/a (obligatorio). El/la usuario/a podrá utilizar

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.