Billable Objects Module

Overview

The Billable Objects Module is an extension to the OpenHMIS Cashier Module that provides a framework to implement and configure billing behaviour for OpenMRS objects, such as Encounters or Drug Orders.  The module also saves metadata associating objects to bills.  The main components of the module are:

• the IBillingHandler interface, by which implementations can define logic for generating appropriate bill line items for an object of a particular class.
• the IBillableObject interface, which can be implemented to allow mapping in the database between an OpenMRS object and a bill
  

Requirements

• OpenMRS 1.9.4
• Event Module 2.1
• REST Web Services Module 2.x
• OpenHMIS Commons Module
• OpenHMIS Backbone Forms Module 2.x
• OpenHMIS Inventory Module 1.x
• OpenHMIS Cashier Module 2.x

Download

• Source code: https://github.com/icchange/openmrs-module-openhmis.billableobjects

Configuration

Once the module has been started, a Manage Billing Handlers link will be available on the administration screen, which allows for adding and editing of billing handlers.  The module includes handlers for Encounter and DrugOrder.  See the developer documentation for information on how to add other handlers.

Billable object metadata will only be saved for classes that have handler instances saved to the database.

Encounter Handler

Encounter handlers allow the association of a set of inventory items with an encounter of a particular type.  For example, to associate a fee with an ADULTINITIAL encounter:

1. Go to the Manage Billing Handlers screen, under Administration, Billable Objects Module
2. Click Add Billing Handler
3. Choose the EncounterHandler type
4. Enter a name, and optionally a description
5. Choose the appropriate encounter type, e.g. ADULTINITIAL
6. Add one or more items from the inventory that should be billed for this encounter type
7. Click Create Encounter Handler

Drug Order Handler

The Drug Order handler uses the ability of the OpenHMIS Inventory Module to associate items to drugs to find the appropriate item to bill for a Drug Order.  Currently the Drug Order Handler has no configurable options; one Drug Order Handler will handle any Drug Order.  To create:

1. Go to the Manage Billing Handlers screen, under Administration, Billable Objects Module
2. Click Add Billing Handler
3. Choose the DrugOrderHandler type
4. Enter a name, and optionally a description
5. Click Create Drug Order Handler