Running a Pharmacy That Serves HMO Enrollees in Nigeria: The Complete 2027 Guide to Chronic-Medication Refills

A customer asks for the same maintenance medicine again, and nobody at the counter is sure when it was last supplied. If you run a licensed pharmacy in Nigeria that serves customers linked to an HMO, that question will reach your counter. An HMO (health maintenance organisation) is the company that pays part of a member's care. This guide shows how to record days supply, flag early refills, pick stock by expiry, sell offline and report in Excel with the ClinikEHR Pharmacy edition.

Quick Answer

To manage chronic refills for customers linked to an HMO, record days supply on every maintenance line and let the four till checks flag early or repeated supplies.

• Open Dispensing details at the till and record days supply: 30, 60, 90 or a custom number. Without it, the early-refill check stays silent.
• Attach a registered customer to the sale. The four checks run only for registered customers, never for a walk-in.
• Read each warning and decide. The till flags and never stops the sale, and the reason you record is optional.
• Let ClinikEHR pick the lot (one batch of a medicine) with the earliest expiry date first, and keep selling when the internet drops. An offline sale is checked only after it syncs.
• Export your reports to Excel and choose a plan from the naira prices. The checks need the Professional plan or above.

What Is a Chronic-Medication Refill, in Plain Words

A chronic medicine is one a person takes for a long time. ClinikEHR marks it as Chronic / maintenance. A refill is the next supply of the same medicine. Days supply is how many days one supply should last. ClinikEHR lets you record 30, 60, 90 or a custom number on each line of a sale.

An enrollee is a person an HMO covers. The HMO is a separate organisation from your pharmacy. It is the payer and, where it has a portal, the portal's user.

In the Pharmacy edition the people you serve are called customers, and there is no enrollee customer type. At the till a person is either a walk-in customer or a registered customer. In this guide, customers linked to the HMO are registered customers whom an HMO's own connection may reach through the API (the way one system reads another's records). The section on the API explains that link.

Which ClinikEHR Edition This Guide Covers

This guide covers one edition: the Pharmacy edition at pharmacy.clinikehr.com. It has its own plans, Starter, Professional, Business and Enterprise, priced in naira. It has an offline point of sale, stock held by lot, registered customers with part payments, four dispensing checks and Excel reports.

The Pharmacy edition does not bill an HMO. Bill HMO and HMO receivables are not on the Pharmacy or Diagnostics editions, because neither has an insurance module. The Pharmacy edition holds no HMO price lists and sends no claims. It does not check whether a person is covered, and it has no connection to the National Health Insurance Authority (NHIA).

Hospitals use another edition for HMO billing. On the Clinic and Hospital edition, Bill HMO is available on any plan once the owner sets Insurance to Outside the US under Settings, General, Insurance. The hospital guide to getting paid by HMOs covers it.

Record Days Supply on Every Maintenance Line

Step 1: Record Days Supply on the Line

What to do. In the cart toolbar, open Dispensing details. On any line, record the days supply: 30, 60, 90 or a custom number. You can also type a prescription number there. Only the repeated-number check uses it.

What you need. The Pharmacy edition. The checks that read days supply need the Professional plan or above.

How you know it worked. When the same registered customer asks for that medicine early, the cart shows a warning that names the earlier supply and its days supply. The Help Center's own example reads:

Last supplied 2 September, 28 days' supply; next due 30 September.

ClinikEHR Help Center, Refill and duplicate-dispensing checks

The mistake people make. Leaving days supply blank because the sale looks routine. The early-refill check then has nothing to compare against and stays silent.

ClinikEHR has no refill scheduler and sends no reminder. Days supply is stored on each line and used for the early-refill check, so the reminder routine stays with your team. The Help Center page on these checks has the detail.

Step 2: Mark Each Maintenance Medicine

