Consolidated CDA (C-CDA), published by Health Level Seven. This guide is not an authorized publication; it is the continuous build for version 4.0.0 built by the FHIR (HL7® FHIR® Standard) CI Build. This version is based on the current content of https://github.com/HL7/CDA-ccda/ and changes regularly. See the Directory of published versions
Official URL: http://hl7.org/cda/us/ccda/StructureDefinition/AllergyIntoleranceObservation | Version: 4.0.0 | |||
Draft as of 2025-10-02 | Computable Name: AllergyIntoleranceObservation | |||
Other Identifiers: urn:ietf:rfc:3986#Uniform Resource Identifier (URI)#urn:hl7ii:2.16.840.1.113883.10.20.22.4.7:2014-06-09 |
This template reflects a discrete observation about a patient's allergy or intolerance. Because it is a discrete observation, it will have a statusCode of "completed". The effectiveTime, also referred to as the "biologically relevant time" is the time at which the observation holds for the patient. For a provider seeing a patient in the clinic today, observing a history of penicillin allergy that developed five years ago, the effectiveTime is five years ago.
The effectiveTime of the Allergy - Intolerance Observation is the definitive indication of whether or not the underlying allergy/intolerance is resolved. If known to be resolved, then an effectiveTime/high would be present. If the date of resolution is not known, then effectiveTime/high will be present with a nullFlavor of "UNK".
The agent responsible for an allergy or adverse reaction is not always a manufactured material (for example, food allergies), nor is it necessarily consumed. The following constraints reflect limitations in the base CDA R2 specification, and should be used to represent any type of responsible agent, i.e., use playingEntity classCode = "MMAT" for all agents, manufactured or not.
Usages:
You can also check for usages in the FHIR IG Statistics
Changes since version 3.0.0:
Description of Template, Differentials, Snapshots and how the different presentations work.
This structure is derived from SubstanceOrDeviceAllergyIntoleranceObservation
Name | Flags | Card. | Type | Description & Constraints Filter: ![]() ![]() |
---|---|---|---|---|
![]() ![]() |
SubstanceOrDeviceAllergyIntoleranceObservation | XML Namespace: urn:hl7-org:v3 Instance of this type are validated by templateId Logical Container: ClinicalDocument (CDA Class) | ||
![]() ![]() ![]() |
2..* | II | ||
![]() ![]() ![]() |
Content/Rules for all slices | |||
![]() ![]() ![]() ![]() |
1..1 | II | ||
![]() ![]() ![]() ![]() ![]() |
1..1 | oid, uuid, ruid | Required Pattern: 2.16.840.1.113883.10.20.22.4.7 | |
![]() ![]() ![]() ![]() ![]() |
1..1 | st | Required Pattern: 2014-06-09 | |
![]() ![]() ![]() |
0..1 | bl | Use negationInd="true" to indicate that the allergy was not observed. | |
![]() ![]() ![]() |
1..1 | IVL_TS | If the allergy/intolerance is known to be resolved, but the date of resolution is not known, then the high element SHALL be present, and the nullFlavor attribute SHALL be set to 'UNK'. | |
![]() ![]() ![]() |
Content/Rules for all slices | |||
![]() ![]() ![]() ![]() |
0..* | Participant2 | participant | |
![]() ![]() ![]() ![]() ![]() |
||||
![]() ![]() ![]() ![]() ![]() ![]() |
||||
![]() ![]() ![]() ![]() ![]() ![]() ![]() |
1..1 | CE | 𝗨𝗦𝗖𝗗𝗜: Substance Binding: Common substances for allergy and intolerance documentation including refutations ![]() | |
![]() |
Path | Status | Usage | ValueSet | Version | Source |
Observation.participant:consumable.participantRole.playingEntity.code | Base | preferred |
Common substances for allergy and intolerance documentation including refutations
![]() |
📦20240625 | VSAC v0.23 |
Path | Status | Usage | ValueSet | Version | Source |
Observation.nullFlavor | Base | required | CDANullFlavor | 📦2.0.1-sd | Clinical Document Architecture v2.0 |
Observation.typeId.nullFlavor | Base | required | CDANullFlavor | 📦2.0.1-sd | Clinical Document Architecture v2.0 |
Observation.templateId:substance-device-allergy-intolerance-obs.nullFlavor | Base | required | CDANullFlavor | 📦2.0.1-sd | Clinical Document Architecture v2.0 |
Observation.templateId:allergy.nullFlavor | Base | required | CDANullFlavor | 📦2.0.1-sd | Clinical Document Architecture v2.0 |
Observation.classCode | Base | required | CDAActClassObservation | 📦2.0.1-sd | Clinical Document Architecture v2.0 |
Observation.moodCode | Base | required | x_ActMoodDocumentObservation | 📍2.0.0 | THO v5.2 |
Observation.code | Base | example | ObservationType | 📦3.0.0 | THO v6.5 |
Observation.code.nullFlavor | Base | required | CDANullFlavor | 📦2.0.1-sd | Clinical Document Architecture v2.0 |
Observation.text.nullFlavor | Base | required | CDANullFlavor | 📦2.0.1-sd | Clinical Document Architecture v2.0 |
Observation.text.compression | Base | required | CDACompressionAlgorithm | 📦2.0.1-sd | Clinical Document Architecture v2.0 |
Observation.text.integrityCheckAlgorithm | Base | required | IntegrityCheckAlgorithm | 📍2.0.0 | THO v5.2 |
Observation.text.mediaType | Base | example | MediaType | 📦3.0.0 | THO v6.5 |
Observation.text.representation | Base | required | CDABinaryDataEncoding | 📦2.0.1-sd | Clinical Document Architecture v2.0 |
Observation.statusCode | Base | required | ActStatus | 📦3.0.0 | THO v6.5 |
Observation.statusCode.nullFlavor | Base | required | CDANullFlavor | 📦2.0.1-sd | Clinical Document Architecture v2.0 |
Observation.effectiveTime.nullFlavor | Base | required | CDANullFlavor | 📦2.0.1-sd | Clinical Document Architecture v2.0 |
Observation.effectiveTime.operator | Base | required | CDASetOperator | 📦2.0.1-sd | Clinical Document Architecture v2.0 |
Observation.priorityCode | Base | example | ActPriority | 📦3.0.0 | THO v6.5 |
Observation.languageCode | Base | required | All Languages | 📦5.0.0 | FHIR Std. |
Observation.value.code | Base | required |
Allergy and Intolerance Type
![]() |
📦20240606 | VSAC v0.23 |
Observation.interpretationCode | Base | required | CDAObservationInterpretation | 📦2.0.1-sd | Clinical Document Architecture v2.0 |
Observation.methodCode | Base | example | ObservationMethod | 📦3.0.0 | THO v6.5 |
Observation.participant:consumable.nullFlavor | Base | required | CDANullFlavor | 📦2.0.1-sd | Clinical Document Architecture v2.0 |
Observation.participant:consumable.typeId.nullFlavor | Base | required | CDANullFlavor | 📦2.0.1-sd | Clinical Document Architecture v2.0 |
Observation.participant:consumable.typeCode | Base | required | CDAParticipationType | 📦2.0.1-sd | Clinical Document Architecture v2.0 |
Observation.participant:consumable.contextControlCode | Base | required | CDAContextControl | 📦2.0.1-sd | Clinical Document Architecture v2.0 |
Observation.participant:consumable.participantRole.nullFlavor | Base | required | CDANullFlavor | 📦2.0.1-sd | Clinical Document Architecture v2.0 |
Observation.participant:consumable.participantRole.typeId.nullFlavor | Base | required | CDANullFlavor | 📦2.0.1-sd | Clinical Document Architecture v2.0 |
Observation.participant:consumable.participantRole.classCode | Base | required | CDARoleClassRoot | 📦2.0.1-sd | Clinical Document Architecture v2.0 |
Observation.participant:consumable.participantRole.code | Base | example | CDARoleCode | 📦2.0.1-sd | Clinical Document Architecture v2.0 |
Observation.participant:consumable.participantRole.playingEntity.nullFlavor | Base | required | CDANullFlavor | 📦2.0.1-sd | Clinical Document Architecture v2.0 |
Observation.participant:consumable.participantRole.playingEntity.typeId.nullFlavor | Base | required | CDANullFlavor | 📦2.0.1-sd | Clinical Document Architecture v2.0 |
Observation.participant:consumable.participantRole.playingEntity.classCode | Base | required | EntityClassRoot | 📦3.0.0 | THO v6.5 |
Observation.participant:consumable.participantRole.playingEntity.determinerCode | Base | required | EntityDeterminer | 📦3.0.0 | THO v6.5 |
Observation.participant:consumable.participantRole.playingEntity.code | Base | preferred |
Common substances for allergy and intolerance documentation including refutations
![]() |
📦20240625 | VSAC v0.23 |
Observation.entryRelationship:status.nullFlavor | Base | required | CDANullFlavor | 📦2.0.1-sd | Clinical Document Architecture v2.0 |
Observation.entryRelationship:status.typeId.nullFlavor | Base | required | CDANullFlavor | 📦2.0.1-sd | Clinical Document Architecture v2.0 |
Observation.entryRelationship:status.typeCode | Base | required | x_ActRelationshipEntryRelationship | 📦3.0.0 | THO v6.5 |
Observation.entryRelationship:reaction.nullFlavor | Base | required | CDANullFlavor | 📦2.0.1-sd | Clinical Document Architecture v2.0 |
Observation.entryRelationship:reaction.typeId.nullFlavor | Base | required | CDANullFlavor | 📦2.0.1-sd | Clinical Document Architecture v2.0 |
Observation.entryRelationship:reaction.typeCode | Base | required | x_ActRelationshipEntryRelationship | 📦3.0.0 | THO v6.5 |
Observation.entryRelationship:severity.nullFlavor | Base | required | CDANullFlavor | 📦2.0.1-sd | Clinical Document Architecture v2.0 |
Observation.entryRelationship:severity.typeId.nullFlavor | Base | required | CDANullFlavor | 📦2.0.1-sd | Clinical Document Architecture v2.0 |
Observation.entryRelationship:severity.typeCode | Base | required | x_ActRelationshipEntryRelationship | 📦3.0.0 | THO v6.5 |
Observation.entryRelationship:criticality.nullFlavor | Base | required | CDANullFlavor | 📦2.0.1-sd | Clinical Document Architecture v2.0 |
Observation.entryRelationship:criticality.typeId.nullFlavor | Base | required | CDANullFlavor | 📦2.0.1-sd | Clinical Document Architecture v2.0 |
Observation.entryRelationship:criticality.typeCode | Base | required | x_ActRelationshipEntryRelationship | 📦3.0.0 | THO v6.5 |
Observation.referenceRange.nullFlavor | Base | required | CDANullFlavor | 📦2.0.1-sd | Clinical Document Architecture v2.0 |
Observation.referenceRange.typeId.nullFlavor | Base | required | CDANullFlavor | 📦2.0.1-sd | Clinical Document Architecture v2.0 |
Observation.referenceRange.typeCode | Base | required | CDAActRelationshipType | 📦2.0.1-sd | Clinical Document Architecture v2.0 |
Id | Grade | Path(s) | Description | Expression |
II-1 | error | Observation.typeId, Observation.participant:consumable.typeId, Observation.participant:consumable.participantRole.typeId, Observation.participant:consumable.participantRole.playingEntity.typeId, Observation.entryRelationship:status.typeId, Observation.entryRelationship:reaction.typeId, Observation.entryRelationship:severity.typeId, Observation.entryRelationship:criticality.typeId, Observation.referenceRange.typeId | An II instance must have either a root or an nullFlavor. |
root.exists() or nullFlavor.exists()
|
should-author | warning | Observation | SHOULD contain author |
author.exists()
|
should-not-severity | warning | Observation | Allergy SHOULD NOT include severity. Severity belongs at reaction level, while Criticality is used at the allergy level. |
entryRelationship.observation.where(code.code = 'SEV' and code.codeSystem = '2.16.840.1.113883.5.4').empty()
|
should-text-ref-value | warning | Observation | SHOULD contain text/reference/@value |
text.reference.value.exists()
|
value-starts-octothorpe | error | Observation.text.reference | If reference/@value is present, it SHALL begin with a '#' and SHALL point to its corresponding narrative |
value.exists() implies value.startsWith('#')
|
Path | Status | Usage | ValueSet | Version | Source |
Observation.nullFlavor | Base | required | CDANullFlavor | 📦2.0.1-sd | Clinical Document Architecture v2.0 |
Observation.typeId.nullFlavor | Base | required | CDANullFlavor | 📦2.0.1-sd | Clinical Document Architecture v2.0 |
Observation.templateId:substance-device-allergy-intolerance-obs.nullFlavor | Base | required | CDANullFlavor | 📦2.0.1-sd | Clinical Document Architecture v2.0 |
Observation.templateId:allergy.nullFlavor | Base | required | CDANullFlavor | 📦2.0.1-sd | Clinical Document Architecture v2.0 |
Observation.classCode | Base | required | CDAActClassObservation | 📦2.0.1-sd | Clinical Document Architecture v2.0 |
Observation.moodCode | Base | required | x_ActMoodDocumentObservation | 📍2.0.0 | THO v5.2 |
Observation.code | Base | example | ObservationType | 📦3.0.0 | THO v6.5 |
Observation.code.nullFlavor | Base | required | CDANullFlavor | 📦2.0.1-sd | Clinical Document Architecture v2.0 |
Observation.text.nullFlavor | Base | required | CDANullFlavor | 📦2.0.1-sd | Clinical Document Architecture v2.0 |
Observation.text.compression | Base | required | CDACompressionAlgorithm | 📦2.0.1-sd | Clinical Document Architecture v2.0 |
Observation.text.integrityCheckAlgorithm | Base | required | IntegrityCheckAlgorithm | 📍2.0.0 | THO v5.2 |
Observation.text.mediaType | Base | example | MediaType | 📦3.0.0 | THO v6.5 |
Observation.text.representation | Base | required | CDABinaryDataEncoding | 📦2.0.1-sd | Clinical Document Architecture v2.0 |
Observation.statusCode | Base | required | ActStatus | 📦3.0.0 | THO v6.5 |
Observation.statusCode.nullFlavor | Base | required | CDANullFlavor | 📦2.0.1-sd | Clinical Document Architecture v2.0 |
Observation.effectiveTime.nullFlavor | Base | required | CDANullFlavor | 📦2.0.1-sd | Clinical Document Architecture v2.0 |
Observation.effectiveTime.operator | Base | required | CDASetOperator | 📦2.0.1-sd | Clinical Document Architecture v2.0 |
Observation.priorityCode | Base | example | ActPriority | 📦3.0.0 | THO v6.5 |
Observation.languageCode | Base | required | All Languages | 📦5.0.0 | FHIR Std. |
Observation.value.code | Base | required |
Allergy and Intolerance Type
![]() |
📦20240606 | VSAC v0.23 |
Observation.interpretationCode | Base | required | CDAObservationInterpretation | 📦2.0.1-sd | Clinical Document Architecture v2.0 |
Observation.methodCode | Base | example | ObservationMethod | 📦3.0.0 | THO v6.5 |
Observation.participant:consumable.nullFlavor | Base | required | CDANullFlavor | 📦2.0.1-sd | Clinical Document Architecture v2.0 |
Observation.participant:consumable.typeId.nullFlavor | Base | required | CDANullFlavor | 📦2.0.1-sd | Clinical Document Architecture v2.0 |
Observation.participant:consumable.typeCode | Base | required | CDAParticipationType | 📦2.0.1-sd | Clinical Document Architecture v2.0 |
Observation.participant:consumable.contextControlCode | Base | required | CDAContextControl | 📦2.0.1-sd | Clinical Document Architecture v2.0 |
Observation.participant:consumable.participantRole.nullFlavor | Base | required | CDANullFlavor | 📦2.0.1-sd | Clinical Document Architecture v2.0 |
Observation.participant:consumable.participantRole.typeId.nullFlavor | Base | required | CDANullFlavor | 📦2.0.1-sd | Clinical Document Architecture v2.0 |
Observation.participant:consumable.participantRole.classCode | Base | required | CDARoleClassRoot | 📦2.0.1-sd | Clinical Document Architecture v2.0 |
Observation.participant:consumable.participantRole.code | Base | example | CDARoleCode | 📦2.0.1-sd | Clinical Document Architecture v2.0 |
Observation.participant:consumable.participantRole.playingEntity.nullFlavor | Base | required | CDANullFlavor | 📦2.0.1-sd | Clinical Document Architecture v2.0 |
Observation.participant:consumable.participantRole.playingEntity.typeId.nullFlavor | Base | required | CDANullFlavor | 📦2.0.1-sd | Clinical Document Architecture v2.0 |
Observation.participant:consumable.participantRole.playingEntity.classCode | Base | required | EntityClassRoot | 📦3.0.0 | THO v6.5 |
Observation.participant:consumable.participantRole.playingEntity.determinerCode | Base | required | EntityDeterminer | 📦3.0.0 | THO v6.5 |
Observation.participant:consumable.participantRole.playingEntity.code | Base | preferred |
Common substances for allergy and intolerance documentation including refutations
![]() |
📦20240625 | VSAC v0.23 |
Observation.entryRelationship:status.nullFlavor | Base | required | CDANullFlavor | 📦2.0.1-sd | Clinical Document Architecture v2.0 |
Observation.entryRelationship:status.typeId.nullFlavor | Base | required | CDANullFlavor | 📦2.0.1-sd | Clinical Document Architecture v2.0 |
Observation.entryRelationship:status.typeCode | Base | required | x_ActRelationshipEntryRelationship | 📦3.0.0 | THO v6.5 |
Observation.entryRelationship:reaction.nullFlavor | Base | required | CDANullFlavor | 📦2.0.1-sd | Clinical Document Architecture v2.0 |
Observation.entryRelationship:reaction.typeId.nullFlavor | Base | required | CDANullFlavor | 📦2.0.1-sd | Clinical Document Architecture v2.0 |
Observation.entryRelationship:reaction.typeCode | Base | required | x_ActRelationshipEntryRelationship | 📦3.0.0 | THO v6.5 |
Observation.entryRelationship:severity.nullFlavor | Base | required | CDANullFlavor | 📦2.0.1-sd | Clinical Document Architecture v2.0 |
Observation.entryRelationship:severity.typeId.nullFlavor | Base | required | CDANullFlavor | 📦2.0.1-sd | Clinical Document Architecture v2.0 |
Observation.entryRelationship:severity.typeCode | Base | required | x_ActRelationshipEntryRelationship | 📦3.0.0 | THO v6.5 |
Observation.entryRelationship:criticality.nullFlavor | Base | required | CDANullFlavor | 📦2.0.1-sd | Clinical Document Architecture v2.0 |
Observation.entryRelationship:criticality.typeId.nullFlavor | Base | required | CDANullFlavor | 📦2.0.1-sd | Clinical Document Architecture v2.0 |
Observation.entryRelationship:criticality.typeCode | Base | required | x_ActRelationshipEntryRelationship | 📦3.0.0 | THO v6.5 |
Observation.referenceRange.nullFlavor | Base | required | CDANullFlavor | 📦2.0.1-sd | Clinical Document Architecture v2.0 |
Observation.referenceRange.typeId.nullFlavor | Base | required | CDANullFlavor | 📦2.0.1-sd | Clinical Document Architecture v2.0 |
Observation.referenceRange.typeCode | Base | required | CDAActRelationshipType | 📦2.0.1-sd | Clinical Document Architecture v2.0 |
Id | Grade | Path(s) | Description | Expression |
II-1 | error | Observation.typeId, Observation.participant:consumable.typeId, Observation.participant:consumable.participantRole.typeId, Observation.participant:consumable.participantRole.playingEntity.typeId, Observation.entryRelationship:status.typeId, Observation.entryRelationship:reaction.typeId, Observation.entryRelationship:severity.typeId, Observation.entryRelationship:criticality.typeId, Observation.referenceRange.typeId | An II instance must have either a root or an nullFlavor. |
root.exists() or nullFlavor.exists()
|
should-author | warning | Observation | SHOULD contain author |
author.exists()
|
should-not-severity | warning | Observation | Allergy SHOULD NOT include severity. Severity belongs at reaction level, while Criticality is used at the allergy level. |
entryRelationship.observation.where(code.code = 'SEV' and code.codeSystem = '2.16.840.1.113883.5.4').empty()
|
should-text-ref-value | warning | Observation | SHOULD contain text/reference/@value |
text.reference.value.exists()
|
value-starts-octothorpe | error | Observation.text.reference | If reference/@value is present, it SHALL begin with a '#' and SHALL point to its corresponding narrative |
value.exists() implies value.startsWith('#')
|
This structure is derived from SubstanceOrDeviceAllergyIntoleranceObservation
Differential View
This structure is derived from SubstanceOrDeviceAllergyIntoleranceObservation
Name | Flags | Card. | Type | Description & Constraints Filter: ![]() ![]() |
---|---|---|---|---|
![]() ![]() |
SubstanceOrDeviceAllergyIntoleranceObservation | XML Namespace: urn:hl7-org:v3 Instance of this type are validated by templateId Logical Container: ClinicalDocument (CDA Class) | ||
![]() ![]() ![]() |
2..* | II | ||
![]() ![]() ![]() |
Content/Rules for all slices | |||
![]() ![]() ![]() ![]() |
1..1 | II | ||
![]() ![]() ![]() ![]() ![]() |
1..1 | oid, uuid, ruid | Required Pattern: 2.16.840.1.113883.10.20.22.4.7 | |
![]() ![]() ![]() ![]() ![]() |
1..1 | st | Required Pattern: 2014-06-09 | |
![]() ![]() ![]() |
0..1 | bl | Use negationInd="true" to indicate that the allergy was not observed. | |
![]() ![]() ![]() |
1..1 | IVL_TS | If the allergy/intolerance is known to be resolved, but the date of resolution is not known, then the high element SHALL be present, and the nullFlavor attribute SHALL be set to 'UNK'. | |
![]() ![]() ![]() |
Content/Rules for all slices | |||
![]() ![]() ![]() ![]() |
0..* | Participant2 | participant | |
![]() ![]() ![]() ![]() ![]() |
||||
![]() ![]() ![]() ![]() ![]() ![]() |
||||
![]() ![]() ![]() ![]() ![]() ![]() ![]() |
1..1 | CE | 𝗨𝗦𝗖𝗗𝗜: Substance Binding: Common substances for allergy and intolerance documentation including refutations ![]() | |
![]() |
Path | Status | Usage | ValueSet | Version | Source |
Observation.participant:consumable.participantRole.playingEntity.code | Base | preferred |
Common substances for allergy and intolerance documentation including refutations
![]() |
📦20240625 | VSAC v0.23 |
Key Elements View
Path | Status | Usage | ValueSet | Version | Source |
Observation.nullFlavor | Base | required | CDANullFlavor | 📦2.0.1-sd | Clinical Document Architecture v2.0 |
Observation.typeId.nullFlavor | Base | required | CDANullFlavor | 📦2.0.1-sd | Clinical Document Architecture v2.0 |
Observation.templateId:substance-device-allergy-intolerance-obs.nullFlavor | Base | required | CDANullFlavor | 📦2.0.1-sd | Clinical Document Architecture v2.0 |
Observation.templateId:allergy.nullFlavor | Base | required | CDANullFlavor | 📦2.0.1-sd | Clinical Document Architecture v2.0 |
Observation.classCode | Base | required | CDAActClassObservation | 📦2.0.1-sd | Clinical Document Architecture v2.0 |
Observation.moodCode | Base | required | x_ActMoodDocumentObservation | 📍2.0.0 | THO v5.2 |
Observation.code | Base | example | ObservationType | 📦3.0.0 | THO v6.5 |
Observation.code.nullFlavor | Base | required | CDANullFlavor | 📦2.0.1-sd | Clinical Document Architecture v2.0 |
Observation.text.nullFlavor | Base | required | CDANullFlavor | 📦2.0.1-sd | Clinical Document Architecture v2.0 |
Observation.text.compression | Base | required | CDACompressionAlgorithm | 📦2.0.1-sd | Clinical Document Architecture v2.0 |
Observation.text.integrityCheckAlgorithm | Base | required | IntegrityCheckAlgorithm | 📍2.0.0 | THO v5.2 |
Observation.text.mediaType | Base | example | MediaType | 📦3.0.0 | THO v6.5 |
Observation.text.representation | Base | required | CDABinaryDataEncoding | 📦2.0.1-sd | Clinical Document Architecture v2.0 |
Observation.statusCode | Base | required | ActStatus | 📦3.0.0 | THO v6.5 |
Observation.statusCode.nullFlavor | Base | required | CDANullFlavor | 📦2.0.1-sd | Clinical Document Architecture v2.0 |
Observation.effectiveTime.nullFlavor | Base | required | CDANullFlavor | 📦2.0.1-sd | Clinical Document Architecture v2.0 |
Observation.effectiveTime.operator | Base | required | CDASetOperator | 📦2.0.1-sd | Clinical Document Architecture v2.0 |
Observation.priorityCode | Base | example | ActPriority | 📦3.0.0 | THO v6.5 |
Observation.languageCode | Base | required | All Languages | 📦5.0.0 | FHIR Std. |
Observation.value.code | Base | required |
Allergy and Intolerance Type
![]() |
📦20240606 | VSAC v0.23 |
Observation.interpretationCode | Base | required | CDAObservationInterpretation | 📦2.0.1-sd | Clinical Document Architecture v2.0 |
Observation.methodCode | Base | example | ObservationMethod | 📦3.0.0 | THO v6.5 |
Observation.participant:consumable.nullFlavor | Base | required | CDANullFlavor | 📦2.0.1-sd | Clinical Document Architecture v2.0 |
Observation.participant:consumable.typeId.nullFlavor | Base | required | CDANullFlavor | 📦2.0.1-sd | Clinical Document Architecture v2.0 |
Observation.participant:consumable.typeCode | Base | required | CDAParticipationType | 📦2.0.1-sd | Clinical Document Architecture v2.0 |
Observation.participant:consumable.contextControlCode | Base | required | CDAContextControl | 📦2.0.1-sd | Clinical Document Architecture v2.0 |
Observation.participant:consumable.participantRole.nullFlavor | Base | required | CDANullFlavor | 📦2.0.1-sd | Clinical Document Architecture v2.0 |
Observation.participant:consumable.participantRole.typeId.nullFlavor | Base | required | CDANullFlavor | 📦2.0.1-sd | Clinical Document Architecture v2.0 |
Observation.participant:consumable.participantRole.classCode | Base | required | CDARoleClassRoot | 📦2.0.1-sd | Clinical Document Architecture v2.0 |
Observation.participant:consumable.participantRole.code | Base | example | CDARoleCode | 📦2.0.1-sd | Clinical Document Architecture v2.0 |
Observation.participant:consumable.participantRole.playingEntity.nullFlavor | Base | required | CDANullFlavor | 📦2.0.1-sd | Clinical Document Architecture v2.0 |
Observation.participant:consumable.participantRole.playingEntity.typeId.nullFlavor | Base | required | CDANullFlavor | 📦2.0.1-sd | Clinical Document Architecture v2.0 |
Observation.participant:consumable.participantRole.playingEntity.classCode | Base | required | EntityClassRoot | 📦3.0.0 | THO v6.5 |
Observation.participant:consumable.participantRole.playingEntity.determinerCode | Base | required | EntityDeterminer | 📦3.0.0 | THO v6.5 |
Observation.participant:consumable.participantRole.playingEntity.code | Base | preferred |
Common substances for allergy and intolerance documentation including refutations
![]() |
📦20240625 | VSAC v0.23 |
Observation.entryRelationship:status.nullFlavor | Base | required | CDANullFlavor | 📦2.0.1-sd | Clinical Document Architecture v2.0 |
Observation.entryRelationship:status.typeId.nullFlavor | Base | required | CDANullFlavor | 📦2.0.1-sd | Clinical Document Architecture v2.0 |
Observation.entryRelationship:status.typeCode | Base | required | x_ActRelationshipEntryRelationship | 📦3.0.0 | THO v6.5 |
Observation.entryRelationship:reaction.nullFlavor | Base | required | CDANullFlavor | 📦2.0.1-sd | Clinical Document Architecture v2.0 |
Observation.entryRelationship:reaction.typeId.nullFlavor | Base | required | CDANullFlavor | 📦2.0.1-sd | Clinical Document Architecture v2.0 |
Observation.entryRelationship:reaction.typeCode | Base | required | x_ActRelationshipEntryRelationship | 📦3.0.0 | THO v6.5 |
Observation.entryRelationship:severity.nullFlavor | Base | required | CDANullFlavor | 📦2.0.1-sd | Clinical Document Architecture v2.0 |
Observation.entryRelationship:severity.typeId.nullFlavor | Base | required | CDANullFlavor | 📦2.0.1-sd | Clinical Document Architecture v2.0 |
Observation.entryRelationship:severity.typeCode | Base | required | x_ActRelationshipEntryRelationship | 📦3.0.0 | THO v6.5 |
Observation.entryRelationship:criticality.nullFlavor | Base | required | CDANullFlavor | 📦2.0.1-sd | Clinical Document Architecture v2.0 |
Observation.entryRelationship:criticality.typeId.nullFlavor | Base | required | CDANullFlavor | 📦2.0.1-sd | Clinical Document Architecture v2.0 |
Observation.entryRelationship:criticality.typeCode | Base | required | x_ActRelationshipEntryRelationship | 📦3.0.0 | THO v6.5 |
Observation.referenceRange.nullFlavor | Base | required | CDANullFlavor | 📦2.0.1-sd | Clinical Document Architecture v2.0 |
Observation.referenceRange.typeId.nullFlavor | Base | required | CDANullFlavor | 📦2.0.1-sd | Clinical Document Architecture v2.0 |
Observation.referenceRange.typeCode | Base | required | CDAActRelationshipType | 📦2.0.1-sd | Clinical Document Architecture v2.0 |
Id | Grade | Path(s) | Description | Expression |
II-1 | error | Observation.typeId, Observation.participant:consumable.typeId, Observation.participant:consumable.participantRole.typeId, Observation.participant:consumable.participantRole.playingEntity.typeId, Observation.entryRelationship:status.typeId, Observation.entryRelationship:reaction.typeId, Observation.entryRelationship:severity.typeId, Observation.entryRelationship:criticality.typeId, Observation.referenceRange.typeId | An II instance must have either a root or an nullFlavor. |
root.exists() or nullFlavor.exists()
|
should-author | warning | Observation | SHOULD contain author |
author.exists()
|
should-not-severity | warning | Observation | Allergy SHOULD NOT include severity. Severity belongs at reaction level, while Criticality is used at the allergy level. |
entryRelationship.observation.where(code.code = 'SEV' and code.codeSystem = '2.16.840.1.113883.5.4').empty()
|
should-text-ref-value | warning | Observation | SHOULD contain text/reference/@value |
text.reference.value.exists()
|
value-starts-octothorpe | error | Observation.text.reference | If reference/@value is present, it SHALL begin with a '#' and SHALL point to its corresponding narrative |
value.exists() implies value.startsWith('#')
|
Snapshot View
Path | Status | Usage | ValueSet | Version | Source |
Observation.nullFlavor | Base | required | CDANullFlavor | 📦2.0.1-sd | Clinical Document Architecture v2.0 |
Observation.typeId.nullFlavor | Base | required | CDANullFlavor | 📦2.0.1-sd | Clinical Document Architecture v2.0 |
Observation.templateId:substance-device-allergy-intolerance-obs.nullFlavor | Base | required | CDANullFlavor | 📦2.0.1-sd | Clinical Document Architecture v2.0 |
Observation.templateId:allergy.nullFlavor | Base | required | CDANullFlavor | 📦2.0.1-sd | Clinical Document Architecture v2.0 |
Observation.classCode | Base | required | CDAActClassObservation | 📦2.0.1-sd | Clinical Document Architecture v2.0 |
Observation.moodCode | Base | required | x_ActMoodDocumentObservation | 📍2.0.0 | THO v5.2 |
Observation.code | Base | example | ObservationType | 📦3.0.0 | THO v6.5 |
Observation.code.nullFlavor | Base | required | CDANullFlavor | 📦2.0.1-sd | Clinical Document Architecture v2.0 |
Observation.text.nullFlavor | Base | required | CDANullFlavor | 📦2.0.1-sd | Clinical Document Architecture v2.0 |
Observation.text.compression | Base | required | CDACompressionAlgorithm | 📦2.0.1-sd | Clinical Document Architecture v2.0 |
Observation.text.integrityCheckAlgorithm | Base | required | IntegrityCheckAlgorithm | 📍2.0.0 | THO v5.2 |
Observation.text.mediaType | Base | example | MediaType | 📦3.0.0 | THO v6.5 |
Observation.text.representation | Base | required | CDABinaryDataEncoding | 📦2.0.1-sd | Clinical Document Architecture v2.0 |
Observation.statusCode | Base | required | ActStatus | 📦3.0.0 | THO v6.5 |
Observation.statusCode.nullFlavor | Base | required | CDANullFlavor | 📦2.0.1-sd | Clinical Document Architecture v2.0 |
Observation.effectiveTime.nullFlavor | Base | required | CDANullFlavor | 📦2.0.1-sd | Clinical Document Architecture v2.0 |
Observation.effectiveTime.operator | Base | required | CDASetOperator | 📦2.0.1-sd | Clinical Document Architecture v2.0 |
Observation.priorityCode | Base | example | ActPriority | 📦3.0.0 | THO v6.5 |
Observation.languageCode | Base | required | All Languages | 📦5.0.0 | FHIR Std. |
Observation.value.code | Base | required |
Allergy and Intolerance Type
![]() |
📦20240606 | VSAC v0.23 |
Observation.interpretationCode | Base | required | CDAObservationInterpretation | 📦2.0.1-sd | Clinical Document Architecture v2.0 |
Observation.methodCode | Base | example | ObservationMethod | 📦3.0.0 | THO v6.5 |
Observation.participant:consumable.nullFlavor | Base | required | CDANullFlavor | 📦2.0.1-sd | Clinical Document Architecture v2.0 |
Observation.participant:consumable.typeId.nullFlavor | Base | required | CDANullFlavor | 📦2.0.1-sd | Clinical Document Architecture v2.0 |
Observation.participant:consumable.typeCode | Base | required | CDAParticipationType | 📦2.0.1-sd | Clinical Document Architecture v2.0 |
Observation.participant:consumable.contextControlCode | Base | required | CDAContextControl | 📦2.0.1-sd | Clinical Document Architecture v2.0 |
Observation.participant:consumable.participantRole.nullFlavor | Base | required | CDANullFlavor | 📦2.0.1-sd | Clinical Document Architecture v2.0 |
Observation.participant:consumable.participantRole.typeId.nullFlavor | Base | required | CDANullFlavor | 📦2.0.1-sd | Clinical Document Architecture v2.0 |
Observation.participant:consumable.participantRole.classCode | Base | required | CDARoleClassRoot | 📦2.0.1-sd | Clinical Document Architecture v2.0 |
Observation.participant:consumable.participantRole.code | Base | example | CDARoleCode | 📦2.0.1-sd | Clinical Document Architecture v2.0 |
Observation.participant:consumable.participantRole.playingEntity.nullFlavor | Base | required | CDANullFlavor | 📦2.0.1-sd | Clinical Document Architecture v2.0 |
Observation.participant:consumable.participantRole.playingEntity.typeId.nullFlavor | Base | required | CDANullFlavor | 📦2.0.1-sd | Clinical Document Architecture v2.0 |
Observation.participant:consumable.participantRole.playingEntity.classCode | Base | required | EntityClassRoot | 📦3.0.0 | THO v6.5 |
Observation.participant:consumable.participantRole.playingEntity.determinerCode | Base | required | EntityDeterminer | 📦3.0.0 | THO v6.5 |
Observation.participant:consumable.participantRole.playingEntity.code | Base | preferred |
Common substances for allergy and intolerance documentation including refutations
![]() |
📦20240625 | VSAC v0.23 |
Observation.entryRelationship:status.nullFlavor | Base | required | CDANullFlavor | 📦2.0.1-sd | Clinical Document Architecture v2.0 |
Observation.entryRelationship:status.typeId.nullFlavor | Base | required | CDANullFlavor | 📦2.0.1-sd | Clinical Document Architecture v2.0 |
Observation.entryRelationship:status.typeCode | Base | required | x_ActRelationshipEntryRelationship | 📦3.0.0 | THO v6.5 |
Observation.entryRelationship:reaction.nullFlavor | Base | required | CDANullFlavor | 📦2.0.1-sd | Clinical Document Architecture v2.0 |
Observation.entryRelationship:reaction.typeId.nullFlavor | Base | required | CDANullFlavor | 📦2.0.1-sd | Clinical Document Architecture v2.0 |
Observation.entryRelationship:reaction.typeCode | Base | required | x_ActRelationshipEntryRelationship | 📦3.0.0 | THO v6.5 |
Observation.entryRelationship:severity.nullFlavor | Base | required | CDANullFlavor | 📦2.0.1-sd | Clinical Document Architecture v2.0 |
Observation.entryRelationship:severity.typeId.nullFlavor | Base | required | CDANullFlavor | 📦2.0.1-sd | Clinical Document Architecture v2.0 |
Observation.entryRelationship:severity.typeCode | Base | required | x_ActRelationshipEntryRelationship | 📦3.0.0 | THO v6.5 |
Observation.entryRelationship:criticality.nullFlavor | Base | required | CDANullFlavor | 📦2.0.1-sd | Clinical Document Architecture v2.0 |
Observation.entryRelationship:criticality.typeId.nullFlavor | Base | required | CDANullFlavor | 📦2.0.1-sd | Clinical Document Architecture v2.0 |
Observation.entryRelationship:criticality.typeCode | Base | required | x_ActRelationshipEntryRelationship | 📦3.0.0 | THO v6.5 |
Observation.referenceRange.nullFlavor | Base | required | CDANullFlavor | 📦2.0.1-sd | Clinical Document Architecture v2.0 |
Observation.referenceRange.typeId.nullFlavor | Base | required | CDANullFlavor | 📦2.0.1-sd | Clinical Document Architecture v2.0 |
Observation.referenceRange.typeCode | Base | required | CDAActRelationshipType | 📦2.0.1-sd | Clinical Document Architecture v2.0 |
Id | Grade | Path(s) | Description | Expression |
II-1 | error | Observation.typeId, Observation.participant:consumable.typeId, Observation.participant:consumable.participantRole.typeId, Observation.participant:consumable.participantRole.playingEntity.typeId, Observation.entryRelationship:status.typeId, Observation.entryRelationship:reaction.typeId, Observation.entryRelationship:severity.typeId, Observation.entryRelationship:criticality.typeId, Observation.referenceRange.typeId | An II instance must have either a root or an nullFlavor. |
root.exists() or nullFlavor.exists()
|
should-author | warning | Observation | SHOULD contain author |
author.exists()
|
should-not-severity | warning | Observation | Allergy SHOULD NOT include severity. Severity belongs at reaction level, while Criticality is used at the allergy level. |
entryRelationship.observation.where(code.code = 'SEV' and code.codeSystem = '2.16.840.1.113883.5.4').empty()
|
should-text-ref-value | warning | Observation | SHOULD contain text/reference/@value |
text.reference.value.exists()
|
value-starts-octothorpe | error | Observation.text.reference | If reference/@value is present, it SHALL begin with a '#' and SHALL point to its corresponding narrative |
value.exists() implies value.startsWith('#')
|
This structure is derived from SubstanceOrDeviceAllergyIntoleranceObservation