STT: API externa pública de STT

[jsastre-dgtic]

Amb la finalitat d'obrir i explotar informació de tramitació electrònica per obtenir, en general, indicadors d'evolució de els eines d'AE. Les dades a explotar podrien ser:

• Forma d'accés al tràmit (mètode d'autenticació, data, gènere (home/dona/no binari), resultat de l'autenticació (ok, error)...)
• Accessos a procediments/serveis administratius via telemàtica (codiSia/CodTramit, nom del procediment/servei, data, òrgan, materia (si fos possible)...)
• Documentació associada a la tramitació (codiSia/CodTramit, tipus de document, obligatorietat, firmat (si/no), mida,...)
• Tramitació amb pagament electrònic (codiSia/CodTramit, data, passarel·la de pagament, import, pagament electrònic/presencial, resultat pagamanet (ok, error)...)
• Tramitació finalitzada/inacabada (codiSia/CodTramit, data, finalitzat (si/no), firma electrònica de documentació (s/n), sistema de firma (autofirma, clavefirma (quan esitgui), ...)
• Valoració usabilitat/satisfacció del tràmit (codiSia/CodTramit, data, valoració (estrelles), comentari,...)

Com veis les dades han de ser no agrupades, anonimitzades i consultables via API externa pública a internet.

Molta de la informació es pot extreure d'auditoria, per tant, el més adequat és API-SISTRAHELP

[jparedes-indra]

Se realiza una primera versión que ha de probarse con Swagger. Se despliega en la versión 1.2.0 (64208c6) en CAIBter.

[jsastre-dgtic]

No veim moltes de les coses demanades al mètode "POST /externa/v1/evento" o "POST /externa/v1/ticketAcceso" del swagger: gènere, codi sia, nom PA/Tràmit (rolsac), firmat, mida, rang de dates, valoracions...

Consideram bàsica la informació de: CodiSIA, NomProcediment + NomTramit, CodiDir3 de la unitat destí de tramitació.

Cal estudiar el que ens torna cl@ve i com ens torna la informació del node eIDAS

VALPROB pareix mal informat, perquè posant una opció en surten dues. En tot cas, cal documentar el significat de cada cosa què representa i els tipus d'esdeveniments que tenim

[jparedes-indra]

Lo analizaremos y veremos qué información se requiere de STG (api externa STG).

Necesitaríamos conocer la definición de los indicadores y estadísticas que se quieren sacar.

[fjcalderon-dgtic]

Os expongo los campos (mínimos) que deberíamos disponer a través de esta API, junto con un valor booleano asociado si ya podemos recuperarlo a través de alguno de los métodos disponibles en esta primera versión, según las pruebas que hemos efectuado en la DGMAD. No entraré en el origen de donde extraer esta información. Eso sí, el siguiente listado también lo añadiré a la pertinente issue (#269), para que quede también constancia en GITHUB.

• Código SIA procedimiento. SÍ
• Código procedimiento (ROLSAC). SÍ
• Nombre del procedimiento. NO
• Código DIR3 de la unidad administrativa. NO
• Nombre de la unidad administrativa. NO
• Código trámite (ROLSAC). SÍ
• Tipo trámite (entiendo que diferencia entre "inicio" e "instrucción"). SÍ
• Versión trámite. SÍ
• ID sesión trámite (entiendo que hablamos de un identificador único, asociado a cada solicitud iniciada en SISTRA2). SÍ
• Nombre trámite. NO
• Fecha trámite (entiendo que hablamos de la fecha en la que se inicia una solicitud concreta): SÍ
• Valoración trámite (estrellas concedidas): SÍ
• Problemas detectados (asociados a un número bajo de estrellas). SÍ
• Comentario adicional (entiendo que asociado a la valoración). SÍ
• Fecha de registro (finalización de la solicitud). NO
• Número de registro asociado. SÍ.
• Dato sesión SO (Sistema Operativo). SÍ
• Dato sesión VSO (Versión Sistema Operativo). SÍ
• Dato sesión NA (Navegador web). SÍ
• Dato sesión VNA (Versión Navegador Web). SÍ
• Método Autenticación utilizado. SÍ
• Género persona que realiza la solicitud (hombre/mujer/no binario). NO
• Pasarela de pago utilizada. SÍ
• Importe del pago. SÍ
• Tipo de pago (electrónico/presencial). NO
• Fecha del pago. NO

Esta información básica es la que tenemos ahora mismo en AUDITA, sin contar con los añadidos del campo género o de las valoraciones mediante estrellas, que es algo nuevo y exclusivo de SISTRA2, y sin tener presente datos sobre el módulo de zona personal, que en esta ocasión ha sido reemplazado por nuestra CARPETA ciudadana. Mirad de analizar todo estos campos que he expuesto y confirmad si actualmente se pueden obtener o no desde los métodos de esta API externa.

Como añadido, no estaría de más, en el caso de que fuera posible, registrar también (a fines estadísticos) posibles errores en las operaciones de registro o de pago electrónico. Tampoco estaría de más, si igualmente fuera posible, incluir información sobre el número, tipo y tamaño de ficheros anexos vinculados a cada trámite. Dejo para el futuro el estudio de más campos de ROLSAC que puedan tener alguna relevancia estadística.

[dmadronal-indra]

Enviado documento de estimación. Quedamos a la espera de que nos indiqueis si podemos continuar.

[jsastre-dgtic]

Tenim vist i plau del DG i l'adjudicació preparada per la instal·lació d'una eina d'ETL+Repositori DataLake+Api Manager que simplificarà els requeriments de les APIs externes. Si no hi ha res de nou, el contracte començarà dins el gener de 2022. De moment i fins que coneguem l'abast de la nova eina crec que no val la pena invertir en adaptacions sobre l'API externa de S2 amb mètodes d'aplanament o processos d'ETL per transformació de la informació des de S2. Deixarem aquesta tasca en Stand-by.