Admin Packages - hmislk/hmis GitHub Wiki

Packages and Medical Packages

Overview

Packages allow multiple services to be sold together as a single bundled item at a fixed or discounted combined price. HMIS supports two types of packages: general packages (for any bundled service combination) and OPD Medical Packages (specifically designed for outpatient clinical bundles such as health check-up packages).

When to Use

  • Creating a health check-up package that includes a consultation, blood tests, and an ECG
  • Offering a corporate wellness package at a special combined rate
  • Bundling common procedure combinations to simplify billing

Navigating to Package Management

  1. Click Administration → Manage Items
  2. In the item management index, look for Packages (general) or OPD Medical Packages

Required privilege: AdminItems

General Package Setup

Step 1: Create the Package Name

Navigate to Package Name in the pricing section:

  1. Click Add New
  2. Enter the package name
  3. Click Save

Step 2: Add Items to the Package

Navigate to Package Item:

  1. Select the package you just created
  2. Add the individual services/investigations that make up the package
  3. Save

Step 3: Set Package Pricing

Navigate to Package Item Prices:

  1. Select the package
  2. Set the price for each included item (or the overall package price)
  3. Save

OPD Medical Package Setup

OPD Medical Packages follow the same three-step process using OPD Medical Package Name, OPD Medical Package Item, and OPD Medical Package Item Prices.

OPD Medical Package vs General Package

Feature OPD Medical Package General Package
Used for Outpatient clinical bundles Any service bundles
Billing module OPD Any module
Pricing granularity Per-item or bundle price Per-item or bundle price

Technical Notes (Admin/Developer)

Packages are modelled as Item entities of type Package, with child PackageItem records linking the member services. Pricing is stored as PackageItemFee records. PackageNameController, PackageItemController, and PackageItemFeeController handle the three setup steps.

Related Features