Admin Mark Foreigner Local Buttons Configuration

Admin — Mark Foreigner / Mark Local Buttons Configuration

The Mark Foreigner and Mark Local buttons let billing staff flag a patient's foreigner/local status directly from the billing screen, without leaving the bill in progress. This article explains where the buttons appear, the config key that controls their visibility, and how it relates to the separate patient-status feature.

Where the buttons appear

The Mark Foreigner / Mark Local button pair appears in the Payment Details panel on:

• OPD Billing (opd_bill.xhtml, opd_bill_ac.xhtml)
• OPD Orders (opd_order.xhtml)
• OPD Billing for Cashier (opd_pre_bill.xhtml)
• Channel Booking, by date and by month (channel_booking_by_date.xhtml, channel_booking_by_month.xhtml, manage_booking_by_date.xhtml, manage_booking_by_month.xhtml)
• Clinic Sessions (sessions.xhtml)
• Inward Service Bill (inward_service_bill.xhtml, inward_service_bill_ac.xhtml)

Only one button shows at a time: Mark Foreigner while the current patient is Local, Mark Local once they've been marked a Foreigner. Clicking either updates the patient's status immediately and recalculates the bill (foreign-patient pricing, where configured, differs from local pricing).

The config key

Key	Type	Default	Effect
Show Mark Foreigner and Mark Local Buttons in Billing	Boolean	true	Controls whether the Mark Foreigner / Mark Local buttons render on the screens listed above.

Toggle it via Administration → Manage Institutions → Application Options:

1. Filter the Key column for Show Mark Foreigner.
2. Click the row's Edit Option button.
3. Toggle Key Value On/Off.
4. Save.

The change takes effect immediately for new page loads — no separate "Reload Config" step is needed when editing through this dialog (Edit Option writes through the same controller that serves the buttons).

Relationship to "Save the Patient with Patient Status"

This key is intentionally independent of Save the Patient with Patient Status. That older key controls a different part of the UI — a read-only foreigner/local badge (and an editable toggle shown only while registering or editing a patient's own record). It does not offer a way to change status for a patient already selected mid-bill.

Before this key existed, the Mark Foreigner / Mark Local buttons were tied to Save the Patient with Patient Status being off — so turning that option on for patient-status tracking silently removed the only in-billing way to flag a patient as a foreigner. See issue #22311.

With the two keys separated, an institution can run both patient-status tracking and the quick Mark Foreigner / Mark Local buttons at the same time, or turn either off independently.

Recommendation

Leave the default (true) unless the billing workflow is fully driven by the newer patient-status badge/toggle and staff should not be able to change foreigner status from the billing screen directly.