ESPECIFICACIONES S2
Esta guía tiene como finalidad la descripción del Estándar para la Interoperabilidad de Datos de Servidores Públicos que Intervienen en Contrataciones, desarrollado por la Secretaría Ejecutiva del Sistema Nacional Anticorrupción (SESNA) y presenta el modelo de interoperabilidad que adoptó y aplicó la Secretaría Ejecutiva del Sistema Estatal Anticorrupción de Aguascalientes (en adelante, SESEA) en el desarrollo el Sistema de Información de Servidores Públicos que Intervienen en los procesos de Contratación de la Plataforma Digital Estatal de Aguascalientes (en adelante, Sistema S2) para proveer información a la Plataforma Digital Nacional (PDN).
Antecedentes
- El 23 de octubre de 2018 fueron publicadas las Bases para el funcionamiento de la Plataforma Digital Nacional (PDN) en el Diario Oficial de la Federación (DOF). En el artículo 6 de las Bases, se establece que, para el correcto funcionamiento de cada uno de los sistemas, la SESNA emitirá los protocolos, estándares, reglamentos, especificaciones técnicas y cualquier normativa necesaria para la colaboración, provisión de datos y acciones, los cuales serán obligatorios para todos los proveedores, concentradores y encargados a nivel federal, estatal y municipal.
- El 26 de junio de 2019 fueron publicadas las Bases para el funcionamiento de la Plataforma Digital Estatal de Aguascalientes (PDE) en el Periódico Oficial del Estado (POE). En el artículo 6 de las Bases, se establece que, para el correcto funcionamiento de cada uno de los sistemas, la SESEA emitirá los protocolos, estándares, reglamentos, especificaciones técnicas y cualquier normativa necesaria para la colaboración, provisión de datos y acciones, los cuales serán obligatorios para todos los proveedores, concentradores y encargados a nivel estatal y municipal.
- El 3 de mayo de 2021 fue publicado el Catálogo de Perfiles de Usuario del Sistema de Información de los Servidores Públicos que Intervengan en Procedimientos de Contrataciones Públicas, de la Plataforma Digital Estatal de Aguascalientes, Documento que tiene por objetivo establecer las facultades, atribuciones y obligaciones, de cada uno de los usuarios que tendrán acceso al Sistema S2.
Introducción
En la actualidad, la información de los servidores públicos que intervienen en contrataciones de los diferentes niveles de gobierno se encuentra contenida en diversos formatos, bases de datos y sistemas de información; cada uno de ellos con particularidades tecnológicas y reglas de negocio distintas, dificultando la integración y la interoperabilidad de los datos. El Estándar para la Interoperabilidad de Datos de Servidores Públicos que Intervienen en Contrataciones surge a partir de la necesidad de distribuir, comparar y analizar información de una manera uniforme e interoperable.
Conforme a lo anterior, la SESNA ha conceptualizado a la Plataforma Digital Nacional como una herramienta que permitirá la consulta de información de las diferentes instituciones gobierno en un solo punto, sin tener el objetivo de concentrarla o resguardarla. En ese sentido, resulta necesario dotar a la PDN de mecanismos le que permitan interconectarse con los diversos sistemas de las Secretarías Ejecutivas locales para consultar la información que resulte necesaria, sin importar la tecnología con la que dichos sistemas fueron desarrollados (i.e., lenguajes de programación, bases de datos, etc.).
La PDN logrará la interoperabilidad técnica con los diversos sistemas que la integrarán a través de la creación de estándares de datos y mediante el uso de Interfaces de Programación de Aplicaciones o APIs (por sus siglas en Inglés). Los estándares de datos permitirán homologar la manera en que la información se debe representar para su entrega a la PDN, mientras que las APIs serán el mecanismo que permitirá la comunicación entre sistemas a través de Internet. Las APIs son ampliamente usadas para el desarrollo de aplicaciones a gran escala. El uso de APIs permitirá que las instituciones conserven el control de sus datos, gestionando el acceso a los mismos mediante reglas y perfiles de usuario.
La SESEA ha cumplido con éxito todas las pruebas de interoperabilidad establecidas por la Plataforma Digital Nacional mediante el uso APIs Web con arquitectura REST (REpresentational State Transfer). Dicha tecnología es ampliamente usada por en la industria del software para el desarrollo de aplicaciones web, y en la actualidad, existe gran diversidad de herramientas de código abierto que permiten la implementación de sistemas basados en APIs REST de manera rápida y a un bajo costo.
Open API Specification
El Estándar para la Interoperabilidad implementado por la SESEA para mostrar los datos de servidores públicos que intervienen en contrataciones está basado en el formato conocido como Open API Specification (OAS), el cual es un formato de especificación que permite describir de manera precisa las características con las que deben contar el API que se integra a la PDN. El OAS cuenta con capacidades para describir los recursos, operaciones, parámetros y estructuras de datos con las que deberán contar las APIs, permitiendo su implementación con independencia tecnológica, es decir, las instituciones podrán emplear las herramientas tecnológicas de su elección (e.g., lenguajes de programación, bases de datos, etc.) siempre que se sigan las especificaciones de manera correcta.
OAuth 2.0
El acceso de la API del Sistema S2 que integrará a la PDN la información se gestiona a través del protocolo de autorización OAuth 2.0. El estándar OAuth 2.0 permitirá a la PDN obtener acceso necesario a la API del Sistema S2 a través del uso de tokens de autorización.
MÁS INFORMACIÓNImplementación del estándar de datos
La implementación del estándar de datos de servidores públicos que intervienen en contrataciones representará esfuerzos de diferente magnitud dependiendo del nivel de adopción tecnológica de cada Ente Público. Suponiendo que un cierto Ente Público ya cuenta o pretende desarrollar un sistema de captura de servidores públicos que intervienen en contrataciones, el proceso de implementación del API de servidores públicos que intervienen en contrataciones puede ser dividido en los siguientes pasos:
- Diagnóstico: Revisar y comparar los datos contenidos en su base de datos con los especificados en diccionario de datos del formato de datos de servidores públicos que intervienen en contrataciones, es importante contar con todos los datos solicitados en el nuevo formato, sin embargo, esto no imposibilita a los Entes Públicos para realizar pruebas de adopción del estándar usando los datos con los que se cuenta.
- Diseño de arquitectura: Se deberá evaluar las capacidades del sistema de información o base de datos de servidores
públicos que intervienen en contrataciones, a fin de diagnosticar su capacidad para soportar la carga de trabajo actual y al
mismo tiempo la tarea de resolver las consultas que serán realizadas por la PDE a través del API.
En el caso de contar con gran cantidad de usuarios y como medida de seguridad, se recomienda implementar alguna solución de replicación de la información en el sistema de base de datos; de tal manera que se divida la carga de trabajo en dos o más bases de datos. - Desarrollo: El desarrollo del API de servidores públicos que intervienen en contrataciones podrá realizarse en el lenguaje de programación que se considere más apropiado con apego a las especificaciones que se proporcionan en las siguientes secciones de la presente guía. Dichas especificaciones son agnósticas a la tecnología, es decir, el resultado de la comunicación deberá ser el mismo, siempre que se respeten las reglas, formatos de datos y la sintaxis de los mensajes.
Modelo de comunicación
A través de la PDE, los usuarios serán capaces de realizar consultas a la API del Sistema S2, dichas consultas se configurarán usando parámetros. La Figura 1 muestra un diagrama en el cual se ejemplifica la comunicación entre el API del Sistema S2 y la PDN. El API tendrá la tarea de recibir la consulta y aplicar la lógica de negocio al interior de la institución para generar la respuesta correspondiente. Dicha respuesta deberá estar apegada al estándar de Datos de Servidores Públicos que Intervienen en Contrataciones que se proporciona en la siguiente sección.
Figura 1. Esquema conceptual del flujo de comunicación entre el Sistema S2 y la PDN. De derecha a izquierda se observan usuarios con diferentes perfiles accediendo a la PDN y solicitando información de acuerdo a sus atribuciones al Sistema S2.
Especificaciones técnicas
Diccionario de datos
MÁS INFORMACIÓNCatálogos de códigos y valores
MÁS INFORMACIÓNEspecificaciones en formato Open API Specification
MÁS INFORMACIÓN
