e. 05/07/2018 N° 48131/18 v. 05/07/2018
RESOLUCIÓN SECRETARA DE MODERNIZACIÓN ADMINISTRATIVA del
MINISTERIO MODERNIZACIÓN
SERVICIO DE CONSULTA AUTOMÁTICA DE NOTIFICACIONES MASVAS -
NOTIFICAR
ANEXO I
PROCEDIMIENTO DE ADHESIÓN AL SERVICIO DE CONSULTA AUTOMÁTICA DE
NOTIFICACIONES MASVAS EN LA PLATAFORMA TRÁMITES A DISTANCIA (TAD)
I.- Introducción
El presente documento tiene como objetivo definir el procedimiento de
adhesión al Servicio de Consulta Automática de Notificaciones Masivas,
en adelante Servicio NOTIFICAR, emitidas en la Plataforma de Trámites a
Distancia (TAD) del sistema de Gestión Documental Electrónica - GDE
hacia un determinado usuario TAD.
El presente servicio de consulta automática de notificaciones masivas
NOTIFICAR fue desarrollado para facilitar la dinámica de trabajo entre
usuarios TAD y la ADMINISTRACIÓN PÚBLICA NACIONAL, brindando celeridad
a los procedimientos administrativos involucrados.
II.- Alcance
El servicio de CONSULTA AUTOMÁTICA DE NOTIFICACIONES MASIVAS EN LA PLATAFORMA TRÁMITES A DISTANCIA (TAD) comprende:
a) La Consulta Automática de Notificaciones Masivas de un usuario TAD.
b) La Consulta de Documentos Oficiales vinculados a los Expedientes
Electrónicos correspondientes a las tramitaciones relacionadas con el
usuario TAD.
c) La posibilidad de realizar Presentaciones a agregar en dichos Expedientes Electrónicos.
En el presente Anexo se detalla el procedimiento de solicitud de
integración a los servicios externos y el tipo de autenticación
requerido para su invocación.
III.- Breve descripción de los servicios
El Servicio NOTIFICAR permite realizar al usuario TAD que ha adherido al mismo, las siguientes acciones:
a) Consulta de Notificaciones
Dado un grupo de trámites y un rango de fecha/hora, permite obtener el
listado de todas las notificaciones emitidas al usuario TAD invocador
entre las fechas dadas, sus documentos oficiales vinculados y el número
de expediente electrónico correspondiente.
b) Consulta de Documentos Oficiales
Permite obtener el contenido de los documentos oficiales que le fueron notificados al usuario TAD invocador.
c) Presentaciones a Agregar
Tomando como base la respuesta del primer servicio, el usuario TAD
invocador podrá realizar una presentación a agregar para dar respuesta
a cualquiera de sus notificaciones. Sólo basta con indicar el número de
expediente electrónico de la notificación y agregar el documento de
respuesta. De esta forma, el usuario TAD podrá vincular documentación
al expediente electrónico correspondiente, previa aprobación del
funcionario público asignado.
IV.- Glosario
A continuación se listan definiciones, abreviaturas y/o alias utilizados en el presente documento:
Archivo .json:
Archivo con formato json. Json es el acrónimo de JavaScript Object
Notation. Es un formato de texto ligero para el intercambio de datos.
Certifícate Signing Request (CSR): código que se genera en el servidor que se desea asegurar, el cual contiene información acerca del dominio a certificar.
Interfaces de programación de aplicaciones (APIs): permiten compartir información entre sistemas.
Json Web Token (JWT):
estándar que define un método compacto, autónomo y seguro para
transmitir información entre dos sistemas. Utiliza un objeto de tipo
json.
Representational State Transfer (REST):
tipo de arquitectura de desarrollo web que permite crear servicios y
aplicaciones respetando el protocolo HTTP (Hypertext Transfer Protocol).
Uniform Resource Locator (URL): Identificador único de recursos en internet.
Usuario TAD invocador: usuario TAD que adhirió al presente servicio de consulta automática de notificaciones masivas.
V.- Procedimiento de solicitud de integración a servicios externos
El usuario TAD o su apoderado, debe ingresar a la plataforma Trámites a
Distancia (www.tramitesadistancia.gob.ar) con CUIT y clave fiscal.
Luego, debe iniciar el trámite "Solicitud de integración a servicios
externos TAD" completando la siguiente documentación:
- Datos del sistema externo a integrar
- Archivo CSR
Esta información es requerida para asegurar la comunicación entre ambos
sistemas a conectar. Para autenticar al sistema externo invocador, es
necesario enviar sus datos de identificación a través del archivo CSR.
VI.- Generación de CSR
El usuario TAD solicitante o su apoderado, que ha iniciado el
procedimiento de solicitud de integración a servicios externos, deberá
generar un archivo de clave privada "privada.key" con 2048 bits de
cifrado y conservarlo por cuestiones de seguridad del sistema.
Luego, deberá generar el código CSR con los siguientes datos del sistema que hará uso de los servicios:
- "CN": Nombre del sistema.
- "SerialNumber": Debe tener como valor la palabra "CUIT y seguido de
un espacio, el número correspondiente al CUIT del dueño del sistema
(Ej.: CUIT XXYYYYYYYYX)
- "C": Corresponde al país, Argentina (AR).
- "O": Nombre del dueño del sistema correspondiente al CUIT anterior.
- "OU": Unidad organizativa. Nombre y domicilio del área que administrará el sistema.
VII.- Autenticación del sistema externo
Como respuesta al pedido de integración a los servicios, el usuario TAD
solicitante recibirá una clave única que lo identificará como usuario
TAD invocador del Servicio NOTIFICAR de la Plataforma de TRÁMITES A
DISTANCIA (TAD).
Con dicha información, el sistema externo podrá autenticarse a la hora
de invocar el servicio de consulta automática de notificaciones
masivas, consultando o respondiendo sólo a las notificaciones que le
pertenecen. El servicio NOTIFICAR valida que las notificaciones
correspondan al CUIT del usuario TAD invocador, permitiendo únicamente
el acceso a las notificaciones o documentos electrónicos de dicho
usuario TAD invocador.
VIII.- Generación de JWT
Una vez concluido el trámite de adhesión al Servicio NOTIFICAR, y en
cada oportunidad que el usuario TAD invocador utilice dicho Servicio
NOTIFICAR, debe generar previamente un JWT utilizando el algoritmo
RS256. Su contenido debe poseer los siguientes campos de datos:
- "iss": clave única brindada por el Ministerio de Modernización.
- "nbf": comienzo tiempo de expiración.
- "exp": fin tiempo de expiración
Para su creación se requiere de la clave privada, generada previamente para el CSR.
IX.- Invocación a servicios de notificaciones
Una vez que el usuario TAD ha sido autorizado a integrar su sistema al
Servicio NOTIFICAR, deberá realizar la siguiente configuración para
invocar correctamente y operar el Servicio.
A continuación se detallan las consideraciones generales respecto a las
tres APIs de tipo REST relacionados a notificaciones masivas.
i. Encabezado de autorización
Se debe incorporar el campo llamado "Authorization" en el header del
servicio a invocar. Su valor debe contener el JWT generado previamente,
con el cual se autentica el usuario.
ii. Servicios
a) Consulta de Notificaciones
El servicio de consulta de notificaciones retorna un listado de todas
las notificaciones y documentos externos del usuario invocador entre un
rango de fechas dadas.
Tipo: GET
Servicio: /notificacion/fechas/{idGrupoTramite}/{fecha Inicio}/{FechaFi n}
b) Consulta de Documentos Oficiales
Tomando como base la respuesta del servicio anterior se podrá consultar
el contenido de los documentos oficiales a través de este servicio.
Tipo: GET
Servicio: /numero/{numeroSadeDocGedo}
c) Presentación a agregar
Tomando como base la respuesta del primer servicio, se podrá realizar
una presentación a agregar sobre el expediente electrónico de una de
las notificaciones del usuario invocador.
Tipo: POST
Servicio: /tramite/agregarPresentacion
iii. Tipo de respuesta
Todas las respuestas de los servicios devuelven un objeto Json bajo el
siguiente formato: {"respuesta": ..., "error": ..., "mensaje": "..."}.
- Respuesta: Objeto con los datos que devuelve cada servicio.
- Error: Campo booleano que identifica si la respuesta es correcta o tiene un error. Informa true o false.
- Mensaje: En caso de un error de tipo "false", informa el motivo del mismo.
X.- Términos y Condiciones de uso de la Plataforma de Trámites a Distancia (TAD)
La adhesión al Servicio NOTIFICAR de CONSULTA AUTOMÁTICA DE
NOTIFICACIONES MASIVAS EN LA PLATAFORMA TRÁMITES A DISTANCIA (TAD)
implica la aceptación de los términos y condiciones para el uso de la
plataforma de Trámites a Distancia (TAD) del sistema de Gestión
Documental Electrónica - GDE.
IF-2018-31389706-APN-DNTEID#MM
