FHIR Basics for Health IT Teams: What Matters in the First 90 Days

FHIR Basics for Health IT Teams: What Matters in the First 90 Days

New team member joining FHIR-first health IT? First 90 days focus on the concepts that shape decisions. Nothing else compounds as fast as these fundamentals.

Days 1-30: Core resource model

1. Resource hierarchy. Patient, Encounter, Observation, Condition, MedicationRequest as core; secondary resources layered on. 2. References vs contained. When to reference by URL vs embed with contained[]. 3. Extensions. Standard vs custom; how to reference StructureDefinitions. 4. Meta.lastUpdated + versioning. How versioning works with ETag/If-Match.

Days 31-60: REST API mechanics

1. HTTP verbs and semantics. GET vs POST vs PUT; conditional creates; Bundle transactions. 2. Search parameters. Basic, chained, reverse-chained, _include, _revinclude. 3. **Bulk data `$export`. Async operation semantics, manifest structure, output storage. 4. Search parameter definitions.** How custom search parameters get defined.

Days 61-90: Profiles and IGs

1. US Core profile suite. What conformance means and how it's verified. 2. Terminology bindings. ValueSets, CodeSystems, ConceptMaps. 3. **Inferno conformance testing. How to run and interpret results. 4. Da Vinci and CMS-0057 context.** What regulatory context shapes the profile choices.

Learning resources

Source Best for
HL7 FHIR spec (R4) Reference
SMART tutorials Auth patterns
FHIR chat Community Q&A
Vendor tutorials (Aidbox, Medplum, HAPI) Product-specific

Common misconceptions

1. "FHIR is just JSON." It's a specification with profiles, terminology, and conformance. 2. "US Core = all US healthcare." It's a baseline; Da Vinci profiles extend for specific use cases. 3. "FHIR replaces HL7v2." v2 is still the dominant integration surface; FHIR complements.

FHIR fluency compounds. The first 90 days of focused study pays off for years.