Settings and Configuration

SETTINGS_CONFIGURATION.md

Settings and Configuration

The Settings page lets administrators configure system-wide preferences for billing, appointments, notifications, and more. Changes take effect immediately across the entire clinic.

Admin or Owner role required to access Settings.


Accessing Settings

Go to Settings in the sidebar.


Billing Settings

Configure how invoices are generated and displayed.

SettingDescription
CurrencyThe currency symbol used on invoices (e.g., PHP, USD, EUR)
Tax / VAT RatePercentage added to invoice totals (set to 0 to disable)
Invoice PrefixText prefix for invoice numbers (e.g., "INV-" produces INV-00001)
Invoice Starting NumberThe first invoice number (useful when migrating from another system)
Payment TermsDefault due date for invoices (e.g., Due on Receipt, Net 30)
PWD Discount RatePercentage discount applied to patients marked as PWD-eligible
Senior Citizen Discount RatePercentage discount applied to patients marked as senior-eligible

Appointment Settings

Configure scheduling defaults.

SettingDescription
Default Appointment DurationLength in minutes for new appointments if not specified (e.g., 30)
Appointment Reminder Lead TimeHow many hours/days before an appointment a reminder is sent
Allow Walk-insToggle walk-in appointment creation
Auto-assign Queue NumberAutomatically assign queue numbers to walk-in appointments
Cancellation PolicyThe period within which cancellations are flagged (e.g., 24 hours)

Notification Settings

Configure how and when alerts are sent.

SettingDescription
Email NotificationsEnable or disable outgoing email
SMS NotificationsEnable or disable outgoing SMS (requires Twilio configuration)
Push NotificationsEnable or disable browser/PWA push notifications
Appointment ReminderEnable automated appointment reminder emails/SMS
Lab Result NotificationNotify patients when lab results are ready
Low Stock AlertSend alerts when inventory falls below reorder level
Expiry Alert WindowNumber of days before expiry to trigger an expiry alert

SMTP / Email Configuration

To send emails from the system, configure your SMTP server:

SettingDescription
SMTP HostYour mail server host (e.g., smtp.gmail.com)
SMTP PortUsually 587 (TLS) or 465 (SSL)
SMTP UserEmail address used to send messages
SMTP PasswordApp-specific password for the email account
From NameDisplay name shown in outgoing emails (e.g., "My Clinic")
From EmailSender address (e.g., noreply@myclinic.com)

For Gmail, use an App Password, not your regular Gmail password. Enable 2-Step Verification first, then generate an App Password in your Google Account Security settings.


SMS Configuration (Twilio)

To enable SMS notifications:

SettingDescription
Twilio Account SIDFound in your Twilio Console dashboard
Twilio Auth TokenFound in your Twilio Console dashboard
Twilio Phone NumberThe SMS-capable number purchased in Twilio

Clinic Information

Set the clinic details shown on printed documents (invoices, prescriptions, referral letters, certificates).

SettingDescription
Clinic NameFull clinic name
AddressStreet address
City / ProvinceCity and province or state
PhoneClinic contact number
EmailClinic contact email
License NumberPhilHealth or DOH accreditation number (if applicable)
LogoUpload a clinic logo for printed documents

Report Settings

SettingDescription
Default Report PeriodThe default time period shown when opening Reports (Today, Week, Month)
Fiscal Year StartMonth the financial year begins

Subscription

View your current subscription plan, usage limits, and billing information. To upgrade or renew:

  1. Go to Subscription in the sidebar.
  2. Review your current plan and usage.
  3. Click Upgrade or Renew and follow the PayPal checkout process.

Tips

  • After changing SMTP settings, use the Send Test Email button to verify the configuration before relying on it for patient notifications.
  • The currency setting affects display only — no currency conversion is performed. Set it to match the currency your clinic bills in.
  • Keep your clinic information up to date, as it appears on all printed documents given to patients.
  • If you change the invoice prefix, existing invoices are not affected. Only new invoices will use the updated prefix.