---
title: "Organization Settings"
description: "How to configure organization-level billing toggles, the zero-amount invoice option, and session timeout — enabling OPD, IPD, Pharmacy, and Doctor Payment ledger accounts."
date: 2026-07-19
lastModified: 2026-10-21
category: "admin"
author: "Dr. Umesh Bilagi"
beta: false
---

## 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](/docs/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](/docs/printing-and-set-up-of-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](/docs/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.