What to do. Mark a medicine as Chronic / maintenance once, in the same Dispensing details panel. After that, every sale of it nudges staff to record days supply. If no customer is on the sale, the till asks once per sale whether to attach one, so it can check when the medicine was last supplied.

What you need. The Pharmacy edition, and a registered customer to attach.

How you know it worked. The next sale of that medicine nudges staff to record days supply. If no customer is on the sale, the till also asks once whether to attach one. That question does not appear while the till is offline or when a customer is already on the sale.

The mistake people make. Expecting the mark to schedule the next refill. It only prompts staff at the till.

Serve Registered Customers and Walk-In Customers in One System

The same till serves both kinds of person. They differ in what ClinikEHR can remember about them.

Step 3: Leave Walk-Ins as Walk-Ins

What to do. Walk-in is the default and needs nothing. You can add a name and a phone number, both optional, so the sale is traceable.

What you need. Nothing more.

How you know it worked. The sale completes, and no customer record is created.

The mistake people make. Typing a name into the walk-in boxes and expecting a history check.

Step 4: Register the Customers You Will See Again

What to do. Attach a registered customer when the sale involves money on account, loyalty or part payment. Do the same for any customer whose maintenance medicine you want checked. A registered customer has a profile with purchases, debts, money on account and the people allowed to collect. Part payment is tracked as a debtor, and a debtor must be a named, registered customer.

What you need. The Pharmacy edition. A cashier cannot open the Customers screen. The Help Center page on customers covers the screen.

How you know it worked. The person appears on the Customers screen, which fills only as you add people.

The mistake people make. Attaching the customer after the sale. The warning appears in the cart before you complete the sale, so attach first.

Customers linked to the HMO. The Pharmacy customer record has no insurer, plan or member-number field. A customer is linked to an HMO only in the API sense. An HMO's key sees only the customers linked to its connection.

The Four Till Checks, and What They Do and Do Not Do

When a sale to a registered customer looks like an early refill, a repeat or an unusual quantity, the till shows an amber warning above the cart. The warning carries the evidence behind it. The checks need the Professional plan or above on the Pharmacy edition.

Four rules hold for every check:

• Registered customers only. A walk-in cannot be checked, and no warning is not the same as clear.
• It warns and never stops the sale. A lost bottle, a changed dose or a trip are real reasons to dispense anyway. The person at the counter decides.
• The reason is optional. Press Add a reason to record why you went ahead.
• It is evidence, not a promise. The checks flag what ClinikEHR's records show and cannot promise to catch everything.

Step 5: Read the Warning and Decide

What to do. Read the warning, which names the medicine and the reason. Decide whether to go ahead. Add a reason if your pharmacy's own policy asks for one.

What you need. A registered customer on the sale, and a days supply for the early-refill check.

How you know it worked. The warning shows above the cart, the sale still completes, and any reason you added appears on the flagged sale in the review list.

The mistake people make. Treating a warning as a verdict. It is evidence for the pharmacist to weigh.

The two examples below are illustrative, invented and separate. Neither is data.

• Early refill (illustrative). A registered customer receives a maintenance medicine, and the pharmacist records a days supply of 30. The customer asks for it again 15 days later. The till warns, showing the earlier supply date. The pharmacist may record a reason, such as travel, and carry on. Had days supply not been recorded, no warning would show.
• Walk-in (illustrative). A walk-in buys a bottle of syrup. No customer record is created and no history check runs.

Step 6: Review Flagged Sales and Adjust the Checks

What to do. Open the review list. The owner, managers and anyone granted the permission can see every flagged sale with its evidence and any reason recorded. Filter it by check and by date. On the Thresholds tab of the same page, change how sensitive each check is, or turn one off. The early-refill grace period and the unusual-quantity multiple can be adjusted.

What you need. An owner or manager login, or anyone granted the permission.

How you know it worked. Each flagged sale appears with its check, its evidence and any reason.

The mistake people make. Never opening the list. The reasons your staff recorded sit there.

How You Know the Counter Is Set Up

