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.r4b.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://terminology.hl7.org/ValueSet/v3-LoincDocumentOntologyInternational'}
    isSummary: true
    index: 3
  date: {isModifier: false, short: Composition editing time, type: dateTime, mustSupport: false, isSummary: true, index: 6}
  encounter:
    isModifier: false
    short: Context of the Composition
    refers: ['http://hl7.org/fhir/StructureDefinition/Encounter']
    type: Reference
    mustSupport: false
    isSummary: true
    index: 5
  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: 25
    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: 32
      section:
        elementReference: ['http://hl7.org/fhir/StructureDefinition/Composition', elements, section]
        isModifier: false
        short: Nested Section
        mustSupport: false
        array: true
        isSummary: false
        index: 35
      mode:
        isModifier: false
        short: working | snapshot | changes
        type: code
        mustSupport: false
        binding: {strength: required, valueSet: 'http://hl7.org/fhir/ValueSet/list-mode|4.3.0'}
        isSummary: false
        index: 31
      title: {isModifier: false, short: Label for section (e.g. for ToC), type: string, mustSupport: false, isSummary: false, index: 26}
      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: 34
      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: 28
      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: 27
      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: 29
      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: 33
      text: {isModifier: false, short: 'Text summary of the section, for human interpretation', type: Narrative, mustSupport: false, isSummary: false, index: 30}
    isSummary: false
  attester:
    isModifier: false
    short: Attests to accuracy of composition
    index: 10
    type: BackboneElement
    mustSupport: false
    array: true
    elements:
      mode:
        isModifier: false
        short: personal | professional | legal | official
        type: code
        mustSupport: false
        binding: {strength: required, valueSet: 'http://hl7.org/fhir/ValueSet/composition-attestation-mode|4.3.0'}
        isSummary: false
        index: 11
      time: {isModifier: false, short: When the composition was attested, type: dateTime, mustSupport: false, isSummary: false, index: 12}
      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: 13
    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: 2
  title: {isModifier: false, short: Human Readable name/title, type: string, mustSupport: false, isSummary: true, index: 8}
  author:
    min: 1
    isModifier: false
    short: Who and/or what authored the composition
    index: 7
    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: 21
    elements:
      code:
        isModifier: false
        short: Code(s) that apply to the event being documented
        type: CodeableConcept
        mustSupport: false
        array: true
        binding: {strength: example, valueSet: 'http://terminology.hl7.org/ValueSet/v3-ActCode'}
        isSummary: true
        index: 22
      period: {isModifier: false, short: The period covered by the documentation, type: Period, mustSupport: false, isSummary: true, index: 23}
      detail:
        isModifier: false
        short: The event(s) being documented
        refers: ['http://hl7.org/fhir/StructureDefinition/Resource']
        type: Reference
        mustSupport: false
        array: true
        isSummary: true
        index: 24
  custodian:
    isModifier: false
    short: Organization which maintains the composition
    refers: ['http://hl7.org/fhir/StructureDefinition/Organization']
    type: Reference
    mustSupport: false
    isSummary: true
    index: 14
  status:
    isModifier: true
    short: preliminary | final | amended | entered-in-error
    index: 1
    type: code
    mustSupport: false
    binding: {strength: required, valueSet: 'http://hl7.org/fhir/ValueSet/composition-status|4.3.0'}
    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
  identifier: {isModifier: false, short: Version-independent identifier for the Composition, type: Identifier, mustSupport: false, isSummary: true, index: 0}
  relatesTo:
    isModifier: false
    short: Relationships to other compositions/documents
    index: 15
    type: BackboneElement
    mustSupport: false
    array: true
    elements:
      code:
        isModifier: false
        short: replaces | transforms | signs | appends
        type: code
        mustSupport: false
        binding: {strength: required, valueSet: 'http://hl7.org/fhir/ValueSet/document-relationship-type|4.3.0'}
        isSummary: false
        index: 16
      target:
        isModifier: false
        short: Target of the relationship
        mustSupport: false
        choices: [targetIdentifier, targetReference]
        isSummary: false
        index: 18
      targetIdentifier: {isModifier: false, short: Target of the relationship, type: Identifier, mustSupport: false, choiceOf: target, isSummary: false, index: 19}
      targetReference:
        isModifier: false
        short: Target of the relationship
        index: 20
        refers: ['http://hl7.org/fhir/StructureDefinition/Composition']
        type: Reference
        mustSupport: false
        choiceOf: target
        isSummary: false
    required: [targetReference, target, targetIdentifier, code]
    isSummary: false
  subject:
    isModifier: false
    short: Who and/or what the composition is about
    refers: ['http://hl7.org/fhir/StructureDefinition/Resource']
    type: Reference
    mustSupport: false
    isSummary: true
    index: 4
  confidentiality:
    isModifier: false
    short: As defined by affinity domain
    type: code
    mustSupport: false
    binding: {strength: required, valueSet: 'http://terminology.hl7.org/ValueSet/v3-Confidentiality|2.0.0'}
    isSummary: true
    index: 9
package_version: 4.3.0
class: resource
kind: resource
url: http://hl7.org/fhir/StructureDefinition/Composition
base: http://hl7.org/fhir/StructureDefinition/DomainResource
version: 4.3.0
required: [author, status, title, type, date]