Kenya Patient Summary FHIR IG
0.1.0 - ci-build Kenya flag

Kenya Patient Summary FHIR IG - Local Development build (v0.1.0) built by the FHIR (HL7® FHIR® Standard) Build Tools. See the Directory of published versions

Business Processes

A business process, or process, is a set of related activities or tasks performed together to achieve the objectives of the health Programme area, such as registration, counseling, and referrals. Workflows are a visual representation of the progression of activities (tasks, events, and interactions) that are performed within the business process. The workflow provides a story for the business process being diagrammed and is used to enhance communication and collaboration among users, stakeholders, and engineers.

Letter Process Name Process ID Personas Objectives Task Set
A Client registration KPS.A Client, Clerk, Community Health Worker To identify and register or update the client’s personal details so that they can benefit from health-care services.
Starting point: Client checks in at facility or is contacted by a health worker.
  • Search for client record
  • Review and update client record
  • Create a new client record
B Clinical Consultation KPS.B Client, Health-care provider (clinician, nurse, CHW) To conduct a comprehensive clinical assessment, document in SHR, support decision-making, and trigger follow-up care.
Starting point: Client has been registered and is being seen for a clinical visit.
  • Take client history
  • Review/update past history & allergies
  • Clinically evaluate the client
  • Request recommended tests
  • Review results with client
  • Record diagnostic decision & procedures
C Diagnostics KPS.C Client, Laboratory technologist, Health-care provider To investigate and obtain results via on-site or off-site diagnostics.
Starting point: Provider identifies the need for testing.
  • Collect specimens
  • Perform or send tests
  • Communicate results to provider
D Treatment KPS.D Client, Health-care provider, Pharmacist To initiate treatment, monitor adherence, and prevent complications.
Starting point: Client has a diagnosis.
  • Perform additional evaluations
  • Determine care plan
  • Set treatment regimen & dosage
  • Discuss adherence & side effects
  • Schedule follow-ups
  • Initiate & record treatment
E Immunization KPS.E Client, Health-care provider, Pharmacist/Vaccine Coordinator To ensure timely vaccination based on guidelines and eligibility.
Starting point: Client assessed as eligible for immunization.
  • Review immunization history
  • Determine eligibility
  • Counsel and obtain consent
  • Prepare and administer vaccine
  • Record vaccine data
  • Schedule next dose
F Emergency care KPS.F Client, Health worker (clinician, CHW) To support rapid, informed emergency decisions and interventions using SHR data.
Starting point: Client identified for emergency services.
  • Identify patient and retrieve SHR
  • Review key history (e.g., allergies)
  • Provide emergency interventions
  • Record decisions, vitals, procedures
G Referral KPS.G Client, Health worker (clinician, CHW) To ensure timely referral to facilities offering unavailable services.
Starting point: Clinician determines client needs services unavailable locally.
  • Determine if it's an emergency
  • Discuss referral locations
  • Contact destination facility
  • Share info with destination
  • Answer client questions

Overview of key processes

This section illustrates the workflows of the identified processes using standardized notations for business process mapping, based on the business process model and notation (BPMN) standard (11). Table below provides an overview of this notation.

Symbol Symbol Name Description
Pool Pool

The pool assumes process control – in other words, it assigns the tasks. A pool consists of one or more “swim lanes” that depict all the individuals or types of users that are involved in carrying out the business process or workflow. Diagrams should be clear, neat and easy for all viewers to understand the relationships across the different swim lanes. For example, a pool would depict the business process of conducting an outreach activity, which involves multiple stakeholders represented by different lanes in that pool.

A business process diagram can contain two or more pools that connect through message flows (messages received from outside of the pool). This indicates different process owners collaborating and exchanging information.

For example, in the case of a referral, the health facility “A” (the referring facility) represents the process owner that assigns internally the tasks for the actors represented as swim lanes in the pool. The health facility “B” (the receiving facility) has allocated its own pool and it’s considered a different process owner, with the same role. These 2 facilities exchange information relevant for a referral (client history, referral details, etc.), represented as message flows, but each facility has control only over the internal activities, without directly impacting the activities of the other facility.

