PharNix Official Help Center & Master User Manual

Pharmacy Core Operations & Master Guide

Complete step-by-step guides for counter cashiers, pharmacists, and store owners. Covering Invoices, Medicines, Emergency Stock, Customers, Purchases, Staff Permissions, Supplier Returns, Reports, Balance Sheet, and AI Sales Intelligence.

New Invoice (POS Billing)

High-speed counter billing, keyboard shortcuts, FBR Tier-1 tax, thermal printing, customer khata & WhatsApp bills.

new_invoice

In new_invoice, cashier speed is prioritized for peak pharmacy rush hours:
  • Focus Search: Press F1 or click the search box to scan a physical barcode or type medicine brand/formula names (e.g. Panadol or Paracetamol).
  • Batch Selection: Use Arrow Up/Down to highlight the desired batch and press Enter to append it to the cart.
  • Quantity & Strip Packing: Type pack units or press Tab to enter strip or loose tablet quantities (e.g. 1s or 10t).
  • Instant Checkout: Press F2 to open the payment drawer.
  • Finalize & Print: Enter cash received and hit Enter. The thermal receipt prints automatically with zero extra clicks.

In new_invoice, customer financial ledgers are integrated directly into the checkout drawer:
  • Select Customer: Choose a registered customer from the dropdown or type their mobile number. The system instantly displays their current Khata Due Balance and Wallet Balance.
  • Pay from Wallet: Check Pay from Wallet (amount_from_wallet) to deduct available wallet credits towards the bill total.
  • Save as Due (Credit Khata): If the patient cannot pay the full amount, check Save as Due (save_as_due). The unpaid portion is automatically transferred to their customer ledger.
  • Pay Previous Dues: If a customer wants to pay off previous overdue balances while purchasing new medicines, check Pay Due Amount (pay_due_amount) to reconcile their ledger on the spot.

PharNix POS provides full legal FBR Tier-1 integration for medical retail stores across Pakistan:
  • Automatic Tax Calculation: Applicable sales tax (total_gst) is calculated automatically based on DRAP drug schedules and customer tax status.
  • Official FBR Signing: When the bill is finalized, the system communicates with FBR IMS via secure API and generates an authentic FBR Invoice Number (e.g. 111000000012345).
  • Scannable QR Code: A cryptographic QR code is printed directly onto your 80mm or 58mm thermal slip.
  • Customer Verification: Customers or tax auditors can scan the receipt with the official FBR Tax Asaan mobile app to verify live submission.

PharNix supports all ESC/POS thermal printers (Epson, Xprinter, Rongta, Black Copper, Sunmi, etc.):
  1. Go to Settings > Hardware & Printer Setup to choose 80mm Standard or 58mm Mini.
  2. Enable Auto-Print upon Checkout to eliminate confirmation dialogs during busy counter hours.
  3. Thermal slips automatically feature your pharmacy logo, NTN/STRN, batch IDs, expiry dates, doctor/patient info, FBR QR code, and bilingual greeting footers.

You can deliver instant digital receipts to patients without wasting thermal paper:
  • Enter or select the customer's WhatsApp mobile number during billing.
  • Click the green Save & WhatsApp button (or click the WhatsApp icon on the invoice preview).
  • PharNix generates an automated WhatsApp message containing your pharmacy name, invoice ID, medicines list, total bill, paid amount, and a secure online link to view the complete digital receipt.

In new_invoice, you never need manual math for cut strips or loose tablets:
  • Every medicine defines its packaging structure (e.g. 1 Box = 10 Strips = 100 Tablets).
  • Cashiers can enter whole boxes, individual strips, or loose tablets directly in the quantity box.
  • PharNix calculates the exact proportional price from the box MRP and deducts the precise unit fraction from the active batch stock without rounding errors.

Manage Invoices & Returns

Searching past sales, thermal slip reprinting, customer sales returns, item refunds, and cashier audit trails.

manage_invoice

In manage_invoice, locating previous bills is fast and flexible:
  • Search Options: Search instantly by Invoice #, Customer Name, or Customer Mobile Number.
  • Date Range Filtering: Filter transactions by Today, Yesterday, This Week, This Month, or choose a custom date range.
  • Reprinting Options: Click Thermal Print to reprint the 80mm/58mm receipt, A4 Print for a full-size tax invoice, or WhatsApp to resend the bill link.

