> ## Documentation Index
> Fetch the complete documentation index at: https://help.agatabo.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Common Errors

> Solutions to frequently encountered issues

## Permission Errors

**Error**: "You don't have permission to perform this action"

**Cause**: Your account lacks required permission

**Solution**:

* Contact administrator to grant permission
* Verify you're logged in with correct account
* Check if permission is SELF vs ANY scope

## Transaction Errors

**Error**: "Transaction date is in closed period"

**Cause**: Trying to record transaction dated in locked period

**Solution**:

* Change date to current open period
* Or request period reopening (with approval)

**Error**: "Insufficient balance"

**Cause**: Transaction would make account negative

**Solution**:

* Verify transaction amount is correct
* Check member has sufficient savings for withdrawal
* Verify bank account has cash for expense

## Deposit Errors

**Error**: "Member not found"

**Cause**: Selected organization user is not a member

**Solution**:

* Assign member role to user first
* Or select different organization user who has member role

## Loan Errors

**Error**: "Member not eligible for loan"

**Cause**: Business rules prevent loan approval

**Solution**:

* Check member has minimum savings required
* Verify member has no delinquent loans
* Check loan amount doesn't exceed limits

## System Errors

**Error**: "Idempotency key already used"

**Cause**: Duplicate transaction submission

**Solution**:

* Refresh page to clear form
* Check if original transaction succeeded
* Don't resubmit - verify status first

**Error**: "Network error"

**Cause**: Connection problem

**Solution**:

* Check internet connection
* Refresh page
* Try again in a few minutes

## Need Help?

<CardGroup cols={2}>
  <Card title="Permissions" icon="shield" href="/reference/permissions-matrix">
    Understand permissions
  </Card>

  <Card title="Period Closing" icon="lock" href="/advanced/period-closing">
    Manage closed periods
  </Card>
</CardGroup>