swim-lane Swim lane Each individual or type of user is assigned to a swim lane, a designated area for noting the activities performed or expected by that specific actor.
start-event Start event or trigger event The workflow diagram should contain both a start and an end event, defining the beginning and completion of the task, respectively.
start-event-message Start event message This is a type of a start event. It can include information exchanged between two systems, like data, alerts, or notifications.
end-event End event There can be multiple end events depicted across swim lanes, but for clarity only one per swim lane is recommended.
activity Activity, process, step or task Each activity should start with a verb, e.g., “register client”, “calculate risk”. Includes all actions in a swim lane.
activity-with-sub-process Activity with subprocess Used when a task is too complex and must be detailed in another diagram. Represents a subprocess of the main activity.
activity-with-business Activity with business rule Denotes a task that involves decision-support or business rules. Typically supported by a separate decision logic table.
sequence-flow Sequence flow Shows the order from one task to another. Should not cross other flows and each task has one output (except gateways and end).
message-flow Message flow Represents information passed between two pools (e.g., different facilities or systems).
gateway Exclusive gateway Shows a binary (e.g., yes/no) decision. Limited to two outputs. Complex logic should use “activity with business rule”.
gateway Parallel gateway Used to perform tasks in parallel or join multiple incoming flows. It does not evaluate conditions.
throw-link Throw – link event Marks the end of a workflow that continues elsewhere (off-page connector). Should be followed by a catch – link.
catch-link Catch – link event Starts a new process on a different page from the throw – link or continues a subprocess. Must be paired with a throw – link.
sub-process Ad hoc subprocess Represents multiple activities that may run in any order, multiple times, or be skipped.
loop-activity Loop activity Represents a repeating activity until a specified condition is met. Condition is noted as an annotation.

Overview of key KPS processes

summary

Workflows

Workflows represent the progression of activities performed within the business process. They help users and stakeholders understand the relationship between activities, data elements and decision-support needs. The workflows shown depict processes that have been generalized and may not reflect variation and nuances across different settings. Also, the simplicity of the workflow may not adequately illustrate non-linear steps that may occur.

A. Business process for registration

Objective: To identify and register or update the client’s personal details so that they can benefit from KPS-related services

process-registration

REGISTRATION BUSINESS PROCESS NOTES AND ANNOTATIONS

General note

Registration may be conducted as a stand-alone process by a data entry clerk or administrative persona ahead of the clinical visit or it may be conducted directly by the health worker as part of the overall encounter. These activities can be performed either in the health-care facility or in the community (e.g. client’s home, workplace, mobile van), depending on where the encounter takes place.

1.Was the visit initiated by the client or by the provider?

  • Depending on the reasons that triggered the encounter, the starting activity could be represented either by client’s arrival at the health-care facility or by the health worker’s arrival at the client’s location.
  • Guidelines and guidance:
  • Ministry of Health: Primary Health Care Network Guidelines

2.Client arrives at facility

  • The client arrives at the health-care facility and notifies the outpatient department of their arrival to be further guided.
  • The client could already be registered at the health-care facility for another service, for example, HIV, diabetes.
  • When digital tools, such as video-supported treatment, are used for communicating with the client (e.g. follow-up checks) this activity could be represented by a video call, phone call or other appropriate digital interaction.

3.Arrive at the client’s location

  • The health worker arrives at the client’s location.

4.Gather the client’s details

  • Ask the client whether they have previously been issued with a unique identifier.
  • Does the client have a card, number or barcode?
  • Does the client say they are a returning or referred client?
  • If a referral, check for the referral slip or data from the community.
  • Determine whether the client is new to the health-care facility or health post.
  • For returning clients, details will be retrieved from the facility’s registry of clients or, if possible, from a central client registry.

5.Search for the client record

  • This search process can be done through several different means depending on what mechanisms are available in-country. For example, clients can be searched for by using their name, unique identifier, a quick response (QR) code or even biometrics.

6.Has the correct client record been identified?

  • If multiple records are found for the client, consider merging or deleting duplicate records, according to the HMIS guidelines.

7.Create a new client record

  • Issue a unique identifier if used and possible at the facility.

8.Validate the client details

  • Review and update client record.
    • 8.1. Review the sociodemographic data with the client
      Review the client’s non-clinical information, that is, name, address, contact information, etc.
    • 8.2. Is an update needed?
      Has the client moved? Have they changed their contact information or has any other sociodemographic information changed?
    • 8.3. Update the client details
    • The client can provide updated information if they have moved or changed their details recently.
  • Merge or update client records.
  • This activity could also happen during other clinical encounters, for example, outreaches and medical camps.

