FHIR CI-Build

This is the Continuous Integration Build of FHIR (will be incorrect/inconsistent at times).
See the Directory of published versions icon

FHIR Infrastructure icon Work GroupMaturity Level: N/AStandards Status: Informative

Note to Balloters: The R4 / R5 version comparison information is updated prior to publication of the final copy of R5. At this point in time (ballot) it has not been updated. Ballot comments concerning this information are welcome to identify issues, but will not be counted as negative.

In addition to a list of all differences between R4 and R5, this specification also provides transforms between R4 and R5 for most resources that were in R5. These transforms are expressed using the FHIR Mapping Language, and both serve as formal documentation of the relationship between the resource structures in R4 and R5, and can also be used to convert between the formats automatically.

The following table summarizes the state of the R5:R5 maps for each resource type.

Note the following:

  • Transforms are tested using the following method:
    1. For each example resource in the R4 release of the FHIR specification that has a transform to R5
    2. apply the transform to R5
    3. validate against the R5 specification
    4. apply the reverse transform back to R4
    5. compare the outcome with the original resource - ideally, it should be identical
  • All transforms should execute - that is, they should be able to take any R4 resource, represent the content in R5, and then generate an R4 representation for the same content. Note, though, that in a few cases, the differences between R4 and R5 designs are so significant that not all examples can be successfully transformed at all.
  • For some resources, the differences in design between R4 and R5 are sufficiently great that the R4 examples cannot reproduce the same output after conversion to R5 and then back to R4. For example, the R5 resource may have a different set of status codes with imperfect maps
  • For some resources, the information available in the R4 examples is not enough to generate valid R5 resources, and so the resources generate R5 validation errors. (e.g. R4 resources missing an element that is required in R5)
  • The transform scripts are only tested to the degree that R4 provided example data
  • For all these reasons, the maps provided in the specification are not authoritative; they are provided to help implementers who need to convert between the R2 and R4 format, but additional revision may be required in an implementation specific context
  • The maps are subject to ongoing maintenance using the FHIR NPM Package icon "fhir.versions.r3r4" which is maintained on GitHub icon. See also FHIR Wiki icon for other ongoing work to support R4/R5 transformations
Resource # Tests % Execute OK % RoundTrip Ok % R5 Valid R5 Error Count
Account21000100
ActivityDefinition9100770
ActorDefinitionNo r3:r4 maps available
AdministrableProductDefinitionNo r3:r4 maps available
AdverseEvent110000
AllergyIntolerance3100100100
Appointment3100100100
AppointmentResponse2100100100
ArtifactAssessmentNo r3:r4 maps available
AuditEvent8100100100
Basic3100100100
Binary2100100100
BiologicallyDerivedProductNo r3:r4 maps available
BodyStructure3100100100
Bundle28898836
CapabilityStatement9100880
CarePlan111001009
CareTeam11001000
ChargeItem1100100100
ChargeItemDefinitionNo r3:r4 maps available
CitationNo r3:r4 maps available
Claim1681076
ClaimResponse110000
ClinicalImpression1100100100
ClinicalUseDefinitionNo r3:r4 maps available
CodeSystem410010025
Communication310010033
CommunicationRequest210010050
CompartmentDefinition61008316
Composition1100100100
ConceptMap41001000
Condition1210010091
ConditionDefinitionNo r3:r4 maps available
Consent121001000
Contract72850-150
Coverage410075100
CoverageEligibilityRequestNo r3:r4 maps available
CoverageEligibilityResponseNo r3:r4 maps available
DetectedIssue4100100100
Device910010088
DeviceDefinitionNo r3:r4 maps available
DeviceDispenseNo r3:r4 maps available
DeviceMetric1100100100
DeviceRequest2100050
DeviceUsageNo r3:r4 maps available
DiagnosticReport1410010035
DocumentManifest2000
DocumentReference1000
Encounter1010010070
Endpoint3100100100
EnrollmentRequest11000100
EnrollmentResponse1100100100
EpisodeOfCare1100100100
EventDefinitionNo r3:r4 maps available
EvidenceNo r3:r4 maps available
EvidenceReportNo r3:r4 maps available
EvidenceVariableNo r3:r4 maps available
ExampleScenarioNo r3:r4 maps available
ExplanationOfBenefit110000
FamilyMemberHistory210010050
Flag2100100100
FormularyItemNo r3:r4 maps available
GenomicStudyNo r3:r4 maps available
Goal2100100100
GraphDefinition11001000
Group2100100100
GuidanceResponse1100100100
HealthcareService11001000
ImagingSelectionNo r3:r4 maps available
ImagingStudy2100500
Immunization31001000
ImmunizationEvaluationNo r3:r4 maps available
ImmunizationRecommendation1100100100
ImplementationGuide11001000
IngredientNo r3:r4 maps available
InsurancePlanNo r3:r4 maps available
InventoryReportNo r3:r4 maps available
InvoiceNo r3:r4 maps available
Library111001000
Linkage1100100100
List910010044
Location610010083
ManufacturedItemDefinitionNo r3:r4 maps available
Measure61001000
MeasureReport31001000
Medication2310044
MedicationAdministration14100710
MedicationDispense31100800
MedicationKnowledgeNo r3:r4 maps available
MedicationRequest36100770
MedicationUsageNo r3:r4 maps available
MedicinalProductDefinitionNo r3:r4 maps available
MessageDefinition310010033
MessageHeader11001000
MolecularSequence14100100100
NamingSystem3100660
NutritionIntakeNo r3:r4 maps available
NutritionOrder131001000
NutritionProductNo r3:r4 maps available
Observation4810010052
ObservationDefinitionNo r3:r4 maps available
OperationDefinition371001008
OperationOutcome6100100100
Organization1110010090
OrganizationAffiliationNo r3:r4 maps available
PackagedProductDefinitionNo r3:r4 maps available
Patient16100100100
PaymentNotice110000
PaymentReconciliation110000
PermissionNo r3:r4 maps available
Person5100100100
PlanDefinition11451000
Practitioner14100100100
PractitionerRole1100100100
Procedure151008093
Provenance510010060
Questionnaire610010016
QuestionnaireResponse5100800
RegulatedAuthorizationNo r3:r4 maps available
RelatedPerson4100100100
RequestOrchestrationNo r3:r4 maps available
RequirementsNo r3:r4 maps available
ResearchStudy1100100100
ResearchSubject1100100100
RiskAssessment410010025
Schedule3100100100
SearchParameter31001000
ServiceRequestNo r3:r4 maps available
Slot4100100100
Specimen410010050
SpecimenDefinitionNo r3:r4 maps available
StructureDefinition206100980
StructureMap210010050
Subscription21000100
SubscriptionStatusNo r3:r4 maps available
SubscriptionTopicNo r3:r4 maps available
Substance610010083
SubstanceDefinitionNo r3:r4 maps available
SubstanceNucleicAcidNo r3:r4 maps available
SubstancePolymerNo r3:r4 maps available
SubstanceProteinNo r3:r4 maps available
SubstanceReferenceInformationNo r3:r4 maps available
SubstanceSourceMaterialNo r3:r4 maps available
SupplyDelivery2100100100
SupplyRequest11001000
Task61005083
TerminologyCapabilitiesNo r3:r4 maps available
TestReport1100100100
TestScript7100850
TransportNo r3:r4 maps available
ValueSet81001000
VerificationResultNo r3:r4 maps available
VisionPrescription2100500