Dec 2025 Published version that is used by CCDA and other guides - incorporates fixes and new sdtc extensions.
RelatedIgs
(None Found)
This release is labelled as a milestone, so should not have a patch version (2.0.2-sd)
The sequence 'CDA 2.1' has already been closed with a current publication, and a new sequence 'CDA 2.1' started - is going back to 'CDA 2.0' really what's intended?
The jira specification file appears to be out of date with the versions, artifacts and pages currently defined in the IG. A proposed revised file to be reviewed and, if appropriate, submitted as a pull request against the XML folder in https://github.com/HL7/JIRA-Spec-Artifacts. To see the differences, perform a file compare on 'template/jira-current.xml' (a normalized view of what is in Github) and 'template/jira-new.xml' (reflects current IG content)
Error from https://tx.fhir.org/r5: A definition for CodeSystem 'http://terminology.hl7.org/CodeSystem/v3-ActCode' version '7.0.0' could not be found, so the value set cannot be expanded. Valid versions: 9.0.0,9.0.0
Editor's Comment: We are using versions of a code system from an older version of THO that tx.fhir.org does not support (from server, see log)
The code 'CASESBJ' is not valid in the system http://terminology.hl7.org/CodeSystem/v3-RoleClass (Unknown code 'CASESBJ' in the CodeSystem 'http://terminology.hl7.org/CodeSystem/v3-RoleClass' version '3.1.0')
Editor's Comment: CASESBJ is the actual code. CASEBJ is what is in THO but that has been verified to be wrong.VALUESET_INCLUDE_INVALID_CONCEPT_CODE
The code 'CASESBJ' is not valid in the system http://terminology.hl7.org/CodeSystem/v3-RoleClass (Unknown code 'CASESBJ' in the CodeSystem 'http://terminology.hl7.org/CodeSystem/v3-RoleClass' version '3.1.0')
Editor's Comment: CASESBJ is the actual code. CASEBJ is what is in THO but that has been verified to be wrong.VALUESET_INCLUDE_INVALID_CONCEPT_CODE
The code 'CASESBJ' is not valid in the system http://terminology.hl7.org/CodeSystem/v3-RoleClass (Unknown code 'CASESBJ' in the CodeSystem 'http://terminology.hl7.org/CodeSystem/v3-RoleClass' version '3.1.0')
Editor's Comment: CASESBJ is the actual code. CASEBJ is what is in THO but that has been verified to be wrong.VALUESET_INCLUDE_INVALID_CONCEPT_CODE
The code 'CASESBJ' is not valid in the system http://terminology.hl7.org/CodeSystem/v3-RoleClass (Unknown code 'CASESBJ' in the CodeSystem 'http://terminology.hl7.org/CodeSystem/v3-RoleClass' version '3.1.0')
Editor's Comment: CASESBJ is the actual code. CASEBJ is what is in THO but that has been verified to be wrong.VALUESET_INCLUDE_INVALID_CONCEPT_CODE
No definition could be found for URL value 'http://hl7.org/fhir/StructureDefinition/implementationguide-resource-format' (1 uses)
Reference to experimental CodeSystem http://hl7.org/fhir/guide-parameter-code|5.0.0 (15 uses)
The extension http://hl7.org/fhir/StructureDefinition/implementationguide-resource-format could not be found so is not allowed here (1 uses)
A number of concepts that have been deprecated but are still used in CDA
The concept 'CASE' is deprecated and its use should be reviewed (2 uses)
The concept 'CNOD' is deprecated and its use should be reviewed (2 uses)
The concept 'DIET' is deprecated and its use should be reviewed (1 uses)
The concept 'ENTRY' has a status of retired and its use should be reviewed (1 uses)
The concept 'EVN.CRT' is deprecated and its use should be reviewed (1 uses)
The concept 'MS' is deprecated and its use should be reviewed (1 uses)
The concept 'NP' has a status of retired and its use should be reviewed (1 uses)
The concept 'ORGANIZER' has a status of retired and its use should be reviewed (1 uses)
The concept 'OUTB' is deprecated and its use should be reviewed (2 uses)
The concept 'VS' is deprecated and its use should be reviewed (1 uses)
CASESBJ is the actual code. CASEBJ is what is in THO but that has been verified to be wrong.
The code 'CASESBJ' is not valid in the system http://terminology.hl7.org/CodeSystem/v3-RoleClass% (4 uses)
CDA type names are UpperCamelCase
Constraint failed: eld-20: 'The first component of the path should be UpperCamelCase.% (134 uses)
CDA type names have _ in them
Constraint failed: cnl-0: 'Name should be usable as an identifier for the module by machine processing applications such as code generation (name.exists() implies name.matches('^[A-Z]([A-Za-z0-9_]){1,254}$'))' (defined in http://hl7.org/fhir/StructureDefinition/StructureDefinition) (15 uses)
Ignore duplicate anchor ids for now
The html source has duplicate anchor Ids:% (139 uses)
The resource should not be deprecated
Resource is not deprecated, but the description mentions deprecated - check whether it should be deprecated (2 uses)
This extension is used in the base FHIR spec
The extension http://hl7.org/fhir/StructureDefinition/regex|5.2.0 is deprecated with the note: 'This was deprecated in favor of using a constraint on the element using FHIRPath, since constraints allow for the provision of a human readable message associated with the regex' (1 uses)
Warnings from the example CDA document
A code with no system has no defined meaning, and it cannot be validated. A system should be provided (1 uses)
No definition could be found for URL value 'HTN.cda' (1 uses)
No definition could be found for URL value 'lefthand.gif' (1 uses)
The CDA Template 2.16.840.1.113883.10.20.22.1.4 / 2024-05-01 is not known (1 uses)
The CDA Template 2.16.840.1.113883.10.20.22.2.10 / 2014-06-09 is not known (1 uses)
The concept '78615007' has a status of inactive and its use should be reviewed (4 uses)
The concept 'COND' is deprecated and its use should be reviewed (10 uses)
The concept 'SUBS' is deprecated and its use should be reviewed (2 uses)
xsi:type is unnecessary at this point (3 uses)
We are included an example of an HTML tag in the description
No definition could be found for URL value 'http://hl7.org/cda/stds/core/StructureDefinition/IVL_TS' (2 uses)
The markdown contains content that appears to be an embedded HTML tag starting at '<r'. This will (or SHOULD) be escaped by the presentation layer. The content should be checked to confirm that this is the desired behaviour (0 uses)
We are using versions of a code system from an older version of THO that tx.fhir.org does not support
Error from https://tx.fhir.org/r5: A definition for CodeSystem 'http://terminology.hl7.org/CodeSystem/v3-ActCode' version '7.0.0' could not be found, so the value set cannot be expanded. Valid versions: 9.0.0,9.0.0 (1 uses)
Error from https://tx.fhir.org/r5: A definition for CodeSystem 'http://terminology.hl7.org/CodeSystem/v3-AddressUse' version '2.1.0' could not be found, so the value set cannot be expanded. Valid versions: 3.0.1,3.0.1 (0 uses)
Error from https://tx.fhir.org/r5: A definition for CodeSystem 'http://terminology.hl7.org/CodeSystem/v3-CompressionAlgorithm' version '2.1.1' could not be found, so the value set cannot be expanded. Valid versions: 3.0.0,3.0.0 (0 uses)
Error from https://tx.fhir.org/r5: A definition for CodeSystem 'http://terminology.hl7.org/CodeSystem/v3-EntityNameUse' version '2.1.0' could not be found, so the value set cannot be expanded. Valid versions: 3.0.0,3.0.0 (0 uses)
Error from https://tx.fhir.org/r5: A definition for CodeSystem 'http://terminology.hl7.org/CodeSystem/v3-NullFlavor' version '2.1.0' could not be found, so the value set cannot be expanded. Valid versions: 3.0.0,3.0.0 (0 uses)
Error from https://tx.fhir.org/r5: A definition for CodeSystem 'http://terminology.hl7.org/CodeSystem/v3-ParticipationSignature' version '2.1.0' could not be found, so the value set cannot be expanded. Valid versions: 3.0.0,3.0.0 (0 uses)
Error from https://tx.fhir.org/r5: A definition for CodeSystem 'http://terminology.hl7.org/CodeSystem/v3-RoleClass' version '3.1.0' could not be found, so the value set cannot be expanded. Valid versions: 4.0.0,4.0.0 (0 uses)
Error from https://tx.fhir.org/r5: A definition for CodeSystem 'http://terminology.hl7.org/CodeSystem/v3-TimingEvent' version '2.1.0' could not be found, so the value set cannot be expanded. Valid versions: 3.0.0,3.0.0 (0 uses)
The concepts in the value set include have not been validated because the code system is not known, and no terminology service supports it (1 uses)
We need this version of hl7.terminology
The ImplementationGuide uses package hl7.terminology.r5#5.2.0 released on 2023-07-17, but the most recent appropriate version is 7.0.0. This reference is getting old and the more recent version should be considered (1 uses)
We want to fix a bunch of coded fields
Constraint failed: eld-24: 'pattern[x] should be used rather than fixed[x] (fixed.exists().not())' (defined in http://hl7.org/fhir/StructureDefinition/ElementDefinition) (Best Practice Recommendation) (439 uses)
The code 'CASESBJ' is not valid in the system http://terminology.hl7.org/CodeSystem/v3-RoleClass (Unknown code 'CASESBJ' in the CodeSystem 'http://terminology.hl7.org/CodeSystem/v3-RoleClass' version '3.1.0')
The code 'CASESBJ' is not valid in the system http://terminology.hl7.org/CodeSystem/v3-RoleClass (Unknown code 'CASESBJ' in the CodeSystem 'http://terminology.hl7.org/CodeSystem/v3-RoleClass' version '3.1.0')
The code 'CASESBJ' is not valid in the system http://terminology.hl7.org/CodeSystem/v3-RoleClass (Unknown code 'CASESBJ' in the CodeSystem 'http://terminology.hl7.org/CodeSystem/v3-RoleClass' version '3.1.0')
The code 'CASESBJ' is not valid in the system http://terminology.hl7.org/CodeSystem/v3-RoleClass (Unknown code 'CASESBJ' in the CodeSystem 'http://terminology.hl7.org/CodeSystem/v3-RoleClass' version '3.1.0')