9.Checking in the client

  • Record the client’s updated details in the client registry.
  • Add the client to the relevant queue for the specific clinical visit e.g outpatient consultation, special clinic consultation.
  • Send or share intake confirmation to or with the referring facility as warranted.

B. Business process for clinical consultation

Objective: To conduct a comprehensive clinical assessment and initiate appropriate care plan

process-consultation

CLINICAL CONSULTATION BUSINESS PROCESS NOTES AND ANNOTATIONS Steps for clinical consultation process

1.Determine reason for visit

  • Search for client details in the record system and determine the reason for visit.

Initial screenings steps 2–4

Steps may be performed in parallel. One or more of these steps are often performed before meeting with the provider.

2.Take vital signs

  • Also record weight, height, etc. For children, weight will be needed to determine dosage and to check for malnutrition.

3.Check for signs of serious illness

  • Any person who has signs of serious illness should be referred to the appropriate higher-level facility for management. Danger signs differ by age group.
  • Decision logic:
    • Check for signs for serious illness

4.Seriously ill

  • Any person who has signs of serious illness should be referred to the appropriate higher-lever facility for management or receive emergency care, depending on availability and policies.

5.Capture or update client history

  • Discuss history with client and review available records.
  • Include checking medications, symptoms, whether taking all the prescribed drugs, immunization history, use of contraception, signs that she may be pregnant, mental health screening, drug use and nutrition.
  • Check other comorbidity lists.

6.Assess medical history and risk factors 7.Determine social and economic factors

  • Capture information related to the client’s occupation, socioeconomic risk factors (e.g. homelessness, imprisonment) and other health-related risk factors such as:

– disorders due to alcohol use;

– HIV;

– smoking;

– undernutrition;

– disorders due to drug use;

– silica exposure, silicosis;

– viral hepatitis;

– other clinical risk factors, for example, treatment with anti-TNFα3, dialysis, organ or haematological transplantation.

Is referral needed?

  • If, during the evaluation, signs are identified requiring urgent medical care (e.g. gastrointestinal, circulatory, respiratory, neurological) and these cannot be offered at the current facility, a referral to the first referral level of care as per national guidelines, shall be considered.

8.Laboratory diagnostics needed?

  • Determine based on the patient presentation if any tests are needed

9.Determine treatment options 10.Make informed decision on treatment

  • The client will choose the treatment option after being advised by the clinician on all treatment options and what benefit/risks they present

Provide integrated services, steps 11–14

11 Offer voluntary partner and family services
12 Offer sexual and reproductive health services
13 Provide preventive treatment
14 Offer other services
Follow-up needed?

C. Business process for diagnostics

Objective: To investigate and obtain results through on-site or off-site diagnostics.

process-diagnostic

DIAGNOSTICS BUSINESS PROCESS NOTES AND ANNOTATIONS

General note

The clinician may order an investigation during an outpatient consultation or inpatient round. Investigations can include:

  • An RDT performed by the healthcare provider.
  • An order to perform the investigation at a laboratory or diagnostic service at the current facility, if available.
  • An order to refer the client to another facility for the investigation.
  • An order to collect a sample from the client and transport it to another facility.
  • Other specialized diagnostic investigations.

Steps for Diagnostic Process

  1. Determine the diagnostics to perform

    • Check supplies and prioritize based on urgency.
    • Confirm if the facility can accommodate and perform the required diagnostic services.
    • If the facility cannot perform or collect the sample for diagnostics, a referral may be required.
  2. Referral needed?
    An order to refer the client to another facility may be issued if the current facility cannot perform or collect the required diagnostics.

  3. Rapid or point-of-care diagnostic by provider?
    Based on available diagnostics, provider skill, and facility processes, the provider may take a specimen on-site or refer for off-site testing. Diagnostics may be performed during the visit or after, with the client returning to the provider for follow-up.

  4. Collect specimen (Rapid/Point-of-care)

    • Provider briefs the client.
    • Specimen is collected by the healthcare provider for rapid or point-of-care diagnostic testing.
  5. Perform rapid diagnostic or point-of-care diagnostic

  6. Interpret results

  7. Collect specimen for laboratory testing

    • The provider or lab personnel briefs the client and collects the specimen for lab-based diagnostics.
  8. Facility can analyse?
    Determine if the specimen can be processed at the current facility or needs to be referred.

  9. Analyse specimen
    If analysis is possible on-site, conduct pre-analysis, analysis, and post-analysis procedures.

  10. Send specimen to off-site laboratory
    If off-site testing is needed, the facility collects and sends the specimen to another laboratory for analysis.

  11. Update lab register
    Record the test and sample information in the laboratory register for tracking and documentation.

  12. Notify provider of results
    Results are returned to the ordering facility or provider. The client may also receive automated result notifications.

  13. Review lab results
    The provider reviews results and determines if client follow-up is needed based on findings.

