description: A set of healthcare-related information that is assembled together into a single logical package that provides a single coherent statement of meaning, establishes its own context and that has clinical attestation with regard to who is making the statement. A Composition defines the structure and narrative content necessary for a document. However, a Composition alone does not constitute a document. Rather, the Composition must be the first entry in a Bundle where Bundle.type=document, and any other resources referenced from Composition must be included as subsequent entries in the Bundle (for example Patient, Practitioner, Encounter, etc.).
package_name: hl7.fhir.r6.examples
derivation: specialization
name: Composition
type: Composition
elements:
  category:
    isModifier: false
    short: Categorization of Composition
    type: CodeableConcept
    mustSupport: false
    array: true
    binding: {strength: example, valueSet: 'http://hl7.org/fhir/ValueSet/referenced-item-category'}
    isSummary: true
    index: 5
  date: {isModifier: false, short: Composition editing time, type: dateTime, mustSupport: false, isSummary: true, index: 8}
  encounter:
    isModifier: false
    short: Context of the Composition
    refers: ['http://hl7.org/fhir/StructureDefinition/Encounter']
    type: Reference
    mustSupport: false
    isSummary: true
    index: 7
  name: {isModifier: false, short: Name for this Composition (computer friendly), type: string, mustSupport: false, isSummary: true, index: 11}
  section:
    constraint:
      cmp-1: {human: 'A section must contain at least one of text, entries, or sub-sections', source: 'http://hl7.org/fhir/StructureDefinition/Composition', severity: error, expression: text.exists() or entry.exists() or section.exists()}
      cmp-2: {human: A section can only have an emptyReason if it is empty, source: 'http://hl7.org/fhir/StructureDefinition/Composition', severity: error, expression: emptyReason.empty() or entry.empty()}
    isModifier: false
    short: Composition is broken into sections
    index: 23
    type: BackboneElement
    mustSupport: false
    array: true
    elements:
      orderedBy:
        isModifier: false
        short: Order of section entries
        type: CodeableConcept
        mustSupport: false
        binding: {strength: preferred, valueSet: 'http://hl7.org/fhir/ValueSet/list-order'}
        isSummary: false
        index: 29
      section:
        elementReference: ['http://hl7.org/fhir/StructureDefinition/Composition', elements, section]
        isModifier: false
        short: Nested Section
        mustSupport: false
        array: true
        isSummary: false
        index: 32
      title: {isModifier: false, short: Label for section (e.g. for ToC), type: string, mustSupport: false, isSummary: false, index: 24}
      emptyReason:
        isModifier: false
        short: Why the section is empty
        type: CodeableConcept
        mustSupport: false
        binding: {strength: preferred, valueSet: 'http://hl7.org/fhir/ValueSet/list-empty-reason'}
        isSummary: false
        index: 31
      author:
        isModifier: false
        short: Who and/or what authored the section
        refers: ['http://hl7.org/fhir/StructureDefinition/Device', 'http://hl7.org/fhir/StructureDefinition/Organization', 'http://hl7.org/fhir/StructureDefinition/Patient', 'http://hl7.org/fhir/StructureDefinition/Practitioner', 'http://hl7.org/fhir/StructureDefinition/PractitionerRole', 'http://hl7.org/fhir/StructureDefinition/RelatedPerson']
        type: Reference
        mustSupport: false
        array: true
        isSummary: false
        index: 26
      code:
        isModifier: false
        short: Classification of section (recommended)
        type: CodeableConcept
        mustSupport: false
        binding: {strength: example, valueSet: 'http://hl7.org/fhir/ValueSet/doc-section-codes'}
        isSummary: false
        index: 25
      focus:
        isModifier: false
        short: Who/what the section is about, when it is not about the subject of composition
        refers: ['http://hl7.org/fhir/StructureDefinition/Resource']
        type: Reference
        mustSupport: false
        isSummary: false
        index: 27
      entry:
        isModifier: false
        short: A reference to data that supports this section
        refers: ['http://hl7.org/fhir/StructureDefinition/Resource']
        type: Reference
        mustSupport: false
        array: true
        isSummary: false
        index: 30
      text: {isModifier: false, short: 'Text summary of the section, for human interpretation', type: Narrative, mustSupport: false, isSummary: false, index: 28}
    isSummary: false
  useContext: {isModifier: false, short: The context that the content is intended to support, type: UsageContext, mustSupport: false, array: true, isSummary: true, index: 9}
  attester:
    isModifier: false
    short: Attests to accuracy of composition
    index: 14
    type: BackboneElement
    mustSupport: false
    array: true
    elements:
      mode:
        isModifier: false
        short: personal | professional | legal | official
        type: CodeableConcept
        mustSupport: false
        binding: {strength: preferred, valueSet: 'http://hl7.org/fhir/ValueSet/composition-attestation-mode'}
        isSummary: false
        index: 15
      time: {isModifier: false, short: When the composition was attested, type: dateTime, mustSupport: false, isSummary: false, index: 16}
      party:
        isModifier: false
        short: Who attested the composition
        refers: ['http://hl7.org/fhir/StructureDefinition/Organization', 'http://hl7.org/fhir/StructureDefinition/Patient', 'http://hl7.org/fhir/StructureDefinition/Practitioner', 'http://hl7.org/fhir/StructureDefinition/PractitionerRole', 'http://hl7.org/fhir/StructureDefinition/RelatedPerson']
        type: Reference
        mustSupport: false
        isSummary: false
        index: 17
    required: [mode]
    isSummary: false
  type:
    isModifier: false
    short: Kind of composition (LOINC if possible)
    type: CodeableConcept
    mustSupport: false
    binding: {strength: preferred, valueSet: 'http://hl7.org/fhir/ValueSet/doc-typecodes'}
    isSummary: true
    index: 4
  title: {isModifier: false, short: Human Readable name/title, type: string, mustSupport: false, isSummary: true, index: 12}
  note: {isModifier: false, short: For any additional notes, type: Annotation, mustSupport: false, array: true, isSummary: false, index: 13}
  author:
    min: 1
    isModifier: false
    short: Who and/or what authored the composition
    index: 10
    refers: ['http://hl7.org/fhir/StructureDefinition/Device', 'http://hl7.org/fhir/StructureDefinition/Organization', 'http://hl7.org/fhir/StructureDefinition/Patient', 'http://hl7.org/fhir/StructureDefinition/Practitioner', 'http://hl7.org/fhir/StructureDefinition/PractitionerRole', 'http://hl7.org/fhir/StructureDefinition/RelatedPerson']
    type: Reference
    mustSupport: false
    array: true
    isSummary: true
  event:
    isModifier: false
    short: The clinical service(s) being documented
    type: BackboneElement
    mustSupport: false
    array: true
    isSummary: true
    index: 20
    elements:
      period: {isModifier: false, short: The period covered by the documentation, type: Period, mustSupport: false, isSummary: true, index: 21}
      detail:
        isModifier: false
        short: The event(s) being documented, as code(s), reference(s), or both
        type: CodeableReference
        mustSupport: false
        array: true
        binding: {strength: example, valueSet: 'http://terminology.hl7.org/ValueSet/v3-ActCode'}
        isSummary: true
        index: 22
  custodian:
    isModifier: false
    short: Organization which maintains the composition
    refers: ['http://hl7.org/fhir/StructureDefinition/Organization']
    type: Reference
    mustSupport: false
    isSummary: true
    index: 18
  status:
    isModifier: true
    short: registered | partial | preliminary | final | amended | corrected | appended | cancelled | entered-in-error | deprecated | unknown
    index: 3
    type: code
    mustSupport: false
    binding: {strength: required, valueSet: 'http://hl7.org/fhir/ValueSet/composition-status|6.0.0-ballot1'}
    isModifierReason: This element is labelled as a modifier because it is a status element that contains status entered-in-error which means that the resource should not be treated as valid
    isSummary: true
  url: {isModifier: false, short: 'Canonical identifier for this Composition, represented as a URI (globally unique)', type: uri, mustSupport: false, isSummary: true, index: 0}
  identifier: {isModifier: false, short: Version-independent identifier for the Composition, type: Identifier, mustSupport: false, array: true, isSummary: true, index: 1}
  relatesTo: {isModifier: false, short: Relationships to other compositions/documents, type: RelatedArtifact, mustSupport: false, array: true, isSummary: false, index: 19}
  version: {isModifier: false, short: An explicitly assigned identifier of a variation of the content in the Composition, type: string, mustSupport: false, isSummary: true, index: 2}
  subject:
    isModifier: false
    short: Who and/or what the composition is about
    refers: ['http://hl7.org/fhir/StructureDefinition/Resource']
    type: Reference
    mustSupport: false
    array: true
    isSummary: true
    index: 6
package_version: 6.0.0-ballot1
class: resource
kind: resource
url: http://hl7.org/fhir/StructureDefinition/Composition
base: http://hl7.org/fhir/StructureDefinition/DomainResource
version: 6.0.0-ballot1
required: [author, status, title, type, date]