When a customer returns unconsumed medicines:
  1. In manage_invoice, locate the original customer invoice and click Return Items.
  2. Select which specific medicines are being returned and specify the returned quantity (full boxes, strips, or tablets).
  3. The system automatically credits the returned units back into their exact original Batch ID in medicines_stock.
  4. Choose the refund mode: Refund Cash or Credit to Customer Khata.
  5. An official FBR Return Credit Note slip is printed to document the tax adjustment.

For pharmacy financial security and fraud prevention:
  • Counter cashiers cannot modify or delete bills once saved.
  • Only users with Admin / Supervisor roles can delete or cancel an invoice.
  • Every cancellation mandates entering an audit reason and is permanently logged in the system activity trail with timestamp and supervisor ID.

Add Medicine (Stock Inward)

Adding new medicines, mandatory fields, multi-row bulk entry, batch tracking, FEFO principle, Rate vs MRP.

add_medicine

In add_medicine, only 3 fields are strictly mandatory to save a medicine:
  1. Medicine Name (name): Brand name (e.g. Augmentin 625mg Tab, Panadol 500mg).
  2. Packing (packing): e.g. 10x10, 1x10, 100ml Syrup, 1 Vial.
  3. Generic Name (generic_name): Active salt formula (e.g. Co-Amoxiclav, Paracetamol) for automated substitute suggestions.
Optional fields: Supplier Name (defaults to 'N/A'), Batch ID (auto-generated if left blank: AUTO-YYYYMMDD...), Expiry Date, Opening Stock Quantity (defaults to 0), Rate (TP), and MRP.

add_medicine is designed for high-speed counter cataloging:
  • The interface displays a clean tabular grid where you can enter multiple medicines simultaneously.
  • Click Add Row or press Enter on the last cell to spawn a new medicine row.
  • You can enter 10, 20, or 50 items and click Save All Medicines. The entire list is validated and inserted in a single atomic database transaction.

PharNix enforces strict pharmaceutical FEFO (First Expiry, First Out):
  • Each medicine can maintain multiple active batches with different expiry dates and batch IDs in medicines_stock.
  • When billing in new_invoice, PharNix automatically defaults to the batch expiring earliest.
  • This ensures older shipments are sold first, dramatically cutting down on expired medicine losses.

To prevent database clutter and accounting confusion:
  • PharNix validates that no two medicines share the exact same Name + Packing combination (SELECT ID FROM medicines WHERE NAME = ? AND PACKING = ?).
  • If a medicine already exists, add new stock under that existing medicine in manage_medicines or via add_purchase instead of creating a duplicate brand entry.
  • Batch IDs are also validated to ensure batch uniqueness per supplier delivery.

Understanding pricing calculations in add_medicine:
  • Rate (rate): The purchase cost or trade price you pay to the distributor.
  • MRP (mrp): The printed maximum retail price for the customer.
  • GST (gst): Applicable sales tax percentage.
  • PharNix automatically calculates your gross profit margin percentage as you type these figures, allowing you to verify profitability before saving.

Manage Medicines & Stock

Viewing stock levels, adding batches to existing medicines, barcode labels, threshold settings, and CSV stock export.

manage_medicines

When receiving fresh stock of an existing medicine:
  1. In manage_medicines, search the medicine brand name.
  2. Click the Add Batch button on the medicine row.
  3. Enter the new Batch ID, Expiry Date (MM/YYYY), Quantity, Purchase Rate, and MRP.
  4. Click Save Batch. The new batch is appended to the medicine stock history without duplicating the brand catalog.

PharNix utilizes an instant visual health radar:
  • Red (Expired): Medicines whose expiry date has passed. Dispensing is locked to prevent legal violations.
  • Orange (Expiring Soon): Batches nearing expiry within the configured threshold (e.g. 30, 60, or 90 days).
  • Yellow (Low Stock): Stock count has fallen to or below the minimum reorder threshold.
  • Grey (Out of Stock): Zero units remaining in inventory.

