Skip to content

DocumentReference Profile

Canonicalhttps://fhir.apps.health/StructureDefinition/nexus-emr-core-documentreference
Statusdraft · 1.33.0
BaseDocumentReference (constraint)
CQL primary code pathtype — what this means
SourceFSH · JSON

Nexus EMR profile for an ATTACHED DOCUMENT -- a clinical document that exists as a file: scanned paper, incoming faxes, external consult letters received as PDF, signed consent forms, patient-uploaded files. FHIR holds the metadata and clinical context; the bytes live in document storage and are reached through content.attachment.url.

Examples

Allergy Consult Letter (challenge refuted) · Anemia Consultation Document · Cardiology Consult Letter (received) · Consent Withdrawal Evidence Document · Faxed Consult Letter (awaiting a patient match) · Faxed Consult Letter (received) · Hrm discharge summary 20260618 · Migration Export File · Terms and Conditions · WSIB Form 8 (filed) · WSIB Form 8 Template (with field mapping)

Faxed Consult Letter (awaiting a patient match)

An incoming faxed letter uploaded before its patient was identified -- subject-less, carrying the awaiting-patient tag under nexus-filing-state, which is what makes the missing subject legitimate. Matching it sets the subject and removes the tag in the same write

DocumentReference/fax-consult-awaiting-patient — claims conformance to DocumentReference Profile

{
  "resourceType": "DocumentReference",
  "id": "fax-consult-awaiting-patient",
  "meta": {
    "profile": [
      "https://fhir.apps.health/StructureDefinition/nexus-emr-core-documentreference"
    ],
    "tag": [
      {
        "system": "https://fhir.apps.health/CodeSystem/nexus-filing-state",
        "code": "awaiting-patient",
        "display": "Awaiting patient"
      }
    ]
  },
  "text": {
    "status": "generated",
    "div": "<div xmlns="http://www.w3.org/1999/xhtml"><p>A faxed consultation letter, uploaded to the inbox from a batch of incoming paper before anyone had identified the patient it is about.</p><p>It has <b>no <code>subject</code></b> and carries the <code>awaiting-patient</code> tag instead: the tag is what makes the missing subject legitimate, and it tells this document apart from a malformed one. It is on no patient's chart. When a user matches it, the same write sets <code>subject</code> and removes the tag.</p><p><code>author</code> and <code>context</code> are absent: the sender is outside the practice, and the document cannot belong to an encounter before it belongs to a patient.</p></div>"
  },
  "status": "current",
  "type": {
    "coding": [
      {
        "system": "http://loinc.org",
        "code": "11488-4",
        "display": "Consult Note"
      }
    ],
    "text": "Consult Note"
  },
  "date": "2026-10-26T09:15:00-04:00",
  "description": "Incoming faxed consultation letter, awaiting a patient match.",
  "custodian": {
    "reference": "Organization/cedarbrook-clinic"
  },
  "content": [
    {
      "attachment": {
        "contentType": "application/pdf",
        "language": "en-CA",
        "title": "Faxed consultation letter",
        "creation": "2026-10-26T09:15:00-04:00",
        "size": 243,
        "data": "JVBERi0xLjQKJeLjz9MKMSAwIG9iago8PAovVHlwZSAvQ2F0YWxvZwovUGFnZXMgMiAwIFIKPj4KZW5kb2JqCjIgMCBvYmoKPDwKL1R5cGUgL1BhZ2VzCi9LaWRzIFszIDAgUl0KL0NvdW50IDEKPD4KZW5kb2JqCjMgMCBvYmoKPDwKL1R5cGUgL1BhZ2UKL1BhcmVudCAyIDAgUgovTWVkaWFCb3ggWzAgMCA2MTIgNzkyXQovUmVzb3VyY2VzIDw8L0ZvbnQgPDwvRjEgNCAwIFI+Pj4+Ci9Db250ZW50cyA1IDAgUgo+PgplbmRvYmoK"
      }
    }
  ]
}