D. Business process for treatment

Objective: To initiate the appropriate treatment and perform the necessary follow- up examinations to ensure that the correct treatment is followed and that the patient adheres to it.

process-treatment

TREATMENT BUSINESS PROCESS NOTES AND ANNOTATIONS

Steps for the treatment process

  1. Determine eligibility for treatment regimen type
    The health worker determines whether the client is eligible based on laboratory results and previous clinical evaluation, for a regimen designed to treat.

  2. Capacity for treating exists
    When treatment cannot be started or continued in the current facility (e.g. lack of skills, knowledge, stock of medicines), a referral is issued to transfer the patient to a new treatment facility.

  3. Assess for comorbidities
    Assess comorbidities and risk factors (e.g. diabetes, HIV, smoking, COVID-19) to guide treatment decisions and interpret adverse reactions.

  4. Perform other baseline clinical evaluations
    For subgroups (e.g. pregnant women, elderly), perform clinical, ECG, and lab evaluations before starting treatment.

  5. Evaluate drug–drug interactions
    Evaluate for interactions between treatment drugs and other medications the patient is taking.

  6. Determine the dosages of medicines for treatment
    Determine medicine dosages based on age and weight band.

  7. Make an informed decision
    Align treatment with WHO standards. Obtain informed consent. Counsel patients who refuse treatment.

  8. Initiate the treatment and discuss adherence
    Once consent is obtained and dosages determined, begin treatment and support adherence through:

    • Directly observed therapy
    • Social protection services
    • Psychosocial support
    • Digital health tools
  9. Is follow-up needed?
    Monitor clinical response and symptoms related to long-term drug use.

  10. Assess treatment adherence
    If adherence is poor:

    • Make a home visit
    • Discuss reasons for discontinuation
    • Counsel and support the patient
    • Engage caregivers/community health workers
  11. Evaluate the presence of adverse drug reactions (if any) and report
    Actively monitor and report any adverse reactions to the national pharmacovigilance system.

  12. Perform the follow-up examinations
    Conduct examinations as per the monitoring schedule to identify and address issues early.

  13. Manage treatment interruptions
    Address reasons for interruption (e.g. stock-outs, side effects), counsel the client, and resume treatment as needed.

  14. Reassess for comorbidities
    Repeat assessments and adjust the treatment approach if new or unresolved conditions are identified.

  15. Adjust the treatment
    Based on evaluation results, adjust composition/duration or change the regimen. Refer if necessary.

  16. Issue a referral
    Refer for continued care of comorbidities or adverse events. Ensure patient preferences and clear referral pathways.

  17. Offer other clinical and support services
    If treatment cannot be started, provide other clinical or social support services tailored to the patient’s needs.

E. Business process for immunisation

Objective: To ensure timely administration of vaccines in line with national guidelines and patient eligibility, especially during pregnancy.

process-immunisation

