1. Overview
Accounts in our system are used to track financial transactions and manage cash flow. Each account represents a distinct source or destination of funds—for example, a bank account, cash on hand, or any other ledger used to record money movements within your business. Accurately setting up your accounts is critical for reliable financial reporting and for ensuring that all expenses, deposits, and other transactions are correctly recorded.
2. Creating a New Account
When adding a new account, you’ll be asked to provide the following key information:
Name
• Requirement:
This field is required.
• Validation:
Enter the account name using up to 100 characters.
• Purpose:
The name serves as the primary identifier for the account (e.g., “Main Bank Account,” “Petty Cash”). It should be clear and concise so that you can quickly recognize which account is being used for a particular transaction.
Opening Balance
• Requirement:
This field is required.
• Validation:
Enter the opening balance as a numeric value. Only numbers are allowed—no letters or symbols.
• Purpose:
The opening balance represents the starting amount in the account at the time of creation. This figure is essential for ensuring that the account’s balance is accurate from the start and for tracking all future transactions correctly.
Description
• Requirement:
This field is optional.
• Validation:
If provided, the description can be up to 250 characters.
• Purpose:
The description provides additional context about the account. For instance, you might include details such as “Primary operating bank account” or “Cash kept on hand for day-to-day expenses.” This extra information can be useful when reviewing your financial records.
3. How the Data is Processed
When you submit the form to add a new account, the system performs the following steps:
• Input Validation and Sanitization:
The system checks that:
• The Name is provided and does not exceed 100 characters.
• The Opening Balance is provided and is numeric.
• The Description, if provided, does not exceed 250 characters.
Each input is then sanitized (using functions like escape_output()) to remove any unwanted characters or potential security risks.
• Record Creation:
Once validated, a new account record is created with the data you’ve entered. The controller also assigns the current user’s ID to the added_by field, ensuring accountability.
• Soft Deletion:
If an account is deleted, it isn’t permanently removed. Instead, its del_status is changed to “Deleted,” ensuring that historical data remains for auditing purposes. Only accounts marked as “Live” are displayed when managing your finances.
4. Editing and Deleting Accounts
Editing an Account
• Process:
When you choose to edit an account, the system retrieves the existing record using a secure identifier. The form is pre-populated with the current values for the Name, Opening Balance, and Description.
• Purpose:
This allows you to update any details as needed while ensuring that you adhere to the same validation rules.
• Purpose:
Keeping deleted records helps maintain a complete financial history without cluttering active lists.
5. How Accounts Fit into the Financial System
• Financial Tracking:
Accounts are used throughout the platform to record all transactions—such as deposits, expenses, and payroll. When an expense is recorded, for instance, the associated account is used to calculate the overall balance.
• Dynamic Balance Calculation:
Although the controller doesn’t update an account balance directly, the Account model includes helper functions (like balance()) that calculate the current balance dynamically. This calculation subtracts all debit transactions (e.g., expenses) from credit transactions (e.g., deposits) to show your up-to-date account balance.
• Reporting and Analysis:
Accurate account data is critical for generating reliable financial reports. Whether you’re reviewing cash flow or reconciling accounts, having properly set up accounts ensures that your financial information is consistent and trustworthy.
6. Final Thoughts
Setting up your accounts correctly is a vital step in managing your company’s finances. By providing a clear account name, an accurate opening balance, and a helpful description, you lay the foundation for accurate transaction tracking and financial reporting. Remember:
• Name: Required and clear (up to 100 characters).
• Opening Balance: Required numeric value (only numbers, no symbols or letters).
• Description: Optional but useful for additional context (up to 250 characters).
If you need to add a new account, simply fill in these details, and our system will handle the rest—ensuring that your financial records are complete and up-to-date.