Overview
Complete these tasks at the end of each accounting period to ensure accurate financial records before closing the period.Accounting period depends on your organization’s configuration:
- MONTHLY: Close every month
- QUARTERLY: Close every 3 months
- YEARLY: Close annually
Pre-Close Checklist
Record all transactions
Ensure all financial activity for the period is recorded:
- ✅ All deposits received
- ✅ All loan payments collected
- ✅ All loan disbursements made
- ✅ All expenses paid
- ✅ All bank fees recorded
- ✅ No pending/unrecorded transactions
Reconcile bank accounts
Match Agatabo records to actual bank balances:
- Download bank statements for all organization bank accounts
- Compare statement ending balance to Agatabo cash/bank account balance
- Identify differences:
- Uncleared checks/deposits
- Bank fees not yet recorded
- Interest earned
- Errors (data entry mistakes)
- Record adjustments:
- Bank fees → Record as expenses
- Interest → Record as income (manual journal entry)
- Correct errors
- Verify reconciliation: Adjusted Agatabo balance = Bank statement balance
Review member balances
Spot-check member savings for accuracy:
- Select 5-10 members randomly
- Compare Agatabo balance to member passbooks/records
- Investigate any discrepancies
- Verify recent deposits/withdrawals recorded correctly
Verify loan portfolio
Ensure loan records are accurate:
- Run Loans Outstanding report (as of period end date)
- Verify total outstanding loans matches Loan Receivable ledger account balance
- Identify overdue loans (arrears > 0)
- Apply penalties if organizational policy requires automatic penalties
- Document any loan modifications, waivers, or write-offs
Generate financial statements
Run all reports as of period end date:Required reports:
- Balance Sheet (as of last day of period)
- Profit & Loss (for the entire period)
- Shares Report (member ownership as of period end)
- Loans Outstanding (portfolio status as of period end)
Review trial balance
Verify accounting equation balances:
- Run Trial Balance (as of period end)
- Check: Total Debits = Total Credits
- Investigate any out-of-balance conditions
- Verify retained earnings reflects prior period net income
Review unusual items
Investigate anomalies before closing:
- Large or unexpected expenses (> 10% of budget)
- Unusual account balances (negative balances where not expected)
- Significant variances from prior period (> 20% change)
- Uncategorized or miscoded transactions
Run period close preview
Simulate the close to verify impact:Review preview response:
- Period being closed (verify correct period)
- Net income/loss amount
- Journal entry that will be created
- Accounts that will be zeroed (INCOME/EXPENSE accounts)
Get management approval
Present financial statements for approval:
- Share reports with treasurer/board/management committee
- Explain significant items, variances, concerns
- Address questions and requests for additional detail
- Obtain sign-off (written approval recommended)
Closing the Period
Once all pre-close tasks complete and approval obtained:Close the period
Execute period close via API:Permission required:
periods:closeWhat happens:- Determines next period to close automatically
- Creates PERIOD_CLOSE journal entry
- Zeros all INCOME and EXPENSE accounts
- Transfers net income to RETAINED_EARNINGS
- Locks period (prevents further changes)
Verify period close results
Confirm close completed correctly:
- Check audit logs: Period close action logged
- Run Balance Sheet: Retained earnings increased by net income
- Run Profit & Loss: Current period shows zero (new period started)
- Check INCOME/EXPENSE accounts: All have zero balances
Post-Close Tasks
Archive documentation
Preserve period records:
- Save all reports to archive folder (named by period, e.g., “2026-06-June”)
- File physical receipts and supporting documents
- Export journal entries for period (for audit trail)
- Backup database
Communicate to members
Share period results with membership:
- Publish Balance Sheet (shows financial position)
- Publish Profit & Loss (shows period performance)
- Publish Shares Report (shows member ownership percentages)
- Announce dividend distribution if applicable
Timeline Examples
Monthly Close (accountingPeriod: MONTHLY)
| Day | Task |
|---|---|
| Last business day | Record final transactions for month |
| 1st of next month | Download bank statements, begin reconciliation |
| 2-3 | Complete reconciliation, run reports, review |
| 4-5 | Present to management, obtain approval |
| 5-7 | Close period, verify, archive |
Quarterly Close (accountingPeriod: QUARTERLY)
| Day | Task |
|---|---|
| Last week of quarter | Ensure all transactions recorded |
| 1-2 days after quarter | Download statements, begin reconciliation |
| 3-7 | Complete reconciliation, run reports, review |
| 7-10 | Present to management, obtain approval |
| 10-14 | Close period, verify, archive |
Yearly Close (accountingPeriod: YEARLY)
| Week | Task |
|---|---|
| 1-2 | Record all transactions, reconcile all accounts |
| 2-3 | Run all reports, prepare annual statements |
| 3-4 | Review with accountant, prepare for audit |
| 4-6 | Present to board, obtain approval |
| 6-8 | Close period, finalize annual report |
Common Issues and Solutions
Trial balance doesn't balance
Trial balance doesn't balance
Problem: Total debits ≠ total creditsCommon causes:
- Journal entry missing debit or credit side
- Data entry error (transposed digits)
- Manual journal entry not balanced
- System bug (rare)
- Run Trial Balance report with details
- Calculate difference amount
- Search journal entries for that exact amount
- Review recent manual entries
- Correct error before closing
Loans don't reconcile to ledger
Loans don't reconcile to ledger
Problem: Loans Outstanding total ≠ Loan Receivable account balanceCommon causes:
- Loan payment recorded incorrectly
- Principal/interest allocation error
- Loan created but not properly recorded
- Missing loan disbursement entry
- Run Loans Outstanding report
- Check Loan Receivable ledger account balance
- Calculate difference
- Review recent loan transactions
- Verify loan disbursements created journal entries
- Correct discrepancies before closing
Bank reconciliation won't balance
Bank reconciliation won't balance
Problem: Agatabo cash balance ≠ bank statement balanceCommon causes:
- Unrecorded bank fees
- Deposits not yet cleared
- Checks not yet cashed
- Data entry errors
- List outstanding checks (issued but not cleared)
- List deposits in transit (recorded but not cleared)
- Identify bank fees not recorded in Agatabo
- Record fees as expenses
- Calculate: Agatabo balance + deposits in transit - outstanding checks = Bank balance
Can't close period - error message
Can't close period - error message
Error: “Cannot close period” or similarCheck:
- Do you have
periods:closepermission? - Is x-organization-id header set correctly?
- Is x-idempotency-key header provided?
- Is there already a close in progress?
- Are there validation errors (unbalanced entries)?
Need to undo period close
Need to undo period close
Situation: Discovered error after closing periodSolution:Limitations:
- Can only undo LAST period closed
- Cannot undo arbitrary historical periods
- Reverses PERIOD_CLOSE journal entry
- Reopens period for corrections
Best Practices
Period closing guidelines:Before closing:
- ✅ Complete ALL steps in checklist (don’t skip)
- ✅ Reconcile ALL bank accounts (not just main account)
- ✅ Verify trial balance balances
- ✅ Get management sign-off
- ✅ Run preview to verify period close impact
- ✅ Archive current reports before closing
- ✅ Use unique idempotency key (prevent duplicate close)
- ✅ Close during low-activity time (minimize disruption)
- ✅ Notify users period close is in progress
- ✅ Verify close completes successfully
- ✅ Verify period close results immediately
- ✅ Check retained earnings updated correctly
- ✅ Confirm INCOME/EXPENSE accounts zeroed
- ✅ Archive all period reports
- ✅ Communicate results to members
- ✅ Close periods promptly (within 7 days of period end)
- ✅ Don’t skip periods (close sequentially)
- ✅ Document significant items for auditors
- ✅ Keep closed period records for 7+ years
- ✅ Train backup staff on closing procedures
Related Topics
Period Closing
Period close API documentation
Balance Sheet
Financial position report
Profit & Loss
Income statement
Audit Trail
Track period close activity