Kenya eClaims FHIR Implementation Guide
0.1.0 - ci-build Kenya flag

Kenya eClaims FHIR Implementation Guide, published by Digital Health Agency of Kenya. 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/IntelliSOFT-Consulting/Kenya-eClaims-FHIR-IG/ and changes regularly. See the Directory of published versions

: Example Claim Submission - XML Representation

Raw xml | Download


<Claim xmlns="http://hl7.org/fhir">
  <id value="ECLM-SUB-001"/>
  <meta>
    <profile
             value="https://nshr-uat.sha.go.ke/fhir/StructureDefinition/ke-eclaims-claimsubmission"/>
    <tag>
      <system value="http://terminology.hl7.org/CodeSystem/common-tags"/>
      <code value="actionable"/>
      <display value="Actionable"/>
    </tag>
  </meta>
  <text>
    <status value="extensions"/>
    <div xmlns="http://www.w3.org/1999/xhtml"><p class="res-header-id"><b>Generated Narrative: Claim ECLM-SUB-001</b></p><a name="ECLM-SUB-001"> </a><a name="hcECLM-SUB-001"> </a><div style="display: inline-block; background-color: #d9e0e7; padding: 6px; margin: 4px; border: 1px solid #8da1b4; border-radius: 5px; line-height: 60%"><p style="margin-bottom: 0px"/><p style="margin-bottom: 0px">Profile: <a href="StructureDefinition-ke-eclaims-claimsubmission.html">Claim Submission</a></p><p style="margin-bottom: 0px">Tag: <a href="http://hl7.org/fhir/R4/codesystem-common-tags.html">Actionable (Details: Common Tags code actionable = 'Actionable')</a></p></div><blockquote><p><b>Patient Invoice Details</b></p><ul><li>invoiceNumber: INV-2025-00789</li><li>invoiceDate: 2025-11-22</li><li>invoiceAmount: <span title="Kenyan Shilling">KES85,000.00</span> (KES)</li><li>patientShare: <span title="Kenyan Shilling">KES0.00</span> (KES)</li></ul></blockquote><p><b>identifier</b>: <code>https://nshr-uat.sha.go.ke/fhir/Identifier/claim-number</code>/CLAIM-SUB-001</p><p><b>status</b>: Active</p><p><b>type</b>: <span title="Codes:{https://nshr-uat.sha.go.ke/fhir/CodeSystem/claim-type-cs institutional}">Institutional</span></p><p><b>subType</b>: <span title="Codes:{https://nshr-uat.sha.go.ke/fhir/CodeSystem/claim-subtype-cs inpatient}">Inpatient</span></p><p><b>use</b>: Claim</p><p><b>patient</b>: <a href="Patient-ECLM-PT-001.html">John Mwangi Kamau (official) Male, DoB: 1985-06-15 ( National ID: 12345678 (use: official, ))</a></p><p><b>billablePeriod</b>: 2025-11-20 --&gt; 2025-11-22</p><p><b>created</b>: 2025-11-23 09:00:00+0300</p><p><b>insurer</b>: <a href="Organization-ECLM-INS-001.html">Organization Social Health Authority</a></p><p><b>provider</b>: <a href="Organization-ECLM-ORG-001.html">Organization Nairobi General Hospital</a></p><p><b>priority</b>: <span title="Codes:{http://terminology.hl7.org/CodeSystem/processpriority normal}">Normal</span></p><h3>Payees</h3><table class="grid"><tr><td style="display: none">-</td><td><b>Type</b></td></tr><tr><td style="display: none">*</td><td><span title="Codes:{http://terminology.hl7.org/CodeSystem/payeetype provider}">Provider</span></td></tr></table><h3>CareTeams</h3><table class="grid"><tr><td style="display: none">-</td><td><b>Sequence</b></td><td><b>Provider</b></td><td><b>Role</b></td><td><b>Qualification</b></td></tr><tr><td style="display: none">*</td><td>1</td><td><a href="Practitioner-ECLM-PRA-001.html">Practitioner Dr. James Ochieng (official)</a></td><td><span title="Codes:{https://nshr-uat.sha.go.ke/fhir/CodeSystem/claim-care-team-role-cs PRIMARY}">Primary provider</span></td><td><span title="Codes:{https://nshr-uat.sha.go.ke/fhir/CodeSystem/eclaims-provider-qualification-cs MBChB}">Bachelor of Medicine and Bachelor of Surgery (MBChB)</span></td></tr></table><h3>Diagnoses</h3><table class="grid"><tr><td style="display: none">-</td><td><b>Sequence</b></td><td><b>Diagnosis[x]</b></td></tr><tr><td style="display: none">*</td><td>1</td><td><span title="Codes:{https://nshr-uat.sha.go.ke/fhir/CodeSystem/icd11-codes-cs DC80}">Appendicitis</span></td></tr></table><h3>Insurances</h3><table class="grid"><tr><td style="display: none">-</td><td><b>Sequence</b></td><td><b>Focal</b></td><td><b>Coverage</b></td></tr><tr><td style="display: none">*</td><td>1</td><td>true</td><td><a href="Coverage-ECLM-COV-001.html">Coverage: extension = Mobile Money,Active,General Practice; identifier = https://nshr-uat.sha.go.ke/fhir/Identifier/coverage-number#COV-SHA-2024-001234; status = active; type = Medical; relationship = Self; period = 2024-01-01 --&gt; 2024-12-31</a></td></tr></table><blockquote><p><b>item</b></p><p><b>sequence</b>: 1</p><p><b>careTeamSequence</b>: 1</p><p><b>category</b>: <span title="Codes:{http://terminology.hl7.org/CodeSystem/ex-benefitcategory 2}">Surgical</span></p><p><b>productOrService</b>: <span title="Codes:{https://nshr-uat.sha.go.ke/fhir/CodeSystem/KenyaSocialHealthAuthorityInterventionCS SHA-19}">Surgical Services</span></p><p><b>quantity</b>: 1</p><h3>UnitPrices</h3><table class="grid"><tr><td style="display: none">-</td><td><b>Value</b></td><td><b>Currency</b></td></tr><tr><td style="display: none">*</td><td>85000</td><td>Kenyan shilling</td></tr></table><h3>Nets</h3><table class="grid"><tr><td style="display: none">-</td><td><b>Value</b></td><td><b>Currency</b></td></tr><tr><td style="display: none">*</td><td>85000</td><td>Kenyan shilling</td></tr></table></blockquote><h3>Totals</h3><table class="grid"><tr><td style="display: none">-</td><td><b>Value</b></td><td><b>Currency</b></td></tr><tr><td style="display: none">*</td><td>85000</td><td>Kenyan shilling</td></tr></table></div>
  </text>
  <extension
             url="https://nshr-uat.sha.go.ke/fhir/StructureDefinition/eclaims-patient-invoice">
    <extension url="invoiceNumber">
      <valueString value="INV-2025-00789"/>
    </extension>
    <extension url="invoiceDate">
      <valueDate value="2025-11-22"/>
    </extension>
    <extension url="invoiceAmount">
      <valueMoney>
        <value value="85000"/>
        <currency value="KES"/>
      </valueMoney>
    </extension>
    <extension url="patientShare">
      <valueMoney>
        <value value="0"/>
        <currency value="KES"/>
      </valueMoney>
    </extension>
  </extension>
  <identifier>
    <system value="https://nshr-uat.sha.go.ke/fhir/Identifier/claim-number"/>
    <value value="CLAIM-SUB-001"/>
  </identifier>
  <status value="active"/>
  <type>
    <coding>
      <system
              value="https://nshr-uat.sha.go.ke/fhir/CodeSystem/claim-type-cs"/>
      <code value="institutional"/>
      <display value="Institutional"/>
    </coding>
  </type>
  <subType>
    <coding>
      <system
              value="https://nshr-uat.sha.go.ke/fhir/CodeSystem/claim-subtype-cs"/>
      <code value="inpatient"/>
      <display value="Inpatient"/>
    </coding>
  </subType>
  <use value="claim"/>
  <patient>🔗 
    <reference value="Patient/ECLM-PT-001"/>
  </patient>
  <billablePeriod>
    <start value="2025-11-20"/>
    <end value="2025-11-22"/>
  </billablePeriod>
  <created value="2025-11-23T09:00:00+03:00"/>
  <insurer>🔗 
    <reference value="Organization/ECLM-INS-001"/>
  </insurer>
  <provider>🔗 
    <reference value="Organization/ECLM-ORG-001"/>
  </provider>
  <priority>
    <coding>
      <system value="http://terminology.hl7.org/CodeSystem/processpriority"/>
      <code value="normal"/>
      <display value="Normal"/>
    </coding>
  </priority>
  <payee>
    <type>
      <coding>
        <system value="http://terminology.hl7.org/CodeSystem/payeetype"/>
        <code value="provider"/>
        <display value="Provider"/>
      </coding>
    </type>
  </payee>
  <careTeam>
    <sequence value="1"/>
    <provider>🔗 
      <reference value="Practitioner/ECLM-PRA-001"/>
    </provider>
    <role>
      <coding>
        <system
                value="https://nshr-uat.sha.go.ke/fhir/CodeSystem/claim-care-team-role-cs"/>
        <code value="PRIMARY"/>
        <display value="Primary provider"/>
      </coding>
    </role>
    <qualification>
      <coding>
        <system
                value="https://nshr-uat.sha.go.ke/fhir/CodeSystem/eclaims-provider-qualification-cs"/>
        <code value="MBChB"/>
        <display
                 value="Bachelor of Medicine and Bachelor of Surgery (MBChB)"/>
      </coding>
    </qualification>
  </careTeam>
  <diagnosis>
    <sequence value="1"/>
    <diagnosisCodeableConcept>
      <coding>
        <system
                value="https://nshr-uat.sha.go.ke/fhir/CodeSystem/icd11-codes-cs"/>
        <code value="DC80"/>
        <display value="Appendicitis"/>
      </coding>
    </diagnosisCodeableConcept>
  </diagnosis>
  <insurance>
    <sequence value="1"/>
    <focal value="true"/>
    <coverage>🔗 
      <reference value="Coverage/ECLM-COV-001"/>
    </coverage>
  </insurance>
  <item>
    <sequence value="1"/>
    <careTeamSequence value="1"/>
    <category>
      <coding>
        <system
                value="http://terminology.hl7.org/CodeSystem/ex-benefitcategory"/>
        <code value="2"/>
        <display value="Surgical"/>
      </coding>
    </category>
    <productOrService>
      <coding>
        <system
                value="https://nshr-uat.sha.go.ke/fhir/CodeSystem/KenyaSocialHealthAuthorityInterventionCS"/>
        <code value="SHA-19"/>
        <display value="Surgical Services"/>
      </coding>
    </productOrService>
    <quantity>
      <value value="1"/>
    </quantity>
    <unitPrice>
      <value value="85000"/>
      <currency value="KES"/>
    </unitPrice>
    <net>
      <value value="85000"/>
      <currency value="KES"/>
    </net>
  </item>
  <total>
    <value value="85000"/>
    <currency value="KES"/>
  </total>
</Claim>