Saltar al contenido principal

Glosario — SINAPSIS

Términos funcionales, técnicos y normativos del sistema SINAPSIS (api-subrogados).

A​

AcceDer (Acceso a Derechohabientes)​

Sistema institucional del IMSS para consultar la vigencia de derechos de los derechohabientes. Permite verificar si un paciente tiene cobertura activa antes de autorizar servicios médicos. En SINAPSIS se consume vía servicios SOAP a través del conector de intranet (modo internet: job asíncrono; modo intranet: llamada directa). Toda consulta está auditada en sec_audit_consulta_externa.

Propósito en SINAPSIS: Verificar vigencia del paciente en el flujo pre-VoBo y pre-Autorización de solicitudes y derivaciones. Si AcceDer no responde, el sistema procede sin bloquear el flujo.

ADR (Architecture Decision Record)​

Documento que registra una decisión arquitectónica relevante, su contexto, alternativas y consecuencias. En el proyecto se versionan en docs/memory/decisiones.md y nunca se eliminan.

Anexo 1 (Tarifas)​

Catálogo de tarifas nacionales para servicios médicos en el intercambio interinstitucional. Publicado por el IMSS y actualizado anualmente. Referencia: docs/normativa/Anexo 1. Tarifas_2025...pdf.

Anexo 2 (Lineamientos)​

Manual de lineamientos del intercambio de servicios interinstitucionales. Define las categorías, servicios y condiciones del intercambio. Referencia: docs/normativa/Anexo 2. MANUAL_LINEAMIENTOS_INTEGRADO_03-05-23.pdf.

Auditoría​

Registro estructurado y persistente de eventos del sistema (autenticación, autorización, consultas externas). Implementado con hash-chain en sec_audit_auth_event y sec_audit_consulta_externa.

Autorización​

  1. Acción del flujo: Aprobación administrativa de una solicitud o derivación — cambia el estatus a AU (3).
  2. Acción técnica: Validación de que el usuario tiene permisos para ejecutar un endpoint (RBAC).

B​

Backup​

Respaldo automático diario de la base de datos generado a las 23:55 con mysqldump + gzip. Retiene los últimos 3 backups en ./backups/.

C​

Cache (Redis)​

Almacenamiento en memoria para:

  • Permisos RBAC del usuario autenticado
  • Opciones de filtros de DataGrid de alto costo (prei:opciones:v2)
  • Pub/Sub de WebSocket

CFDI (Comprobante Fiscal Digital por Internet)​

Factura electrónica mexicana con UUID único. Las facturas CFDI se registran en fac_facturas y se validan contra el SAT.

CLUES (Clave Única de Establecimientos de Salud)​

Identificador oficial del IMSS para establecimientos de salud a nivel nacional. Permite referenciar unidades médicas con un código único.

Contrarecibo (CR)​

Número de contrarecibo asignado por el IMSS a una factura aprobada. Se registra en fac_facturas.contrarecibo.

Control de Facturas​

Sub-módulo que gestiona la vinculación entre solicitudes de subrogados y las facturas CFDI que las amparan, incluyendo cálculo fiscal y control de pagos.

D​

DataGrid​

Componente de tabla de datos usando MUI X DataGrid. Convención en SINAPSIS: siempre autoHeight + Box sx={{ width: '100%' }}, localización esES.

Derechohabiente​

Persona con derecho a los servicios médicos del IMSS (afiliada y con vigencia activa en ACCEDER).

Derivación​

Proceso por el cual una unidad médica refiere a un paciente a otra institución o proveedor para atención de un servicio específico. Gestionado en el módulo de Intercambio.

DTO (Data Transfer Object)​

Estructura de datos para transportar información entre capas del sistema, desacoplada de los modelos de base de datos.

E​

Estatus​

Identificador del estado de una solicitud o derivación en su ciclo de vida. Ver tabla completa en Flujos de Estado.

F​

FINAT​

Sistema presupuestal del IMSS. El reporte IMKK022 es el reporte de Disponibilidad Presupuestal de FINAT/Millenium.

Folio​

Identificador secuencial único asignado a solicitudes y derivaciones por unidad médica. Se reinicia al inicio de cada año fiscal.

G​

Glosador​

Persona responsable de revisar y validar las facturas CFDI contra los servicios prestados. Tiene acceso a la Mesa de Glosa.

Glosa​

Proceso de revisión de una factura CFDI para verificar que los conceptos facturados corresponden a los servicios efectivamente prestados.

GORM​

ORM (Object-Relational Mapping) para Go, usado para el mapeo entre estructuras Go y tablas MariaDB.

H​

Hash-chain​

Mecanismo de integridad que enlaza registros de auditoría mediante hashes (prev_hash → row_hash), impidiendo la alteración de registros sin detección.

I​

IMKK022​

Nombre del reporte de Disponibilidad Presupuestal generado por el sistema PREI Millenium del IMSS. Formato CSV con 9 líneas de encabezado.

IMSS (Instituto Mexicano del Seguro Social)​

Institución principal usuaria del sistema. Patrón de identificación: tipo de usuario imss, matrícula de empleado.

Intercambio de Servicios​

Modalidad de atención en la que un paciente de una institución es atendido por otra institución, bajo acuerdos normativos (Anexo 1 y Anexo 2).

ISSSTE (Instituto de Seguridad y Servicios Sociales de los Trabajadores del Estado)​

Segunda institución soportada por el sistema. Tipo de usuario issste.

J​

Job (Async Job)​