To print barcode stickers for counter shelf boxes:
  • In manage_medicines, click the Barcode icon on any medicine row.
  • Specify the number of stickers required (e.g. 10 or 50).
  • Click Print Barcodes. PharNix formats the labels for standard 50x25mm or 38x25mm thermal barcode sticker rolls with pharmacy name, medicine name, MRP, and scannable Code128 barcode.

Emergency Stock Resolutions

What is emergency stock, resolving counter emergency additions, assigning suppliers, and updating batch cost prices.

manage_emergency_stock

PharNix ensures you never lose a customer:
  • How It Happens: During busy counter hours in new_invoice, if a patient urgently needs a medicine that has arrived from a nearby store or distributor but hasn't been formally entered into purchases yet, cashiers can bill it immediately under Emergency Stock.
  • Resolution Queue: The bill is completed for the patient, and the transaction is automatically queued in manage_emergency_stock under Pending Resolutions for management review.

To balance your purchase accounts and supplier ledgers:
  1. Open manage_emergency_stock to review pending emergency items.
  2. Click Resolve on the pending voucher row.
  3. In the modal, assign the actual Distributor / Supplier from the dropdown.
  4. Enter the distributor's actual Batch ID, Expiry Date (MM/YYYY), and Cost Price.
  5. Select payment terms: Cash Paid or Remaining Due.
  6. Click Submit Resolution. PharNix updates purchase_items, credits medicines_stock, and posts the balance into the distributor's ledger.

Upon clicking Submit Resolution:
  • The temporary auto-generated batch ID is replaced with the supplier's authentic manufacturer batch number.
  • The cost price is updated from zero/estimated to the true purchase rate, enabling accurate profit & loss reporting.
  • The temporary "Emergency Stock" placeholder is cleared, keeping your audit records 100% compliant.

Add Customer (Khata Profile)

Registering new customers, mobile lookup, wallet deposits, attending doctor details, and khata ledgers.

add_customer

In add_customer, you record complete customer profiles:
  • Customer Name (customer_name): Mandatory customer or family head name.
  • Contact Number (contact_number): Mandatory mobile/WhatsApp number used for POS counter search and WhatsApp receipt delivery.
  • Address (address): Residential area or street address.
  • Doctor Name & Address (doctor_name, doctor_address): Attending clinic or family doctor for prescription history tracking.
  • Initial Wallet Balance (initial_balance): Opening credit deposit or advance payment.

You can register multiple customers at once:
  • Click Add Another Customer to create additional entry rows.
  • Enter names, mobile numbers, and credit balances for your regular neighborhood clients.
  • Click Save Customers to register all entries simultaneously in a single transaction.

Customer financial deposits are tracked with full audit history:
  • If an initial_balance is entered, PharNix automatically logs a DEPOSIT record in the wallet_transactions table.
  • During counter billing in new_invoice, the cashier can select Pay from Wallet to deduct purchases directly from this stored credit.
  • All wallet additions and deductions are logged chronologically with timestamps and user IDs.

PharNix protects ledger integrity by verifying both Name and Mobile Number (SELECT ID FROM customers WHERE NAME = ? AND CONTACT_NUMBER = ?). If a customer with the same phone number already exists, duplicate creation is prevented so that credit khata balances never split across two different accounts.

Manage Customers & Khata

Viewing customer khata balances, recording wasooli payments, printing account ledgers, and WhatsApp statements.

manage_customer

When a regular customer pays off their pending credit khata:
  1. In manage_customer, search for the customer by Name or Mobile Number.
  2. Click Receive Payment / Wasooli.
  3. Enter the amount paid (e.g. Rs. 5,000) and select the payment mode (Cash, EasyPaisa, JazzCash, or Bank Transfer).
  4. Click Save & Send WhatsApp Receipt. The customer's ledger balance updates immediately, and an automated payment receipt with remaining balance is delivered to their WhatsApp.

To provide a transparent billing statement to a client:
  • In manage_customer, click View Ledger on any customer profile.
  • The ledger displays a chronological statement of every bill taken on credit, every cash payment received, invoice numbers, and running balance.
  • Click Print Thermal Slip, Print A4 Statement, or Share on WhatsApp to deliver a downloadable PDF ledger directly to the customer.

Add Purchase (Supplier Bills)

Distributor purchase invoices, bonus quantities (10+1), payment vouchers, line discounts, and supplier payables.