• A maintenance line shows a days supply in Dispensing details.
• An early repeat request from a registered customer shows the amber warning above the cart.
• The flagged sale appears in the review list with its evidence.

Pick Stock Earliest-Expiry-First

Step 7: Receive Stock by Lot and Let ClinikEHR Pick

What to do. Receive each delivery as a lot (one batch of a medicine) with its own quantity, location and expiry date. When something is sold or dispensed, ClinikEHR picks the lot with the earliest expiry date first. The till and the dispensing sheet show which lot was used. Set expiry alerts at up to four day-values. Ninety, 60 and 30 days is the usual set.

What you need. The Pharmacy edition. Lot control is on every plan. The expiry-risk projection needs the Professional plan. The Help Center page on batches and expiry has the screens.

How you know it worked. The till names the lot it used, and an alert is raised when a lot crosses a day-value you set.

The mistake people make. Entering a lot without its expiry date. No expiry alert can warn you about an undated lot. Turn on Require expiry date on new lots under Settings, Inventory, Receiving quality, so a delivery cannot be received without one.

Keep Selling When the Internet Drops

Step 8: Ring Up Sales Offline

What to do. Sell as you always do. Sales are saved on the terminal and sync on their own when the network returns. Offline you can complete a sale on any payment method except Account balance, including part payment and credit. You can scan and search the saved catalogue, hold carts and print the receipt. The receipt is marked PROVISIONAL — WILL CONFIRM ON SYNC, carries a provisional number and has no barcode. It is a real sale from the moment you complete it.

Three things at the till need a connection: Account balance as a payment method, searching for a registered customer, and redeeming a loyalty reward. Everything outside the till, such as receiving stock and reports, needs one too.

What you need. The Pharmacy edition, on any plan. The Help Center page on offline selling.

How you know it worked. The offline receipt carries the provisional wording, and the sale takes its confirmed number once it syncs.

The mistake people make. Planning to look up a registered customer while offline.

Step 9: Let Offline Sales Sync, Then Read the Review List

What to do. A sale taken offline is never checked against history at the counter. Once it reaches ClinikEHR's own record, the same check runs. Any finding appears later in the review list. It never changes or reverses the sale that already happened.

Each offline sale carries its capture time, so it lands in the right trading day and counts in reports. A sale ClinikEHR refuses goes to Need review and waits for a person.

What you need. A person who opens the review list and the Need review list.

How you know it worked. Waiting sales clear, and the day's totals include them.

The mistake people make. Reading a missing warning on an offline sale as a clear result. The check had not run yet.

Read Your Numbers in Excel

Step 10: Export a Report

What to do. Pick one of the eleven pharmacy reports, choose a period and export the view to CSV or Excel. The Excel choice gives a formatted workbook that is built for you and downloaded. The sales page exports an accounting workbook with a category summary, per-product detail and a reconciliation to the till. The executive dashboard has Export Excel on its report tabs.

What you need. Reports and the sales page are on every plan. The executive dashboard needs the Professional plan or above. The Help Center page on reports lists them.

How you know it worked. A workbook downloads and opens in Excel with the period you chose.

The mistake people make. Expecting stock quantities in the catalogue export. It exports the catalogue to Excel or CSV without them.

Choose a Plan in Naira

A new Pharmacy workspace starts in naira. Your plan includes its seats, and nothing is billed per seat. The prices below are monthly list prices from the edition's price list at pharmacy.clinikehr.com. Check that page before you decide.

A new pharmacy can start a 7-day trial. It runs on the Professional plan, which carries the four checks, and needs no card. The Help Center page on choosing a plan explains the trial.

How an HMO's Portal Can Connect to Your Pharmacy

This section is a short map. It assumes the HMO builds its portal as a separate organisation with its own key. It uses the ClinikEHR API (api.clinikehr.com), the API of the ClinikEHR app. It is a different product from ClinikAPI (clinikapi.com), a separate developer product built on FHIR R4, a health data standard, with its own keys and licence. Start at the API documentation.

