This page is part of the FHIR Specification (v1.1.0: STU 3 Ballot 1). The current version which supercedes this version is 5.0.0. For a full list of available versions, see the Directory of published versions
. Page versions: R5 R4B R4 R3 R2
This is a frozen snapshot of the FHIR specification created for the purpose of balloting the GAO implementation Guide. It includes draft changes that may be part of the future DSTU 2.1 release but further change is expected. Readers should focus solely on the GAO implementation content, and FHIR DSTU 2 for other purposes.

The official URL for this profile is:
http://hl7.org/fhir/StructureDefinition/clinicaldocument
The base Composition is a general resource for compositions or documents about any kind of subject that might be encountered in healthcare including such things as guidelines, medicines, etc. A clinical document is focused on documents related to the provision of care process, where the subject is a patient, a group of patients, or a closely related concept. A clinical document has additional reqiurements around confidentiality that do not apply in the same way to other kinds of documents
This profile was published on Tue, Mar 17, 2015 00:00+1100 as a draft by Health Level Seven, Inc. - Structured Documents WG.

Description of Profiles, Differentials, Snapshots, and how the XML and JSON presentations work.
This structure is derived from Composition.
This structure is derived from Composition.
| Name | Flags | Card. | Type | Description & Constraints![]() |
|---|---|---|---|---|
![]() | 0..* | Composition | A set of resources composed into a single coherent clinical statement with clinical attestation | |
![]() ![]() | ∑ | 0..1 | Meta | Metadata about the resource |
![]() ![]() | ?! ∑ | 0..1 | uri | A set of rules under which this content was created |
![]() ![]() | 0..1 | code | Language of the resource content Binding: IETF BCP-47 (required) | |
![]() ![]() | I | 0..1 | Narrative | Text summary of the resource, for human interpretation |
![]() ![]() | 0..* | Resource | Contained, inline Resources | |
![]() ![]() | 0..* | Extension | Additional Content defined by implementations | |
![]() ![]() | ?! | 0..* | Extension | Extensions that cannot be ignored |
![]() ![]() | ∑ | 0..1 | Identifier | Logical identifier of composition (version-independent) |
![]() ![]() | ∑ | 1..1 | dateTime | Composition editing time |
![]() ![]() | ∑ | 1..1 | CodeableConcept | Kind of composition (LOINC if possible) Binding: FHIR Document Type Codes (preferred) |
![]() ![]() | ∑ | 0..1 | CodeableConcept | Categorization of Composition Binding: FHIR Document Class Codes (example) |
![]() ![]() | ∑ | 1..1 | string | Human Readable name/title |
![]() ![]() | ?! ∑ | 1..1 | code | preliminary | final | amended | entered-in-error Binding: CompositionStatus (required) |
![]() ![]() | ?! ∑ | 0..1 | code | As defined by affinity domain Binding: v3 Code System Confidentiality (required) |
![]() ![]() | ∑ | 1..1 | Reference(Patient | Practitioner | Group | Device | Location) | Who and/or what the composition is about |
![]() ![]() | ∑ | 1..* | Reference(Practitioner | Device | Patient | RelatedPerson) | Who and/or what authored the composition |
![]() ![]() | ∑ | 0..* | BackboneElement | Attests to accuracy of composition |
![]() ![]() ![]() | 0..* | Extension | Additional Content defined by implementations | |
![]() ![]() ![]() | ?! | 0..* | Extension | Extensions that cannot be ignored |
![]() ![]() ![]() | ∑ | 1..* | code | personal | professional | legal | official Binding: CompositionAttestationMode (required) |
![]() ![]() ![]() | ∑ | 0..1 | dateTime | When composition attested |
![]() ![]() ![]() | ∑ | 0..1 | Reference(Patient | Practitioner | Organization) | Who attested the composition |
![]() ![]() | ∑ | 0..1 | Reference(Organization) | Organization which maintains the composition |
![]() ![]() | ∑ | 0..* | BackboneElement | The clinical service(s) being documented |
![]() ![]() ![]() | 0..* | Extension | Additional Content defined by implementations | |
![]() ![]() ![]() | ?! | 0..* | Extension | Extensions that cannot be ignored |
![]() ![]() ![]() | ∑ | 0..* | CodeableConcept | Code(s) that apply to the event being documented Binding: v3 Code System ActCode (example) |
![]() ![]() ![]() | ∑ | 0..1 | Period | The period covered by the documentation |
![]() ![]() ![]() | ∑ | 0..* | Reference(Resource) | The event(s) being documented |
![]() ![]() | ∑ | 0..1 | Reference(Encounter) | Context of the Composition |
![]() ![]() | I | 0..* | BackboneElement | Composition is broken into sections cmp-2: A section can only have an emptyReason if it is empty cmp-1: A section must at least one of text, entries, or sub-sections |
![]() ![]() ![]() | 0..* | Extension | Additional Content defined by implementations | |
![]() ![]() ![]() | ?! | 0..* | Extension | Extensions that cannot be ignored |
![]() ![]() ![]() | 0..1 | string | Label for section (e.g. for ToC) | |
![]() ![]() ![]() | 0..1 | CodeableConcept | Classification of section (recommended) Binding: Document Section Codes (example) | |
![]() ![]() ![]() | I | 0..1 | Narrative | Text summary of the section, for human interpretation |
![]() ![]() ![]() | ?! ∑ | 0..1 | code | working | snapshot | changes Binding: ListMode (required) |
![]() ![]() ![]() | 0..1 | CodeableConcept | Order of section entries Binding: List Order Codes (preferred) | |
![]() ![]() ![]() | I | 0..* | Reference(Resource) | A reference to data that supports this section |
![]() ![]() ![]() | I | 0..1 | CodeableConcept | Why the section is empty Binding: List Empty Reasons (preferred) |
![]() ![]() ![]() | I | 0..* | See Composition.section | Nested Section |
Documentation for this format | ||||
todo
This structure is derived from Composition.
Differential View
This structure is derived from Composition.
Snapshot View
| Name | Flags | Card. | Type | Description & Constraints![]() |
|---|---|---|---|---|
![]() | 0..* | Composition | A set of resources composed into a single coherent clinical statement with clinical attestation | |
![]() ![]() | ∑ | 0..1 | Meta | Metadata about the resource |
![]() ![]() | ?! ∑ | 0..1 | uri | A set of rules under which this content was created |
![]() ![]() | 0..1 | code | Language of the resource content Binding: IETF BCP-47 (required) | |
![]() ![]() | I | 0..1 | Narrative | Text summary of the resource, for human interpretation |
![]() ![]() | 0..* | Resource | Contained, inline Resources | |
![]() ![]() | 0..* | Extension | Additional Content defined by implementations | |
![]() ![]() | ?! | 0..* | Extension | Extensions that cannot be ignored |
![]() ![]() | ∑ | 0..1 | Identifier | Logical identifier of composition (version-independent) |
![]() ![]() | ∑ | 1..1 | dateTime | Composition editing time |
![]() ![]() | ∑ | 1..1 | CodeableConcept | Kind of composition (LOINC if possible) Binding: FHIR Document Type Codes (preferred) |
![]() ![]() | ∑ | 0..1 | CodeableConcept | Categorization of Composition Binding: FHIR Document Class Codes (example) |
![]() ![]() | ∑ | 1..1 | string | Human Readable name/title |
![]() ![]() | ?! ∑ | 1..1 | code | preliminary | final | amended | entered-in-error Binding: CompositionStatus (required) |
![]() ![]() | ?! ∑ | 0..1 | code | As defined by affinity domain Binding: v3 Code System Confidentiality (required) |
![]() ![]() | ∑ | 1..1 | Reference(Patient | Practitioner | Group | Device | Location) | Who and/or what the composition is about |
![]() ![]() | ∑ | 1..* | Reference(Practitioner | Device | Patient | RelatedPerson) | Who and/or what authored the composition |
![]() ![]() | ∑ | 0..* | BackboneElement | Attests to accuracy of composition |
![]() ![]() ![]() | 0..* | Extension | Additional Content defined by implementations | |
![]() ![]() ![]() | ?! | 0..* | Extension | Extensions that cannot be ignored |
![]() ![]() ![]() | ∑ | 1..* | code | personal | professional | legal | official Binding: CompositionAttestationMode (required) |
![]() ![]() ![]() | ∑ | 0..1 | dateTime | When composition attested |
![]() ![]() ![]() | ∑ | 0..1 | Reference(Patient | Practitioner | Organization) | Who attested the composition |
![]() ![]() | ∑ | 0..1 | Reference(Organization) | Organization which maintains the composition |
![]() ![]() | ∑ | 0..* | BackboneElement | The clinical service(s) being documented |
![]() ![]() ![]() | 0..* | Extension | Additional Content defined by implementations | |
![]() ![]() ![]() | ?! | 0..* | Extension | Extensions that cannot be ignored |
![]() ![]() ![]() | ∑ | 0..* | CodeableConcept | Code(s) that apply to the event being documented Binding: v3 Code System ActCode (example) |
![]() ![]() ![]() | ∑ | 0..1 | Period | The period covered by the documentation |
![]() ![]() ![]() | ∑ | 0..* | Reference(Resource) | The event(s) being documented |
![]() ![]() | ∑ | 0..1 | Reference(Encounter) | Context of the Composition |
![]() ![]() | I | 0..* | BackboneElement | Composition is broken into sections cmp-2: A section can only have an emptyReason if it is empty cmp-1: A section must at least one of text, entries, or sub-sections |
![]() ![]() ![]() | 0..* | Extension | Additional Content defined by implementations | |
![]() ![]() ![]() | ?! | 0..* | Extension | Extensions that cannot be ignored |
![]() ![]() ![]() | 0..1 | string | Label for section (e.g. for ToC) | |
![]() ![]() ![]() | 0..1 | CodeableConcept | Classification of section (recommended) Binding: Document Section Codes (example) | |
![]() ![]() ![]() | I | 0..1 | Narrative | Text summary of the section, for human interpretation |
![]() ![]() ![]() | ?! ∑ | 0..1 | code | working | snapshot | changes Binding: ListMode (required) |
![]() ![]() ![]() | 0..1 | CodeableConcept | Order of section entries Binding: List Order Codes (preferred) | |
![]() ![]() ![]() | I | 0..* | Reference(Resource) | A reference to data that supports this section |
![]() ![]() ![]() | I | 0..1 | CodeableConcept | Why the section is empty Binding: List Empty Reasons (preferred) |
![]() ![]() ![]() | I | 0..* | See Composition.section | Nested Section |
Documentation for this format | ||||
XML Template
JSON Template
todo
Other representations of profile: Schematron