add_purchase

In add_purchase, incoming distributor shipments (e.g. Muller & Phipps, Searle, OBS) are recorded accurately:
  1. Select the Supplier / Distributor from the dropdown.
  2. Enter the distributor's Invoice Number and Purchase Date.
  3. The system automatically generates a unique Purchase Voucher Number (voucher_number).
  4. Add medicines received, input Batch IDs, Expiry Dates, Quantities, Cost Prices, and Discounts.
  5. Click Save Purchase to update inventory and post to the supplier's payable ledger.

In add_purchase, every item row includes a distinct Bonus Quantity (bonus_quantity) column:
  • Enter the billed units in Quantity (e.g. 10) and the free scheme units in Bonus Quantity (e.g. 1).
  • Total inventory increases by 11 units.
  • PharNix automatically recalculates the true unit cost price: Total Billed Amount / (Quantity + Bonus Quantity), ensuring 100% accurate profit margin analysis when selling at retail MRP.

Managing distributor payables in add_purchase:
  • Cash Paid (cash_paid): Amount paid immediately to the delivery rider or distributor.
  • Advance Adjusted (advance_adjusted): Any prior credit balance adjusted.
  • Remaining Amount (remaining_amount): The balance is posted to the distributor's ledger under purchases as PAID, PARTIAL, or DUE.

In add_purchase, taxes and discounts are calculated per item:
  • Enter line-item discounts (discount_percent or discount_amount).
  • Enter GST rates (gst_percent and gst_amount). The total GST is calculated across all rows and saved to total_gst for tax accounting.

Manage Suppliers & Ledgers

Viewing supplier balances, recording payment vouchers (cheque/bank/cash), supplier statements, and distributor contacts.

manage_supplier

