Organization Settings

Overview

Organization Settings control billing channel activation and session security. Accessible only by the admin role.

Sidebar → Admin → Organization → Settings (/admin/admin/org/setting/{organizationId})

This page is not available on the Free plan.

Settings

Idle Session Timeout

Field	Type	Default	Range
Idle Session Timeout (minutes)	Number	60	15–1440

Minutes of user inactivity before automatic logout. The value is clamped server-side — entering a number below 15 or above 1440 is adjusted to the nearest limit.

Billing Toggles

Four toggles control which billing channels are active. Each toggle, when enabled, creates a ledger account in the patient table with the corresponding account type. When disabled, it sets the account to inactive — the ledger still exists but cannot be used for new transactions.

Toggle	Account Type	What It Enables
Activate OPD Billing	OPD	Outpatient billing for OPD encounters and services
Activate pharmacy Billing	PHARMACY	Pharmacy purchase and invoice vouchers (PURCHASE_P, INVOICE_P). The Pharmacist role depends on this being active.
Activate IPD Billing	IPD	Inpatient billing for IPD admissions and bed charges
Activate Doctor Billing	DOCTOR_PAYMENT	Journal entries for doctor payment tracking. Not needed for routine clinical use — only if you track doctor payments through the accounts system.

Each toggle checks whether an account of that type already exists for the organization. If it does, the toggle reflects its current active state and switching it updates isActive. If no account exists, one is created automatically when toggled on.

Disabling a billing channel does not affect historical transactions — only new ones are blocked.

Invoice Options

Option	Default	What It Does
Allow zero-amount invoices	Off	When on, the organization may save an invoice whose total is 0 — line rates may be 0 while the quantity stays at least 1. Useful for no-charge or fully-discounted services.
Allow pharmacy counter sales without an encounter	Off	Shows Counter Sales in the sidebar and lets a registered patient buy medicines as an `INVOICE_P` with no OPD/IPD encounter. See Counter Sales.
Allow lab counter sales without an encounter	Off	Lets the same screen bill a walk-in lab test as an `INVOICE` credited to the OPD ledger. Independent of the pharmacy setting.

Negative amounts are never allowed, at item level or in the invoice total. While the option is off, saving an invoice with a zero total (or a line with a zero rate) is rejected with Invalid Amount value / Invalid values at item …. The check applies to invoice creation and editing (both the screen and the API).

The two counter-sale settings are checked when a sale is created, not when it is edited — turning one off blocks new counter sales but leaves saved ones editable. Like the other session flags, they reach the menu and the billing screens only after the user logs in again.

Page Layout

The settings form is the top section of the page. Below it are two additional components:

Component	Purpose
Facebook Integration	Meta Business Suite connection for WhatsApp and Instagram messaging
NHCX Participant	PMJAY/NHCX participant configuration (development environments only — production NHCX setup is handled separately under Admin → Organization)

FAQ

Q: Can I turn off a billing channel that has existing transactions? A: Yes. Disabling a toggle sets the account to inactive, which blocks new transactions but preserves all historical data.

Q: Where do I configure print settings and letterhead? A: Print settings are on a separate page. See Printing and Setting Up Letter Pad Header.

Q: Where do I set the organization name, address, GST, etc.? A: These are set when the organization is created and can be edited through the organization edit flow, not on this Settings page.

Q: What does the Doctor Billing toggle do? A: It creates a DOCTOR_PAYMENT ledger account for tracking payments to doctors through journal entries. This is separate from creating doctor profiles (see Creating Doctors). Most organizations only need OPD, IPD, and Pharmacy billing.

Q: Is the NHCX Participant section for production use? A: No. The NHCX Participant component on this page is for development environments. Production NHCX/PMJAY setup is configured separately.