Step 11: Decide What the Portal May Read

What to do. Treat two kinds of data differently.

• Stock, availability and medicine codes are not patient data. They need no patient-data approval. The pharmacy needs a plan with API access, which starts at Business on the Pharmacy edition. Once the connection grants the permission, a portal can read availability bands: out, low or in stock. Locations and exact quantities need inventory.stock:read. A band carries the time of the item's last recorded stock movement. It is not a reservation.
• Drug requests and dispensing history are patient data. They need the pharmacy on its Enterprise plan. The HMO organisation also needs ClinikEHR's approval for each kind of data and an accepted data-protection addendum. The connection needs a recorded legal basis (the reason the pharmacy gives for sharing the data).

A drug request asks the pharmacy to prepare medicines for a linked customer. It is a request, not a prescription, and the pharmacist always decides. The portal cannot accept it, mark it ready or dispense it. Dispensing history is read-only: medicine, quantity, days supply and date, with the flags a pharmacist recorded. It never shows a price, another customer or a staff name.

The HMO can also upload its own medicine codes. A row links to a pharmacy item automatically only on an exact barcode, NAFDAC number or other standard drug code. A match on name alone goes to review. It is a code match, not a check of what a plan covers.

An HMO that receives patient information accepts a data-protection addendum with Bettar Platforms, Inc. It has a clause for organisations established in Nigeria, and the clause names the Nigeria Data Protection Act (NDPA). That is a contract term, not a certification, and this guide is not legal advice.

What you need. The pharmacy's owner generates a one-time connection code and approves what the connection may read. The connections page and the dispensing page give the detail.

How you know it worked. The pharmacy's access log records each read of patient data. The owner can narrow or end the connection at any time, and access stops with the next request.

The mistake people make. Expecting the portal to see every customer. A customer who is not linked, or who does not exist, gets the same not-found answer.

Pharmacy Software for Pharmacies That Serve HMO Enrollees: What to Look For

Use these questions with any pharmacy software, ClinikEHR included, and ask for a live demo of each answer. To compare products, read the top 10 and top 5 guides to pharmacy software in Nigeria.

1. Does it keep selling when the internet drops? Yes, on every plan. See Step 8.
2. Does it flag early refills and duplicates at the till? Yes, for registered customers on Professional and above. See the four checks above.
3. Can it record days supply of 30, 60, 90 or a custom number? Yes, per line. There is no refill scheduler or reminder.
4. Does it pick stock earliest-expiry-first? Yes. See Step 7.
5. Does it hold registered customers and walk-in customers at the same till? Yes. A walk-in cannot be checked.
6. Does it have an API an HMO portal can use? The ClinikEHR API covers stock, availability, drug requests and dispensing history. The last two are patient data with their own approvals. See the API section above.
7. Can an HMO's own medicine codes be matched to your items? They link on exact identifiers, and a name-only match goes to review.
8. Does it export to Excel? Yes, eleven reports. See Step 10.
9. Is it priced in naira? Yes. A new Pharmacy workspace starts in naira.
10. What data-protection terms apply when a portal reads patient information? The addendum with Bettar Platforms, Inc. has NDPA terms. Ask any vendor for the same in writing.
11. Does it bill an HMO? The Pharmacy edition does not. See the edition section.

Mistakes That Cost Pharmacies Money

• Treating the Insurance payment method as an HMO claim. It asks for a claim number and records it. It creates no claim and checks no cover.
• Wiping a terminal with sales waiting to sync. Unsynced sales live on that terminal and nowhere else. Do not clear browser data or reset the machine until they sync.
• Turning a check off to quiet the till. The owner can do it, but that check then flags nothing.
• Expecting every sale to appear as a flag. A flag appears only when a check found something. A walk-in with no customer record is never returned, and a sale where no check ran is not a finding.
• Expecting a drug request to carry a price. A request has no price, so do not plan around one.

