description: Composition provides the structural backbone for assembling a set of healthcare-related information into a single logical package that provides a single coherent statement of meaning, establishes its own context and has traceability to the author who is making the statement.
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: 7
  date: {isModifier: false, short: Composition editing time, type: dateTime, mustSupport: false, isSummary: true, index: 10}
  encounter:
    isModifier: false
    short: Context of the Composition
    refers: ['http://hl7.org/fhir/StructureDefinition/Encounter']
    type: Reference
    mustSupport: false
    isSummary: true
    index: 9
  name:
    constraint:
      cmp-4: {human: 'Name should start with an uppercase letter (A–Z), be 2 to 255 characters long, and contain only letters, digits, and underscores. Whitespace, hyphens, and other punctuation are not permitted', source: 'http://hl7.org/fhir/StructureDefinition/Composition', severity: warning, expression: '%resource.name.exists() implies %resource.name.matches(''^[A-Z]([A-Za-z0-9_]){1,254}$'')'}
    isModifier: false
    short: Computer friendly name
    type: string
    mustSupport: false
    isSummary: true
    index: 18
  section:
    constraint:
      cmp-3: {human: If attester exists then the Composition either needs a text or a section, source: 'http://hl7.org/fhir/StructureDefinition/Composition', severity: warning, expression: '%resource.attester.exists() implies(text.exists() or section.exists())'}
      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 no entries are included, source: 'http://hl7.org/fhir/StructureDefinition/Composition', severity: error, expression: emptyReason.empty() or entry.empty()}
    isModifier: false
    short: Composition is broken into sections
    index: 41
    type: BackboneElement
    mustSupport: false
    array: true
    elements:
      orderedBy:
        isModifier: false
        short: Order of section entries
        type: CodeableConcept
        mustSupport: false
        binding: {strength: preferred, valueSet: 'http://terminology.hl7.org/ValueSet/list-order'}
        isSummary: false
        index: 48
      section:
        elementReference: ['http://hl7.org/fhir/StructureDefinition/Composition', elements, section]
        isModifier: false
        short: Nested Section
        mustSupport: false
        array: true
        isSummary: false
        index: 51
      title: {isModifier: false, short: Label for section (e.g. for ToC), type: string, mustSupport: false, isSummary: false, index: 42}
      note: {isModifier: false, short: Information about the section contents that is not represented by any of the section entries, type: Annotation, mustSupport: false, array: true, isSummary: false, index: 47}
      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: 50
      author:
        isModifier: false
        short: Who and/or what authored the section, when the section is authored by someone other than the composition.author
        refers: ['http://hl7.org/fhir/StructureDefinition/CareTeam', '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: 44
      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: 43
      focus:
        isModifier: false
        short: Who/what the section is about, when it is not about the subject of the composition
        refers: ['http://hl7.org/fhir/StructureDefinition/Resource']
        type: Reference
        mustSupport: false
        isSummary: false
        index: 45
      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: 49
      text: {isModifier: false, short: 'Text summary of the section, for human interpretation', type: Narrative, mustSupport: false, isSummary: false, index: 46}
    isSummary: false
  useContext: {isModifier: false, short: The context that the content is intended to support, type: UsageContext, mustSupport: false, array: true, isSummary: true, index: 11}
  attester:
    isModifier: false
    short: Attests to accuracy of composition
    index: 24
    type: BackboneElement
    mustSupport: false
    array: true
    elements:
      mode:
        isModifier: false
        short: personal | professional | legal | official
        type: CodeableConcept
        mustSupport: false
        binding: {strength: preferred, valueSet: 'http://terminology.hl7.org/ValueSet/composition-attestation-mode'}
        isSummary: false
        index: 25
      time: {isModifier: false, short: When the composition was attested, type: dateTime, mustSupport: false, isSummary: false, index: 26}
      party:
        isModifier: false
        short: Who attested the composition
        refers: ['http://hl7.org/fhir/StructureDefinition/Group', '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: 27
    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: 6
  participant:
    isModifier: false
    short: Identifies supporting entities, including parents, relatives, caregivers, insurance policyholders, guarantors, and others related in some way to the patient
    index: 13
    type: BackboneElement
    mustSupport: false
    array: true
    elements:
      type:
        min: 1
        isModifier: false
        short: Meaning and purpose of participation, in creation of the clinical document
        index: 14
        type: CodeableConcept
        mustSupport: false
        array: true
        binding: {strength: preferred, valueSet: 'http://terminology.hl7.org/ValueSet/fhir-clinical-doc-participant'}
        isSummary: false
      function:
        isModifier: false
        type: CodeableConcept
        mustSupport: false
        array: true
        binding: {strength: preferred, valueSet: 'http://terminology.hl7.org/ValueSet/v3-ParticipationFunction'}
        isSummary: false
        index: 15
      time: {isModifier: false, short: Time period of participation, type: Period, mustSupport: false, isSummary: false, index: 16}
      party:
        isModifier: false
        short: Who the participant is
        refers: ['http://hl7.org/fhir/StructureDefinition/CareTeam', 'http://hl7.org/fhir/StructureDefinition/Device', 'http://hl7.org/fhir/StructureDefinition/Group', '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: [type, party]
    isSummary: false
  consent:
    isModifier: false
    short: Represents informed consents and medico-legal transactions
    refers: ['http://hl7.org/fhir/StructureDefinition/Consent']
    type: Reference
    mustSupport: false
    array: true
    isSummary: false
    index: 3
  classification:
    isModifier: false
    short: The assignment to an organizing scheme
    type: BackboneElement
    mustSupport: false
    array: true
    isSummary: true
    index: 21
    elements:
      type:
        isModifier: false
        short: The kind of classifier (e.g. population, intervention)
        type: CodeableConcept
        mustSupport: false
        binding: {strength: example, valueSet: 'http://hl7.org/fhir/ValueSet/evidence-classifier-type-example'}
        isSummary: false
        index: 22
      classifier:
        isModifier: false
        short: The specific classification value
        type: CodeableReference
        mustSupport: false
        array: true
        binding: {strength: example, valueSet: 'http://hl7.org/fhir/ValueSet/condition-code'}
        isSummary: false
        index: 23
  title: {isModifier: false, short: Human Readable name/title, type: string, mustSupport: false, isSummary: true, index: 19}
  note: {isModifier: false, short: For any additional notes, type: Annotation, mustSupport: false, array: true, isSummary: false, index: 20}
  author:
    isModifier: false
    short: Who and/or what authored the composition
    refers: ['http://hl7.org/fhir/StructureDefinition/CareTeam', '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
    index: 12
  event:
    isModifier: false
    short: The clinical service(s) being documented
    type: BackboneElement
    mustSupport: false
    array: true
    isSummary: true
    index: 38
    elements:
      period: {isModifier: false, short: The period covered by the documentation, type: Period, mustSupport: false, isSummary: true, index: 39}
      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: 40
  custodian:
    isModifier: false
    short: Organization which maintains the composition
    refers: ['http://hl7.org/fhir/StructureDefinition/Group', 'http://hl7.org/fhir/StructureDefinition/Organization', 'http://hl7.org/fhir/StructureDefinition/Patient']
    type: Reference
    mustSupport: false
    isSummary: true
    index: 28
  status:
    isModifier: true
    short: registered | partial | preliminary | final | amended | corrected | appended | cancelled | entered-in-error | deprecated | unknown
    index: 5
    type: code
    mustSupport: false
    binding: {strength: required, valueSet: 'http://hl7.org/fhir/ValueSet/composition-status|6.0.0-ballot5'}
    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
    index: 29
    type: BackboneElement
    mustSupport: false
    array: true
    elements:
      type:
        isModifier: false
        short: documentation | justification | citation | predecessor | successor | derived-from | depends-on | composed-of | part-of | amends | amended-with | appends | appended-with | cites | cited-by | comments-on | comment-in | contains | contained-in | corrects | correction-in | replaces | replaced-with | retracts | retracted-by | signs | similar-to | supports | supported-with | transforms | transformed-into | transformed-with | documents | specification-of | created-with | cite-as | reprint | reprint-of | summarizes
        type: CodeableConcept
        mustSupport: false
        binding: {strength: extensible, valueSet: 'http://terminology.hl7.org/ValueSet/artifact-relationship-type'}
        isSummary: false
        index: 30
      target:
        isModifier: false
        short: The artifact that is related to this Composition
        mustSupport: false
        choices: [targetUri, targetAttachment, targetCanonical, targetReference, targetMarkdown]
        isSummary: false
        index: 32
      targetUri: {isModifier: false, short: The artifact that is related to this Composition, type: uri, mustSupport: false, choiceOf: target, isSummary: false, index: 33}
      targetAttachment: {isModifier: false, short: The artifact that is related to this Composition, type: Attachment, mustSupport: false, choiceOf: target, isSummary: false, index: 34}
      targetCanonical: {isModifier: false, short: The artifact that is related to this Composition, type: canonical, mustSupport: false, choiceOf: target, isSummary: false, index: 35}
      targetReference:
        isModifier: false
        short: The artifact that is related to this Composition
        index: 36
        refers: ['http://hl7.org/fhir/StructureDefinition/Resource']
        type: Reference
        mustSupport: false
        choiceOf: target
        isSummary: false
      targetMarkdown: {isModifier: false, short: The artifact that is related to this Composition, type: markdown, mustSupport: false, choiceOf: target, isSummary: false, index: 37}
    required: [targetCanonical, targetMarkdown, targetReference, type, target, targetAttachment, targetUri]
    isSummary: false
  basedOn:
    isModifier: false
    short: Fulfills plan, proposal or order
    refers: ['http://hl7.org/fhir/StructureDefinition/Appointment', 'http://hl7.org/fhir/StructureDefinition/AppointmentResponse', 'http://hl7.org/fhir/StructureDefinition/CarePlan', 'http://hl7.org/fhir/StructureDefinition/Claim', 'http://hl7.org/fhir/StructureDefinition/CommunicationRequest', 'http://hl7.org/fhir/StructureDefinition/CoverageEligibilityRequest', 'http://hl7.org/fhir/StructureDefinition/DeviceRequest', 'http://hl7.org/fhir/StructureDefinition/MedicationRequest', 'http://hl7.org/fhir/StructureDefinition/NutritionOrder', 'http://hl7.org/fhir/StructureDefinition/RequestOrchestration', 'http://hl7.org/fhir/StructureDefinition/ServiceRequest', 'http://hl7.org/fhir/StructureDefinition/Task', 'http://hl7.org/fhir/StructureDefinition/VisionPrescription']
    type: Reference
    mustSupport: false
    array: true
    isSummary: false
    index: 4
  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: 8
package_version: 6.0.0-ballot5
class: resource
kind: resource
url: http://hl7.org/fhir/StructureDefinition/Composition
base: http://hl7.org/fhir/StructureDefinition/DomainResource
version: 6.0.0-ballot5
required: [status, type, date]