When clearing distributor purchase bills:
  1. In manage_supplier, locate the supplier (e.g. Muller & Phipps).
  2. Click Make Payment.
  3. Enter the payment amount, payment date, and method: Cash, Cheque (with Cheque #), or Online Bank Transfer (with Ref #).
  4. Click Save Payment. The supplier's payable balance is reduced, and a payment debit voucher is appended to their ledger.

In manage_supplier, click View Ledger on any distributor row:
  • View an itemized chronological record of all purchase bills received, voucher numbers, payments issued, cheque numbers, and the running payable balance.
  • Filter by Date Range to reconcile monthly supplier accounts.
  • Click Print Ledger or Export to CSV to share reconciliation sheets with distributor representatives.

Manage Employees & Permissions

Staff accounts, granular Role-Based Access Control (RBAC), module permissions, and active cashier statuses.

manage_employees

In manage_employees:
  1. Click Add New Employee.
  2. Fill in the employee's Full Name, Mobile Number, Assigned Username, Login Password, Role (Cashier, Pharmacist, Manager, or Salesman), and Monthly Salary.
  3. Click Save Employee. The staff member can now log in securely using their credentials.

PharNix includes deep, file-level permission controls:
  • In manage_employees, click Permissions on any staff member.
  • For every single module (new_invoice, manage_invoice, medicines, suppliers, reports, settings, backup_restore), you can independently grant or deny:
    • can_view: Can see the page and data.
    • can_add: Can create new records/bills.
    • can_edit: Can edit existing items.
    • can_delete: Can delete or void transactions.
  • Example: You can allow a counter cashier to create bills (can_add) while strictly blocking them from editing prices, deleting invoices, or viewing store profit margins.

If an employee resigns or is on leave:
  • In manage_employees, toggle their Status switch from Active to Suspended.
  • Their active session is terminated immediately, and any login attempt will be rejected until the admin reactivates the profile.

Supplier Return & Debit Notes

Returning expired, near-expiry or damaged stock to distributors, automatic debit notes, and ledger deductions.

supplier_return

In supplier_return, returning stock to distributors is fully automated:
  • The system links every batch back to its original purchase invoice in purchase_items to automatically identify which distributor (e.g. Muller & Phipps, Searle, OBS) supplied that specific batch.
  • You can search medicines by Brand Name or Batch ID to quickly locate items destined for return.

To compile distributor return packages before medicines go bad:
  • EXPIRED: Isolates all batches whose expiry date has passed so you can claim replacement credit.
  • EXPIRING_SOON: Filters stock expiring within the next 3 months, giving you ample time to hand over near-expiry units to distributor delivery vans.
  • Filter by Supplier: Group claims by a specific distributor to print a single consolidated return invoice.

When you submit a supplier return:
  1. The returned units are automatically deducted from medicines_stock.
  2. An official Supplier Debit Note voucher is generated with the return date and reason.
  3. The total return value is debited from your outstanding payable balance in supplier_ledgers, reducing what you owe to the distributor.

Sales Reports & Analytics

Daily counter reconciliations, gross vs net sales, payment mode breakdowns (cash/card/khata), and CSV exports.

sales_report

In sales_report, analyzing revenue is effortless:
  • Quick Date Filters: One-click filters for Today, Yesterday, This Week, This Month, Last Month, or This Year.
  • Custom Range: Specify any custom From Date and To Date.
  • Payment Filter: Filter bills by PAID (Full payment), PARTIAL (Credit khata dues), or RETURNED.

The report provides key sales metrics at a glance:
  • Total Gross Sales: Retail sum of all sold medicines before deductions.
  • Total Discounts: Total sum of item-wise and global bill discounts given.
  • Total Sales Tax (GST): Official FBR sales tax collected.
  • Net Sales: Actual revenue earned.
  • Payment Mode Breakdown: Cash in drawer vs Bank POS Card vs Unpaid Credit Khata balances.

Yes! Click Export to Excel / CSV to download the complete row-by-row transaction history for accounting software, or click Print Summary to print a compact closing slip on your 80mm thermal receipt printer.

Purchase Reports & Procurement

Stock inward procurement logs, distributor purchases, cash paid vs pending payables, and purchase GST tracking.

purchase_report

In purchase_report, review all stock purchases from distributors across any timeframe:
  • View total purchase invoices received, total stock value purchased, cash paid upfront, and remaining payable liabilities.
  • Filter by specific Distributor / Supplier to evaluate purchasing volume per pharmaceutical company.

The report aggregates Total Purchase GST and line discounts across all bills, making monthly sales tax returns and FBR input-tax declarations easy to cross-verify against distributor invoices.

Customer Return Statistics

Analyzing customer sales returns, identifying damaged or defective medicine batches, and tracking return frequencies.

return_statistics

return_statistics provides forensic analytics on customer returns:
  • Summary Stats: Total Return Count, Total Refund Amount (Cash/Khata refunded), and Total Returned Item Units.
  • Helps you understand return rates as a percentage of overall sales to protect pharmacy profitability.

The Most Returned Medicines leaderboard ranks medicines with the highest return frequency. This helps you identify defective manufacturer batches, damaged foil packaging, or patient tolerance complaints so you can discontinue stocking that brand.

The Customer Return Statistics table highlights repeat returners with names and contact numbers, helping store managers spot potential cashier fraud or customers returning expired medicines purchased elsewhere.

Balance Sheet & Profit / Loss

True pharmacy Profit & Loss, Cost of Goods Sold (COGS), gross margins, stock asset valuation, and net balance sheet.

balance_sheet

PharNix calculates true pharmaceutical gross profit using exact cost formulas:
  • Net Sales: Total sales revenue minus customer discounts and returns.
  • COGS (Cost of Goods Sold): The actual distributor purchase cost of the medicines that were sold.
  • Gross Profit = Net Sales - COGS.
  • Gross Profit Margin % = (Gross Profit / Net Sales) × 100.

Rather than rough percentage estimates, PharNix performs true cost matching: Every unit sold is matched against its specific batch purchase rate (RATE in medicines_stock or purchase_items). This gives an accurate, item-by-item profit breakdown showing which specific medicines earned you the most profit.

The Balance Sheet provides an overview of your store's financial position:
  • Inventory Asset Valuation: Total wholesale value of medicines currently sitting on your shelves.
  • Customer Receivables: Total unpaid credit khata balances owed to your pharmacy.
  • Supplier Payables: Total unpaid distributor liabilities owed by your pharmacy.
  • Net Working Capital: (Inventory Assets + Receivables) - Payables.

Employee Productivity Reports

Staff sales performance, cashier bill volume, customer additions, shift comparisons, and cashier anti-theft audits.

employee_reports

In employee_reports, evaluate your pharmacy staff across any date range:
  • Total Sales Revenue: Total cash and bills collected by the employee.
  • Total Invoices Processed: Number of customers served.
  • Total Customer Returns Handled: Return volume per cashier.
  • Total Customers Registered: New customer profiles added.
  • Total Medicines / Batches Added: Inventory cataloged.

Because every counter sale, discount, and return is permanently stamped with the active employee_id, owners can easily compare discount rates across cashiers to prevent unauthorized price reductions or suspicious cash drawer shortages.

Sales Intelligence & Dead Stock

Fast-moving medicines, high-margin winners, dead stock detection (30/60/90/180 days), and procurement optimization.

sales_intelligence

sales_intelligence acts as an automated procurement advisor:
  • It analyzes sales velocity over 7, 30, 90, or 180 days to show which medicines drive 80% of your pharmacy's revenue.
  • Prevents stocking capital in slow drugs while ensuring fast-moving essentials never run out.

Dead stock is the #1 cause of lost profits in pharmacies: The Dead Stock Radar lists all medicines in your inventory that have had zero sales over the last 30, 60, 90, or 180 days. You can immediately return them to distributors or apply promotional clearance discounts before they expire.

The report ranks medicines by Gross Profit Margin percentage. When distributor representatives visit, you can review which companies offer the highest net margins and negotiate volume bonus schemes (e.g. 10+2 free) on high-velocity items.

System & Invoice Settings

Low stock threshold, expiry warning days, sound alerts, thermal slip customizations, Urdu fonts & pharmacy header settings.

settings

In settings, open the General & Stock Settings tab:
  • Low Stock Threshold: Enter the minimum quantity buffer (e.g. 10 units). When inventory drops below this number, the medicine highlights in red and triggers dashboard replenishment alerts.
  • Expiry Days Threshold: Set the warning period (e.g. 30, 60, or 90 days). Medicines expiring within this timeframe will automatically appear in yellow/orange alerts across billing, stock lists, and supplier return screens.
Click Save Settings to apply changes instantly across all counters.

Navigate to the Invoice Print Settings tab in settings:
  • Pharmacy Details: Update your official Pharmacy Name, Street Address, Phone/WhatsApp number, and Drug Sale License (DSL) number.
  • Font Selection: Choose between modern clean Arial or beautiful 'Jameel Noori Nastaleeq' for Urdu titles.
  • Font Sizes & Styling: Configure font sizes (14px to 18px) and toggle Bold for header, table items, and totals.
  • Logo: Upload your pharmacy logo (PNG/JPG format) and enable Show Logo to print it directly on invoices.

Under Invoice Print Settings:
  • Invoice Design Template: Choose between Template 1 (Compact 58mm receipt for small counters) or Template 2 (Standard 80mm full layout with customer loyalty balances).
  • Show / Hide Discount: Toggle show_discount to 1 to display line item discount amounts, or 0 to print only the final net amount.
  • Table Border Style: Select between full, minimal, or borderless depending on your thermal printer model.
  • Footer Alert Message: Add custom text such as "Medicines sold are non-refundable after 3 days. Keep away from heat." and choose top/bottom placement.

In settings under Notification Settings:
  • Enable Sound: Toggle audio chimes on or off for key POS events (e.g. barcode scan success, item added, out-of-stock warning).
  • Notification Volume: Adjust volume slider from 10% to 100% to match your pharmacy counter noise level.
  • Display Time: Configure how many seconds (e.g. 3 to 7 seconds) alert banners stay on screen before auto-dismissing.

My Profile & Subscription

Pharmacy owner credentials, tenant account details, license numbers, active subscription plan, and renewal management.

my_profile

my_profile displays the verified master account details for the pharmacy:
  • Pharmacy Name & Owner Name: The legal commercial entity and licensed proprietor.
  • Contact Coordinates: Primary owner email and WhatsApp/mobile phone used for official notifications and license alerts.
  • Drug Sale License (DSL): Government health authority registration number printed on regulatory tax documents.
  • Tenant ID: Unique database identifier for your pharmacy branch.

The Subscription Overview card in my_profile displays:
  • Plan Tier: Shows whether your pharmacy is on the Monthly Professional, Annual Enterprise, or Offline Standard Plan.
  • Status Badge: Displays a green Active badge or warning Expiring Soon badge.
  • Start & Expiry Dates: Exact calendar dates showing when the current billing cycle began and when renewal is due.
  • One-Click Upgrade / Renew: Direct button to contact support via WhatsApp (+92 320 6457172) for instant plan renewals or additional terminal licenses.

PharNix POS features hybrid offline-first architecture:
  • Offline Mode (Electron / Desktop): Profile reads securely from local encrypted master SQLite storage. Your pharmacy can operate 100% disconnected from the internet without subscription lockouts during internet outages.
  • Online Cloud Mode: Synchronizes with central admin servers for instant license verification, remote feature activation, and multi-branch cloud consolidation.

Change Password & Security

Master account security, password updates, multi-device session logout, and OWASP credential protection.

change_password

To update your password:
  1. Navigate to change_password from the top-right profile dropdown menu.
  2. Enter your Current Password for identity verification.
  3. Enter your New Password (minimum 6 characters; recommended 8+ with uppercase, lowercase, numbers, and symbols).
  4. Re-type into Confirm New Password to prevent typos.
  5. Click Update Password. Your new password is encrypted using high-security PASSWORD_DEFAULT (bcrypt/Argon2) hashing.

For pharmacy security compliance (OWASP Best Practice): When you update your password, the system automatically runs an audit query on device_sessions to deactivate all other active browser or terminal sessions logged into your account. This ensures that if a counter terminal was left unattended or an old device was compromised, unauthorized users are immediately locked out until they provide the new password.

If you forgot your password:
  • Log out and click the "Forgot Password?" link on the main login screen (forgot_password).
  • Enter your registered owner email or mobile number to receive a secure password reset link / OTP verification code.
  • Alternatively, contact your pharmacy administrator or PharNix official support via WhatsApp (+92 320 6457172) for identity-verified credential assistance.

Backup, Restore & GitHub Sync

One-click SQL database backup, disaster recovery restore, automated scheduled backups, and secure private GitHub repository sync.

backup_restore

In backup_restore:
  1. Click the green "Create & Download Backup" button.
  2. The system dumps all pharmacy tables (medicines, batches, invoices, purchase bills, customer ledgers, and settings) into a complete .sql file.
  3. The file downloads directly to your PC with an exact timestamp (e.g. pharnix_backup_2026-11-13_15-30-00.sql).
  4. Best Practice: Always copy this file to an external USB flash drive or secure cloud drive at the end of each business day.

PharNix includes enterprise-grade GitHub cloud integration for automated offsite backups:
  1. In GitHub Cloud Backup Settings, enter your:
    • GitHub Personal Access Token (PAT): Generated from your GitHub developer settings with repo permissions.
    • Username & Repository: The name of your private GitHub repository (e.g. mypharmacy-pos-backups).
    • Auto-Backup Interval: Choose how often automatic backups run (e.g. every 3 hours or daily).
  2. Enable the Auto-Backup Toggle and click Save GitHub Config.
  3. The system will automatically push encrypted, compressed SQL backups to your private repository in the background without interrupting cashier billing.

To restore a database:
  1. In backup_restore, locate the Restore Database section.
  2. Click Choose File and select your verified .sql backup file.
  3. Click Upload & Restore. The system verifies SQL headers and table prefixes to prevent database corruption.
CRITICAL WARNING: Restoring a backup overwrites current stock, sales, and accounts with the data from that file. Always generate a fresh manual backup of your existing database before initiating any restore operation!

Because database backups contain full financial turnover, wholesale costs, customer balances, and profit records, backup_restore is strictly guarded with SessionManager::isPharmacyOwner(). Cashiers, pharmacists, and staff accounts cannot view or trigger backup downloads. Any unauthorized role attempting to visit the URL is blocked with "Access Denied: Only pharmacy owners can access the Backup & Restore system."

Need Dedicated Help with Your Pharmacy Setup?

Our official technical support team is available on WhatsApp (+923206457172) to assist with printer drivers, FBR activation, data migration, and cashier training.

Chat on WhatsApp (+923206457172)