Skip to content

Task Business Status CodeSystem Code system

Canonicalhttps://fhir.apps.health/CodeSystem/task-business-status
Statusdraft · 1.33.0
Contentcomplete
SourceFSH · JSON

Coarse business sub-states recordable on a clinical task alongside its standard FHIR lifecycle status. The lifecycle status says where a task is in its workflow; these codes say whether the chart element the task is filed against needs a human's attention.

The axis is deliberately shallow -- in practice one flag and its cleared state. Richer sub-states belong in status, in intent, or in a workflow's own vocabulary carried under its own system.

Content is complete for the standard vocabulary defined here (Ok, Needs review), consolidating under the IG canonical base the codes that a pre-consolidation system, http://well.company/task-business-status, carried under an older canonical. Stored data may still hold codings on that system, so a reader meeting older records should recognise it; it is being migrated to the canonical declared here. Write the canonical system above.

⚠ As of 1.26.0 NexusEmrCoreClinicalTask.businessStatus binds required to the union set, which admits this system and the statutory correction vocabulary and nothing else. A coding on the pre-consolidation canonical is therefore non-conformant rather than merely old, and this guide does not make an exception for it. Sub-states from other systems -- SNOMED CT workflow states, source-EMR legacy vocabularies -- are likewise no longer representable here: that freedom is what the required binding withdrew.

CodeDisplayDefinitionProperties
status
okOkThe flag is not set: nothing about the chart element this task references needs attention. Carries no information that an absent `businessStatus` does not also carry -- it exists so a writer can CLEAR the flag in place rather than remove the coding, and a reader should treat `ok` and absent as the same fact.
needs-reviewNeeds reviewDEPRECATED -- do not write. Inbound/legacy only: it marks a chart element the task is filed against (a result, document or referral) as unread or warranting a clinician's eyes. Retained because roughly two years of stored data carry it and it must stay representable. Do NOT forward-pull it into new Nexus EMR workflows: the case it was built for -- a completed referral that a new message should resurface -- is modelled as a NEW Task on the same ServiceRequest, because once a task is completed it does not come back to life. Inbound data carrying this code is transformed at the C3 gateway. The reason, when there is one, is free text in `businessStatus.text`.deprecated

Properties

What each property column means, and how many of the 2 concepts carry it.

Property Type Group Concepts Description
status code Properties 1 of 2 Concept lifecycle status (active | deprecated | retired).