| Left: | FHIR Clinical Document Composition Profile (http://hl7.org/fhir/uv/fhir-clinical-document/StructureDefinition/clinical-document-composition) |
| Right: | FHIR Clinical Document Composition Profile (http://hl7.org/fhir/uv/fhir-clinical-document/StructureDefinition/clinical-document-composition) |
| Error | StructureDefinition.version | Values for version differ: '1.0.1' vs '1.1.0' |
| Information | StructureDefinition.date | Values for date differ: '2026-01-30T02:13:33+11:00' vs '2026-06-18T11:28:33+00:00' |
| Warning | Composition.language | Elements differ in definition for mustSupport: 'true' vs 'false' |
| Information | StructureDefinition.short | Values for short differ: 'Extension' vs 'Extensions that cannot be ignored' |
| Information | StructureDefinition.definition | Values for definition differ: 'An Extension' vs 'May be used to represent additional information that is not part of the basic definition of the resource and that modifies the understanding of the element that contains it and/or the understanding of the containing element's descendants. Usually modifier elements provide negation or qualification. To make the use of extensions safe and manageable, there is a strict set of governance applied to the definition and use of extensions. Though any implementer is allowed to define an extension, there is a set of requirements that SHALL be met as part of the definition of the extension. Applications processing a resource are required to check for modifier extensions. Modifier extensions SHALL NOT change the meaning of any elements on Resource or DomainResource (including cannot change the meaning of modifierExtension itself).' |
| Warning | Composition.identifier | Elements differ in definition for mustSupport: 'true' vs 'false' |
| Warning | Composition.status | Elements differ in definition for mustSupport: 'false' vs 'true' |
| Warning | Composition.category | Elements differ in definition for mustSupport: 'true' vs 'false' |
| Information | Composition.category | Element minimum cardinalities differ: '1' vs '0' |
| Warning | Composition.attester | Elements differ in definition for mustSupport: 'true' vs 'false' |
| Warning | Composition.attester.mode | Elements differ in definition for mustSupport: 'true' vs 'false' |
| Warning | Composition.attester.time | Elements differ in definition for mustSupport: 'true' vs 'false' |
| Warning | Composition.attester.party | Elements differ in definition for mustSupport: 'true' vs 'false' |
| Warning | Composition.relatesTo | Elements differ in definition for mustSupport: 'true' vs 'false' |
| Name | Value | Comments | |
|---|---|---|---|
abstract | false | ||
baseDefinition | http://hl7.org/fhir/StructureDefinition/Composition | ||
copyright | Used by permission of HL7 International, all rights reserved Creative Commons License | ||
date | 2026-01-30T02:13:33+11:00 | 2026-06-18T11:28:33+00:00 |
|
description | Starting point for a specification for a composition of a FHIR Clinical Document. | ||
experimental | |||
fhirVersion | 4.0.1 | ||
jurisdiction | |||
![]() jurisdiction[0] | http://unstats.un.org/unsd/methods/m49/m49.htm#001 | ||
kind | resource | ||
name | ClinicalDocumentComposition | ||
publisher | HL7 International / Structured Documents | ||
purpose | |||
status | active | ||
title | FHIR Clinical Document Composition Profile | ||
type | Composition | ||
url | http://hl7.org/fhir/uv/fhir-clinical-document/StructureDefinition/clinical-document-composition | ||
version | 1.0.1 | 1.1.0 |
|
| Name | L Flags | L Card. | L Type | L Description & Constraints | R Flags | R Card. | R Type | R Description & Constraints | Comments![]() | ||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
![]() | C | 0..* | Composition | A set of resources composed into a single coherent clinical statement with clinical attestation Constraints: clindoc-limit-participantType | C | 0..* | Composition | A set of resources composed into a single coherent clinical statement with clinical attestation Constraints: clindoc-limit-participantType | |||||||||
![]() ![]() | Σ | 0..1 | id | Logical id of this artifact | Σ | 0..1 | id | Logical id of this artifact | |||||||||
![]() ![]() | Σ | 0..1 | Meta | Metadata about the resource | Σ | 0..1 | Meta | Metadata about the resource | |||||||||
![]() ![]() | ?!Σ | 0..1 | uri | A set of rules under which this content was created | ?!Σ | 0..1 | uri | A set of rules under which this content was created | |||||||||
![]() ![]() | S | 0..1 | code | Language of the resource content Binding: ?? (preferred): A human language.
| 0..1 | code | Language of the resource content Binding: ?? (preferred): A human language.
|
| |||||||||
![]() ![]() | S | 0..1 | Narrative | Text summary of the resource, for human interpretation This profile does not constrain the narrative in regard to content, language, or traceability to data elements | S | 0..1 | Narrative | Text summary of the resource, for human interpretation This profile does not constrain the narrative in regard to content, language, or traceability to data elements | |||||||||
![]() ![]() | 0..* | Resource | Contained, inline Resources | 0..* | Resource | Contained, inline Resources | |||||||||||
![]() ![]() | 0..* | Extension | Extension Slice: Unordered, Open by value:url | 0..* | Extension | Extension Slice: Unordered, Open by value:url | |||||||||||
![]() ![]() | ?! | 0..* | Extension | Extension Slice: Unordered, Open by value:url | ?! | 0..* | Extension | Extensions that cannot be ignored | |||||||||
![]() ![]() | SΣ | 0..1 | Identifier | Version-independent identifier for the Composition | Σ | 0..1 | Identifier | Version-independent identifier for the Composition |
| ||||||||
![]() ![]() | ?!Σ | 1..1 | code | preliminary | final | amended | entered-in-error Binding: ?? (required): The workflow/clinical status of the composition. | ?!SΣ | 1..1 | code | preliminary | final | amended | entered-in-error Binding: ?? (required): The workflow/clinical status of the composition. |
| ||||||||
![]() ![]() ![]() | 0..1 | string | xml:id (or equivalent in JSON) |
| |||||||||||||
![]() ![]() ![]() | 0..* | Extension | Extension Slice: Unordered, Open by value:url |
| |||||||||||||
![]() ![]() ![]() | 0..1 | string | Primitive value for code |
| |||||||||||||
![]() ![]() | SΣ | 1..1 | CodeableConcept | Kind of composition (LOINC if possible) Binding: ?? (preferred): Type of a composition. | SΣ | 1..1 | CodeableConcept | Kind of composition (LOINC if possible) Binding: ?? (preferred): Type of a composition. | |||||||||
![]() ![]() | SΣ | 1..* | CodeableConcept | Categorization of Composition Slice: Unordered, Open by value:$this Binding: ?? (example): High-level kind of a clinical document at a macro level. | Σ | 0..* | CodeableConcept | Categorization of Composition Slice: Unordered, Open by value:$this Binding: ?? (example): High-level kind of a clinical document at a macro level. |
| ||||||||
![]() ![]() | SΣ | 1..1 | Reference(Patient | Group) | Who and/or what the composition is about | SΣ | 1..1 | Reference(Patient | Group) | Who and/or what the composition is about | |||||||||
![]() ![]() | Σ | 0..1 | Reference(Encounter) | Context of the Composition | Σ | 0..1 | Reference(Encounter) | Context of the Composition | |||||||||
![]() ![]() | SΣ | 1..1 | dateTime | Composition editing time | SΣ | 1..1 | dateTime | Composition editing time | |||||||||
![]() ![]() | SΣ | 1..* | Reference(Patient | Practitioner | PractitionerRole | RelatedPerson | Device | Organization) | Who and/or what authored the composition | SΣ | 1..* | Reference(Patient | Practitioner | PractitionerRole | RelatedPerson | Device | Organization) | Who and/or what authored the composition | |||||||||
![]() ![]() | SΣ | 1..1 | string | Human Readable name/title | SΣ | 1..1 | string | Human Readable name/title | |||||||||
![]() ![]() | Σ | 0..1 | code | As defined by affinity domain Binding: ?? (required): Codes specifying the level of confidentiality of the composition. | Σ | 0..1 | code | As defined by affinity domain Binding: ?? (required): Codes specifying the level of confidentiality of the composition. | |||||||||
![]() ![]() | S | 0..* | BackboneElement | Attests to accuracy of composition Slice: Unordered, Open by value:mode | 0..* | BackboneElement | Attests to accuracy of composition Slice: Unordered, Open by value:mode |
| |||||||||
![]() ![]() ![]() | 0..1 | string | Unique id for inter-element referencing | 0..1 | string | Unique id for inter-element referencing | |||||||||||
![]() ![]() ![]() | 0..* | Extension | Additional content defined by implementations | 0..* | Extension | Additional content defined by implementations | |||||||||||
![]() ![]() ![]() | ?!Σ | 0..* | Extension | Extensions that cannot be ignored even if unrecognized | ?!Σ | 0..* | Extension | Extensions that cannot be ignored even if unrecognized | |||||||||
![]() ![]() ![]() | S | 1..1 | code | personal | professional | legal | official Binding: ?? (required): The way in which a person authenticated a composition. | 1..1 | code | personal | professional | legal | official Binding: ?? (required): The way in which a person authenticated a composition. |
| |||||||||
![]() ![]() ![]() | S | 0..1 | dateTime | When the composition was attested | 0..1 | dateTime | When the composition was attested |
| |||||||||
![]() ![]() ![]() | S | 0..1 | Reference(Patient | RelatedPerson | Practitioner | PractitionerRole | Organization) | Who attested the composition | 0..1 | Reference(Patient | RelatedPerson | Practitioner | PractitionerRole | Organization) | Who attested the composition |
| |||||||||
![]() ![]() | SΣ | 0..1 | Reference(Organization) | Organization which maintains the composition | SΣ | 0..1 | Reference(Organization) | Organization which maintains the composition | |||||||||
![]() ![]() | S | 0..* | BackboneElement | Relationships to other compositions/documents Slice: Unordered, Open by value:code, type:target | 0..* | BackboneElement | Relationships to other compositions/documents Slice: Unordered, Open by value:code, type:target |
| |||||||||
![]() ![]() ![]() | 0..1 | string | Unique id for inter-element referencing | 0..1 | string | Unique id for inter-element referencing | |||||||||||
![]() ![]() ![]() | 0..* | Extension | Additional content defined by implementations | 0..* | Extension | Additional content defined by implementations | |||||||||||
![]() ![]() ![]() | ?!Σ | 0..* | Extension | Extensions that cannot be ignored even if unrecognized | ?!Σ | 0..* | Extension | Extensions that cannot be ignored even if unrecognized | |||||||||
![]() ![]() ![]() | 1..1 | code | replaces | transforms | signs | appends Binding: ?? (required): The type of relationship between documents. | 1..1 | code | replaces | transforms | signs | appends Binding: ?? (required): The type of relationship between documents. | |||||||||||
![]() ![]() ![]() | 1..1 | Identifier, Reference(Composition) | Target of the relationship Slice: Unordered, Open by type:$this | 1..1 | Identifier, Reference(Composition) | Target of the relationship Slice: Unordered, Open by type:$this | |||||||||||
![]() ![]() | Σ | 0..* | BackboneElement | The clinical service(s) being documented | Σ | 0..* | BackboneElement | The clinical service(s) being documented | |||||||||
![]() ![]() ![]() | 0..1 | string | Unique id for inter-element referencing | 0..1 | string | Unique id for inter-element referencing | |||||||||||
![]() ![]() ![]() | 0..* | Extension | Additional content defined by implementations | 0..* | Extension | Additional content defined by implementations | |||||||||||
![]() ![]() ![]() | ?!Σ | 0..* | Extension | Extensions that cannot be ignored even if unrecognized | ?!Σ | 0..* | Extension | Extensions that cannot be ignored even if unrecognized | |||||||||
![]() ![]() ![]() | Σ | 0..* | CodeableConcept | Code(s) that apply to the event being documented Binding: ?? (example): This list of codes represents the main clinical acts being documented. | Σ | 0..* | CodeableConcept | Code(s) that apply to the event being documented Binding: ?? (example): This list of codes represents the main clinical acts being documented. | |||||||||
![]() ![]() ![]() | Σ | 0..1 | Period | The period covered by the documentation | Σ | 0..1 | Period | The period covered by the documentation | |||||||||
![]() ![]() ![]() | Σ | 0..* | Reference(Resource) | The event(s) being documented | Σ | 0..* | Reference(Resource) | The event(s) being documented | |||||||||
![]() ![]() | SC | 1..* | BackboneElement | Composition is broken into sections | SC | 1..* | BackboneElement | Composition is broken into sections | |||||||||
![]() ![]() ![]() | 0..1 | string | Unique id for inter-element referencing | 0..1 | string | Unique id for inter-element referencing | |||||||||||
![]() ![]() ![]() | 0..* | Extension | Extension Slice: Unordered, Open by value:url | 0..* | Extension | Extension Slice: Unordered, Open by value:url | |||||||||||
![]() ![]() ![]() | ?!Σ | 0..* | Extension | Extensions that cannot be ignored even if unrecognized | ?!Σ | 0..* | Extension | Extensions that cannot be ignored even if unrecognized | |||||||||
![]() ![]() ![]() | S | 1..1 | string | Label for section (e.g. for ToC) | S | 1..1 | string | Label for section (e.g. for ToC) | |||||||||
![]() ![]() ![]() | S | 0..1 | CodeableConcept | Classification of section (recommended) Binding: ?? (example): Classification of a section of a composition/document. | S | 0..1 | CodeableConcept | Classification of section (recommended) Binding: ?? (example): Classification of a section of a composition/document. | |||||||||
![]() ![]() ![]() | 0..* | Reference(Practitioner | PractitionerRole | Device | Patient | RelatedPerson | Organization) | Who and/or what authored the section | 0..* | Reference(Practitioner | PractitionerRole | Device | Patient | RelatedPerson | Organization) | Who and/or what authored the section | |||||||||||
![]() ![]() ![]() | 0..1 | Reference(Resource) | Who/what the section is about, when it is not about the subject of composition | 0..1 | Reference(Resource) | Who/what the section is about, when it is not about the subject of composition | |||||||||||
![]() ![]() ![]() | SC | 0..1 | Narrative | Text summary of the section, for human interpretation This profile does not constrain the narrative in regard to content, language, or traceability to data elements | SC | 0..1 | Narrative | Text summary of the section, for human interpretation This profile does not constrain the narrative in regard to content, language, or traceability to data elements | |||||||||
![]() ![]() ![]() | 0..1 | code | working | snapshot | changes Binding: ?? (required): The processing mode that applies to this section. | 0..1 | code | working | snapshot | changes Binding: ?? (required): The processing mode that applies to this section. | |||||||||||
![]() ![]() ![]() | 0..1 | CodeableConcept | Order of section entries Binding: ?? (preferred): What order applies to the items in the entry. | 0..1 | CodeableConcept | Order of section entries Binding: ?? (preferred): What order applies to the items in the entry. | |||||||||||
![]() ![]() ![]() | C | 0..* | Reference(Resource) | A reference to data that supports this section | C | 0..* | Reference(Resource) | A reference to data that supports this section | |||||||||
![]() ![]() ![]() | C | 0..1 | CodeableConcept | Why the section is empty Binding: ?? (preferred): If a section is empty, why it is empty. | C | 0..1 | CodeableConcept | Why the section is empty Binding: ?? (preferred): If a section is empty, why it is empty. | |||||||||
![]() ![]() ![]() | C | 0..* | See section (Composition) | Nested Section | C | 0..* | See section (Composition) | Nested Section | |||||||||
Documentation for this format | |||||||||||||||||