Smile CDR v2024.08.PRE
On this page:

6.19.1FHIR versions

This page discusses FHIR versions, meaning the different versions of the FHIR Standard itself. For information about FHIR resource versions, see Resource Versions.

HL7 FHIR is not a backwards- or forwards-compatible standard overall, although portions of the specification have been marked as "normative". Normative sections are considered permanently stable and will not have breaking changes applied to them. The Patient resource (as of FHIR R4) is an example of a Normative resource.

Smile CDR fully supports all released versions of FHIR from the DSTU2 release onward, and can also support draft (pre-release) resource definitions as well. When starting a new project and configuring a FHIR repository, a FHIR version must be selected. If you are implementing an Implementation Guide (e.g. the CARIN Consumer Directed Payer Data Exchange), then this IG will dictate the version of FHIR that you should select. FHIR version R4 is the most widely used version of FHIR, and is the default version for new repositories.

An ongoing avenue of discussion in the FHIR community revolves around how to support new versions of the specification. Smile CDR is actively participating in these discussions, and has developed code to convert data automatically between versions of FHIR. We make the FHIR Versioned API Mode available via a simple configuration switch, which provides automatic conversion using community-maintained translations. We are also considering a "data at rest" converter that will allow incremental upgrades to data in place. This is not as pressing a concern as it might seem however, as real-world experience shows that working systems rarely need FHIR version upgrades, and in fact this is often explicitly forbidden either by regulation or by policy.