Getting Started
Welcome to WAZOBIA-Books
WAZOBIA-Books is a modern, cloud-based accounting software designed specifically for Nigerian businesses. Our platform is fully hosted in the cloud, so there's no installation required - just sign up and start using it!
Recent Improvements & Enhancements
We've made significant improvements to make WAZOBIA-Books more secure, reliable, and user-friendly:
Enhanced Security
- ✓ Rate limiting on login and registration to prevent brute force attacks
- ✓ Password reset functionality with secure token system
- ✓ IP address and user agent tracking for security monitoring
- ✓ Comprehensive audit logging for all critical actions
- ✓ Account lockout after failed login attempts
Cloud Backup Options
- ✓ Google Drive integration for seamless backups
- ✓ OneDrive support for Microsoft users
- ✓ Azure Blob Storage for enterprise customers
- ✓ Automatic scheduled backups
- ✓ Multiple cloud service support simultaneously
Partner Portal
- ✓ Professional partner authentication system
- ✓ Admin approval workflow for partner accounts
- ✓ Referral code generation and tracking
- ✓ Commission management and reporting
- ✓ Dedicated partner dashboard and resources
User Experience
- ✓ Improved error messages and user feedback
- ✓ Better loading states and progress indicators
- ✓ Enhanced email notifications
- ✓ Professional privacy policy and documentation
- ✓ Streamlined registration and onboarding
First Login
- Access the application at your deployed URL or
http://localhost:3000 - Click "Login"
- Enter your email and password
- You'll be redirected to the dashboard
Email-Based Login
WAZOBIA-Books uses email addresses for login instead of usernames. This is simpler and more secure.
User Registration
Creating a new account is simple:
- Click "Register" or "Create Account"
- Enter your details:
- First Name and Last Name
- Email Address (used for login)
- Password (minimum 8 characters)
- Business Name (optional - creates your business automatically)
- Phone Number (optional)
- Click "Create Account"
- You'll be automatically logged in
No Username Required
Your username is automatically generated from your email address. You only need to remember your email to login.
Two-Factor Authentication (2FA)
For enhanced security, 2FA is available for Owner and Accountant roles. This can be configured in Settings → Security.
Multi-Business Support
WAZOBIA-Books now supports managing multiple businesses from a single account, similar to QuickBooks. This feature allows you to:
- Own and manage multiple businesses
- Switch between businesses seamlessly
- Keep data completely isolated per business
- Access all businesses from one login
Creating Your First Business
During registration, you'll be asked to provide:
- Business Name (required) - Your company or business name
- Business Type (required) - Select from: Sole Proprietorship, Partnership, Limited Liability Company (LLC), Corporation, or Other
- Business Size (required) - Select from: Micro, Small, Medium, or Large
Your first business is automatically set as your Primary Business and you become the Owner.
Switching Between Businesses
To switch between your businesses:
- Look for the Business Selector in the sidebar (top section)
- Click on the current business name
- Select the business you want to switch to from the dropdown
- The system will automatically switch and reload data for the selected business
Quick Switch
The business selector shows all businesses you have access to. Your current business is highlighted. Switching is instant and all data is automatically filtered to the selected business.
Creating Additional Businesses
To create a new business:
- Click on the Business Selector in the sidebar
- Click "Create New Business" or "+ Add Business"
- Fill in the business details:
- Business Name
- Business Type
- Business Size
- Other optional details (TIN, VAT Number, Address, etc.)
- Click "Create Business"
- You'll automatically become the Owner of the new business
- The system will switch to your new business automatically
Data Isolation
Each business has completely separate data. Customers, invoices, expenses, inventory, payroll, and reports are all isolated per business. When you switch businesses, you only see data for the currently selected business.
Business Roles
When you create a business, you automatically become the Owner. As an owner, you can:
- Manage all aspects of the business
- Invite other users to the business
- Assign roles (Accountant, Staff, Viewer)
- Configure business settings
- Access all reports and data
Primary Business
Your first business is marked as your Primary Business. This is used as a default when you log in. You can switch to any business at any time, and the system remembers your last selection.
Best Practices
- Use descriptive business names - Make it easy to identify which business you're working in
- Complete business profiles - Fill in TIN, VAT Number, and address for proper tax compliance
- Verify current business - Always check the business selector before creating invoices or expenses
- Separate personal and business - Use different businesses for different entities to maintain proper accounting separation
Initial Setup
Before using the system, you need to configure:
- Business Profile - Your company details
- Chart of Accounts - Use the built-in template
- Tax Settings - VAT, WHT rates
- User Accounts - Team member access
System Configuration
Configure your system settings through the admin panel:
Quick Setup Command
Run python setup_chart_of_accounts.py to automatically create 70+ standard accounts using GAAP/IFRS templates.
Invoicing & Billing
Managing Customers
To create a new customer:
- Go to Customers from the sidebar
- Click "Add Customer"
- Select Customer Type: Business, Individual, or Government
- Enter customer details:
- Name (required) - Contact name or full name
- Company Name - For business customers
- Email - For sending invoices
- Phone - Contact number
- TIN - Tax ID Number (important for WHT)
- Address, City, State - Location details
- Credit Limit - Maximum outstanding balance (₦)
- Payment Terms - Days until payment due (default 30)
- Click "Add Customer"
Automatic Business Assignment
Customers are automatically linked to your current business. The system uses the business you're currently viewing (shown in the sidebar). You don't need to manually select a business when creating customers.
Validation Errors
If there are any issues with your input, detailed error messages will be shown. Check that required fields are filled correctly.
Creating Invoices
To create a professional invoice:
- Go to Invoices from the sidebar
- Click "Create Invoice"
- Select a Customer from the dropdown
- Set Issue Date and Due Date
- Optionally enter a custom Invoice Number (auto-generated if left blank)
- Add Invoice Items by clicking "Add Item":
- Description - What you're billing for
- Quantity - Number of units
- Unit Price - Price per unit (₦)
- Taxable - Check to apply VAT
- Review the calculated totals
- Click "Create Invoice"
Auto-Calculated Fields
The system automatically calculates: Subtotal, VAT (7.5% on taxable items), WHT (if enabled), and Total Amount. No manual math needed!
Create Customer First
If your customer isn't in the dropdown, go to Customers and add them first. Then return to create the invoice.
Invoice Status
| Status | Description |
|---|---|
| Draft | Being prepared, not sent |
| Sent | Sent to customer |
| Viewed | Customer has viewed |
| Partial | Partially paid |
| Paid | Fully paid |
| Overdue | Past due date |
| Cancelled | Cancelled invoice |
VAT Calculation
VAT is automatically calculated at 7.5% on taxable items:
- Default VAT rate: 7.5%
- Applied only to items marked as "Taxable"
- VAT amount shown separately on invoice
- Total = Subtotal + VAT
Withholding Tax (WHT)
WHT can be applied to invoices when the customer withholds tax:
- Check "Apply WHT" on the invoice
- Default rate: 5% (can be customized per customer)
- WHT is deducted from total amount
- Net Amount = Total - WHT
Recording Payments
- Go to the invoice detail page
- Scroll to "Payments" section
- Click "Add Payment"
- Enter:
- Payment Amount
- Payment Date
- Payment Method (Cash, Bank Transfer, Cheque, etc.)
- Save - balance updates automatically
Recurring Invoices
Set up automatic invoice generation for regular billing:
- Go to Invoicing → Recurring Invoices
- Create recurring invoice template
- Set frequency (Daily, Weekly, Monthly, Quarterly, Annually)
- Define start date and end date (optional)
- System automatically generates invoices on schedule
Expense Management
Managing Vendors
- Go to Expenses → Vendors → Add Vendor
- Enter vendor details:
- Name, Email, Phone
- TIN (Tax Identification Number) - Important for WHT compliance
- Address
- Save
Expense Categories
- Go to Expenses → Expense Categories
- Create categories like:
- Office Supplies
- Travel & Entertainment
- Professional Fees
- Utilities
- Marketing
- Mark as Tax Deductible if applicable
Recording Expenses
- Go to Expenses → Expenses → Add Expense
- Select: Vendor, Category, Business
- Enter: Description, Amount, Date, Payment Method
- Mark as Tax Deductible if applicable
- Save
Recurring Expenses
For expenses that repeat (rent, subscriptions, etc.):
- Go to Expenses → Recurring Expenses
- Set up: Description, Amount, Frequency, Start Date
- System auto-generates expenses on schedule
Bills (Accounts Payable)
New Feature - December 2024
Complete Accounts Payable workflow to track vendor invoices and manage what you owe to suppliers.
Bills Overview
Bills (Accounts Payable) allow you to track vendor invoices and manage payments to suppliers. This is the counterpart to customer invoices (Accounts Receivable).
Key Features:
- Create bills from vendor invoices
- Convert Purchase Orders to Bills automatically
- Approval workflow for bill processing
- Record payments against bills
- Track outstanding payables
- AP Aging reports
- Automatic GL postings
- Inventory updates when bills are paid
Workflow
Purchase Order → Bill → Approval → Payment. Bills must be approved before payments can be recorded.
Creating Bills
To create a new bill:
- Go to Bills from the sidebar
- Click "New Bill"
- Select a Vendor from the dropdown
- Enter Vendor Invoice Number (from vendor's invoice)
- Set Bill Date and Due Date
- Optionally select a Purchase Order to convert
- Add Bill Items:
- Description - What you're being billed for
- Quantity - Number of units
- Unit Price - Price per unit
- Taxable - Check to apply VAT
- Set VAT Rate (default 7.5%)
- Optionally enable Withholding Tax (WHT)
- Review calculated totals
- Click "Create Bill"
Auto-Calculated Totals
The system automatically calculates: Subtotal, VAT, WHT (if applicable), and Total Amount. Total = Subtotal + VAT - WHT.
Bill Status
| Status | Description |
|---|---|
| Draft | Being prepared, not approved |
| Pending Approval | Submitted for approval |
| Approved | Approved and posted to GL, ready for payment |
| Partial | Partially paid |
| Paid | Fully paid |
| Overdue | Past due date, not fully paid |
| Cancelled | Cancelled bill |
Approving Bills
Bills must be approved before payments can be recorded. When approved:
- Bill status changes to "Approved"
- GL entry is automatically posted:
- Debit: Expense/Inventory account
- Credit: Accounts Payable
- Debit: VAT Receivable (if VAT applies)
- Credit: WHT Payable (if WHT applies)
- Bill becomes available for payment
To Approve a Bill:
- Go to the bill detail page
- Click "Approve Bill" button
- Confirm approval
- GL entry is posted automatically
Cannot Pay Unapproved Bills
Only approved bills can receive payments. This ensures proper GL posting and accounting controls.
Recording Bill Payments
To record a payment against an approved bill:
- Go to the bill detail page (or click payment icon in bills list)
- Click "Record Payment"
- Enter payment details:
- Amount - Payment amount (cannot exceed balance due)
- Payment Date - Date payment was made
- Payment Method - Cash, Bank Transfer, Card, Cheque, Mobile Money, POS
- Reference - Transaction reference number
- Notes - Additional notes
- Click "Record Payment"
What Happens When Payment is Recorded:
- Payment is saved
- Bill status updates: Approved → Partial → Paid
- GL entry is posted:
- Debit: Accounts Payable
- Credit: Cash/Bank account
- Debit: WHT Payable (if WHT was paid)
- If bill items have products, inventory is increased (purchase)
- Stock movement record is created
Partial Payments Supported
You can make multiple payments against a single bill. The system tracks the balance due automatically.
AP Aging Report
The AP Aging Report shows outstanding payables grouped by how long they've been outstanding:
- Go to Bills page
- Click "AP Aging" button
- View bills grouped by age buckets:
- 0-30 Days - Current payables
- 31-60 Days - Slightly overdue
- 61-90 Days - Overdue
- Over 90 Days - Significantly overdue
- See total amounts per bucket
- Identify which bills need attention
Use for Cash Flow Planning
The AP Aging Report helps you plan cash outflows and prioritize which bills to pay first.
Convert Purchase Order to Bill
When you receive goods from a Purchase Order, convert it to a Bill:
- Go to Inventory → Purchase Orders
- Find the received Purchase Order
- Go to Bills page
- Click "New Bill"
- Select the Purchase Order from the dropdown
- Click "Convert Purchase Order" button
- System automatically:
- Creates bill with vendor from PO
- Copies all items and quantities
- Sets bill date to PO received date
- Links bill to the Purchase Order
- Review and adjust if needed
- Save the bill
Time Saver
Converting PO to Bill saves time by automatically copying all items and details. You only need to review and approve.
Payroll Management
Adding Employees
- Go to Payroll → Employees → Add Employee
- Enter personal details:
- First Name, Last Name
- Email, Phone
- Employee ID
- Employment details:
- Job Title, Department
- Employment Type (Full-time, Part-time, Contract)
- Hire Date
- Salary information:
- Basic Salary
- Allowances (if any)
- Save
Payroll Periods
- Go to Payroll → Payroll Periods → Add Payroll Period
- Enter:
- Period Name (e.g., "January 2026")
- Start Date
- End Date
- Pay Date
- Save
PAYE Calculation
The system automatically calculates PAYE based on Nigerian tax bands:
| Annual Income | Tax Rate |
|---|---|
| First ₦300,000 | 7% |
| Next ₦300,000 | 11% |
| Next ₦500,000 | 15% |
| Next ₦500,000 | 19% |
| Next ₦1,600,000 | 21% |
| Above ₦3,200,000 | 24% |
Consolidated Relief Allowance (CRA)
CRA is automatically applied: Higher of ₦200,000 or 1% of gross income, plus 20% of gross income.
Pension & NHF
Automatic statutory deductions:
- Pension (Employee): 8% of basic salary
- Pension (Employer): 10% of basic salary
- NHF: 2.5% of basic salary
Net Salary Formula:
Net = Gross - PAYE - Pension (8%) - NHF (2.5%) - Other DeductionsGenerating Payslips
- Go to the Payroll Period
- System automatically generates payslips for all active employees
- Review each payslip
- Mark as "Paid" when payment is made
- Export or print payslips
Inventory Management
Adding Products
- Go to Inventory → Products → Add Product
- Enter:
- Name, SKU, Barcode
- Description
- Product Type (Product, Service, Digital)
- Category
- Pricing: Cost Price, Selling Price
- Inventory settings:
- Track Inventory: Yes/No
- Quantity on Hand
- Reorder Level
- Reorder Quantity
- Tax: Mark as Taxable for VAT
- Save
Stock Movements
- Go to Inventory → Stock Movements → Add Stock Movement
- Select Product
- Choose Movement Type:
- Purchase: Stock coming in
- Sale: Stock going out
- Adjustment: Manual adjustment
- Transfer: Between locations
- Enter Quantity
- System automatically updates stock levels
Purchase Orders
- Go to Inventory → Purchase Orders → Add Purchase Order
- Select Vendor
- Add items: Product, Quantity, Unit Price
- System calculates total
- Set status: Draft, Sent, Received, Cancelled
Costing Methods
WAZOBIA-Books supports two costing methods:
FIFO (First In, First Out)
- Oldest stock sold first
- Cost based on purchase order dates
- Better for perishable goods
Average Cost (AVG)
- Average of all purchases
- Cost = Total Cost / Total Quantity
- Simpler to manage
Bank Reconciliation
Bank Accounts Setup
- Go to Accounts → Bank Accounts → Add Bank Account
- Enter:
- Bank Name
- Account Name
- Account Number
- Account Type (Current, Savings)
- Opening Balance
- Linked GL Account Code
- Save
Importing Bank Statements
- Go to Ledger → Bank Statements
- Click "Import Statement"
- Upload CSV/Excel file with format:
- Date
- Description
- Amount (Debit/Credit)
- Reference
- System imports and creates statement lines
Auto-Matching (Intelligent Reconciliation)
WAZOBIA-Books uses intelligent matching to reconcile transactions:
- Exact matches: Same amount and date (100% confidence)
- Fuzzy matching: Similar descriptions using AI (shows confidence score)
- Amount matching: Matches by amount when dates differ
- Split matches: One transaction matching multiple lines
- Transfer detection: Bank-to-bank transfers
AI-Powered Matching
The system learns from your previous matches to improve suggestions. High-confidence matches (>95%) can be auto-approved.
Match Confidence Levels
| Confidence | Action |
|---|---|
| 95-100% | Auto-match (exact match found) |
| 80-94% | Suggested match (review recommended) |
| 60-79% | Possible match (manual review required) |
| Below 60% | No match suggested |
Manual Reconciliation
- Go to Bank Account
- View unmatched statement lines
- Manually match to transactions:
- Invoices (receipts)
- Expenses (payments)
- Journal entries
- Mark as reconciled
Financial Reports
Profit & Loss Report
- Go to Reports → Profit & Loss
- Select: Date Range, Business
- View:
- Revenue (Income)
- Cost of Goods Sold
- Gross Profit
- Operating Expenses
- Net Profit
Balance Sheet
- Go to Reports → Balance Sheet
- Select date
- View:
- Assets
- Liabilities
- Equity
- Total Assets = Liabilities + Equity
Cash Flow Statement
- Go to Reports → Cash Flow
- Select period
- View:
- Operating Activities
- Investing Activities
- Financing Activities
- Net Cash Flow
VAT Return
- Go to Reports → VAT Return
- Select period
- View:
- Output VAT (on sales)
- Input VAT (on purchases)
- VAT Payable/Receivable
- Export for FIRS filing
PDF Export
Export any financial report as a professional PDF document:
- Go to Reports page
- Select the report type (Profit & Loss, Balance Sheet, Cash Flow)
- Select your date range
- Click "Export PDF" button
- PDF file downloads automatically
Professional Format
PDF reports include your business name, report type, date range, and all financial data in a professional format suitable for sharing with stakeholders, accountants, or filing.
Available PDF Reports:
- Profit & Loss Statement
- Balance Sheet
- Cash Flow Statement
- VAT Return Report
- Tax Summary Report
Updated - January 2026
PDF export is now available for all report types including VAT Return and Tax Summary. Reports are generated client-side for instant download.
File Naming
PDF files are automatically named with the report type and date range, e.g., profit_loss_2024-01-01_2024-12-31.pdf
Period Comparison
Compare current period performance with the previous period:
- Go to Reports page
- Select report type (Profit & Loss, Balance Sheet, or Cash Flow)
- Select your date range
- Enable "Compare Periods" toggle
- View comparison data:
- Current Period - Your selected period
- Previous Period - Same length period before
- Variance - Difference between periods
- Percentage Change - % increase or decrease
Automatic Calculation
The system automatically calculates the previous period based on your selected date range. If you select "This Month", it compares with "Last Month".
Comparison Metrics
For Profit & Loss reports, you can compare:
- Revenue - Current vs previous period
- Expenses - Current vs previous period
- Gross Profit - Current vs previous period
- Net VAT Position - Current vs previous period
- Profit Margin - Current vs previous period
Visual Indicators
Green arrows indicate increases, red arrows indicate decreases. This makes it easy to spot trends at a glance.
Use Cases:
- Month-over-month performance analysis
- Quarter-over-quarter comparisons
- Year-over-year growth tracking
- Identifying trends and patterns
- Budget vs actual analysis
Tax Compliance
VAT Management
VAT on Sales:
- Automatically calculated on invoices
- Rate: 7.5% (default)
- Can be customized per invoice
VAT on Purchases:
- Recorded on expenses
- Input VAT can be claimed
- Net VAT = Output VAT - Input VAT
WHT Certificates
Withholding Tax Rates:
| Type | Rate |
|---|---|
| Services | 5% |
| Contracts | 5% |
| Consultancy | 10% |
| Dividends | 10% |
| Interest | 10% |
| Rent | 10% |
PAYE Management
- Automatically calculated in payroll
- Based on Nigerian tax bands
- Remitted monthly to FIRS
Tax Filings
- Go to Tax Compliance → Tax Filings
- Create filing for: VAT Return, WHT Return, PAYE Return
- Enter period and amounts
- Track status and due dates
General Ledger
Chart of Accounts
Using Templates:
python setup_chart_of_accounts.pyThis creates 70+ standard GAAP/IFRS accounts.
Account Types:
- Assets (1000-1999): Cash, Bank, Inventory, etc.
- Liabilities (2000-2999): Accounts Payable, Loans, etc.
- Equity (3000-3999): Capital, Retained Earnings
- Income (4000-4999): Sales, Service Revenue
- Expenses (5000-5999): COGS, Operating Expenses
Journal Entries
- Go to Ledger → Journal Entries → Add Journal Entry
- Enter: Date, Memo/Description, Currency (default: NGN)
- Add Journal Lines:
- Account
- Debit Amount
- Credit Amount
- System ensures debits = credits
- Save
Trial Balance
- Go to Ledger → Trial Balance
- Select date
- View:
- All accounts
- Debit balances
- Credit balances
- Total debits = Total credits
Closing Entries
Closing entries transfer revenue and expense account balances to Retained Earnings at the end of an accounting period.
New Feature - December 2024
Automated period-end closing entries ensure revenue and expense accounts start with zero balances for the new period.
How Closing Entries Work
The closing process happens in three steps:
- Close Revenue Accounts:
- All revenue accounts are debited
- Income Summary is credited
- Revenue accounts now have zero balances
- Close Expense Accounts:
- All expense accounts are credited
- Income Summary is debited
- Expense accounts now have zero balances
- Close Income Summary:
- Income Summary balance is transferred to Retained Earnings
- If net income: Debit Income Summary, Credit Retained Earnings
- If net loss: Credit Income Summary, Debit Retained Earnings
To Close a Period:
- Go to Accounting from the sidebar
- Click on the "Closing Entries" tab
- Enter the Period End Date (last day of the period you want to close)
- Review the period you're closing
- Click "Close Period" button
- System automatically:
- Creates closing entries for all revenue accounts
- Creates closing entries for all expense accounts
- Transfers net income/loss to Retained Earnings
- Posts all entries to the General Ledger
- You'll see a success message when complete
Automatic Account Creation
If Income Summary or Retained Earnings accounts don't exist, the system automatically creates them with proper account codes.
Reversing Closing Entries
If you need to reverse closing entries (e.g., to make corrections):
- Go to Accounting → Closing Entries tab
- Enter the Period End Date of the period you want to reverse
- Click "Reverse Closing" button
- Confirm the reversal
- System creates reversing entries
When to Close Periods
- • Monthly: Close at the end of each month
- • Quarterly: Close at the end of each quarter
- • Annually: Close at the end of the fiscal year
- • Always review your Trial Balance before closing
- • Ensure all transactions for the period are recorded
Important Notes
- • Closing entries cannot be undone easily - use Reverse Closing if needed
- • Always backup your data before closing a period
- • Review financial statements after closing to ensure accuracy
- • Closing entries are posted to the General Ledger automatically
Best Practices
- Close periods consistently (monthly, quarterly, or annually)
- Review Trial Balance before closing
- Ensure all transactions are recorded
- Create a backup before closing
- Review financial statements after closing
- Lock the period after closing to prevent changes
Period Locks
Lock accounting periods to prevent changes:
- Go to Ledger → Fiscal Periods
- Create period
- Lock when closed
- Prevents editing transactions in locked periods
Important
Period locks are enforced at the model level and cannot be bypassed. Always ensure all entries are complete before locking a period.
Cloud Service Access & Backup
Cloud Access Overview
WAZOBIA-Books provides comprehensive cloud backup and data access options to protect your business data. You can connect to multiple cloud storage providers and access your backups from anywhere:
Supported Cloud Services
Google Drive
Connect your Google account for seamless backup storage
OneDrive
Use Microsoft OneDrive for business backup storage
Azure Blob
Enterprise-grade Azure Blob Storage for backups
How Cloud Backup Works
- • Your primary data is stored securely in our cloud database
- • Backups are automatically created and stored in your connected cloud service
- • Backups are stored as compressed JSON files (
.json.gz) you own and control - • You can access, download, or restore backups directly from your cloud storage
- • Automatic backups run on a schedule you configure
- • Multiple cloud services can be connected simultaneously
What gets backed up:
- Business profile and settings
- All customers and vendors
- Invoices and payments
- Expenses and categories
- Employee and payroll data
- Inventory and products
- Journal entries and ledger accounts
- Tax filings and compliance records
- User accounts and permissions
- System configurations
Your Data, Your Control
All backups are stored in YOUR cloud storage account. We never store your backup data on our servers. You have full control over your backups - view, download, or delete them anytime directly from your cloud storage.
Connect Google Drive
Connect your Google Drive account to enable automatic backups to your personal or business Google Drive:
- Go to Settings → Backup & Export
- Select "Google Drive" from the cloud service options
- Click "Connect Google Drive" button
- You'll be redirected to Google's authentication page
- Sign in with your Google account
- Grant permissions for WAZOBIA-Books to access your Drive
- You'll be redirected back to the settings page
- You should see "Connected" status with your Google email address
Google Drive Features
- • Automatic backups to your Google Drive
- • Access backups from any device with Google Drive
- • Share backups with your accountant or team
- • View backup history directly in Google Drive
- • Download backups anytime from Google Drive
- • Secure OAuth authentication - we never see your password
Disconnect Google Drive
To disconnect your Google Drive:
- Go to Settings → Backup & Export
- Click "Disconnect" next to Google Drive
- Confirm the disconnection
- Your existing backups remain in your Google Drive
Connect OneDrive
Connect your Microsoft OneDrive account for business-grade backup storage:
- Go to Settings → Backup & Export
- Select "OneDrive" from the cloud service options
- Click "Connect OneDrive" button
- You'll be redirected to Microsoft's authentication page
- Sign in with your Microsoft account (personal or business)
- Grant permissions for WAZOBIA-Books to access your OneDrive
- You'll be redirected back to the settings page
- You should see "Connected" status with your Microsoft email address
OneDrive Features
- • Automatic backups to your OneDrive
- • Perfect for Microsoft 365 business users
- • Enterprise-grade security and compliance
- • Access backups from Office 365 apps
- • Version history and file recovery
- • Integration with Microsoft Teams and SharePoint
Disconnect OneDrive
To disconnect your OneDrive:
- Go to Settings → Backup & Export
- Click "Disconnect" next to OneDrive
- Confirm the disconnection
- Your existing backups remain in your OneDrive
Connect Azure Blob Storage
For enterprise users, connect Azure Blob Storage for advanced backup management:
- Create an Azure Storage Account in the Azure Portal
- Create a Blob Container (e.g.,
wazobia-backups) - Generate a SAS (Shared Access Signature) token with:
- Read permission
- Write permission
- List permission
- Delete permission (optional, for cleanup)
- Set the expiration date (recommended: 1 year, then rotate)
- Go to Settings → Backup & Export in WAZOBIA-Books
- Select "Azure Blob Storage"
- Enter your Azure Storage details:
- Storage Account Name
- Container Name
- SAS Token
- Click "Connect"
- Verify the connection status
Azure Blob Storage Features
- • Enterprise-grade storage with 99.9% availability
- • Automatic lifecycle management and retention policies
- • Advanced security with encryption at rest
- • Cost-effective storage for large backup archives
- • Integration with Azure Backup and Recovery services
- • Compliance with various regulatory standards
Security Best Practices
- • Use container-scoped SAS tokens (not account-level)
- • Set appropriate expiration dates
- • Rotate SAS tokens periodically (every 6-12 months)
- • Never commit SAS tokens to version control
- • Use Azure Key Vault for production environments
Manual Backup
Create a backup anytime you want to any of your connected cloud services:
- Go to Settings → Backup & Export
- Ensure at least one cloud service is connected (Google Drive, OneDrive, or Azure)
- Select the cloud service you want to backup to
- Click "Backup Now" button
- Wait for the backup to complete (usually takes 10-30 seconds)
- You'll see a success message with the backup name and location
- The backup will appear in your cloud storage immediately
When to Create Manual Backups
- • Before making major changes to your data
- • At the end of each business day
- • Before closing a fiscal period
- • Before tax filing deadlines
- • Before system updates or migrations
- • When preparing for audits
Backup File Naming:
backup_YYYYMMDD_HHMMSS.json.gz- Timestamped backup files- Files are compressed to save storage space
- Each backup is a complete snapshot of your business data
Multiple Cloud Services
You can create backups to multiple cloud services simultaneously. This provides redundancy and ensures your data is protected even if one service has issues.
Automatic Backups
Enable automatic scheduled backups for worry-free data protection:
- Go to Settings → Backup & Export
- Ensure at least one cloud service is connected
- Find the "Automatic Backups" toggle
- Switch it to ON
- Select backup frequency:
- Daily - Every day at a set time (recommended)
- Weekly - Once per week
- Monthly - Once per month
- Select which cloud services to backup to (can select multiple)
- Set backup retention (how many backups to keep)
- Save your settings
Highly Recommended
We highly recommend enabling automatic backups. This ensures your data is always protected without requiring any manual action. Automatic backups run in the background and you'll receive email notifications when backups complete.
Auto-backup features:
- Runs automatically on your configured schedule
- Creates compressed exports for each business
- Backs up to all selected cloud services simultaneously
- Email notifications on success or failure
- Automatic retry on failure with exponential backoff
- Retention cleanup removes old backups automatically
- No manual intervention required
Backup Retention
Configure how many backups to keep:
- Keep All - Never delete backups (uses more storage)
- Keep Last 30 Days - Delete backups older than 30 days
- Keep Last 90 Days - Delete backups older than 90 days
- Keep Last 1 Year - Delete backups older than 1 year
- Custom - Set your own retention period
View & Download Backups
Access your backup history from any connected cloud service:
- Go to Settings → Backup & Export
- Select the cloud service you want to view backups for
- Scroll to "Backup History" section
- View list of all backups with:
- Backup date and time
- File size
- Status (success/failed)
- Business name (if multiple businesses)
- Click on any backup to:
- Download: Get the backup file directly
- View Details: See backup metadata and contents summary
- Open in Cloud: Open the backup in your cloud storage
- Delete: Remove old backups (if retention allows)
Access Backups Directly in Cloud Storage
Google Drive
- Open Google Drive in your browser or app
- Look for "WAZOBIA-Books Backups" folder
- Browse backups organized by date
- Download, share, or move backups as needed
OneDrive
- Open OneDrive in your browser or app
- Navigate to "WAZOBIA-Books Backups" folder
- View backups with version history
- Download or restore previous versions
Azure Blob Storage
- Open Azure Portal and navigate to your Storage Account
- Go to Containers → your backup container
- Browse
backups/folders organized by date - Download files or configure lifecycle management rules
Cloud Features & Benefits
Data Security
- ✓ Encrypted backups in transit and at rest
- ✓ OAuth authentication - we never see your passwords
- ✓ Your data stays in your cloud account
- ✓ Enterprise-grade security from cloud providers
- ✓ Compliance with data protection regulations
Accessibility
- ✓ Access backups from any device
- ✓ Share backups with your accountant
- ✓ Download backups for offline access
- ✓ View backup history anytime
- ✓ Restore from any backup point
Automation
- ✓ Automatic scheduled backups
- ✓ Multiple cloud service support
- ✓ Automatic retention management
- ✓ Email notifications
- ✓ Error recovery and retry
Reliability
- ✓ 99.9% uptime from cloud providers
- ✓ Redundant storage across data centers
- ✓ Version history and recovery
- ✓ Disaster recovery ready
- ✓ No single point of failure
Best Practices
- • Connect Multiple Services: Use at least 2 cloud services for redundancy
- • Enable Auto-Backup: Set up daily automatic backups
- • Regular Verification: Periodically check that backups are being created
- • Test Restores: Test restoring from a backup at least quarterly
- • Monitor Storage: Keep an eye on your cloud storage usage
- • Secure Access: Use strong passwords and 2FA on your cloud accounts
Export Data
Export your data for use in spreadsheets (Excel, Google Sheets):
- Go to Settings → Backup & Export
- Click "Export Data"
- Select what to export:
- All Data
- Invoices Only
- Expenses Only
- Payroll Only
- Custom Selection
- Choose format: JSON or CSV
- Click "Download"
No Google Drive Required
Data export works without Google Drive connection. You can export your data anytime directly to your computer.
Common uses for exported data:
- Create custom reports in Excel
- Share data with your accountant
- Import into other software
- Audit and compliance purposes
- Data analysis and visualization
Security & Access
User Roles
WAZOBIA-Books has different access levels based on user roles:
| Role | Access Level |
|---|---|
| Owner | Full access to all features, settings, and user management |
| Accountant | Full access to accounting features, limited admin access |
| Staff | Basic access to transactions and data entry |
| Viewer | Read-only access to reports and dashboards |
2FA Required for Sensitive Roles
Owner and Accountant roles require Two-Factor Authentication (2FA) for enhanced security.
Two-Factor Authentication (2FA)
Enable 2FA for an extra layer of security:
- Go to Settings → Security
- Click "Enable 2FA"
- Scan the QR code with an authenticator app:
- Google Authenticator
- Microsoft Authenticator
- Authy
- Enter the 6-digit code from your app
- Save your backup codes securely
Backup Codes
You'll receive 8 backup codes. Keep these safe - they can be used if you lose access to your authenticator app.
Password Security
Password requirements:
- Minimum 8 characters
- Mix of letters, numbers, and symbols recommended
- Passwords are encrypted and never stored in plain text
Resetting Your Password
- Click "Forgot Password?" on login page
- Enter your email address
- Check your email for reset link
- Create a new password
Account Lockout
After 5 failed login attempts, your account will be temporarily locked for 30 minutes to protect against brute force attacks.
Session Management
Your login sessions are managed securely:
- Sessions use secure HTTP-only cookies
- JWT tokens expire and refresh automatically
- Click "Logout" to end your session
- Sessions expire after 24 hours of inactivity
AI Insights & Features
AI Overview
WAZOBIA-Books includes powerful AI-powered features to automate tasks, detect issues, and provide insights:
AI Features Available
- • Smart Categorization - Auto-categorize transactions
- • Payment Predictions - Predict when customers will pay
- • Fraud Detection - Detect duplicate/suspicious invoices
- • AI Reports - Generate narrative financial summaries
- • Cash Flow Forecasting - Predict future cash positions
- • Anomaly Detection - Find unusual transactions
Access AI features by clicking "AI Insights" in the sidebar navigation.
Smart Transaction Categorization
AI automatically categorizes transactions based on descriptions and patterns:
- Go to AI Insights from the sidebar
- Click "Auto-Categorize" in Quick Actions
- AI analyzes uncategorized transactions
- Review suggested categories with confidence scores
- Approve or reject suggestions
Learning System
The AI learns from your corrections. The more you use it, the more accurate it becomes.
Payment Predictions
AI predicts when customers will pay invoices based on historical patterns:
- Go to AI Insights → Payment Predictions
- Click "Generate Predictions"
- View predictions for all outstanding invoices
- See:
- Predicted Payment Date - When payment is expected
- Days Until Payment - Expected wait time
- Risk Score - Low, Medium, or High risk
- Confidence - AI's confidence in prediction
Risk Levels
| Risk Level | Description | Action |
|---|---|---|
| Low | Expected on time | No action needed |
| Medium | May be delayed | Send reminder |
| High | Likely late payment | Proactive follow-up |
Invoice Fraud Detection
AI scans invoices for potential fraud indicators:
- Go to AI Insights → Fraud Detection
- Click "Scan for Fraud"
- AI analyzes all invoices for:
- Duplicate Invoices - Same amount and vendor
- Unusual Amounts - Significantly higher than average
- Suspicious Vendors - New vendors with large amounts
- Timing Anomalies - Invoices at unusual times
- Review flagged invoices
- Mark as legitimate or investigate further
Fraud Indicators
- • Duplicate invoices from same vendor
- • Round number amounts (₦100,000 exactly)
- • Amounts just below approval thresholds
- • New vendors with immediate large invoices
AI-Generated Reports
Generate human-readable financial narratives:
- Go to AI Insights → AI Reports
- Click "Generate AI Report"
- Select report type:
- Executive Summary - High-level business overview
- Financial Health - Detailed financial analysis
- Cash Position - Liquidity and cash flow analysis
- Performance - Revenue and profitability trends
- Choose language: English or Nigerian Pidgin
- Download or share the report
Report Sections
AI reports include: Summary, Highlights, Concerns, Recommendations, and Key Metrics.
Cash Flow Forecasting
Predict future cash positions based on historical data:
- Go to AI Insights
- View the Cash Flow Forecast chart
- See predictions for:
- Expected cash inflows (from receivables)
- Expected cash outflows (from payables)
- Net cash position projections
- Seasonal patterns and trends
- Hover over chart points for details
Accuracy Improves Over Time
The more historical data available, the more accurate forecasts become. At least 3 months of data is recommended.
Anomaly Detection
AI monitors transactions for unusual patterns:
- Go to AI Insights
- Click "Scan for Anomalies"
- AI flags transactions that are:
- Significantly larger or smaller than usual
- From unusual vendors or customers
- At unusual times (weekend, holiday, late night)
- In unusual categories for the vendor
- Review flagged items in the Anomalies list
- Mark as reviewed to dismiss false positives
AI Configuration
Customize AI behavior in Settings:
- Go to AI Insights
- Scroll to AI Settings section
- Configure:
- Confidence Threshold - Minimum confidence for auto-actions (default 70%)
- Enable Auto-Categorization - Automatically categorize new transactions
- Enable Fraud Alerts - Get notified of suspicious invoices
- Enable Anomaly Alerts - Get notified of unusual transactions
Confidence Threshold Guide
| Threshold | Behavior | Best For |
|---|---|---|
| 90%+ | Very conservative | Businesses needing high accuracy |
| 70-89% | Balanced (recommended) | Most businesses |
| 50-69% | More suggestions | High volume, quick review |
Lower Threshold = More False Positives
Setting a lower confidence threshold means more suggestions but also more items to review manually.
Tips & Best Practices
General Tips
- Regular Backups: Enable automatic cloud backups (Azure, Google Drive, or OneDrive)
- Reconcile Monthly: Reconcile bank accounts monthly
- Review Reports: Check financial reports regularly
- Keep Records: Maintain supporting documents
- User Permissions: Assign appropriate roles to users
Security Tips
- Enable 2FA: Set up Two-Factor Authentication for all Owner/Accountant accounts
- Strong Passwords: Use unique, complex passwords of at least 12 characters
- Save Backup Codes: Store 2FA backup codes in a secure location
- Regular Logout: Log out when finished, especially on shared devices
- Review Access: Periodically review which users have access to your business
Cloud Backup Tips
- Connect Multiple Services: Use Google Drive, OneDrive, and Azure for redundancy
- Enable Auto-Backup: Turn on automatic daily backups to your chosen cloud storage
- Backup Before Changes: Create a manual backup before major data changes
- Verify Backups: Periodically check your cloud storage to confirm backups are running
- Keep Multiple Copies: Don't delete old backups too quickly - use retention settings
- Test Restores: Periodically test restoring from a backup to ensure they work
- Monitor Storage: Keep an eye on your cloud storage usage and upgrade if needed
- Secure Cloud Accounts: Use strong passwords and 2FA on your Google/Microsoft/Azure accounts
Tax Compliance Tips
- TIN Required: Always add TIN for customers/vendors
- VAT Basis: Choose accrual or cash basis consistently
- WHT Certificates: Issue certificates when WHT is deducted
- Filing Deadlines: Set reminders for tax filing due dates
- Documentation: Keep all tax-related documents
Invoice Tips
- Add Customers First: Create customers before creating invoices
- Complete Details: Add customer TIN and address for professional invoices
- Item Descriptions: Use clear, detailed descriptions for invoice items
- Check Calculations: Review calculated totals before saving
- Payment Reminders: Use recurring invoices for regular clients
AI Features Tips
- Start with High Confidence: Set confidence threshold to 80%+ initially, then lower as AI learns
- Review Regularly: Check AI predictions weekly to catch any issues early
- Correct Mistakes: When AI makes errors, correct them - this helps the model improve
- Use Fraud Detection: Run fraud scans monthly, especially before closing periods
- Generate Reports: Use AI reports for quick executive summaries for stakeholders
- Monitor Anomalies: Enable anomaly alerts to catch unusual transactions in real-time
- Payment Predictions: Use predictions to prioritize collection efforts on high-risk invoices
- Cash Flow Forecasting: Review forecasts weekly to plan for cash needs