Integraciones de Atomik
Atomik está diseñado para integrarse. No pretende ser un sistema monolítico que lo gestione todo — es una plataforma de datos que se conecta a las herramientas que la organización ya utiliza. La integración se gestiona a través de estándares publicados siempre que es posible, para evitar la dependencia de conectores propietarios.
Estándares que Atomik Soporta
Usar estándares publicados significa menos código personalizado en la capa de integración y menos decisiones que solo el equipo propio entiende.
API REST openEHR
Atomik implementa la especificación openEHR ITS REST. Cualquier cliente compatible con openEHR puede interactuar con él sin modificaciones — almacenando y recuperando HCEs, composiciones y datos demográficos a través de la misma interfaz.
Esto significa que las aplicaciones escritas para otro CDR openEHR funcionarán con Atomik sin cambios en el código de integración.
FHIR R4/R5
Atomik soporta integración FHIR R4/R5 a través de una fachada FHIR personalizada construida sobre tu modelo de datos openEHR. Se diseña y construye para tus dominios clínicos específicos — no es un mapeo genérico automático.
Trabajamos contigo para identificar los casos de uso y dominios que necesitas soportar vía FHIR, diseñamos los perfiles FHIR correspondientes y los mapeamos con tus plantillas openEHR. El resultado es una API FHIR con soporte bidireccional completo — crear, actualizar, leer y buscar — sin duplicación de datos. El mapeo ocurre en tiempo de consulta sobre el almacén openEHR.
Servicios de Terminología (SNOMED CT)
Atomik se integra con servicios de terminología SNOMED CT para soportar consultas semánticas. Al consultar datos clínicos, Atomik puede expandir expresiones SNOMED CT — permitiendo filtrar por un concepto clínico y sus subtipos sin necesidad de listar cada código individual en la consulta.
Esto es relevante cuando el modelo de datos usa códigos SNOMED CT y se necesitan consultas que respeten la jerarquía de SNOMED CT en lugar de comparar valores de código exactos.
Patrones de Integración
El enfoque adecuado depende de cómo sea el entorno existente.
Integración Directa por API
La aplicación llama directamente a la API REST de Atomik para almacenar y recuperar datos clínicos. Es el patrón más sencillo y funciona bien para proyectos nuevos donde se controla todo el stack.
La API REST openEHR está bien documentada y existen librerías cliente en varios lenguajes. Se envían composiciones por HTTPS y se reciben respuestas JSON estructuradas.
- No requiere middleware
- Fácil de probar y depurar
- Recomendado para proyectos nuevos
Motor de Integración
Para entornos con infraestructura de integración existente — feeds de mensajes HL7 v2, conexiones con HCEs legacy o sistemas de mensajería — Atomik se conecta a través de un motor de integración como Mirth Connect.
El motor gestiona el enrutamiento de mensajes, la transformación entre formatos (HL7 v2, FHIR, openEHR) y la orquestación. El rol de Atomik es la persistencia de datos clínicos — recibe composiciones ya transformadas a través de su API REST.
- Gestiona formatos de mensajes legacy en origen
- Centraliza la lógica de transformación
- Compatible con Mirth Connect y motores similares
Consideraciones Prácticas
Se necesitan plantillas operacionales openEHR
Antes de almacenar datos en Atomik, hay que definir qué datos se van a recopilar usando plantillas operacionales openEHR. Las plantillas se construyen a partir de arquetipos publicados en el Clinical Knowledge Manager de openEHR. Si es nuevo en esto, nuestros programas de formación lo cubren desde cero.
Autenticación
Las APIs de Atomik usan autenticación basada en tokens. Cada organización tiene su propio conjunto de usuarios y roles. Para despliegues en producción, es habitual colocar un API gateway o proxy inverso delante de Atomik para gestionar la terminación TLS y la validación de tokens.
Pruebas de integración
La herramienta complementaria openEHR Toolkit de Atomik puede generar composiciones sintéticas a partir de las plantillas. Esto proporciona datos de prueba realistas para validar la capa de integración antes de conectar sistemas clínicos reales.
Documentación de la API
La documentación completa de referencia de la API está disponible en atomik.app/documentation. Incluye ejemplos de peticiones y respuestas, instrucciones de autenticación y códigos de error para todos los endpoints.
¿Tienes alguna pregunta?
Dinos cómo podemos ayudarte.