| Path | Name | Conformance | ValueSet |
| Composition.language | ?ext | required | http://tools.ietf.org/html/bcp47 ![]() |
| Composition.type | FHIR Document Type Codes | preferred | FHIR Document Type Codes |
| Composition.class | FHIR Document Class Codes | example | FHIR Document Class Codes |
| Composition.status | CompositionStatus | required | CompositionStatus |
| Composition.confidentiality | v3 Code System Confidentiality | required | v3 Code System Confidentiality |
| Composition.attester.mode | CompositionAttestationMode | required | CompositionAttestationMode |
| Composition.event.code | v3 Code System ActCode | example | v3 Code System ActCode |
| Composition.section.code | Document Section Codes | example | Document Section Codes |
| Composition.section.mode | ListMode | required | ListMode |
| Composition.section.orderedBy | List Order Codes | preferred | List Order Codes |
| Composition.section.emptyReason | List Empty Reasons | preferred | List Empty Reasons |

| Id | Path | Details | Requirements |
| cmp-2 | Composition.section | A section can only have an emptyReason if it is empty XPath: not(exists(f:emptyReason) and exists(f:entry)) | |
| cmp-1 | Composition.section | A section must at least one of text, entries, or sub-sections XPath: exists(f:text) or exists(f:entry) or exists(f:section) |