Task Profile

Canonical	../StructureDefinition/nexus-emr-core-clinical-task
Status	draft · 1.26.0
Base	Task (constraint)
Source	FSH · JSON

A unit of work in the chart: who asked for it, who owns it now, what has been said about it, and which chart element it concerns. Inbox items, to-dos, follow-ups, a result that needs review -- deliberately one kind of work item.

Examples

Chart-Created · Clinical · Document Review Task, Completed · Clinical task ai triage 001 · Clinical task completed 001 · Clinical task lab review 001 · Clinical task nursing pool 001 · Clinical task referral 001 · Suggested-Resource Task - Add a Chart Entry · Suggested-Resource Task - Card Alternative A (empagliflozin) · Suggested-Resource Task - Card Alternative B (dulaglutide) · Suggested-Resource Task - Retire a Chart Entry · Team-Owned Standalone · Unassigned

Suggested-Resource Task - Retire a Chart Entry

A suggestion that CHANGES something already in the chart rather than adding to it. The Bundle entry carries a conditional PUT over the recorded penicillin allergy, and the prototype is its suggested new state, carrying entered-in-error -- there is no delete in this chart, so a withdrawal is an update. Demonstrates that create-versus-update is entry.request.method, stated per suggested resource, with no vocabulary of actions anywhere on the Task

Task/nexus-emr-clinical-task-suggestion-update — claims conformance to Task Profile

