Kiosk Patient Self Registration

Kiosk Patient Self-Registration

Overview

The Kiosk Self-Registration feature allows patients to register themselves at a physical kiosk terminal installed in the facility — without requiring any staff intervention. The kiosk is pre-authenticated at the device level; patients do not need an HMIS login.

When a patient registers via the kiosk, their record is saved with a Registration Source of Kiosk, so that clinical and billing staff know the identity has not been verified in person by a staff member.

---

When to Use This

The kiosk registration workflow is designed for:

• Outpatient waiting areas where patients can self-check whether they are already in the system, or register themselves before reaching the counter
• Emergency and A&E lobby areas where patients with mild conditions can register while waiting
• Any facility where reducing front-desk queue time is a priority

Kiosk registrations are identity-unverified — the patient enters their own demographic details. For patients who need identity-verified records, front-desk or counter registration should be used instead.

---

How the Kiosk Flow Works

The kiosk page is a four-step workflow:

Step 1 — Search by Mobile Number

The patient enters their mobile number. The system searches for existing patient records matching that number (checking both the primary and mobile phone fields).

• If the number contains formatting characters (spaces, hyphens, + prefix), the system normalises it automatically.
• If the number is invalid, the patient is asked to re-enter.

Step 2 — Results

• If existing records are found: Each matching profile is displayed with name, NIC, and date of birth. The patient taps "This is me" to confirm their identity and proceed to the done screen — no new record is created.
• If no records are found: The patient proceeds directly to the registration form.

Step 3 — New Patient Registration Form

The patient fills in their details:

Field	Required
Title	Yes
Full Name	Yes
Gender	Yes
Age / Date of Birth	Yes
Mobile Number	Pre-filled, read-only
NIC / Passport No	Optional

Selecting a Title automatically updates the Gender field. The patient taps Register to save.

Step 4 — Done

A confirmation screen is shown with the patient's name. The patient is directed to proceed to the reception desk.

---

Registration Source

All patients registered via the kiosk receive:

• patient.registrationSource = KIOSK

The "Kiosk" badge is then displayed on the patient profile, OPD bill screen, and any other location that shows the Registration Source.

Existing patients who confirm their profile via "This is me" are not modified — their original Registration Source is preserved.

---

URL / Access

The kiosk page is accessible at:

/faces/kiosk/kiosk_registration.xhtml

No HMIS user login is required. Kiosk terminals should be set up to open this URL directly in a full-screen browser session.

---

Administrator Notes

• The controller is com.divudi.bean.kiosk.KioskController (@ViewScoped)
• The page uses PatientFacade and PersonFacade directly — no dependency on the logged-in session user; patient.creater is stored as null for kiosk-registered patients
• Phone input is normalised with CommonFunctions.removeSpecialCharsInPhonenumber() before search and save
• Duplicate detection is by phone number (both patientPhoneNumber and patientMobileNumber columns are checked)
• No configuration key is required — the page is always accessible

---

Related Articles

• Patient Registration Source
• Add New Patient
• Preventing Duplicate Patient Records
• Channelling Patient Portal