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.

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.