Documentation Index
Fetch the complete documentation index at: https://docs.fhiron.cl/llms.txt
Use this file to discover all available pages before exploring further.
Escenario
Un laboratorio clínico emite resultados que viajan hacia el EHR del prescriptor y, en paralelo, hacia el bus MINSAL. El identificador del examen debe ser LOINC (no códigos internos del laboratorio), y la fecha del examen — no de emisión — va en effectiveDateTime. Bridge valida que DiagnosticReport lleve status, code, subject y effective[x], todo bajo la regla cl-dr-04.
Payload válido
Hemograma completo con LOINC
{
"resourceType": "DiagnosticReport",
"status": "final",
"category": [
{
"coding": [
{
"system": "http://terminology.hl7.org/CodeSystem/v2-0074",
"code": "HM",
"display": "Hematology"
}
]
}
],
"code": {
"coding": [
{
"system": "http://loinc.org",
"code": "58410-2",
"display": "Complete blood count (hemogram) panel - Blood by Automated count"
}
],
"text": "Hemograma completo"
},
"subject": { "reference": "Patient/example" },
"effectiveDateTime": "2026-05-10T08:32:00-04:00",
"issued": "2026-05-10T14:05:00-04:00",
"performer": [
{
"display": "Laboratorio clínico"
}
],
"result": [
{ "reference": "Observation/hb-example" },
{ "reference": "Observation/leuco-example" },
{ "reference": "Observation/plt-example" }
],
"conclusion": "Sin alteraciones significativas en serie roja, blanca ni plaquetas."
}
Cómo validarlo
curl -X POST https://fhiron.cl/api/validate \
-H "Content-Type: application/json" \
-H "X-API-Key: $FHIRON_API_KEY" \
-d @diagnostic-report.json
OperationOutcome esperado
Cuando code.coding[] incluye al menos un coding con system: "http://loinc.org" y effectiveDateTime está en formato ISO-8601, issue[] viene vacío.
Errores típicos cuando algo falla:
cl-dr-04 — falta effective[x] (effectiveDateTime o effectivePeriod). Sin la fecha del examen, el resultado no es trazable clínicamente.cl-dr-* — falta status, code o subject. Tres cardinalidades 1..1.cl-json-* — effectiveDateTime con formato no ISO-8601 (ej: "10/05/2026").
Tips
effectiveDateTime vs issued:
effectiveDateTime es cuándo se tomó la muestra.issued es cuándo se emitió el informe.
Pueden estar separados por horas o días. Para tendencias clínicas siempre se usa effectiveDateTime.
LOINC más comunes en Chile:
58410-2 — hemograma completo.24323-8 — perfil bioquímico.2160-0 — creatinina sérica.2345-7 — glucosa.2089-1 — colesterol LDL.
Para exámenes que cubren un período (ej: Holter de 24 h, recolección orina 24 h) usar effectivePeriod con start y end en vez de effectiveDateTime.
result[] referencia los Observation con cada parámetro (hemoglobina, leucocitos, plaquetas, etc.). Bridge valida cada Observation referenciado en el Bundle por separado.
Time zone Chile: usar offset explícito (-04:00 abril–septiembre, -03:00 octubre–marzo con horario de verano) en lugar de UTC, salvo que el sistema receptor exija UTC. La fecha clínica suele leerse en hora local.
Bridge valida este DiagnosticReport contra el perfil R4 base más la regla cl-dr-04. Si falta effectiveDateTime y tampoco hay effectivePeriod, devuelve cl-dr-04 con quickFix (jsonPointer: /effectiveDateTime).
