Admin Inpatient Module Behaviour Config Keys - hmislk/hmis GitHub Wiki
Admin — Inpatient Module Behaviour (Config Keys)
The Inpatient module behaviour is controlled by Application Option (config key) settings. These are managed via Admin → Application Options (filter by "Inward" or "Admission"). All keys are boolean unless stated otherwise.
BHT Number Configuration
| Config Key |
Default |
Effect |
BHT Number can be edited at the time of admission |
true |
Allows staff to override the auto-generated BHT number at admission |
Generate Separate BHT Number Series for Each Institution |
false |
When enabled, each institution generates its own independent BHT sequence with the institution code as a prefix |
Room Assignment
| Config Key |
Default |
Effect |
Patient admission and room assignment are simultaneous processes. |
true |
When true, the room is accepted at the time of admission and room billing starts immediately. When false, the room must be accepted by ward staff before billing begins. See Inpatient — Room Assignment Modes and Billing for full details. |
Claimable / Insurance
| Config Key |
Default |
Effect |
Inward Admission - Show Claimable Field |
false |
Shows or hides the Claimable checkbox on the admission form |
Inward Admission - Claimable Required For |
None |
Short text: None, Credit, Cash, or All — when payment mode matches, Claimable becomes required |
Inward Admission - Auto Apply Claimable For Credit |
false |
Automatically sets Claimable = true when payment mode is Credit |
Inward Admission - Auto Mark Claimable for Credit Admissions |
false |
Marks all credit admissions as claimable automatically |
Inward Patient Admit - Credit Companies Require Reference Number |
false |
Makes reference number mandatory when payment mode is Credit |
Inward Admission - Find And Fill Last Used Credit Companies of a Patient |
false |
Pre-fills credit company with the patient's last used company |
Mandatory Patient Fields at Admission
| Config Key |
Default |
Effect |
Inward Admission - Mandatory Fields Enabled |
false |
Master switch — enables all mandatory field checks below |
Patient Details Required in Patient Admission |
false |
Requires patient detail fields to be filled |
Patient Title is Required in Patient Admission |
false |
Title (Mr/Mrs/etc.) is required |
Patient Gender is Required in Patient Admission |
false |
Gender is required |
Patient Age is Required in Patient Admission |
false |
Age or date of birth is required |
Patient Name is Required in Patient Admission |
false |
Full name is required |
Patient Address is Required in Patient Admission |
false |
Address is required |
Patient NIC is Required in Patient Admission |
false |
NIC/Passport number is required |
Patient Phone Number is Required in Patient Admission |
false |
Phone number is required |
Patient Admit - Require Referred From in Patient Admission |
false |
"Referred From" field is required |
Patient Insurance - Show Expiry Alert on Admission |
false |
Shows an alert if the patient's insurance is expired at admission |
Mandatory Admission Fields
| Config Key |
Default |
Effect |
Inward Admission - Medical Officer Required |
false |
Medical officer selection is required |
Inward Admission - Primary Reason Required |
false |
Primary reason for admission is required |
Inward Admission - Comments Required |
false |
Comments/reference field is required |
Inward Admission - Referring Doctor Required |
false |
Referring doctor is required |
Inward Admission - Referring Staff Required |
false |
Referring staff member is required |
Inward Admission - Referral Institution Required |
false |
Referring institution is required |
Inward Admission - Workplace Required |
false |
Patient workplace is required |
Inward Admission - Referral Number Required |
false |
Referral number is required |
Mandatory Guardian Fields
| Config Key |
Default |
Effect |
Guardian Details Required in Patient Admission |
false |
Enables guardian field validation |
Guardian Title is Required in Patient Admission |
false |
Guardian title is required |
Guardian Name is Required in Patient Admission |
false |
Guardian name is required |
Guardian NIC is Required in Patient Admission |
false |
Guardian NIC is required |
Guardian Address is Required in Patient Admission |
false |
Guardian address is required |
Guardian Mobile Number is Required in Patient Admission |
false |
Guardian mobile is required |
Guardian Home Phone Number is Required in Patient Admission |
false |
Guardian home phone is required |
Guardian Relationship is Required in Patient Admission |
false |
Relationship to patient is required |
Final Bill Behaviour
| Config Key |
Default |
Effect |
Show an Intermediate Bill on Final Bill Edit |
false |
Shows a "Process Bill" button that generates a preview before Settle |
Show Print Button For Intermediate Bill on Final Bill Edit |
false |
Shows a print button for the intermediate preview bill |
Show Save Provisional on Final Bill Edit |
false |
Shows a "Save Provisional Bill" button on the final bill page |
Other
| Config Key |
Default |
Effect |
Restirct Inward Admission Search to Logged Department of the User |
false |
Limits admissions search results to the user's current department (note: intentional typo in key name — database compatibility) |
Use BHT print template with header and logo |
false |
Switches the BHT print layout to a template that includes the hospital header and logo |
Enable Collecting Payments on Add Services & Investigations on Inward |
false |
When true, the Services & Investigations page includes a payment collection step |
Related Articles