Bridge
Validación FHIR® contra CL Core, hecha para Chile.
Bridge valida cualquier recurso HL7® FHIR R4 contra los perfiles CL Core publicados por HL7® Chile. Los errores vienen en español, con la ruta FHIRPath exacta del campo que falla. Construido para builders que integran sistemas de salud chilenos sin tener que mantener su propio motor de validación.
Una llamada, una respuesta determinística.
curl -X POST https://fhiron.cl/api/validate \
-H "Content-Type: application/fhir+json" \
-H "X-API-Key: $FHIRON_API_KEY" \
-d '{
"resourceType": "Encounter",
"meta": {
"profile": [
"https://hl7chile.cl/fhir/ig/clcore/StructureDefinition/EncounterCl"
]
},
"status": "finished",
"class": {
"system": "http://terminology.hl7.org/CodeSystem/v3-ActCode",
"code": "AMB",
"display": "ambulatory"
},
"subject": { "reference": "Patient/example" },
"period": {
"start": "2026-04-15T09:00:00-04:00",
"end": "2026-04-15T09:42:00-04:00"
}
}'{
"resourceType": "OperationOutcome",
"issue": [
{
"severity": "information",
"code": "informational",
"diagnostics": "Encounter válido contra CL Core.",
"expression": ["Encounter"]
}
]
}Ejemplo de Encounter ambulatorio con v3-ActCode. Más recetas en docs.fhiron.cl/recetas.
Cómo se integra.
- 01
Genera tu API key
Crea una cuenta en fhiron.cl/registro. El plan Free incluye 100 validaciones mensuales sin tarjeta de crédito. La API key tiene formato fhrn_... y se gestiona desde el dashboard.
- 02
Llama a POST /api/validate
Envía el recurso FHIR como `application/fhir+json` al endpoint de Bridge con el header X-API-Key. Si el recurso declara su meta.profile, Bridge usa ese perfil; si no, infiere desde resourceType y aplica el perfil CL Core correspondiente.
- 03
Lee el OperationOutcome
Si el recurso es válido recibes severity information. Si hay errores, recibes una lista de issues con expression (FHIRPath del campo que falla), diagnostics (descripción en español) y code (clasificación del error).
Qué incluye Bridge.
Evita mantener tu propio HAPI, tus tablas locales de terminología y la traducción manual de los errores de la spec internacional al español.
Validación contra CL Core
El motor carga la versión publicada oficialmente por HL7® Chile en hl7chile.cl. Cardinalidades, slicing, invariantes FHIRPath y bindings se aplican en cada llamada, sin atajos.
OperationOutcome en español
Cada issue trae severity, code y la ruta FHIRPath del campo que falla, con el texto del error redactado para que un developer chileno lo entienda sin traducir de la spec internacional.
Terminología local cargada
TFC, DEIS, comunas del decreto 817, SNOMED CT Edición Español, v3-ActCode y los CodeSystems publicados por HL7 Chile vienen precargados. Tu integración no tiene que mantener tablas locales.
Respuesta determinística
Una misma entrada contra una misma versión del IG devuelve el mismo OperationOutcome. El motor expone la versión exacta de CL Core que evaluó en el header de respuesta.
Pensado para CI/CD
Integrable en GitHub Actions, GitLab CI o cualquier pipeline que pueda hacer un POST HTTP. Webhooks para eventos asincrónicos disponibles desde el plan Basic.
Linter en el editor
El conector MCP de Fhiron expone un linter local que detecta errores CL Core mientras escribes JSON o XML. No consume cuota del plan — la cuota solo se descuenta cuando se llama al motor.
Integración con el resto del stack.
La misma API REST se consume desde el dashboard, desde el conector MCP de Fhiron para flujos con agentes de IA y desde pipelines de CI/CD vía webhook. No existen clientes propietarios — todo el tráfico es HTTP estándar.
Preguntas frecuentes.
¿Contra qué versión de CL Core valida Bridge?
Bridge valida siempre contra la versión vigente del paquete hl7.fhir.cl.clcore publicado por HL7® Chile. Cada release del IG queda etiquetado en los logs internos, de modo que cada validación queda atada a la versión exacta del estándar que estaba activa cuando se hizo la llamada y es reproducible más tarde.
¿Cómo se cuenta una validación?
Una validación equivale a un recurso FHIR evaluado contra CL Core. Un Bundle con N entries cuenta como N validaciones. Las llamadas al linter local que corre dentro del conector MCP no descuentan del cupo. El detalle está en docs.fhiron.cl/conceptos/conteo-de-validaciones.
¿Qué pasa con los datos clínicos enviados a Bridge?
Bridge valida el recurso, devuelve el OperationOutcome y descarta la copia. No persiste recursos clínicos en producción — esta es la arquitectura stateless gateway descrita en docs.fhiron.cl/conceptos/stateless-gateway. Solo se almacenan metadatos técnicos: timestamp, perfil evaluado, severity agregado y versión del IG.
¿Es compatible con HAPI FHIR y otros validadores?
El motor de Bridge está construido sobre HAPI FHIR 8.8.0 con los perfiles CL Core publicados oficialmente. Un recurso que pasa Bridge debería pasar también un HAPI con el mismo IG cargado en la misma versión. Bridge agrega la traducción de los mensajes al español y reglas operativas internas que no cambian el resultado de validación.
¿Puedo integrar Bridge desde mi lenguaje preferido?
Sí. Bridge expone una API REST estándar; funciona con cualquier lenguaje que pueda hacer peticiones HTTP. Hay ejemplos para curl, Node.js, Python y Java en docs.fhiron.cl/bridge/api.
¿Bridge valida también los perfiles MINSAL (NID, SNRE, EIS, IPS-CL)?
Estos IGs derivan de CL Core. Soporte explícito a sus perfiles está en la hoja de ruta del producto. Mientras tanto, los recursos enviados con meta.profile apuntando a un perfil MINSAL se validan contra el perfil base CL Core correspondiente y se reporta cuando una restricción específica MINSAL aún no está cubierta.
Valida tu primer recurso hoy mismo.
Plan Free con 100 validaciones al mes. Sin tarjeta de crédito, sin configuración previa.
Marcas registradas
FHIR® es marca registrada de Health Level Seven International (HL7®). El uso de la marca FHIR® en esta página y en la plataforma Fhiron no constituye respaldo (endorsement) por parte de HL7®.
FHIR® is the registered trademark of Health Level Seven International and the use does not constitute endorsement by HL7.