1.- Introducción a TTO para integradores

Owned by Servicios Digitales de Aragón
Last updated: 17 Jul 2024
5 min read


1.- ¿Qué es TTO?

El Tramitador Online (TTO) es una aplicación que permite a los ciudadanos la presentación telemática de solicitudes normalizadas utilizando firma electrónica y Registro Telemático. Es decir, el ciudadano no tendrá que desplazarse a la administración para realizar un trámite, sino que podrá realizarlo online. La herramienta garantiza al ciudadano que su trámite va a ser procesado al igual que si lo hubiera hecho de manera presencial en la ventanilla de cualquiera de las administraciones.


1.2.- ¿Qué funcionalidades ofrece TTO mediante sus servicios?

Mediante los servicios web que publica el core se podrán realizar las siguentes consultas sobre solicitudes:

  • Listado de solicitudes en forma en formato JSON y en formato XML

  • Obtención de datos de una solicitud en formato JSON y en formato XML.

Además, TTO utiliza el Sistema gestor de avisos y eventos para avisar a aplicaciones integradoras de la creación de solicitudes, con lo que también podemos añadir dicha funcionalidad:

  • Recepción de avisos de creación de solicitudes mediante eventos TTO por medio de la aplicación de Sistema gestor de avisos y eventos.


3.- ¿Cómo funciona TTO?

3.1.- Módulos de TTO

TTO esta formado por los siguientes módulos que hacen posible la gestión de los trámites y solicitudes:

  • Servicios / Core del Tramitador (tto_core): Servicios web REST publicados para permitir a las aplicaciones externas al sistema hacer uso de la funcionalidad proporcionada por el mismo.

  • Front (tto_front): Aplicación con interfaz web que permite al ciudadano la presentación de solicitudes de forma telemática.

  • MockCat (tto_mock): Aplicación Java de uso interno que permite gestionar los trámites accesibles por TTO.

  • Backoffice (tto_bo): Aplicación con interfaz web para que la parte gestora pueda dar de alta y editar los trámites que se puedan realizar mediante TTO.

El siguiente diagrama muestra la interacción del core (módulo que afecta al integrador) con diversos servicios paega que utiliza para la creación, edición y gestión de las solicitudes realizadas por los usuarios:


3.2.- Cómo Integrarse con TTO

A continuación se muestra un diagrama de cómo una aplicación integradora se relaciona con TTO. El flujo descrito es para consultar la información de una solicitud completamente finalizada por un usuario.


Como puede verse en el diagrama, para la integración con TTO es necesario realizarla mediante una tercera aplicación SGA-Eventos que se encarga de avisar a la aplicación integradora cuando una solicitud se ha finalizado. Se puede consultar una información más detallada de esta aplicación en el apartado 1.-Introducción a SGA para integradores

Actualmente, se están emitiendo los siguientes eventos que incluyen los correspondientes datos:

  • finishedProcedure, para solicitudes
    • number → número de la solicitud
    • requestCode → código de la solicitud
    • signature → signatura del procedimiento al que corresponde la solicitud finalizada
  • finishedProcedureWithOrigin, para trámites que no sean solicitudes. A diferencia del anterior, en este método se envía el campo origin para diferenciar el tipo del trámite (aportación, subsanación, etc.).
    • number → número del trámite
    • requestCode → código del trámite
    • signature → signatura del procedimiento al que corresponde el trámite finalizado
    • origin → origen del trámite
  • registerProcedure , para trámites registrados independientemente de su origen

    • requestCode → código del trámite

    • requestCodeAssociated → código del trámite asociado (por ejemplo el trámite involucrado en una subsanación)

    • signature → signatura del procedimiento al que corresponde el trámite registrado

    • requestSignature → signatura a la que se metadata el trámite registrado

    • origin → origen del trámite (SOLICITUD, APORTACION, RECURSO, SUBSANACION)

    • registerId → identificador del justificante de registro

    • csvRequest → código CSV del trámite

    • csvRegisterReceipt → código CSV del justificante de registro

  • addInfoProcedure , para la actualización de la información de un trámite finalizado independientemente de su origen

    • requestCode → código del trámite

    • requestCodeAssociated → código del trámite asociado (por ejemplo el trámite involucrado en una subsanación)

    • signature → signatura del procedimiento al que corresponde el trámite registrado

    • requestSignature → signatura a la que se metadata el trámite registrado

    • origin → origen del trámite (SOLICITUD, APORTACION, RECURSO, SUBSANACION)

    • registerId → identificador del justificante de registro

    • csvRequest → código CSV del trámite

    • csvRegisterReceipt → código CSV del justificante de registro

    • bentId → identificador de BENT



Librería cliente

Para facilitar la integración de las aplicaciones con los servicios de TTO se ha generado un cliente que contiene las clases necesarias para consumir los servicios y realizar la transformación del XML en el caso en el que se consulte este formato. Para realizar esta transformación se recomienda el uso de la clase TransformXMLToObject y concretamente el método parseTramiteBeanFromFile. Este método tiene como datos de entrada un objeto InputStream con el XML obtenido del servicio getXml y proporciona como salida un objeto ResultTramiteBean. 

Para el uso de este cliente serán necesario:

  • Versión de Java:
    • Mínima → 1.5
    • Recomendada → 1.8

y las siguientes librerías externas

  • slf4j-api.jar (versión 1.7.25): el log del cliente esta implementado con esta librería.
  • gson.jar (version 2.2.4): liberia para distinguir entre diferentes nombres de los objetos y parámetros. Se recomienda su uso para construir los objetos devueltos por los servicios



4.-  Conceptos básicos

A lo largo de las diversas secciones de TTO, se van a mencionar diversos conceptos que se aclaran a continuación para una mejor comprensión de los servicios. 

Trámite

Procedimiento administrativo a efectos de presentación el cual tiene una normativa propia, unos plazos de presentación, características, formulario, documentación asociada, etc propios.

Solicitud

Documento cumplimentado por un usuario que va dirigido a un organismo público o a una autoridad a los que se pide algo.
En el caso de TTO, además de un documento nos referiremos a ella también como el conjunto de información que ha sido cumplimentada por el usuario. En TTO se almacena esta información tanto de solicitudes finalizadas como de aquellas que no lo están. Se consideran solicitudes finalizadas aquellas que estén completamente rellenadas, firmadas y registradas.

Autorizaciones

Existen trámites en los que se precisan ciertos datos, tales como datos de identidad del solicitante o representante, el nivel de renta o el estado de alta en la Seguridad Social. Dichos datos pueden ser adjuntados por el usuario en el proceso de presentación del formulario o pueden ser consultados a los organismos pertinentes. Para que estos organismos puedan conceder los datos necesarios el usuario deberá indicar que autoriza a los gestores de los trámites la consulta de dichos datos.

Representación

La representación en sentido general, es un fenómeno jurídico que implica la actuación de una persona a nombre de otra. En el Tramitador Online, el caso de representación se da en la realización de un trámite por parte de una persona física o jurídica (solicitante) en nombre de otra (beneficiario).