8. Integraciones externas

8.1 SIGSA — 14 formularios MSPAS

Receta SIGSA paso a paso

1. Servicios clínicos publican eventos (nota.firmada, parto.cerrado, epi.notificado…).
2. reportes-sigsa mantiene vistas materializadas que se refrescan al consumir cada evento.
3. Cron mensual ejecuta POST /sigsa/{form}/generar?periodo=2026-05.
4. Genera CSV oficial + PDF con plantilla MSPAS · firma digital institucional.
5. Envía vía pasarela-fhir (donde MSPAS lo acepta) o portal MSPAS oficial.
6. Estadística HNSM revisa, aprueba, archiva acuse.
7. pub sigsa.enviado → tablero Dirección.

8.2 SICOIN (MINFIN · UE 248)

1. presupuesto guarda copia de la estructura programática vigente (Programa, Subprograma, Actividad, Renglón).
2. Cada movimiento contable (compromiso, devengado, pagado) se registra primero en SIH y luego se sincroniza.
3. Cron 23:30 invoca SOAP UE 248 con XML firmado.
4. Idempotencia: hash diario por (UE, fecha, partida).
5. Errores → reintentos con backoff (5 min, 30 min, 2 h) · alerta a Subdir Financiero.
6. Acuse exitoso → marca conciliado_at en cada movimiento.

// Cliente SOAP minimalista (Java / Spring)
@Service
public class SicoinClient {
  private final WebServiceTemplate ws;
  public AcuseSicoin enviar(MovimientoBatch batch){
    return (AcuseSicoin) ws.marshalSendAndReceive(URL_UE248, batch);
  }
}

8.3 Guatecompras (NPG / NOG)

1. compras registra requerimientos internos asignados a un Renglón.
2. Compras publica el evento NPG en Guatecompras (manual hoy, asistido por automatización mañana).
3. Scraper autorizado consulta Guatecompras por NPG/NOG cada hora durante el evento.
4. Importa: ofertas, adjudicación, contrato, fianza, plazos.
5. Al adjudicarse, pub compra.adjudicada → presupuesto (compromiso) e inventario (espera ingreso).
6. Recepción de mercadería: POST /api/v1/entradas con número de NIT, factura, lote, vencimiento.
7. Trazabilidad: lote → orden de compra → NPG → contrato.

8.4 RENAP — Validación de CUI

1. identidad-paciente mantiene cliente HTTP con MFA institucional contra RENAP-WS.
2. Verificación local primero: algoritmo de dígito verificador del CUI (módulo 11 ponderado).
3. Si pasa local, consulta a RENAP por nombres + fecha de nacimiento.
4. Cache local de 90 días (sólo para reducir latencia, no para reemplazar fuente).
5. Pacientes sin CUI (extranjeros, recién nacidos): identificador transitorio HNSM-yyyy-#######.
6. Al obtener CUI posteriormente: caso de uso Fusionar pacientes con auditoría completa.

8.5 FHIR R4 — Salida hacia MSPAS / IGSS / otros hospitales

Recursos expuestos por pasarela-fhir (mTLS · OAuth2 client-credentials):

Receta FHIR paso a paso

1. pasarela-fhir consume eventos internos (paciente.creado, nota.firmada, lab.resultado.liberado…).
2. Por cada evento, materializa el recurso FHIR equivalente en su BD (read-model).
3. Expone endpoints FHIR estándar (search, read) protegidos por mTLS + OAuth2.
4. Audita cada acceso externo en auditoría WORM con identidad del cliente.
5. Validación contra perfiles MSPAS (cuando los publiquen) o IPS internacional como mínimo.

8.6 HL7 v2.5 — equipos clínicos vía Mirth

• Lab: ORM-O01 (orden) → analizador · ORU-R01 (resultado) → laboratorio.
• PACS / Modalidades: ORM + DICOM Modality Worklist (MWL) → imagenologia.
• Monitores cabecera: ORU vital signs → signos-vitales (cada minuto).
• Mirth transforma HL7 ↔ JSON interno · canales versionados · DLQ a Kafka.