ChartOfAccounts (v1.0.0)

Defines the structure and organization of accounts used in the accounting system

Entity Java Configuration

ChartOfAccounts Entity

The ChartOfAccounts entity defines the organizational structure of accounts used within the accounting system. It serves as a blueprint for creating and managing different types of accounts across various ledgers and sub-ledgers.

Properties

NameTypeRequiredDescription
idintegerRequiredUnique identifier for the chart of accounts (auto-generated primary key)
namestringRequiredDescriptive name of the chart of accounts
descriptionstringOptionalOptional description providing additional context

Schema

schema.json
{
  "$schema": "http://json-schema.org/draft-07/schema#",
  "type": "object",
  "title": "ChartOfAccounts",
  "description": "Defines the structure and organization of accounts used in the accounting system",
  "properties": {
    "id": {
      "type": "integer",
      "description": "Unique identifier for the chart of accounts (auto-generated primary key)",
      "example": 15655
    },
    "name": {
      "type": "string",
      "description": "Descriptive name of the chart of accounts",
      "example": "easy/merchant"
    },
    "description": {
      "type": "string",
      "description": "Optional description providing additional context",
      "example": "Collecting merchant sub-ledger"
    }
  },
  "required": ["id", "name"],
  "additionalProperties": false
}

Account Organization

The chart of accounts organizes financial accounts into different categories based on accounting principles:

  • Asset Accounts (1xxx): Resources owned by the business
  • Liability Accounts (2xxx): Debts and obligations owed by the business
  • Equity Accounts (3xxx): Owner’s equity and retained earnings
  • Revenue Accounts (4xxx): Income generated from business operations
  • Expense Accounts (5xxx): Costs incurred in business operations

Usage in Accounting Service

The ChartOfAccounts is used by the MerchantAccount aggregate to:

  • Define available account types for new merchant accounts
  • Validate account creation requests
  • Ensure consistent account structure across different merchants
  • Support account definition updates and modifications

Configuration Management

Charts of accounts are typically configured in the admin backend and referenced by:

  • Ledger hierarchies
  • Sub-ledger configurations
  • Bookkeeping configurations
  • Transaction definitions

Validation Rules

  • Account IDs must be unique within a chart
  • Account types must follow the standard numbering convention
  • Names must be descriptive and non-empty
  • Each account must have a valid type classification
Edit this page