Generated Narrative: CodeSystem medication-administration-codesystem

Properties

This code system defines the following properties for its concepts

NameCodeURITypeDescription
supply-failuresupply-failurehttps://fhir.slade360.co.ke/fhir/concept-properties#supply-failurebooleanTrue where the dose was not given because the drug was not there to give. These are stock failures rather than clinical decisions, and are escalated to pharmacy and counted.

Concepts

This case-sensitive code system https://fhir.slade360.co.ke/fhir/CodeSystem/medication-administration-codesystem defines the following codes:

CodeDisplayDefinitionsupply-failure
given GivenThe dose was administered. Carried on MedicationAdministration.status as #completed.
held HeldA clinical decision to withhold the dose, expecting to give it later. Carried as #on-hold, whose definition — temporarily halted but expected to continue — is exactly this.
refused RefusedThe patient declined the dose. Carried as #not-done, which it shares with #omitted; the two are told apart by the reason recorded, not by the status.
omitted OmittedThe dose passed without being given. Carried as #not-done, shared with #refused as above.
nil-by-mouth Nil by mouthThe patient is nil by mouth, so an oral dose cannot be given.
vomiting VomitingThe patient is vomiting and would not keep the dose down. Not HL7's reason-medication-not-given #d, which is the opposite case: a dose that was given and then vomited back.
observations-out-of-range Observations out of rangeAn observation the dose depends on is outside the range it may be given in.
awaiting-result Awaiting a resultA result the dose depends on has not come back yet.
prescriber-asked-to-hold Prescriber asked to holdThe prescriber asked for the dose to be held.
patient-refused Patient refusedThe patient declined the dose.
unable-to-swallow Unable to swallowThe patient could not swallow the dose.
adverse-effect-reported Adverse effect reported by patientThe patient declined the dose, reporting an adverse effect from it.
drug-not-available Drug not availableThe drug was not available to give. A supply failure rather than a clinical decision: escalated to pharmacy and counted as a stock-out.true
 <status value="active"/> <experimental value="false"/> <date value="2026-09-15T11:40:24+00:00"/> <publisher value="Kathurima Kimathi"/> <contact> <name value="Kathurima Kimathi"/> <telecom> <system value="url"/> <value value="https://www.linkedin.com/in/kathurima-kimathi/"/> </telecom> <telecom> <system value="email"/> <value value="kathurimakimathi415@gmail.com"/> </telecom> </contact> <contact> <name value="Oscar John"/> <telecom> <system value="email"/> <value value="oscarjohnotieno@gmail.com"/> <use value="work"/> </telecom> </contact> <contact> <name value="Kennedy Omondi"/> <telecom> <system value="email"/> <value value="kennankole@gmail.com"/> <use value="work"/> </telecom> </contact> <description value="A code system enumerating what happened to a medication dose at the drug round, and the reasons a dose was held, refused or omitted that have no home in HL7 terminology."/> <caseSensitive value="true"/> <content value="complete"/> <count value="13"/> <property> <code value="supply-failure"/> <uri value="https://fhir.slade360.co.ke/fhir/concept-properties#supply-failure"/> <description value="True where the dose was not given because the drug was not there to give. These are stock failures rather than clinical decisions, and are escalated to pharmacy and counted."/> <type value="boolean"/> </property> <concept> <code value="given"/> <display value="Given"/> <definition value="The dose was administered. Carried on MedicationAdministration.status as #completed."/> </concept> <concept> <code value="held"/> <display value="Held"/> <definition value="A clinical decision to withhold the dose, expecting to give it later. Carried as #on-hold, whose definition — temporarily halted but expected to continue — is exactly this."/> </concept> <concept> <code value="refused"/> <display value="Refused"/> <definition value="The patient declined the dose. Carried as #not-done, which it shares with #omitted; the two are told apart by the reason recorded, not by the status."/> </concept> <concept> <code value="omitted"/> <display value="Omitted"/> <definition value="The dose passed without being given. Carried as #not-done, shared with #refused as above."/> </concept> <concept> <code value="nil-by-mouth"/> <display value="Nil by mouth"/> <definition value="The patient is nil by mouth, so an oral dose cannot be given."/> </concept> <concept> <code value="vomiting"/> <display value="Vomiting"/> <definition value="The patient is vomiting and would not keep the dose down. Not HL7's reason-medication-not-given #d, which is the opposite case: a dose that was given and then vomited back."/> </concept> <concept> <code value="observations-out-of-range"/> <display value="Observations out of range"/> <definition value="An observation the dose depends on is outside the range it may be given in."/> </concept> <concept> <code value="awaiting-result"/> <display value="Awaiting a result"/> <definition value="A result the dose depends on has not come back yet."/> </concept> <concept> <code value="prescriber-asked-to-hold"/> <display value="Prescriber asked to hold"/> <definition value="The prescriber asked for the dose to be held."/> </concept> <concept> <code value="patient-refused"/> <display value="Patient refused"/> <definition value="The patient declined the dose."/> </concept> <concept> <code value="unable-to-swallow"/> <display value="Unable to swallow"/> <definition value="The patient could not swallow the dose."/> </concept> <concept> <code value="adverse-effect-reported"/> <display value="Adverse effect reported by patient"/> <definition value="The patient declined the dose, reporting an adverse effect from it."/> </concept> <concept> <code value="drug-not-available"/> <display value="Drug not available"/> <definition value="The drug was not available to give. A supply failure rather than a clinical decision: escalated to pharmacy and counted as a stock-out."/> <property> <code value="supply-failure"/> <valueBoolean value="true"/> </property> </concept> </CodeSystem>