Frequently Asked Questions

How do I manage chronic-medication refills at a pharmacy in Nigeria?

Record days supply on each line at the till: 30, 60, 90 or a custom number. Mark each maintenance medicine as Chronic / maintenance so staff are nudged to record it. Attach a registered customer so the early-refill check has history to compare. ClinikEHR has no refill scheduler or reminder, so your team keeps that routine.

Will the till refuse an early refill?

No. The till shows a warning with its evidence and never stops the sale. The pharmacist decides, and the reason they record is optional. The checks flag what ClinikEHR's records show, and they cannot promise to catch every early refill.

Which checks does the till run, and for whom?

Four checks run: early refill, dispensed again today, prescription number repeated, and unusual quantity. They run only for a registered customer, never for a walk-in. The early-refill check stays silent unless days supply was recorded. On the Pharmacy edition they need the Professional plan or above.

Are offline sales checked for early refills and duplicates?

Not at the counter. A sale taken offline is checked once it reaches ClinikEHR's own record. Any finding appears later in the review list, and it never changes or reverses the sale. Searching for a registered customer needs a connection.

Can the Pharmacy edition bill an HMO or send claims?

No. Bill HMO and HMO receivables are not on the Pharmacy or Diagnostics editions, and the Pharmacy edition sends no claims. Its Insurance payment method only records a claim number. On the Clinic and Hospital edition, Bill HMO is available on any plan once the owner sets Insurance to Outside the US.

Can one system serve walk-in customers and customers linked to an HMO?

Yes. Walk-in is the default at the till, and registered customers carry purchases, debts and money on account. The customer record has no insurer or member-number field. A customer is linked to an HMO only through an API connection, and a walk-in cannot be checked.

What does the Pharmacy edition cost in naira?

The monthly list prices are ₦60,000 for Starter, ₦95,000 for Professional and ₦150,000 for Business. Enterprise is custom. Seats are included in each plan. A new pharmacy can start a 7-day trial on the Professional plan with no card.

Can an HMO's portal connect to my pharmacy?

Yes, through the ClinikEHR API, as a separate organisation with its own key. Stock and availability need no patient-data approval. Drug requests and dispensing history need the pharmacy on its Enterprise plan, ClinikEHR's approval for the HMO organisation, and an accepted data-protection addendum. The pharmacist decides every request.

Conclusion

A pharmacy that serves customers linked to an HMO needs a clear record of what it supplied on chronic medicines and for how long. In ClinikEHR that record is days supply on each line, four till checks for registered customers, and stock taken by earliest expiry. Offline sales and Excel reports keep the counter and the books working together.

The limits are listed in the four rules, in Step 9 and in the edition section. Try it on the 7-day trial, and use contact for questions about Enterprise or the API.

Related Articles

• How Pharmacies That Serve HMO Enrollees in Nigeria Can Flag Early Refills and Duplicate Dispensing of Chronic Medication (2027)
• How to Connect an HMO Portal to a Licensed Pharmacy in Nigeria: Stock Availability and Drug Request API (Developer Guide, 2027)
• Top 10 Pharmacy Management Software in Nigeria 2027 (Updated Review)
• Top 5 Pharmacy Management Software in Nigeria 2027 (Updated Review)
• Offline-First Pharmacy POS: Why It Matters When Your Internet Drops
• How to Track Drug Expiry and Lot Numbers Without Losing Stock to Waste
• Credit Sales in Nigerian Pharmacies: How to Track Debtors Without Losing Money
• Pharmacy Accounting Software in Nigeria: Track Daily Profit Without a Manual Ledger
• Getting Paid by HMOs in Nigeria: The Complete 2027 Guide for Hospital Owners and Billers
• ClinikEHR API documentation

Facts are as of the dates shown. Check the linked sources for updates. This is general information, not legal or professional advice.