IMMUNISATION BUSINESS PROCESS AND ANNOTATIONS

  1. Check vaccine eligibility
    The clinician assesses whether the patient is due for any vaccines based on gestational age, immunization history, and national guidelines (e.g., KEPI). This check may be triggered by clinical workflow or decision support systems.

  2. Review immunisation history
    The clinician or nurse reviews the patient’s immunization records retrieved from EMR and SHR to avoid duplication and determine whether the vaccine is the first dose, a second dose, or a booster.

  3. Counsel patient
    The patient is briefed on the importance of the vaccine, its expected benefits, and any potential side effects. Risks are contextualized, such as the prevention of neonatal tetanus.

  4. Make an informed decision
    The patient engages in discussion, may ask questions, and gives formal consent to proceed. Consent is documented digitally (e.g., checkbox or e-signature) or in writing.

  5. Verify vaccine stock and cold chain
    The nurse checks that the required vaccine is available, within expiry date, and stored properly under cold chain conditions. Verification may include checking VVM (Vaccine Vial Monitor) or barcodes in the stock system.

  6. Record vaccine details
    The provider records all relevant data, including:

    • Date of administration
    • Dose given
    • Manufacturer
    • Batch/lot number
    • Administration site and route
    • Adverse events (if any)
    • Provider ID
  7. Administer vaccine
    The vaccine is given following national protocols — route (e.g., intramuscular), site (e.g., upper arm), and dose (e.g., 0.5 mL TT).

  8. Set reminder for the next dose
    For multi-dose schedules (e.g., TT2), a reminder is entered into the EMR. The reminder aligns with scheduled milestones and national immunization guidelines.

F. Business process for emergency care

Objective: To initiate the appropriate treatment and perform the necessary follow- up examinations to ensure that the correct treatment is followed and that the patient adheres to it.

process-emergency

EMERGENCY CARE BUSINESS PROCESS NOTES AND ANNOTATIONS

General note

G. Business process for referral

Objective: To provide timely and appropriate referrals to another health-care facility that can provide services unavailable within this facility

process-referral

REFERRAL BUSINESS PROCESS NOTES AND ANNOTATIONS

General notes

Examples of reasons for referral include:

  • the health worker cannot provide the service because of a lack of training and skills;
  • the facility does not have the supplies needed to provide the service;
  • the facility cannot perform the service for other reasons;
  • there is an emergency and the client needs immediate referral.
  1. Emergency referral?
    If the client needs immediate referral due to an emergency situation, bypass standard referral steps.
    In an emergency, a referral can be made at any time, including during diagnosis and treatment encounters.

  2. Emergency referral

    1. 2.1 Stabilize the client and give pre-referral treatment
      The client is assumed to need emergency referral if their condition requires immediate medical attention. Stabilize the client’s condition and provide any necessary treatment.
    2. 2.2 Is the client stable enough to transport?
      Once the client is stable enough to transport, immediately organize it. If the client is still not stable, provide pre-referral treatment for stabilization.
    3. 2.3 Organize transport
      For emergency referrals, the health-care facility usually arranges for an ambulance or other vehicle.
  3. Identify and discuss referral location options
    In discussion with the client and their relatives, decide where the client will be referred to. Discussions include:

    • how to get to the referral facility, including location and transportation options;
    • who to see and what is likely to happen;
    • whether to follow up on return.

    Either the client or the client’s relatives should decide on a referral location based on their preferences.

  4. Contact referral facility
    Health workers should contact the referral facility to determine whether that facility can accommodate such a referral.

  5. Can the facility accommodate?
    Check whether facility can accommodate the client and provide the services needed.
    If the facility can accommodate the client, move on to step 6.
    Otherwise, find a different facility that is able to accommodate the client.
    A system can be set up to catalogue referral facilities, and what type of referral needs they can handle to accommodate a referral.

  6. Provide information to the receiving facility
    Make an appointment, if needed.
    If not an emergency referral, the client or family arranges transport.
    For emergency referrals, the health-care facility arranges transport, usually by phoning the district for an ambulance or other vehicle, and informing the receiving facility that the emergency client is on the way.
    Fill out a referral form, which can include notification of the referral destination.
    Provide the necessary clinical, sociodemographic and identity information to the referral facility. This can be done digitally if the appropriate systems are in place.

  7. Discuss any questions with the client
    Discuss any of the client’s questions or concerns.

  8. Check whether the client can be accommodated
    The receiving facility evaluates the needs and assesses if the client can receive the services needed.

  9. Is it possible to accommodate the client?
    If the receiving facility cannot accommodate the client, it will inform the source facility. If accommodation for the client is possible, move on to step 10.

  10. Receive the client
    The receiving health-care facility receives the client, along with all the necessary clinical, sociodemographic and identification information, and provides the services. If both facilities use digital systems with interoperability standards in place, the information can be exchanged digitally in a faster and more reliable way.