{
  "resourceType": "CodeSystem",
  "status": "draft",
  "content": "complete",
  "name": "NexusTaskStatusReasonCS",
  "id": "nexus-task-status-reason",
  "title": "Task Status Reason CodeSystem",
  "description": "Why a task reached its status, for the cases where a reader derives a state from the reason rather\nthan only displaying it.\n\n`Task.statusReason` is free text elsewhere in the chart, which is sufficient wherever the reason is\nread by a person. It is not sufficient where a reason CHANGES WHAT A READER CONCLUDES: a note's\nsign-off state is read from the most recent sign-off request, and a request cancelled because the\nnote was returned for changes asks the learner to act, while a request cancelled for any other\nreason asks them for nothing.\n\n**Only reasons a state is derived from are coded here.** Every other closure in Nexus EMR writes\n`statusReason.text` with no coding -- the Inbox's Archive and Reject, and a declined suggestion.\nThat is intentional: a reader keys on the coding it cares about and treats the absence of one as\n\"no coded reason\", instead of enumerating the reasons it must ignore.\n\n**Match the coding, never the text.** The text beside a coding is advisory, is not a translation of\nthe code, and is not stable.",
  "url": "https://fhir.apps.health/CodeSystem/nexus-task-status-reason",
  "concept": [
    {
      "code": "returned",
      "display": "Returned for changes",
      "definition": "The request was cancelled because the reviewer sent the work back to its author to be changed, rather than approving it or setting it aside. On a `note-sign-off` request this is what makes a note read as RETURNED: the supervisor read the note, did not sign it off, and is asking the learner for a correction. It is the only cancellation that asks the author for anything, which is why it alone is coded -- a request archived, declined, or handed to another supervisor is cancelled with no coding and leaves the note awaiting a supervisor, who can still sign it off or return it from the note. What the reviewer asked to be changed is NOT carried here: that goes to the author as a task of its own, and this reason names only the decision."
    }
  ],
  "experimental": false,
  "caseSensitive": true,
  "count": 1
}