{
  "resourceType": "Task",
  "id": "nexus-emr-clinical-task-suggestion-update",
  "meta": {
    "profile": [
      "../StructureDefinition/nexus-emr-core-clinical-task"
    ],
    "security": [
      {
        "system": "http://terminology.hl7.org/CodeSystem/v3-ObservationValue",
        "code": "AIAST",
        "display": "Artificial Intelligence asserted"
      }
    ]
  },
  "contained": [
    {
      "resourceType": "Bundle",
      "id": "suggested",
      "type": "transaction",
      "entry": [
        {
          "fullUrl": "urn:uuid:9f2c8a1e-0000-4000-8000-000000000002",
          "resource": {
            "resourceType": "AllergyIntolerance",
            "meta": {
              "profile": [
                "../StructureDefinition/nexus-emr-core-allergyintolerance"
              ]
            },
            "identifier": [
              {
                "use": "official",
                "system": "../NamingSystem/cedarbrook-clinic-allergyintolerance-raw-code",
                "value": "ALG-AVERY-PENICILLIN-01"
              }
            ],
            "verificationStatus": {
              "coding": [
                {
                  "system": "http://terminology.hl7.org/CodeSystem/allergyintolerance-verification",
                  "code": "entered-in-error"
                }
              ]
            },
            "type": "allergy",
            "category": [
              "medication"
            ],
            "criticality": "high",
            "code": {
              "coding": [
                {
                  "system": "http://snomed.info/sct",
                  "code": "764146007",
                  "display": "Penicillin"
                }
              ],
              "text": "Penicillin"
            },
            "patient": {
              "reference": "Patient/nexus-emr-patient-attachment-example",
              "display": "Avery Linwood"
            },
            "onsetDateTime": "2019-06-14",
            "recordedDate": "2019-06-14",
            "recorder": {
              "reference": "PractitionerRole/dr-ben-mrp-role",
              "display": "Dr. Ben"
            },
            "reaction": [
              {
                "manifestation": [
                  {
                    "coding": [
                      {
                        "system": "http://snomed.info/sct",
                        "code": "271807003",
                        "display": "Eruption of skin"
                      }
                    ],
                    "text": "Rash"
                  }
                ],
                "severity": "moderate"
              }
            ]
          },
          "request": {
            "method": "PUT",
            "url": "AllergyIntolerance?identifier=../NamingSystem/cedarbrook-clinic-allergyintolerance-raw-code|ALG-AVERY-PENICILLIN-01"
          }
        },
        {
          "fullUrl": "urn:uuid:9f2c8a1e-0000-4000-8000-100000000002",
          "resource": {
            "resourceType": "Provenance",
            "extension": [
              {
                "url": "../StructureDefinition/nexus-attributed-fact",
                "extension": [
                  {
                    "url": "statement",
                    "valueString": "The allergist's letter records that the recorded penicillin allergy was excluded on challenge testing and should not have been entered."
                  },
                  {
                    "url": "citation",
                    "extension": [
                      {
                        "url": "chunk",
                        "valueString": "c2"
                      },
                      {
                        "url": "quote",
                        "valueString": "Graded oral challenge to amoxicillin completed without reaction. The previously reported penicillin allergy is refuted; please remove it from the chart."
                      },
                      {
                        "url": "source",
                        "valueReference": {
                          "reference": "DocumentReference/allergy-consult-20260817",
                          "display": "Allergy consult letter, 2026-08-17"
                        }
                      }
                    ]
                  }
                ]
              }
            ],
            "target": [
              {
                "reference": "urn:uuid:9f2c8a1e-0000-4000-8000-000000000002",
                "display": "Suggested new state: penicillin allergy entered in error"
              }
            ],
            "occurredDateTime": "2026-08-18T09:10:00-04:00",
            "recorded": "2026-08-18T09:10:04-04:00",
            "activity": {
              "text": "AI clinical extraction suggested retiring a chart entry"
            },
            "agent": [
              {
                "type": {
                  "coding": [
                    {
                      "system": "http://terminology.hl7.org/CodeSystem/provenance-participant-type",
                      "code": "author",
                      "display": "Author"
                    }
                  ],
                  "text": "Generating agent (non-human)"
                },
                "who": {
                  "type": "Device",
                  "identifier": {
                    "system": "../NamingSystem/nexus-harness-graph",
                    "value": "chart-update"
                  },
                  "display": "ChartUpdate graph (AI)"
                },
                "onBehalfOf": {
                  "reference": "PractitionerRole/dr-ben-mrp-role",
                  "display": "Dr. Ben"
                }
              }
            ],
            "entity": [
              {
                "role": "source",
                "what": {
                  "reference": "DocumentReference/allergy-consult-20260817",
                  "display": "Allergy consult letter, 2026-08-17"
                }
              }
            ]
          },
          "request": {
            "method": "POST",
            "url": "Provenance"
          }
        }
      ]
    }
  ],
  "extension": [
    {
      "url": "../StructureDefinition/nexus-emr-thread-id",
      "valueString": "thread-b81c47e0-allergy-reconciliation"
    }
  ],
  "identifier": [
    {
      "use": "official",
      "system": "../NamingSystem/nexus-harness-key",
      "value": "chart-update:Patient/avery-linwood-01:penicillin-allergy-refuted"
    }
  ],
  "status": "ready",
  "intent": "proposal",
  "priority": "routine",
  "code": {
    "coding": [
      {
        "system": "../CodeSystem/nexus-task-code",
        "code": "review-report",
        "display": "Review report"
      }
    ],
    "text": "Chart change suggested from a consult letter"
  },
  "description": "The allergy consult letter states the penicillin allergy was refuted on challenge testing. Suggested change: mark the recorded allergy entered-in-error. Review, then approve (updates the allergy on the chart) or reject (retained as declined).",
  "for": {
    "reference": "Patient/nexus-emr-patient-attachment-example",
    "display": "Avery Linwood"
  },
  "focus": {
    "reference": "AllergyIntolerance/nexus-emr-allergyintolerance-example",
    "display": "Recorded allergy: Penicillin"
  },
  "authoredOn": "2026-08-18T09:10:00-04:00",
  "requester": {
    "type": "Device",
    "identifier": {
      "system": "../NamingSystem/nexus-harness-graph",
      "value": "chart-update"
    },
    "display": "ChartUpdate graph (AI)"
  },
  "owner": {
    "reference": "PractitionerRole/dr-ben-mrp-role",
    "display": "Dr. Ben"
  },
  "input": [
    {
      "type": {
        "coding": [
          {
            "system": "../CodeSystem/nexus-task-input-type",
            "code": "suggested-resource",
            "display": "Suggested resource"
          }
        ]
      },
      "valueReference": {
        "reference": "#suggested",
        "display": "Suggested resource Bundle"
      }
    }
  ]
}