SGHI FHIR Profile Implementation Guide
0.1.0 - ci-build
SGHI FHIR Profile Implementation Guide, published by Kathurima Kimathi. This guide is not an authorized publication; it is the continuous build for version 0.1.0 built by the FHIR (HL7® FHIR® Standard) CI Build. This version is based on the current content of https://github.com/savannahghi/sil_fhir_profile_ig/ and changes regularly. See the Directory of published versions
| Active as of 2026-09-15 |
<CodeSystem xmlns="http://hl7.org/fhir">
<id value="medication-administration-codesystem"/>
<text>
<status value="generated"/>
<div xmlns="http://www.w3.org/1999/xhtml"><p class="res-header-id"><b>Generated Narrative: CodeSystem medication-administration-codesystem</b></p><a name="medication-administration-codesystem"> </a><a name="hcmedication-administration-codesystem"> </a><p><b>Properties</b></p><p><b>This code system defines the following properties for its concepts</b></p><table class="grid"><tr><td><b>Name</b></td><td><b>Code</b></td><td><b>URI</b></td><td><b>Type</b></td><td><b>Description</b></td></tr><tr><td>supply-failure</td><td>supply-failure</td><td>https://fhir.slade360.co.ke/fhir/concept-properties#supply-failure</td><td>boolean</td><td>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.</td></tr></table><p><b>Concepts</b></p><p>This case-sensitive code system <code>https://fhir.slade360.co.ke/fhir/CodeSystem/medication-administration-codesystem</code> defines the following codes:</p><table class="codes"><tr><td style="white-space:nowrap"><b>Code</b></td><td><b>Display</b></td><td><b>Definition</b></td><td><b>supply-failure</b></td></tr><tr><td style="white-space:nowrap">given<a name="medication-administration-codesystem-given"> </a></td><td>Given</td><td>The dose was administered. Carried on MedicationAdministration.status as #completed.</td><td/></tr><tr><td style="white-space:nowrap">held<a name="medication-administration-codesystem-held"> </a></td><td>Held</td><td>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.</td><td/></tr><tr><td style="white-space:nowrap">refused<a name="medication-administration-codesystem-refused"> </a></td><td>Refused</td><td>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.</td><td/></tr><tr><td style="white-space:nowrap">omitted<a name="medication-administration-codesystem-omitted"> </a></td><td>Omitted</td><td>The dose passed without being given. Carried as #not-done, shared with #refused as above.</td><td/></tr><tr><td style="white-space:nowrap">nil-by-mouth<a name="medication-administration-codesystem-nil-by-mouth"> </a></td><td>Nil by mouth</td><td>The patient is nil by mouth, so an oral dose cannot be given.</td><td/></tr><tr><td style="white-space:nowrap">vomiting<a name="medication-administration-codesystem-vomiting"> </a></td><td>Vomiting</td><td>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.</td><td/></tr><tr><td style="white-space:nowrap">observations-out-of-range<a name="medication-administration-codesystem-observations-out-of-range"> </a></td><td>Observations out of range</td><td>An observation the dose depends on is outside the range it may be given in.</td><td/></tr><tr><td style="white-space:nowrap">awaiting-result<a name="medication-administration-codesystem-awaiting-result"> </a></td><td>Awaiting a result</td><td>A result the dose depends on has not come back yet.</td><td/></tr><tr><td style="white-space:nowrap">prescriber-asked-to-hold<a name="medication-administration-codesystem-prescriber-asked-to-hold"> </a></td><td>Prescriber asked to hold</td><td>The prescriber asked for the dose to be held.</td><td/></tr><tr><td style="white-space:nowrap">patient-refused<a name="medication-administration-codesystem-patient-refused"> </a></td><td>Patient refused</td><td>The patient declined the dose.</td><td/></tr><tr><td style="white-space:nowrap">unable-to-swallow<a name="medication-administration-codesystem-unable-to-swallow"> </a></td><td>Unable to swallow</td><td>The patient could not swallow the dose.</td><td/></tr><tr><td style="white-space:nowrap">adverse-effect-reported<a name="medication-administration-codesystem-adverse-effect-reported"> </a></td><td>Adverse effect reported by patient</td><td>The patient declined the dose, reporting an adverse effect from it.</td><td/></tr><tr><td style="white-space:nowrap">drug-not-available<a name="medication-administration-codesystem-drug-not-available"> </a></td><td>Drug not available</td><td>The drug was not available to give. A supply failure rather than a clinical decision: escalated to pharmacy and counted as a stock-out.</td><td>true</td></tr></table></div>
</text>
<url
value="https://fhir.slade360.co.ke/fhir/CodeSystem/medication-administration-codesystem"/>
<version value="0.1.0"/>
<name value="SGHIMedicationAdministrationCodeSystem"/>
<title value="SGHI Medication Administration Code System"/>
<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>