Proceso asíncrono en segundo plano para tareas de larga duración: importación CLUES, importación PREI, consultas SOAP.

K​

KPIs​

(Key Performance Indicators) o Indicadores Clave de Desempeño, son métricas utilizadas para medir qué tan bien está funcionando un proceso, proyecto, área o empresa respecto a un objetivo específico..

M​

Memorándum de Devolución​

Documento oficial generado cuando una factura es devuelta al proveedor por inconsistencias. Referencia normativa: Procedimiento 6B13-003-002.

Mesa de Glosa​

Vista operativa del glosador (/finanzas/glosador) donde revisa y procesa las facturas asignadas a él.

Middleware​

Componente que intercepta requests HTTP para lógica transversal: autenticación JWT, autorización RBAC, manejo de errores.

N​

NOM-024-SSA3-2012​

Norma Oficial Mexicana que establece requisitos funcionales para sistemas de información en salud. Exige control de acceso, trazabilidad y auditoría. Ver Cumplimiento NOM-024.

NSS (Número de Seguridad Social)​

Identificador único del derechohabiente en el IMSS.

O​

OOAD (Órgano de Operación Administrativa Desconcentrada)​

Nivel administrativo del IMSS por encima de las unidades médicas. Equivalente a una delegación o sub-delegación regional. Tabla: imss_uo.

P​

Paciente Específico​

En el módulo de Subrogados, un paciente puede tener contratos de precios específicos distintos a los del catálogo general de la unidad.

Perfil (Profile)​

Rol lógico que agrupa permisos relacionados a funciones específicas. Un usuario puede tener múltiples perfiles. Tabla: sec_profiles.

Permiso (Permission)​

Representación de un endpoint del sistema en el RBAC. Se identifica por METHOD + path_template y tiene una action asociada. Tabla: sec_permissions.

PREI (Presupuesto de Recursos para la Infraestructura)​

Sistema presupuestal del IMSS que controla la disponibilidad de recursos para infraestructura. Los datos se importan desde el reporte IMKK022 del sistema Millenium.

Privilegio (priv_*)​

Bandera booleana en sec_user_profiles que indica si el usuario puede ejecutar una acción específica en un módulo: priv_create, priv_read, priv_update, priv_delete, priv_export, priv_print.

Proveedor​

Institución privada o pública que presta servicios médicos bajo contrato con el IMSS. Tabla: proveedores.

R​

RBAC (Role-Based Access Control)​

Control de acceso basado en roles, implementado dinámicamente en SINAPSIS. Los permisos se cargan desde BD al autenticarse y se cachean en Redis. Ver Seguridad RBAC.

Redis​

Sistema de almacenamiento en memoria para: cache RBAC, Pub/Sub de WebSocket y opciones de filtros.

RFC (Registro Federal de Contribuyentes)​

Identificador fiscal del proveedor. Usado para el lookup de proveedor al escanear el QR del CFDI.

S​

SIAP (Sistema Integral de Administración de Personal)​

Sistema del IMSS para consultar y validar información del personal IMSS. Proporciona datos biométricos e identificativos de empleados (médicos, operadores). Se usa al registrar o actualizar usuarios de tipo imss en el sistema. Se consume vía SOAP a través del conector de intranet.

Propósito en SINAPSIS: Validar la identidad del personal IMSS al crear o actualizar cuentas de usuario. URL del servicio SOAP: http://172.26.18.157/biometrico/Biometrico/WebServices/wsBiometrico.asmx

SINAPSIS​

Nombre del sistema. Sistema Nacional de Administración y Procesos Integrados en Salud.

SIRES​

Sistema de Información de Registro Electrónico para la Salud.

Soft Delete​

Borrado lógico usando gorm.DeletedAt. Los registros eliminados conservan todos sus datos y son recuperables. Nunca se hace borrado físico en entidades de negocio.

Solicitud (Subrogados)​

Petición de servicio médico subrogado que registra al paciente, proveedor, contrato y estudios requeridos.

Subrogación​

Proceso por el cual una institución (IMSS) contrata servicios médicos con un tercero (proveedor) cuando no tiene capacidad instalada.

U​

UMA (Unidad de Medida y Actualización)​

Referencia económica para ciertos cálculos financieros del IMSS. Tabla: uma_valores.

Unidad​

Establecimiento médico del IMSS (UMF, HGZ, HGR, etc.) asociado a una OOAD y referenciado por CLUES. Tabla: unidades.

UUID (Universally Unique Identifier)​

Identificador único del CFDI. Se usa para evitar facturas duplicadas en el sistema.

V​

VAPID (Voluntary Application Server Identification)​

Estándar de autenticación para Web Push. Las claves VAPID permiten al backend enviar notificaciones push directamente a los navegadores.

VoBo (Visto Bueno)​

Aprobación médica de una solicitud o derivación. Paso previo a la autorización administrativa. Estatus: VB (19).

W​

WebSocket​

Protocolo de comunicación bidireccional en tiempo real. Usado en SINAPSIS para chat y notificaciones. Backend: gorilla/websocket. Redis Pub/Sub como bus de eventos.

ZEROFILL​

Formato de presentación del ID del proveedor con ceros a la izquierda (10 dígitos). Implementado como fmt.Sprintf("%010d", prov.ID) en PDFs y encabezados de documentos.

Z​

Zona Médica​

Agrupación administrativa de OOADs. Tabla: imss_zonas. Usada para validaciones de vinculación factura-solicitud y para filtros en analítica.