Pharmacy Module Development Guide

Key Documentation

For detailed pharmacy development, refer to these files:

• •Pharmaceutical Management API - REST API for managing VTM, ATM, VMP, AMP, VMPP, AMPP, categories, dosage forms, and measurement units
• •GRN Fixes - GRN completion patterns
• •Multi-Window Sales - Multi-window handling
• •Cost Accounting Signs - Sign normalization
• •Disbursement Signs - Disbursement conventions
• •Quantity Decimals - Decimal validation
• •Transfer Disbursement - Transfer workflow
• •Purchase Order Workflow - PO workflow

Configuration Options

Pharmacy uses configOptionApplicationController.getBooleanValueByKey() for feature toggles. Key patterns:

• •Pharmacy Transfer is by Purchase Rate / Cost Rate / Retail Rate
• •Display Colours for Stock Autocomplete Items
• •Pharmacy Disbursement Reports - Display * (various column visibility)

Common Patterns

Stock Queries

• •Always include s.retired = false and s.itemBatch.item.retired = false
• •Filter inactive items with s.itemBatch.item.inactive = false
• •Use DTOs for display, entities for business logic

Transfer Workflow

• •Transfer Request -> Transfer Issue -> Transfer Receive
• •Each step creates a Bill with appropriate BillType
• •Sign conventions matter for cost accounting

Retail Sale

• •Use StockDTO for autocomplete performance
• •Cache autocomplete results for converter
• •Defer expensive discount calculations

Backward Compatibility

• •Never "fix" purcahseRate spelling - it's a database column name
• •Never rename composite components without checking ALL usage