Saltar al contenido
API e integraciones

FHIR R4. SMART on FHIR. CDS Hooks. Sin middleware propietario.

Materna Health Solutions habla los estándares que su equipo ya usa. Diseñamos cada integración para que sea documentada, versionada y cubierta por BAA. Somos deliberados sobre lo que envolvemos y transparentes sobre lo que aún no.

A patient at home, connected to her care team

FHIR R4

Estándares que hablaremos

HL7 v2.x, CDS Hooks, CCDA, SMART, X12, NCPDP

Epic, Cerner, athena

EHR objetivo

Diseñado conforme a la especificación SMART on FHIR R4

8

Categorías de integración

EHR, reclamos, laboratorio, farmacia, imágenes, telesalud, identidad, comunicaciones

Marco honesto

Materna Health Solutions está en desarrollo temprano. El catálogo de abajo es lo que estamos construyendo, diseñado conforme a los estándares de interoperabilidad publicados, no integraciones en producción. No publicaremos socios en vivo, métricas de tráfico ni tiempos de implementación hasta que una práctica real use la plataforma. Cada elemento es un objetivo de diseño que los compradores pueden exigirnos.

El catálogo

Lo que diseñamos contra el estándar y lo que está planificado.

EHR

Epic (HL7 FHIR R4)

diseñado

Lectura y escritura por SMART on FHIR. Diseñado conforme a la especificación SMART on FHIR R4.

Oracle Cerner Millennium

diseñado

Lectura FHIR R4, CDS Hooks para mostrar el riesgo.

athenahealth

diseñado

Lectura y escritura FHIR R4. Acotado por paciente y por encuentro.

eClinicalWorks

planificado

Lectura FHIR R4. API de escritura en la hoja de ruta.

NextGen

planificado

Puente CCD diseñado, FHIR R4 planificado.

Reclamos

Medicaid 837/835 (X12)

diseñado

Construido conforme a la especificación X12 para AHCCCS, PA Medicaid, Medi-Cal y TX Medicaid.

Commercial X12 837P/I, 835

diseñado

BCBS, United, Aetna, Cigna, Anthem.

CMS 1500 / UB-04 PDF render

diseñado

Para contingencias de reclamos en papel.

Laboratorio

LabCorp HL7 v2.5.1

diseñado

Resultados de entrada, órdenes de salida.

Quest Diagnostics

diseñado

Resultados de entrada, órdenes de salida.

In-house lab via FHIR

diseñado

Para FQHC que operan su propio laboratorio.

Farmacia

Surescripts ePrescribing

diseñado

NCPDP SCRIPT 2017071. Compatible con EPCS.

Walgreens Rx Direct

planificado

Verificación de beneficios directo con la farmacia.

Imágenes

DICOM web (WADO-RS)

diseñado

Traer estudios de ultrasonido al expediente.

Ambra Health

diseñado

Intercambio de imágenes entre instalaciones.

Telesalud

Doxy.me embed

diseñado

Iframe nativo con contexto del expediente.

Zoom for Healthcare

diseñado

Cubierto por BAA, alineado con HIPAA.

Materna native (WebRTC)

diseñado

Integrado, sin inicios de sesión adicionales.

Identidad

OAuth 2.0 / OIDC

diseñado

Para SSO hacia los espacios de trabajo del proveedor.

SAML 2.0

diseñado

Compatible con SSO iniciado por el IdP.

SCIM 2.0

planificado

Aprovisionamiento al instante para socios.

Comunicaciones

Twilio SMS + WhatsApp

diseñado

Mensajería bilingüe de salida y de dos vías.

SendGrid email

diseñado

Con plantillas y marca propia.

Push notifications (PWA)

diseñado

iOS 16.4+ y Android.

API REST

Una superficie pequeña, bien documentada, versionada.

La API de Materna es pequeña a propósito. Exponemos lo que los equipos realmente necesitan para componer, y resistimos la tentación de publicar todo.

GET

/v1/patients/{id}/risk

Devuelve la banda de riesgo más reciente y los factores que contribuyen.

GET

/v1/patients/{id}/screenings

Lista de resultados de tamizaje validados, acotada por rango de fechas.

POST

/v1/patients/{id}/messages

Enviar un mensaje a la bandeja de la paciente, con etiquetas de seguridad opcionales.

POST

/v1/referrals

Crear una referencia a especialista en red con contexto del expediente.

GET

/v1/care-gaps

Brechas de atención abiertas en su panel, filtrables por gravedad.

POST

/v1/sdoh-requests

Crear o actualizar una solicitud de ciclo cerrado de SDOH.

GET

/v1/audit-log

Consulta del registro de auditoría HIPAA, acotada por usuario, paciente o rango de fechas.

POST

/v1/fhir-export

Generar un paquete FHIR R4 de la paciente con consentimiento para exportación transfronteriza.

Autenticación y límites

Flujo de credenciales de cliente OAuth 2.0 para sistema a sistema. Flujo de código de autorización para lanzamientos SMART on FHIR. TLS mutuo disponible para despliegues de alta confianza.

Límite de tasa previsto: 600 solicitudes por minuto por cliente, ampliable a petición. Los trabajos de exportación masiva corren en una cuota aparte.

SDKs

SDK oficiales en TypeScript y Python. Tipado fuerte en toda la superficie. Generados a partir de una especificación OpenAPI 3.1 publicada, para que los SDK no oficiales en cualquier lenguaje se mantengan alineados.

Colección de Postman y un generador de CLI para configurar el entorno de pruebas. Mantenemos ejemplos en EN y ES, porque diseñamos para una base de pacientes que vive en español.

Webhooks

Escuche los eventos. Los enviamos al menos una vez con un cuerpo firmado.

EventoDescripción
patient.risk.changedLa banda de riesgo de una paciente subió o bajó.
screening.self_harm_detectedUn tamizaje o la voz detectó una frase de autolesión. Siempre se dirige además a la ruta de seguridad.
care_gap.openedSe abrió una nueva brecha de atención para una paciente en su panel.
care_gap.closedSe cerró una brecha de atención con una acción documentada.
sdoh.matchedUn coordinador vinculó a una paciente con un recurso verificado.
sdoh.deliveredSe confirmó la entrega de un recurso de SDOH (ciclo cerrado).
visit.signedEl proveedor finalizó una nota SOAP.
voice.safety_keywordUn agente de voz detectó una palabra clave de seguridad. Se dirige a la ruta de seguridad en paralelo.

Los cuerpos se firman con HMAC-SHA256. Protección contra reenvío mediante marcas de tiempo. Reintentos en un horario de 1m, 5m, 30m, 2h, 12h. Visibilidad de mensajes no entregados en la consola del socio.

Exportación transfronteriza

Lo que otros proveedores no tienen.

Un paquete FHIR R4 con consentimiento que lleva el expediente de una paciente entre sistemas de salud y a través de la frontera internacional, auditado en ambas direcciones.

Paquete bilingüe

Todos los valores de texto en EN y ES. El sistema receptor elige el idioma de visualización sin pérdida de fidelidad.

Consentimiento primero

La paciente autoriza en lenguaje sencillo. El consentimiento es revocable. Cada acceso del lado receptor queda registrado y visible para la paciente.

Auditado en ambos sentidos

Cada lectura del lado receptor, sin importar el país, llega al registro de auditoría unificado de la paciente. Reguladores y auditores pueden solicitar un rastro completo.

Traiga su stack. Lo encontraremos donde esté.

Diseñamos cada integración para que se conecte rápido cuando vayamos en vivo. Nuestro equipo de ingeniería de integraciones tiene nombres reales y canales de Slack reales.