{ "resourceType" : "CodeSystem", "id" : "medication-administration-codesystem", "text" : { "status" : "generated", "div" : "

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
" }, "url" : "https://fhir.slade360.co.ke/fhir/CodeSystem/medication-administration-codesystem", "version" : "0.1.0", "name" : "SGHIMedicationAdministrationCodeSystem", "title" : "SGHI Medication Administration Code System", "status" : "active", "experimental" : false, "date" : "2026-09-15T11:40:24+00:00", "publisher" : "Kathurima Kimathi", "contact" : [{ "name" : "Kathurima Kimathi", "telecom" : [{ "system" : "url", "value" : "https://www.linkedin.com/in/kathurima-kimathi/" }, { "system" : "email", "value" : "kathurimakimathi415@gmail.com" }] }, { "name" : "Oscar John", "telecom" : [{ "system" : "email", "value" : "oscarjohnotieno@gmail.com", "use" : "work" }] }, { "name" : "Kennedy Omondi", "telecom" : [{ "system" : "email", "value" : "kennankole@gmail.com", "use" : "work" }] }], "description" : "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" : true, "content" : "complete", "count" : 13, "property" : [{ "code" : "supply-failure", "uri" : "https://fhir.slade360.co.ke/fhir/concept-properties#supply-failure", "description" : "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" : "boolean" }], "concept" : [{ "code" : "given", "display" : "Given", "definition" : "The dose was administered. Carried on MedicationAdministration.status as #completed." }, { "code" : "held", "display" : "Held", "definition" : "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." }, { "code" : "refused", "display" : "Refused", "definition" : "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." }, { "code" : "omitted", "display" : "Omitted", "definition" : "The dose passed without being given. Carried as #not-done, shared with #refused as above." }, { "code" : "nil-by-mouth", "display" : "Nil by mouth", "definition" : "The patient is nil by mouth, so an oral dose cannot be given." }, { "code" : "vomiting", "display" : "Vomiting", "definition" : "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." }, { "code" : "observations-out-of-range", "display" : "Observations out of range", "definition" : "An observation the dose depends on is outside the range it may be given in." }, { "code" : "awaiting-result", "display" : "Awaiting a result", "definition" : "A result the dose depends on has not come back yet." }, { "code" : "prescriber-asked-to-hold", "display" : "Prescriber asked to hold", "definition" : "The prescriber asked for the dose to be held." }, { "code" : "patient-refused", "display" : "Patient refused", "definition" : "The patient declined the dose." }, { "code" : "unable-to-swallow", "display" : "Unable to swallow", "definition" : "The patient could not swallow the dose." }, { "code" : "adverse-effect-reported", "display" : "Adverse effect reported by patient", "definition" : "The patient declined the dose, reporting an adverse effect from it." }, { "code" : "drug-not-available", "display" : "Drug not available", "definition" : "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" : "supply-failure", "valueBoolean" : true }] }] }