description: To promote interoperability and adoption through common implementation, this profile sets minimum expectations for searching and fetching patient documents including Clinical Notes using the DocumentReference resource. It identifies the mandatory core elements, extensions, vocabularies and value sets which **SHALL** be present in the DocumentReference resource when using this profile. It provides the floor for standards development for specific use cases. Prior to reviewing this profile, implementers are encouraged to read the Clinical Notes Guidance to understand the overlap of US Core DocumentReference Profile and US Core DiagnosticReport Profile for Report and Note exchange.
package_name: hl7.fhir.us.core
derivation: constraint
name: USCoreDocumentReferenceProfile
type: DocumentReference
elements:
  category:
    mustSupport: true
    index: 3
    slicing:
      rules: open
      discriminator:
      - {path: $this, type: pattern}
      min: 1
      slices:
        us-core:
          match: {}
          schema:
            binding: {strength: required, valueSet: 'http://hl7.org/fhir/us/core/ValueSet/us-core-documentreference-category'}
            mustSupport: true
            index: 4
  date: {mustSupport: true, index: 6}
  content:
    mustSupport: true
    index: 8
    elements:
      attachment:
        constraint:
          us-core-6: {human: DocumentReference.content.attachment.url or DocumentReference.content.attachment.data or both SHALL be present., severity: error, expression: url.exists() or data.exists()}
        mustSupport: true
        index: 9
        elements:
          contentType: {mustSupport: true, index: 10}
          data: {mustSupport: true, index: 11}
          url: {mustSupport: true, index: 12}
      format:
        binding: {strength: extensible, valueSet: 'http://hl7.org/fhir/ValueSet/formatcodes'}
        mustSupport: true
        index: 13
  type:
    binding: {strength: required, valueSet: 'http://hl7.org/fhir/us/core/ValueSet/us-core-documentreference-type'}
    mustSupport: true
    index: 2
  author:
    type: Reference
    mustSupport: true
    refers: ['http://hl7.org/fhir/StructureDefinition/Device', 'http://hl7.org/fhir/us/core/StructureDefinition/us-core-organization', 'http://hl7.org/fhir/us/core/StructureDefinition/us-core-patient', 'http://hl7.org/fhir/us/core/StructureDefinition/us-core-practitioner', 'http://hl7.org/fhir/us/core/StructureDefinition/us-core-practitionerrole', 'http://hl7.org/fhir/us/core/StructureDefinition/us-core-relatedperson']
    index: 7
  status:
    binding: {strength: required, valueSet: 'http://hl7.org/fhir/ValueSet/document-reference-status'}
    mustSupport: true
    index: 1
  identifier: {mustSupport: true, index: 0}
  context:
    mustSupport: true
    index: 14
    elements:
      encounter:
        type: Reference
        mustSupport: true
        refers: ['http://hl7.org/fhir/us/core/StructureDefinition/us-core-encounter']
        index: 15
      period: {mustSupport: true, index: 16}
  subject:
    type: Reference
    mustSupport: true
    refers: ['http://hl7.org/fhir/us/core/StructureDefinition/us-core-patient']
    index: 5
package_version: 6.0.0-ballot
class: profile
kind: resource
url: http://hl7.org/fhir/us/core/StructureDefinition/us-core-documentreference
base: http://hl7.org/fhir/StructureDefinition/DocumentReference
version: 6.0.0-ballot
required: [subject, type, category]