1.1 How to Log In
Login requires two-step verification using your email credentials and a verification code:
- Open your web browser (Google Chrome, Mozilla Firefox, or Microsoft Edge).
- Go to your organisation's SymaCore web address as provided by your IT department.
- Enter your registered work email address and password.
- Click the "Sign In" button.
- The system verifies your credentials and immediately sends a 6-digit verification code (OTP) to your work email.
For two-factor code handling, see Section 1.2: One-Time Passwords (OTP). If you cannot remember your password, see Section 1.3: Forgot or Reset Password.
1.2 One-Time Passwords (OTP)
Every login requires verification using a One-Time Password (OTP) sent directly to your registered work email:
- Open your work email inbox and look for an email with the subject "Login Verification Code".
- Type the 6-digit code into the verification box on your screen.
- Click "Verify" to complete your login.
- Once verified, your session stays active for up to 12 hours, allowing uninterrupted access during your shift.
- If the code does not arrive:
- Check your spam or junk folder.
- Wait 60 seconds (the system has a 60-second cooldown timer before a new code can be requested).
- Click "Resend Code" to receive a fresh verification code.
Note on Expiry: Login OTP codes expire after 10 minutes. If your code expires, click "Resend Code" or return to the login screen to start again.
1.3 Forgot or Reset Password
To reset your password, request a One-Time Password (OTP) from the login page. The system sends a 6-digit verification code to your email rather than a reset link:
- On the login screen, click the "Forgot Password?" link beneath the password field.
- Enter your registered work email address and submit the request.
- Check your email inbox for an email with the subject "Password Reset OTP" containing a 6-digit numeric code. The reset code expires after 10 minutes.
- On the password reset screen:
- Enter the 6-digit OTP code received in your email.
- Type in your new password (must be at least 8 characters long and include a mix of uppercase letters, lowercase letters, and numbers).
- Re-type your new password in the confirm password field.
- Click "Reset Password".
- The system updates your password, terminates any active sessions on other devices for security, and confirms the reset. You can now log in using your new password.
1.4 Understanding Your Screen Layout
Once logged in, your screen is divided into three easy sections:
- A. The Left Sidebar Menu: Your main navigation bar. It lists all the sections you have access to: Operations, Lending, Finance, and Administration. If you do not see a particular section, your account has not been assigned permission for that area.
- B. The Top Bar: Located along the top right of your screen. Here you can see your current branch name, your user profile, and a menu where you can change your password or log out safely when you leave your desk.
- C. The Main Work Area: The center of your screen. This is where your tables, search bars, customer cards, and forms appear.
3.1 Branches
This page lists all official office locations (such as Head Office, Nairobi Branch, Mombasa Branch, or Nakuru).
How to Add a New Branch:
- In the left sidebar under Operations, click Branches.
- Click the "Add Branch" button at the top right.
- Fill in Branch Name (eg Nakuru Branch), Branch Code (a short unique code, eg NAK-01), Location (physical street or building address), and Status (choose "Active").
- Click "Save".
How to Edit or Deactivate a Branch:
- Find the branch in the table.
- Click the "Edit" button on the right side of the row.
- Update any details or switch status to "Inactive" if the branch is closing.
- Click "Save Changes".
3.2 Customers
This is the core borrower directory. You can register new individuals or businesses, view complete borrower profiles, and carry out compliance checks.
Finding a Customer:
- Use the search bar at the top of the list to find a customer by full name, ID number, phone number, or system customer number.
- Use the status dropdown to filter by Active, Pending, or Suspended customers.
How to Register a New Customer:
- In the left sidebar under Operations, click Customers, then click the "Add Customer" button.
- Choose the Customer Type:
- Individual: For personal loans and single borrowers.
- Business / Corporate: For registered enterprises and companies.
Important: Customer type cannot be changed once saved, so be sure to select the right one.
- Fill in Personal / Business Details: Full Name or Registered Business Name, National ID or Passport number (for individuals) or Certificate of Incorporation / Registration number (for businesses), KRA PIN tax number, Date of Birth (must be in the past), Mobile Phone Number, Email Address, Gender, and Marital Status.
- Fill in Physical Address: County, Sub-County, Town / Area / Estate, Road or Street Name, and House or Land Reference (LR) Number.
- Upload Identity Documents: Scanned copy or photo of the National ID (front and back) or Passport, plus the KRA PIN certificate.
- Click "Submit".
Using AI to Fast-Track Customer Registration (ID & KRA PIN Parsing):
To save your team valuable time and prevent typing mistakes, SymaCore features integrated AI document parsing powered by Google Gemini:
- When filling out the "Add Customer" form, you can simply upload clear photos or PDF scans of the customer's National ID card (or Passport) and KRA PIN certificate.
- Click the "Parse Documents" button.
- The AI reads the documents instantly and extracts:
- From National ID / Passport: Full Name (Surname and Other Names), National ID or Passport number, Date of Birth, Gender, and Town.
- From KRA PIN: KRA PIN tax number, registered email address, road or street name, estate or building, town, postal address, and postal code.
- Automatic Pre-Fill: The system automatically populates the registration form with the extracted details.
- Human Review: Review the extracted data on screen, enter the customer's active phone number, adjust any fields if necessary, and click "Submit".
Once registered, customer activation follows the Two-Person Maker-Checker Rule.
The Customer Profile Page
Click the customer's name or the "View" (eye icon) button in any customer row to open their profile, organized into the following tabs:
- Overview Tab: Contact numbers, ID numbers, home address, account status, and quick action buttons.
- Contacts Tab: Referees, spouse, and next-of-kin. Click "Add Contact" to save family members or personal references who can be contacted if needed.
- Employment Tab: Where the customer works, employer name, job title, terms (permanent, contract, self-employed), and work address.
- Income Tab (Mandatory for Loan Applications): Captures the customer's complete monthly financial situation:
- Monthly Income: Net salary from employment, regular business earnings, and any secondary income sources.
- Monthly Expenses: Living costs broken down into rent, food and groceries, transport, utilities, school fees, insurance, and other regular household expenditures.
- Disposable Income: The system automatically calculates their net disposable surplus (Total Monthly Income minus Total Monthly Expenses).
Why the Income Tab must be set for a loan application to proceed: SymaCore uses these figures directly in credit weighting and affordability appraisal. When an application is appraised, the credit engine determines Net Available Income by taking monthly disposable income and subtracting existing debt obligations (from the Existing Loans tab and any other active loans in SymaCore). Dividing this by the proposed monthly installment gives the Affordability Ratio. If left blank, income evaluates to zero, failing the minimum affordability ratio (1.0x), flagging the loan as High Risk, and issuing a recommendation to Decline. Standard branch managers cannot approve an unaffordable loan; only an elevated user with discretionary approval permissions (loans.discretionary-approve) can approve it with an audited justification.
- Financials Tab (Businesses): Captures annual turnover, gross profit, and net profit for the last 3 years.
AI Financial Statement Parsing: Instead of typing long numbers by hand from paper or PDF statements, click "Parse Statement" and upload the business's audited accounts or trading summary. The AI reads the document, extracts the financial year, turnover, and net profit, and presents them for your review and confirmation.
- Existing Loans Tab: Records loans the customer currently holds with other banks, microfinances, or mobile lenders.
- KYC Tab: Shows the customer's identity verification status. See Identity Checks (KYC Verification).
Maker-Checker Approvals
Maker-Checker Approval Workflow:
Step 1 (Maker): Loan officer reviews customer and clicks "Approve". Status becomes "Pending Authorization".
Step 2 (Checker): Branch manager reviews and clicks "Authorize Approval". Status becomes "Active".
Note: The person who submitted or initiated approval cannot authorize it. A different colleague must do it.
If an action was submitted in error, click "Cancel Pending" to revoke the submission prior to managerial review. This approval model also applies to Loan Applications, Loan Reschedules, and Loan Write-Offs.
Identity Checks (KYC Verification)
- In the customer's profile, go to the "KYC" tab.
- Click "Submit for KYC" to verify their National ID and facial identity automatically.
- If automated verification fails due to a blurry document or system mismatch, an authorized officer can click "KYC Override", enter a written explanation, and have a manager authorize the override under Maker-Checker rules.
Customer Statements & Suspension
Downloading Customer Statements: Click the "Statement" button inside the customer folder to view or print a clean summary of all loans, payments, and balances for that borrower.
Suspending or Reactivating a Customer:
- If a customer provides false information or breaks company terms, click "Suspend" and state a clear reason. A second officer must authorize the suspension.
- Suspended customers cannot apply for or receive new loans in Section 4.3: Loan Applications.
- To restore them, click "Reactivate", which again requires second-officer authorization under the Maker-Checker rule.
3.3 Customer Groups (Chamas)
If your branch runs community lending, solidarity groups, or chama financing, this page is where you group borrowers together:
- In the left sidebar under Operations, click Groups.
- Click "Add Group" and enter the group name and purpose.
- Click "View" on any group to see its members.
- Click "Add Member" to link an existing customer to the group and assign their role (eg Chairperson, Treasurer, Secretary, or Member).
- You can remove a member at any time by clicking the delete icon next to their name in the member list.
4.1 Loan Products
Loan products are the financial packages your business offers to customers (for example: Logbook Loans, Title Deed Financing, Asset Finance, or Short-Term Salary Advances).
A loan product defines the operational and credit parameters for a financing facility, including interest rates, repayment tenors, and applicable fees. Standardizing these terms ensures consistent underwriting across branches and prevents manual errors during loan origination.
How to Set Up or Edit a Loan Product:
- In the left sidebar under Lending, click Loan Products.
- To create a new package, click the "Add Product" button at the top right. To update an existing package, find it in the table and click "Edit".
- Fill in the product settings detailed in the guide below.
- Review the General Ledger accounting links to ensure all 7 required accounts are selected.
- Set the status to "Active" and click "Save".
Detailed Guide to Product Settings:
Do Product Changes Affect Existing or Provisioned Loans?
A frequent question is whether updating product parameters (such as interest rates, term lengths, or fees) will alter existing or provisioned loans.
Modifying a loan product does not affect existing loans.
The Contract Snapshot Principle: When an application is created, SymaCore captures a permanent snapshot of that product's configuration. The interest rate, calculation method, allowable term lengths, fee schedules, and penalty rates are bound directly to that application record.
How SymaCore preserves loan contract integrity:
- Signed Agreements Remain Binding: When a loan is appraised, approved, and disbursed, the system generates the repayment schedule strictly from the parameters established at origination. Once a loan agreement is executed, subsequent updates to the general product catalog cannot retroactively alter an active borrower's repayment schedule or financial terms.
- Active and Provisioned Loans Remain Protected: Whether a loan is performing, in arrears, or subject to monthly IFRS 9 or CBK loan loss provisioning, its repayment schedule, interest calculations, and outstanding balances remain locked to its original terms.
- Effect of Product Edits: Parameter changes apply exclusively to new applications created after saving updates. Existing active loans and previously submitted applications retain their original contracted terms.
- Restructuring Existing Loan Terms: If a borrower requires term modifications (such as extending tenor to adjust monthly installment amounts), do not modify the loan product. Instead, execute a formal Loan Reschedule, which follows documented credit appraisal, collateral verification, and supervisory approval workflows.
4.2 Loan Agents (Field Agents)
Loan agents are independent sales representatives and field scouts who introduce customers to the company:
- Agents do NOT have user accounts or system passwords.
- They are simply registered with their name, phone number, and branch so they can be selected on Loan Applications to track commissions and deal originations.
4.3 Loan Applications
Every new loan starts as an application:
Step 1: Drafting the Application
- In the left sidebar under Lending, click Loans to expand the menu, choose Loan Applications, then click "Add Application".
- Select the Customer: Search by full name, ID number, or phone number. The customer must be in Active status. In addition, their Income Tab must be completed first, as the system relies on declared earnings and living expenses for credit weighting and affordability appraisal.
- Select the Loan Product: The system automatically pulls in the pre-configured interest rate, calculation method, fee defaults, and allowable term boundaries from the chosen Loan Product.
- Enter Requested Loan Amount: Must sit within the product's Minimum Amount and Maximum Amount boundaries.
- Choose Number of Installments (Term Length): Specify the repayment duration chosen by the borrower. Each installment represents one monthly repayment cycle. The number must fall strictly between the product's user-defined Minimum Term (which can start from just 1 month) and Maximum Term.
- Review Upfront Fees & Deductions: Default figures for credit appraisal, legal fees, valuation fees, transfer fees, inspection fees, and NTSA fees pre-fill automatically. Review and adjust them if special terms were approved.
- Select Loan Purpose: Choose the primary reason for borrowing (eg Business, School Fees, Medical, Property Purchase, Asset Purchase). If you select "Other", provide a brief description.
- Source of Awareness & Introducing Agent: Record how the customer heard about your institution. If a field agent introduced the borrower, select them from the Loan Agent dropdown to ensure commission tracking.
- Click "Save Draft". At this exact moment, SymaCore permanently locks the product terms snapshot onto this application file.
Step 2: Attaching Security (Collateral)
- Ensure the customer has at least one active, valued collateral item registered under their profile. See full registration details in Section 4.7: Collaterals (Vehicles & Land).
- The loan amount cannot exceed the maximum Loan-To-Value (LTV) limit allowed for that asset. LTV limits are configured in Section 6.7: System Settings.
- The valuation report must be recent (no older than the company valuation age limit, 6 months by default, set in System Settings). The same freshness check runs again during final disbursement.
Step 3: Submitting the Application
- Click the "Submit" (paper airplane icon) button on the application row.
- The system checks that collateral is attached, valuations are valid, and the customer account is active.
- If valid, the application transitions to "Submitted" status.
Step 4: Appraising and Approving
- A credit officer reviews the borrower's income, expenses, and security, and records appraisal notes based on their Income & Disposable Affordability.
- To approve: Click the green "Approve" button and enter approval remarks. If the installment is high compared to disposable income, an Affordability Override Reason must be typed in by an officer with discretionary approval rights.
- Once approved, the application is ready for payout under Segregation of Duties rules.
Rejecting an Application: If an application does not meet credit criteria, click the red "Reject" button. You must enter a clear, human explanation in the remarks box so the customer and your team understand why the loan could not proceed.
Segregation of Duties on Loans
Segregation of Duties on Loans: The system enforces user separation across three distinct loan processing roles:
- Person 1: Creates and submits the loan application.
- Person 2: Appraises and approves the application.
- Person 3: Disburses the payout.
The person who originated a loan can never disburse it. The person who approved it cannot normally disburse it either, although an authorized supervisor holding the disbursement override permission may do so under strict audit logging. See Section 6.1: Users, Roles & Permissions.
4.4 Active Loans (Disbursing)
Disbursing an Approved Loan (Paying Out):
Before money can be disbursed to a customer, SymaCore performs strict automated safety checks:
- Customer Status: The borrower must be in "Active" status (not pending or suspended).
- Active Loan Cap: The customer cannot exceed the company's active loan limit (1 active loan per borrower by default, configured in System Settings).
- Collateral Approval: Pledged collaterals must be approved (status "Active") with all mandatory security documents verified in Collateral Custody.
- Valuation Freshness: The collateral valuation report cannot be older than the company limit (6 months by default).
- Vehicle Insurance Validity: For motor vehicle security, the vehicle's insurance policy must have at least 11 months of remaining cover before payout. If expiring sooner, the borrower must renew their cover before money can be released.
- LTV Ceiling: The approved loan amount cannot exceed the Loan-To-Value cap (50% of the collateral's Forced Sale Value by default).
- Upfront Fee Sanity: Total fees cannot exceed the principal loan amount.
- User Separation: The user disbursing the payout cannot be the person who created the application, nor the person who approved it (unless holding an audited disbursement override; see Segregation of Duties on Loans).
Steps to Disburse:
- On an approved application, click the "Disburse" button.
- Select the Payout Date (Disbursement Date): Can be today or a past date to match the actual bank or mobile money transfer date. It cannot be in the future, and cannot fall into a closed or locked financial period. Setting the disbursement date back to the bank transfer date ensures repayment schedule due dates, interest accrual, and final maturity are anchored to the true value date.
- Select Source Bank Account: Choose the company bank account where funds are leaving from (configured in Section 5.3: Banking and Cash Book).
- Review Deductions: Upfront fees (processing, appraisal, legal, valuation, inspection, NTSA) are deducted from the approved loan, displaying Gross Loan, Total Deductions, and Net Cash paid to the borrower.
- Enter Customer Recipient Details: Mobile Money (phone number and reference), Bank Transfer (recipient bank selected from the active Banks list, account name, and account number), or Cash (receipt voucher number).
- Click "Confirm Disbursement".
The system immediately builds the full repayment schedule, creates the active loan record, and automatically posts the double-entry accounting journals into the General Ledger.
Recording Repayments & Split Order
When a borrower pays money back:
- In the left sidebar under Lending, click Loans to expand the menu, and choose Loans.
- Find the loan in the list (search by customer name or loan number), then click the "Repay" button on that row.
Critical Rule: Overdue Installments & Reschedule Policy:
If a loan currently has overdue installments, the system blocks standard payment with this message:
"Payment is blocked: this loan has overdue installments. Submit a reschedule request and have it approved before making a payment."
Why payment is blocked when an installment is overdue: Company credit policy requires that defaulted or overdue accounts must have an approved relief plan (an approved Reschedule with a future due date) before standard payments are accepted. This prevents borrowers from making random small token payments while ignoring severe arrears.
How to proceed if payment is blocked:
- If the customer genuinely paid late: Submit a Loan Reschedule request for the overdue installment (see Section 4.5: Loan Reschedules). Once a manager approves the reschedule, the payment gate unlocks immediately.
- If the customer deposited funds on or before their due date: Enter the actual deposit date in the "Payment Date" field. For backdated entries, the system evaluates overdue status as of the entered payment date. If the payment was timely on that date, the overdue restriction is bypassed, late penalties are reversed, and the repayment is posted.
Payment Entry Fields:
- Payment Date and Amount Paid:
- The payment date must sit between the loan disbursement date and today.
- STRICT BOUNDARY: The payment date can NEVER be before the loan was disbursed. If a loan was disbursed on June 10th, the system will reject any repayment dated June 9th or earlier. A customer cannot repay funds before receiving them.
- Future dates are never accepted.
- If you date the payment before today, it is treated as a backdated payment and requires a mandatory written reason (5 to 500 characters). Backdating further than the company limit (30 days by default, set in System Settings) requires an authorized supervisory override.
- Choose Payment Method:
- Mobile Money (M-Pesa, Airtel Money, T-Kash): Enter customer phone number, transaction reference, and select the Company Receipt Bank Account (the company's receiving float or paybill account).
- Bank Transfer: Choose the customer's drawer bank, account number, and transaction reference. Optionally select the company receiving account.
- Cheque: Enter cheque number, customer drawer bank, and account number.
- Cash: Received at the branch teller counter.
- Click "Submit Repayment".
How the System Splits Repayments: Money paid by the customer is allocated automatically in a fair, strict order:
- Unpaid fees (if any) are cleared first.
- Late payment penalties are cleared second.
- Due interest is cleared third.
- The remaining balance reduces the loan principal.
After posting a repayment, you can immediately issue an official receipt in Payment Receipts & Schedules.
Keeping Records Current: Operational Risks of Delayed Posting
A foundational operational principle in lending is same-day posting: every payment received (whether cash at a branch till, an M-Pesa paybill notification, or a direct bank transfer) should be recorded in SymaCore on the date funds are received.
Operational Risks of Delayed Record-Keeping:
- Inaccurate Overnight Penalties: Daily at 00:05, the system runs an automated penalty check. If an installment was paid on time but not recorded before the scheduled run, the system evaluates the loan as delinquent and assesses late payment penalties.
- Erroneous Collection Escalations: The Defaulters module automatically generates collection cases for past-due accounts. Unposted payments lead collection teams to contact borrowers whose obligations were already settled, causing customer friction and misallocating operational recovery efforts.
- Unreconciled Bank Balances: Repayments post immediately to the cashbook. When finance staff reconcile bank or M-Pesa statements against SymaCore, delayed entries produce variances between statement deposits and general ledger records, stalling daily closing procedures.
Understanding Backdating Rules in SymaCore (Loans vs. Repayments):
To keep company accounts accurate while reflecting actual transaction dates, SymaCore allows backdating under defined rules:
- 2. Backdating a Repayment (Actual Value Date): Ensures the borrower account is credited on the effective deposit date, preventing improper penalty charges and erroneous collection flags.
- 3. Repayments Cannot Precede Loan Disbursement: SymaCore enforces the rule that the Payment Date must be on or after the Loan Disbursement Date. If a loan was disbursed on June 10th, the system rejects any repayment entry dated June 9th or earlier.
- 4. Repayments Cannot be Post-Dated: The Payment Date cannot be later than today. You cannot record payments for funds that have not yet arrived.
- 5. Mandatory Written Reason for Backdated Repayments: Whenever the Payment Date is earlier than today, SymaCore flags it as backdated and requires a written explanation (5 to 500 characters) in the Backdate Reason box, permanently saved in the audit log.
- 6. The 30-Day Limit & Supervisory Override: Standard staff can backdate repayments up to the company threshold (30 days by default, set in System Settings). Reaching further back requires an authorized supervisor.
- 7. Automated Penalty Reversal (Value-Date Protection): If an installment incurred an overdue penalty because payment entry was delayed, recording the actual payment date automatically reverses the penalty, recalculates the loan balance, and posts the appropriate adjustment to the General Ledger.
- 8. Closed-Period Posting Restriction: Neither loan disbursements nor repayments can be backdated into a financial period that has been closed and locked by the Finance Department.
Payment Receipts & Schedules
Repayment Receipts: After saving a payment in Section 4.4, click the receipt link to print or save an official receipt showing amount received, how it was split, and the new outstanding balance.
Repayment Schedule: Click any loan number to view its full schedule: Due date, Principal portion, Interest portion, Total due, Amount paid, and Status (Paid, Pending, Overdue). You can export the schedule to Excel or PDF for the customer at any time.
Late Payment Penalties & Notices
- If a repayment date passes and the installment is not settled in full, the system marks it overdue.
- The penalty is a percentage of the FULL scheduled installment, defined on the Loan Product.
- It is charged ONCE per overdue installment. It does not grow with days late, and running calculations again never charges it twice.
- A part payment does NOT reduce the penalty. Only settling the installment in full before its due date avoids it.
- Penalties can be calculated manually or run automatically each night via the scheduled penalty job (see Section 6.5: Scheduled System Jobs).
- Click "Download Penalty Notice" to generate an official demand letter explaining what is overdue, how late fees were calculated, and payment instructions.
4.5 Loan Reschedules (Restructuring)
When a borrower experiences genuine hardship (medical issues, delayed receivables):
- On the loan row, click "Reschedule".
- Choose the installment to defer and enter Extension days (1 to 365 days, within policy limits set in System Settings).
- Enter the Reason for restructuring.
- The system calculates any reschedule fee and displays the new due date.
- Click "Submit Reschedule". A second officer reviews and approves the request under Maker-Checker rules.
Note: A reschedule defers ONE installment. Every other installment keeps its original due date, and the loan maturity date does not change.
4.6 Loan Write-Offs & Queue
Writing off a loan is a last resort when all recovery options are exhausted:
- Initiate (Maker): Click "Write-Off", enter a thorough explanation, and provide the Board Resolution Reference if the balance exceeds the threshold set in System Settings. Click "Initiate Write-Off".
- Authorize (Checker): A manager expands Loans under Lending in the sidebar, selects Write-Off Queue, reviews the loan snapshot, and clicks "Authorize". The loan closes and the loss posts to bad debt expense in the General Ledger.
4.7 Collaterals (Vehicles, Land & Security)
This module holds all pledged assets securing loans in Section 4.3: Loan Applications.
Supported Collateral Types:
- Motor Vehicles: Cars, trucks, vans, motorcycles.
- Land & Property: Plots, agricultural land, residential and commercial buildings.
Supported Asset Types Rule: Motor Vehicles and Land/Property are the only two collateral types permitted for registration. Older records may still display retired types such as chattels, shares, or personal guarantors; those records remain readable for historical reference, but all new security must be registered as a motor vehicle or land.
How to Register Collateral:
- In the left sidebar under Lending, click Collaterals, then click "Add Collateral".
- Select the Owner (Customer).
- Choose the Collateral Type and enter asset specifications:
- Motor Vehicle:
- Registration number (eg KDA 123X).
- Make and Model (selected from Reference Data).
- Year of Manufacture and standardized Body Type (Saloon, Pick-up, Station Wagon, SUV, etc.).
- Chassis Number / VIN and Engine Number.
- Market Value and Forced Sale Value (distressed liquidation value).
- Valuer Name and Date of Valuation.
- Insurance Company, Policy / Certificate Number, and Insurance Expiry Date.
- Land & Real Estate:
- Ownership Category: Individual, Joint, Company, or Institutional. This field is required and defines the exact document requirements enforced by the system.
- Title / LR Parcel Number: Official land registry identifier.
- Registered Owners: Entered verbatim as recorded on the title deed.
- Tenure: Freehold or Leasehold. If Leasehold, enter lease commencement and expiry dates. The remaining lease term must exceed the loan term by at least the institutional lease margin (default 6 months).
- Location & Size: County, Sub-County, and Acreage / Parcel Area.
- Valuation Figures: Market Value, Forced Sale Value, Valuer Name, and Valuation Date.
- Official Land Search: Search date, search reference number, and registry outcome. The official search must be recent (under 30 days old) and is re-verified at submission and prior to loan disbursement.
- Encumbrances: Mandatory declaration of existing charges, cautions, restrictions, or ongoing ownership disputes. A charge held by another financial institution blocks the asset from securing loans.
- Clearances & Custody: Rates clearance certificate, ground rent clearance certificate, consent to charge, and physical title custody details. Spousal consent is optional and tracked independently of marital status.
- Attach supporting files. Requirements depend on collateral type and, for land, on the ownership category. Corporate entities pledging land must provide their certificate of incorporation and board resolution; individual borrowers do not. Open the collateral and check the compliance view for the outstanding list.
- Click "Save". The asset is saved in "Draft" status. Placeholder land records without mandatory ownership and document parameters are prohibited.
Using AI to Parse Vehicle Documents (Logbooks, Valuations & Insurance):
When recording vehicle collateral, officers can enter details manually or use document parsing (powered by Google Gemini OCR) to extract specifications from uploaded files:
- In the left sidebar under Lending, click Collaterals, then click "Add Collateral".
- Select the customer and choose "Motor Vehicle" as the collateral type.
- In the document upload area, attach the vehicle files (clear JPEG, JPG, PNG photos or PDF documents up to 10 files per type, up to 10MB per file):
- Valuation Report (including vehicle inspection photos and logbook pages)
- Insurance Certificate or Policy schedule
- Click the "Parse Documents" button.
- In just a few seconds, the parser extracts the information and populates the form fields:
- Vehicle Identity: Registration number plate (eg KDA 123X), manufacturer make (eg Toyota), model name (eg Corolla Axio), standardized body type (Saloon, Pick-up, Station Wagon, SUV), vehicle color, engine serial number, chassis / VIN number, and the registered owner's full name.
- Valuation Figures: Full asset description, estimated market value in KES, forced sale value in KES (distressed sale value), valuation date, and the valuer name or firm.
- Insurance Coverage: Insurance company name, policy / certificate number, insurance expiry date, and the insured / declared sum in KES.
Cross-Document Verification:
When both a valuation report and an insurance certificate are uploaded, the parser compares the vehicle registration number, chassis/VIN, and engine serial number across both documents. If discrepancies are detected (such as differing chassis numbers between the valuation report and insurance certificate), the system flags the mismatch in the review notes and displays a warning on screen for staff review.
Confidence Rating and Review Notes:
The extraction output includes an overall confidence percentage and notes detailing any unreadable text, assumptions, or items requiring manual confirmation.
Human Review and Maker-Checker Verification:
AI document parsing functions as an operational processing aid rather than an automated decision maker. Extracted figures are presented as editable suggestions and are not saved directly to the database. An officer reviews the suggested values against the original documents, makes any necessary adjustments, and clicks "Save". The collateral then advances to document verification, where a second officer reviews the records under the maker-checker approval policy.
Data Privacy and Isolation:
Customer and institutional data remain protected. The AI parser operates under strict data isolation: only raw document bytes and neutral document type labels are transmitted for OCR processing. Internal database keys, loan account numbers, ledger balances, and borrower profile records are never transmitted to external services.
Uploading & Verifying Documents (Two-Eyes Review)
Supporting documents provide the legal and financial foundation of every pledged security. To maintain record integrity and protect against credit risks, the system enforces a strict two-eyes verification control:
Independent Verification Rule: The officer who uploads a logbook, title deed, valuation report, or insurance certificate cannot verify it. If that user attempts to click "Verify", the system blocks the action immediately with an alert: "You cannot verify a document you uploaded." A separate, independent officer must inspect the file and complete the verification.
Document Requirements by Asset Type:
- Motor Vehicles: Original Logbook (proof of legal ownership), Certified Valuation Report (assessing current market and forced sale values), Comprehensive Insurance Certificate / Policy Schedule (confirming active cover), and vehicle inspection photographs.
- Land & Property: Title Deed / Certificate of Lease, Official Land Search Certificate (issued within the last 30 days), Valuation Report with site photos, Land Rates Clearance Certificate, Land Rent Clearance Certificate, Consent to Charge (where required by tenure), and Board Resolution / Entity Documentation (mandatory for Company or Institutional ownership).
How to Verify Collateral Documents in the UI:
- In the left sidebar under Lending, click Collaterals.
- Click on the collateral row in the table to open the Collateral Details dialog.
- Scroll to the Documents section. Each attached file displays its verification badge ("Pending", "Under Review", "Verified", or "Rejected"), the uploader's name, upload date, and action buttons.
- Click the download icon (tray with arrow) to open and inspect the document.
- Click the "Verify" button (check-circle icon) next to the document.
- In the Verify Document dialog:
- Decision: Select one of the three options:
- "Verified": Confirms the document is genuine, legible, unaltered, and matches the collateral record.
- "Under Review": Keeps the document in a holding status while further inquiries, land registry searches, or valuer confirmations are conducted, without reaching a final decision.
- "Rejected": Declines the document. Written remarks are required explaining why the document was declined (eg blurry scan, missing valuation schedule, mismatched chassis number, or expired insurance policy).
- Click "Submit" to record the verification decision.
Live Compliance Card:
Directly below the documents list, the Compliance card dynamically tracks the asset's readiness in real time:
- Displays an overall status badge: "Compliant" (green) or "Not Compliant" (yellow/red).
- Highlights outstanding items, including missing statutory documents and files awaiting verification.
- For land assets, calculates the remaining lease term against the loan duration and highlights legal blockers (such as active cautions, ownership disputes, or competing registered charges).
- A collateral cannot be submitted for approval until this card turns "Compliant".
All verified documents can also be searched centrally across the institution in the Documents Library.
Collateral Approval (Maker-Checker Workflow)
Once all required documents are verified and legal blockers are resolved, the collateral moves through a formal two-person maker-checker approval workflow. The user who registers and submits the security (Maker) and the user who approves it (Checker) must be different individuals.
The workflow progresses through the following sequential steps:
Step 1: Registration and Document Attachment (Maker)
- The loan officer (Maker) goes to Lending > Collaterals and clicks "Add Collateral".
- The officer selects the customer and collateral type (Motor Vehicle or Land), enters technical specifications, valuations, and valuer details, attaches the supporting files, and clicks "Save".
- The newly registered collateral enters "Draft" status. While in Draft, all fields and documents can be edited, updated, or removed by the officer.
Step 2: Document Verification (First Checker Gate / Two-Eyes Review)
An independent colleague opens the collateral details dialog, inspects each uploaded file, and marks them "Verified" as detailed in Uploading & Verifying Documents. This satisfies the document compliance matrix and unlocks the submission action.
Step 3: Submitting the Collateral for Approval (Maker)
Once all documents are verified and compliance checks pass, the originating officer submits the asset:
- In Lending > Collaterals, locate the asset (currently in "Draft" or "Rejected" status).
- In the row action menu, click "Submit" (paper airplane icon).
- The system automatically executes five pre-submission guardrails:
- Mandatory Fields: Verifies that Forced Sale Value, Valuation Date, and Valuer Name are fully captured.
- Valuation Freshness: Confirms that the valuation report date is not older than the company maximum (default 6 months). A valuation older than this limit is rejected with an alert.
- Vehicle Insurance Cover: For motor vehicles, confirms that the insurance policy expiry date is set and provides at least the minimum required active cover (default 11 months).
- Land Legal Clearances: For land assets, confirms there are no active cautions, restrictions, litigation disputes, or existing charges registered to other institutions.
- Ownership Document Matrix: Confirms that every document required for the asset and ownership category is present and verified.
- An information dialog appears reminding the officer of the four-eyes rule: the officer submitting this collateral cannot approve it.
- Click "Submit" to confirm.
- The collateral status transitions to "Pending Approval", and the system records the submitter's name and submission timestamp. Direct editing is now locked.
Step 4: Supervisory Review and Approval or Rejection (Checker)
A branch manager, credit manager, or designated supervisor (Checker) conducts the final supervisory review:
- Four-Eyes Separation of Duties: The user who created or submitted the collateral cannot approve it. If the maker attempts to click "Approve", the system rejects the request with an error: "Four-eyes policy: you cannot approve a collateral you submitted. A different authorised user must perform this action."
- Valuation Freshness Re-check: At the exact moment of approval, the system re-validates the valuation age. If a valuation report was valid when submitted but has since expired while awaiting review in the queue, approval is blocked until a fresh valuation is completed.
- Reviewing the Record: The manager opens Lending > Collaterals, filters records with the "Pending Approval" status badge, and clicks the row to review the details modal (financial figures, asset details, verified documents, and compliance summary).
- Taking Action:
- To Approve:
- In the row action menu, click "Approve" (green checkmark icon).
- An alert confirms the four-eyes policy and notes that approval activates the collateral and locks direct edits.
- Click "Approve".
- The collateral status moves to "Active", stamped with the reviewer's name and approval timestamp. It is now live and can be pledged to secure loan applications in Section 4.3 and loan disbursements in Section 4.4.
- To Reject:
- If the manager identifies discrepancies, missing information, or unacceptable risk, click "Reject" (red X icon).
- In the rejection dialog, enter a mandatory "Rejection reason" (minimum 10 characters).
- Click "Reject".
- The collateral status changes to "Rejected", stamping the rejection reason into the record.
- Rejection unlocks the asset back to the originating loan officer (Maker). The maker can view the rejection reason, make corrections or re-upload documents, and click "Submit" again to restart the review.
Security Override (Exception Handling):
If an urgent loan must proceed while a non-critical security document is still in transit (for example, an official title deed awaiting collection from the land registry):
- An authorized officer holding the security override permission can bypass the block during loan application submission or loan disbursement.
- The officer must provide a written justification (minimum 20 characters) explaining why security compliance is being temporarily waived.
- The override applies strictly to that single instance and is logged permanently in the audit trail (Section 6.6) for governance and compliance review.
Updating Collaterals & Substitutions
Updating Active Collaterals (Maker-Checker Workflow):
Once a collateral asset has been approved and moved to "Active" status, direct edits are locked. This control prevents any individual user from altering valuations, reducing forced sale values, or modifying ownership details while loans are actively secured by that asset. Proposed changes require a pending update request and secondary manager approval before values update on the active record.
How to Update an Active Collateral:
- Open the collateral record in Lending > Collaterals and click "Initiate Update".
- Enter the updated fields (for example, fresh valuation figures, new valuer name, or updated vehicle details).
- The system captures your changes as a "Pending Update" request. The active collateral retains its original values while the request is under review.
- Checker Authorization: A manager opens the collateral's "Pending Updates" tab, reviews the proposed before-and-after values, and clicks "Approve" (or "Reject" with written remarks).
- Only after manager approval are the new values applied to the active collateral, with a permanent before-and-after record saved to the audit trail in Section 6.6.
Annual Insurance Renewal Exception: Annual vehicle insurance renewals (policy number, insurer name, expiry date, and insured value) can be updated directly on active assets without requiring a pending update request, allowing your team to keep insurance coverage current and uninterrupted.
Collateral Substitution:
If a borrower needs to sell a pledged vehicle or replace a title deed with another property while their loan is still running:
- In the left sidebar under Lending, expand Collaterals and click Substitutions (or navigate to Lending > Collateral Substitutions).
- Click "Initiate Substitution".
- Select the active security asset, enter the replacement asset details, and state the business reason for the swap.
- The replacement collateral undergoes physical inspection, document verification, and manager approval.
- Once the new asset is inspected, verified, and approved by a manager, the original security is formally released from the loan.
4.8 Defaulters & Debt Collections
- Automated Case Creation: The system opens a defaulter case automatically whenever an installment passes the arrears threshold (eg 30 days) during the nightly status transition job (see Section 6.5).
- Managing a Recovery Case: In the left sidebar under Lending, click Defaulters, open the customer's case, and click "Add Follow-Up" to record calls, SMS reminders, visits, and borrower commitments (Promise to Pay).
- Set the Next Follow-up Date to receive automated reminders. When the customer pays arrears in full via Section 4.4: Repayments, the case resolves automatically.
- Defaulter trends feed directly into the regulatory PAR Aging Report and month-end Loan Loss Provisions.
5.1 General Ledger & Accounts
The Chart of Accounts organizes finances into five standard groups:
- Assets (1000s): Bank accounts, gross loan portfolio, interest receivable.
- Liabilities (2000s): Borrowings, customer deposits, accounts payable. Linked to Funding Sources.
- Equity (3000s): Shareholder capital, retained earnings.
- Income (4000s): Interest income, loan appraisal fees, late penalties. Linked to Loan Products.
- Expenses (5000s): Staff salaries, office rent, bank charges, bad debts from Write-Offs.
Control Accounts: Accounts receiving automated loan entries cannot be edited manually to prevent discrepancies.
5.2 Journal Entries & Balance Rule
The Double-Entry Balance Rule: Total Debits must equal Total Credits to the exact cent. If they do not balance, the system will not allow the entry to be saved.
Automatic Entries: Posted automatically for Disbursements, Repayments, fee deductions, daily interest accruals, Late Penalties, and Write-Offs.
Manual Adjustments & Reversals: To record overheads or adjustments, expand General Ledger under Finance in the sidebar and select Journal Entries. If a mistake was made, click "Reverse" to create an exact offsetting entry that preserves a transparent audit trail in Section 6.6: Audit Trail.
5.3 Banking and Cash Book
This section tracks company bank accounts, deposits, withdrawals, branch cash floats, and reconciliations.
- Managing Bank Accounts: Add and monitor commercial bank accounts (eg KCB, Equity Bank, Co-op Bank, NCBA) in KES currency used for Loan Disbursements and Repayment Receipts.
- Cash Book Transactions: Record non-loan income ("Receipt") or expenses ("Payment") with receipts and vouchers.
- Statement Lines & Matching: Upload electronic bank statements under "Statement Lines". Match each line against cash book records or mark bank charges and interest.
Supported Banks Directory:
SymaCore maintains a centralized registry of commercial banks in Kenya in the left sidebar under Finance > Banking > Banks:
- Standard Lookup: Provides the official list of banks (such as KCB, Equity Bank, Co-operative Bank, NCBA, Stanbic, ABSA, DTB, Family Bank, and others) available across dropdown menus when entering borrower bank accounts and selecting disbursement payout recipients.
- Active Status: Administrators can add new financial institutions or mark inactive banks so outdated institutions cannot be selected for new transactions.
Petty Cash Management:
For managing small day-to-day office expenses and branch cash floats in the left sidebar under Finance > Petty Cash:
- Float Accounts: Each branch can register a dedicated petty cash float account with an authorized custodian, a defined float ceiling (eg KES 20,000), and a linked General Ledger cash account.
- Recording Cash Transactions: Open the petty cash account and click "Add Transaction":
- Expense: Office supplies, daily mail, courier, minor repairs, or staff travel.
- Reimbursement: Reimbursing approved out-of-pocket expenses.
- Top-Up: Cash withdrawal from a main company bank account to replenish the float.
- Receipt Vouchers: You can attach photo or PDF scans of paper receipts directly to the transaction to keep the float fully audited and accountable.
Monthly Bank Reconciliations
- In the left sidebar under Finance, expand Banking & Cash Book, choose Bank Reconciliations, and click "New Reconciliation".
- Select the Bank Account, date range, and enter Ending Statement Balance from your physical bank statement.
- The system compares your bank statement against the internal cash book (see Section 5.3).
- When the difference is zero, click "Submit for Approval" for Finance Manager sign-off under Maker-Checker controls.
5.4 Funding Sources
Tracks where the capital used to lend originates: Shareholder Capital, Commercial Bank Credit Lines (eg KCB Credit Line KES 50M), Investor Facilities, or Grants. Each pool links to a General Ledger account (see Section 5.1) to monitor drawdowns.
5.5 Provisions and ECL (Risk Rates)
Under Central Bank and IFRS 9 accounting rules, institutions must set aside reserves for loan losses across the portfolio:
| Category |
Arrears Duration |
Provision Rate |
| Normal |
0 to 30 days overdue |
1% |
| Watch |
31 to 90 days overdue |
3% |
| Substandard |
91 to 180 days overdue |
20% |
| Doubtful |
181 to 360 days overdue |
50% |
| Loss |
Over 360 days overdue |
100% |
Provisions run automatically on the last day of each month at 23:30 via Scheduled Jobs. You can also run a Dry Run anytime to preview figures without posting, or a Live Run to post expenses to the General Ledger.
5.6 Financial Reports
All figures in financial reports are generated in real time from posted General Ledger entries and live loan schedules. In the left sidebar under Finance, select Reports to view or export any statement:
- Trial Balance: Lists every account in the Chart of Accounts with total debits, total credits, and net balances up to a selected cut-off date (defaulting to today). Accountants use this to confirm that the entire ledger is in balance and that total debits equal total credits. See The Balance Rule.
- Balance Sheet: Shows the cumulative financial position of your institution as of a specific date: Total Assets, Total Liabilities, and Total Shareholder Equity, ensuring that Assets equal Liabilities plus Equity. The system automatically splits earnings between prior years Retained Earnings and the Current Period Surplus based on the financial year start date set in System Settings.
- Profit and Loss (Income Statement): Measures business performance over any defined date range (From Date to To Date). Compares earned revenues (interest income, facility fees, penalties) against operational costs (staff salaries, office rent, bank charges, and loan loss provisions) to show net profit or loss.
- PAR Aging Schedule (Portfolio at Risk): The primary credit risk and regulatory report required by financial regulators (such as the Central Bank of Kenya). It categorizes the active loan book by Days Past Due (DPD): Current (0 days overdue), 1 to 30 days, 31 to 60 days, 61 to 90 days, 91 to 180 days, and over 180 days. It calculates regulatory PAR1, PAR30 (the core Non-Performing Loan benchmark), and PAR90 risk ratios, directly tied to Defaulter Recovery Cases and Loan Loss Provisions.
How Backdating Alters Past Financial & Regulatory Reports
Backdating an entry modifies historical records. While backdating is occasionally necessary to record the actual value date of a transaction, staff must recognize its impact on previously reported financial statements:
1. Impact on the Trial Balance
The Trial Balance aggregates all ledger entries with transaction dates on or before the selected cut-off date. If a periodic Trial Balance has been finalized and an entry is subsequently backdated into that period, historical debits and credits shift, creating a variance between certified periodic reports and live ledger balances.
2. Impact on the Profit & Loss (P&L) Statement
The P&L measures revenues and expenses within a specific reporting window. Backdating revenue (such as facility fees or interest) or operational expenses into a closed period alters the net surplus or deficit for that period. If financial statements, tax filings, or board reports were already finalized, those figures require formal restatement.
3. Impact on the Balance Sheet
The Balance Sheet distinguishes between prior years' Retained Earnings and Current Period Surplus. Backdating transactions across financial year boundaries shifts balances between historical equity and current-period earnings, altering the reported equity structure.
4. Impact on the PAR Aging Schedule
The Portfolio at Risk (PAR) report evaluates portfolio quality as of a specific historical date based on repayments recorded up to that cutoff. If repayments are delayed in entry, historical aging reports reflect inflated delinquency rates and distorted Non-Performing Loan (NPL) ratios. Subsequent backdating revises historical risk metrics, creating discrepancies with prior compliance and board submissions.
5. Impact on Bank Reconciliations and Cashbook
Every loan repayment records a cashbook movement on the specified value date. Backdating a payment into a period with already certified bank reconciliations introduces unverified cashbook movements, disrupting completed reconciliations and creating audit discrepancies.
The Closed-Period Lock: To prevent backdated operational entries from modifying closed financial statements, SymaCore enforces a strict Closed-Period Lock. At the end of each accounting cycle, the Finance Department closes and locks the financial period. Once locked, SymaCore rejects any disbursement, repayment, or manual journal entry dated within that period with the error: "The financial period is not open for posting." If an adjustment is required for a locked period, designated finance administrators must formally re-open the period, complete the transaction under audit logging, and re-lock it immediately.
6.1 Users, Roles & Permissions
User access is managed through roles and permissions:
- super_admin: Full access to all modules, settings, and technical controls.
- admin: Day-to-day administration across operations and lending.
- credit_officer: Registers customers in Section 3.2, creates loan applications in Section 4.3, logs repayments in Section 4.4.
- credit_manager: Appraises and approves loans under Maker-Checker, handles Defaulters and Write-Offs.
- finance_officer: Manages General Ledger, banking, cash book, and Reconciliations.
- auditor: Read-only access across all records for internal and external checks.
How to Add a New Staff Member:
- In the left sidebar under Administration, select Users & RBAC.
- Click "Add User".
- Fill in their Full Name, Work Email, Phone Number, User Code, and Branch.
- Select the Role(s) they should have (eg Credit Officer).
- Click "Save".
Password Handling: When adding a user, do not enter a password manually. The system generates a temporary password and emails it to the employee's registered work email in a welcome message.
Assigning or Changing Roles: In the Users table, find the employee, click "Assign Roles", tick or untick roles as needed, and click "Save".
6.2 Notifications & Reminders
Sending Messages to Borrowers:
- In the left sidebar under Administration, expand Notifications and select Notifications.
- Click "Send Notification".
- Select the Customer (or enter a phone number), choose SMS or Email, type your message, and click "Send".
Scheduling Payment Reminders:
- Click "Create Reminder".
- Pick the customer and their active loan.
- Select the upcoming due date and enter a friendly reminder message.
- The system dispatches the reminder automatically when that date arrives via Scheduled Jobs.
Notification Templates: Customize standard automated messages with placeholders (such as customer name, application reference, and amount) that populate automatically upon loan application submission, approval, rejection, disbursement, repayment receipt, and rescheduling.
6.3 Reference Data (Vehicles & Counties)
To eliminate spelling mistakes and maintain consistent records across branches, administrators maintain official lookup lists:
- Vehicle Data: Under Administration, expand Reference Data and select Vehicle Data to manage approved Car Makes (eg Toyota, Isuzu, Nissan), Models (eg Hilux, Land Cruiser, Probox), and Body Types (eg Pickup, Station Wagon, Saloon). Used when registering security in Section 4.7: Collaterals.
- County Data: Under County Data, maintain the standard list of Kenya Counties and Sub-Counties used across Customer Registration and collateral addresses.
6.4 Documents Library (Retention & Deletion Protection)
The Documents page in the left sidebar under Administration provides a single central search engine for every file uploaded into SymaCore:
You can search by customer name, document type, or upload date, and click "Download" to review any original file safely.
Legal Retention and Deletion Protection Rule:
Financial institutions are legally required to preserve complete records and unbroken lending evidence. SymaCore enforces automated document protection:
- Protected Evidence:
- Any document attached to a loan application.
- Any document attached or linked to a collateral asset (such as vehicle logbooks, title deeds, valuation reports, land searches, and insurance certificates).
- Identity documents (National ID, Passport, KRA PIN) of any borrower who has ever applied for or received a loan in SymaCore.
- Permanent Lock: These supporting files form a permanent part of the institution's credit archive and cannot be deleted by any user, even after the loan has been fully settled and closed. If a user attempts to delete a protected file, the system blocks the action and explains that the document is retained as security and loan evidence.
- Category Permissions: Only unlinked files (such as a document uploaded for a prospective inquiry that never proceeded to an application) may be deleted, and only by users holding granular deletion permissions (such as
documents.delete.customer, documents.delete.loan, or documents.delete.collateral).
6.5 Scheduled System Jobs
The system runs automated background tasks late at night so staff do not have to perform repetitive calculations manually:
| Schedule |
Job Name |
Purpose |
| 00:05 Daily |
loans:apply-daily-penalties |
Calculates and applies late fees on unsettled past-due installments. See Section 4.4. |
| 00:15 Daily |
loans:apply-status-transitions |
Moves overdue loans to in-arrears or defaulted status, and returns cured accounts to active. Runs right after penalties so days overdue is calculated on updated installments. Feeds Section 4.8: Defaulters. |
| 01:00 Daily |
loans:accrue-interest |
Posts daily interest accrual entries for running loans into the General Ledger. |
| 02:00 Daily |
job-logs:prune |
Clears older job logs per retention settings configured in Section 6.7: System Settings. |
| 08:00 Daily |
notifications:process-reminders |
Sends scheduled payment reminder SMS messages configured in Section 6.2. |
| 23:30 Month-End |
loans:calculate-provisions |
Calculates regulatory CBK / IFRS 9 provisions detailed in Section 5.5. |
Viewing Job History: In the left sidebar under Administration, click Job Runs to confirm that nightly automated jobs ran on schedule, see how many records were processed, and check execution times.
6.6 Audit Trail (Activity Logs)
Every significant action taken in the system is permanently logged to ensure complete transparency. In the left sidebar under Administration, click Audit Logs to inspect permanent activity records across the platform:
- Who made the change (staff name and work email).
- The exact action taken (Created, Updated, Deleted, Approved, Disbursed).
- The exact date and timestamp.
- The user's computer IP address.
- Side-by-side Before and After values: Clicking any audit row displays the exact field modified, what it held before, and what it was updated to. Every action from Maker-Checker to Disbursements is preserved here.
6.7 System Settings
Accessible only to administrators. Settings are organized into dedicated tabs to manage company policies and institutional limits:
- Organisation: Official company name, physical office address, customer care telephone, email, and corporate logo.
- Mail (SMTP): Mail server settings for outgoing system emails, user invitations, and alerts.
- Security & OTP: Rules for login verification codes, session timeouts, and password security policies.
- Lending: Maximum Loan-to-Value (LTV) percentage (applied during Loan Applications), affordability threshold ratio, Board approval loan amount threshold for write-offs (enforced during Write-Off Authorization), days overdue before defaulting, maximum active loans per borrower, minimum required vehicle insurance validity, maximum collateral valuation report age (default 6 months), minimum leasehold land margin (default 6 months beyond loan maturity), maximum age of official land searches (default 30 days) and charge registrations, and repayment backdating limit (default 30 days, enforced during Repayment Entry).
- Finance: Financial year start month (1 for January through 12 for December). This dictates where the Balance Sheet splits prior years Retained Earnings from current period Surplus.
- AI & Gemini Settings:
- Gemini API Key: Google Gemini API key used for document parsing of customer IDs, KRA PIN certificates, financial statements, and vehicle collaterals.
- Gemini Model: The specific AI model used for document reading (defaults to
gemini-flash-latest for fast, cost-effective, and high-accuracy parsing).
- AI Parsing Enabled: A master toggle switch (Enabled / Disabled) that turns automated document reading on or off across the entire system.
- KYC & Identity Verification (MetaMap): Configuration keys, client credentials, and verification flow settings for automated customer identity checks and biometric photo verification.
Why cannot I approve this loan or customer?
Action Denied / Unauthorized: SymaCore enforces a strict maker-checker policy. You cannot approve a record that you created, submitted, or appraised yourself. Ask a different qualified officer or branch manager to log in and approve it.
Read full rules in Section 3.2: Maker-Checker Approvals.
Why was my loan disbursement rejected?
Disbursement can only succeed if all credit and regulatory guards pass:
- The customer is currently "Active" (not suspended or pending in Customer Records).
- The customer has not reached the active loans limit (default is 1 active loan per borrower, configured in System Settings).
- The collateral documents have been verified and approved in Collateral Custody.
- The collateral valuation is still fresh (valued within the last 6 months).
- For motor vehicles, the insurance policy has at least 11 months of remaining cover before payout.
- The loan amount does not exceed the maximum Loan-To-Value cap (50% of the collateral's Forced Sale Value).
- Upfront deductions do not exceed the principal loan amount.
- The person disbursing is different from the person who created and the person who approved the loan (unless holding an audited disbursement override; see Segregation of Duties on Loans).
- The disbursement date is not in the future and does not fall in a locked accounting period.
Review the payout procedure in Section 4.4: Disbursing an Approved Loan.
Why was my customer repayment blocked with a message about overdue installments?
SymaCore enforces an overdue payment gate. If a borrower has past-due installments, the system blocks standard payments until a manager has approved a Loan Reschedule (see Section 4.5). This ensures defaulted loans receive formal credit supervision and prevents borrowers from making random small token payments while ignoring severe arrears.
If the customer actually paid the money on or before their scheduled due date, enter the true deposit date in the "Payment Date" field. For backdated entries, the system calculates overdue status as of that date, bypassing the block, removing any overnight late penalties, and accepting the payment. Review guidelines in Section 4.4: Recording Repayments.
Why was my manual journal entry blocked?
In double-entry accounting, your total debits must equal your total credits exactly, to the cent. Check that the two column totals match. Also ensure the transaction date is not in the future and does not fall inside a closed financial period. Review guidelines in Section 5.2: Journal Entries & Balance Rule.
How do I change an agent's details or branch?
In the left sidebar under Lending, click Loan Agents, find the agent in the list, click "Edit", update their information, and save. To remove an agent from a branch, select the blank option in the branch dropdown. Note that agents with active loans cannot be deleted; you should set their status to "Inactive" instead. See Section 4.2: Loan Agents (Field Agents).
A customer paid, but their loan still shows overdue installments. Why?
Check the amount paid. Repayments clear unpaid penalties and interest before reducing the principal installment. If the borrower paid less than the full overdue amount, the remaining portion will stay overdue until cleared. See the waterfall breakdown in Section 4.4: How Repayments Are Split.
What should I do if a customer forgot their login or needs an OTP reset?
Customers do not have logins; SymaCore is for internal staff only. If a colleague forgets their password, they must reset it themselves using the "Forgot Password" link on the login page (see Section 1.3).
The system sends a 6-digit reset OTP code to their registered work email (no reset link is emailed). They enter this 6-digit code along with their new password (minimum 8 characters, mixed case, and numbers) on the screen to complete the reset.
For security, administrators cannot view, manually set, or email another user's password from the Users page. If the reset OTP email does not arrive in their inbox or spam folder, have your IT Systems Administrator check the system mail settings.
If I edit a loan product, will it change existing or provisioned loans?
No. SymaCore uses contract snapshotting. When a loan application is first drafted, a complete copy of the product's terms (interest rate, calculation method, term boundaries, fee rates, and penalty rules) is permanently bound to that application record.
Editing a loan product only affects brand-new applications submitted after the change. Already provisioned, approved, or active loans retain their original agreed terms for their entire duration. If an active loan needs adjusted terms, use the formal Loan Reschedule feature.
Read full details in Product Changes & Existing Loans.
Why is backdating restricted, and can a payment be dated before disbursement?
Backdating alters the company's financial timeline. When you enter a payment or disbursement with a past date, it posts transactions into past days, which shifts previous cashbook balances, recalculates interest and penalties, and changes historical reports.
Can a loan disbursement be backdated? Yes, you can set the disbursement date to a past date to match when money actually left the bank account.
Can a repayment be dated before the loan was disbursed? No. SymaCore enforces a strict validation rule: repayments cannot precede loan disbursement. The payment date must always fall on or after the loan disbursement date, and cannot be set in the future.
The system requires a written reason for any backdated repayment so there is a permanent audit trail explaining why the entry was delayed. Standard users can backdate repayments up to 30 days; reaching further into the past requires an authorized supervisor. Crucially, the system will completely block any backdating into closed financial months to protect signed accounting records.
Review the full operational impact in Risks of Backdating Payments and How Backdating Alters Past Financial & Regulatory Reports.
How does document parsing work, and can I rely on its figures?
Document parsing extracts fields from uploaded files to assist with form completion, but does not replace manual verification.
When you upload an ID card, KRA PIN certificate, financial statements, or vehicle collateral documents (such as a valuation report or insurance certificate), the system reads the files and pre-fills form fields with suggested values.
For vehicle documents, the system also checks whether identifiers (registration number, chassis number, engine number) match across both the valuation report and insurance certificate, displaying an extraction confidence rating and notes on any unreadable or ambiguous text.
Staff must always verify suggested figures against the uploaded source documents before saving or submitting records. Loan officers and approvers remain responsible for data accuracy. See AI Customer Registration and AI Collateral Parsing.
Who do I contact for help?
- For credit and approval questions, speak to your Credit Manager (see Section 6.1).
- For ledger and payment discrepancies, contact the Finance Department (see Section 5.1).
- For login, browser, or hardware issues, contact your IT Systems Administrator or reach out to Symatech Labs Ltd at symatechlabs.com.