KaritmDocs
English

Accounting

Menu path: Accounting — the fifth main menu group, after Treasury · Subgroups: Accounting · Chart of Accounts · Financial Reports · Year-End

Accounting is the final destination of every operation in the system. Every sales invoice, every warehouse receipt, every payment and receipt, and every payroll slip eventually turns into an accounting voucher; this module is where those vouchers are created, viewed, corrected, and turned into reports.

A key point for new users: in Karitm, most vouchers are not created by a human. The "Created from" column in the voucher list and the journal shows which operation generated each voucher. Manual voucher entry is for exceptional cases: adjustments, opening and closing entries, corrections, and entries outside the operational cycle.

The bridge that makes this automation possible is document templates: 111 predefined templates that specify, for each type of operation, which debit and credit lines hit which accounts. If someone asks "why did my sales invoice generate such a strange voucher?", the answer is always in that operation's document template.

Module Structure

Subgroup Focus Pages
Accounting Voucher entry and review 4 pages
Chart of Accounts Coding structure 2 pages
Financial Reports Output and analysis 4 pages
Year-End Closing and opening the period 1 page

A spelling note: the titles "Chart of Accounts," "Detail Accounts Tree," and "Account Overview" are written in the menu itself without the half-space (ZWNJ) character used in standard Persian typography. Keep this spelling in mind when searching, so you can find the item.

"Voucher Entry"

Menu path: Accounting ← Accounting ← Voucher Entry · Breadcrumb: Home › Accounting › Voucher Entry

The manual voucher entry page has three areas: the voucher header, the line-items table, and the "active row" panel.

Voucher Header

Field Behavior
Voucher number Labeled "optional"; if left blank, the system assigns a number
Voucher type Defaults to Normal; opening and closing vouchers are created from the Year-End subgroup, not from here
Date Defaults to today's date (Persian calendar) with a calendar picker and a clear button
Voucher description Free text, full page width

Toolbar and Line-Item Table

Element Function
Detail columns: 1 Sets the number of detail-account columns shown in the table
Add row Adds a new line item to the end of the table
Swap icon Swaps the debit and credit values of a row
Gear icon Column settings — disabled until a row has been filled in

Line-item table columns: # · Code · Account name · Detail · Description · Debit · Credit · Actions. The detail column shows a "select an account first" hint until an account is chosen. Each row has two actions: delete row and duplicate row.

Below the table is a totals row that keeps a live running sum of the debit total and the credit total. The voucher cannot be posted until these two amounts are equal.

The "active row" panel below the table summarizes the state of the row currently being edited: row number, account name (or "No account"), detail account ("No data available"), line description ("No description entered"), and the debit and credit amounts. It is mainly useful on small screens.

Bottom-of-Page Buttons

Button Effect
Post voucher Posts the voucher in operational status
Save draft Keeps the voucher without financial effect; it appears in the voucher list under the "Draft" filter
Replace text Bulk find-and-replace across the row descriptions; saves significant time on vouchers with dozens of lines
Attach file Attaches a scanned document to the voucher

Both editing and read-only viewing of an existing voucher open from the "Voucher List," via the edit and view icons on each row, and open in a separate tab.

"Voucher List"

Menu path: Accounting ← Accounting ← Voucher List

Columns: # · bulk-selection checkbox · Date · Voucher number · Voucher type · Description · Status · Created from · Actions.

The Voucher type column takes values such as "Sales Invoice," "Warehouse Stock-Out Note," "Cash Receipt" — that is, the type of operation that created the voucher, not the accounting type of the voucher. The Created from column shows a direct link to that operation as a clickable chip (e.g., "Deposit Transaction"); if the voucher was entered manually, this column is empty.

Toolbar: New voucher button on the left, a search box with the Ctrl+/ shortcut, and three icons — gear (columns), funnel (filter), and sort.

  • Filter panel: Status (Show all / Draft / Operational), From date, To date, plus "Apply" and "Clear." Unlike sales invoices, an accounting voucher has no "Voided" status; corrections are made through a reversing voucher.
  • Sort panel: For each level, a "Field" and "Direction" (ascending/descending) pair, plus a "+" button for the next level. Sortable fields: Creation date, Update date, Voucher date, Code, Base code, Status. Priority is applied from top to bottom.
  • Row actions: Delete (red), Edit, View.
  • Counters: Total / Loaded / Remaining. Vouchers load in batches of a hundred as you scroll.

"Journal"

Menu path: Accounting ← Accounting ← Journal

If you think of the "Voucher List" as the voucher level, the journal is the line-item level: each row is a single debit or credit line from a voucher. Columns: # · selection checkbox · Voucher number · Date · Account · Description · Created from · Debit · Credit · Diagnosis.

Row Meaning
Current page total The debit and credit totals of the batch loaded so far
Grand total The total for the whole journal within the filtered range; labeled "Balanced" if it balances
Net balance total The difference between debit and credit in the journal; in a healthy journal it should be zero and labeled "Balanced"

These three rows are the most important tool for monitoring the health of the books. If the "Net balance total" is not zero, it means an unbalanced voucher was posted somewhere and must be investigated before running any reports.

"Document Templates"

Menu path: Accounting ← Accounting ← Document Templates

The system's automatic voucher-generation engine. Ready-made, predefined templates exist for every operational area. List columns: # · selection checkbox · Issuing section · Title · Description · Rows (count) · Actions.

The Issuing section specifies which operation the template is linked to: Sales Invoice, Purchase Invoice, Sales Return Invoice, Purchase Return Invoice, Warehouse Stock-Out Note, Warehouse Receipt, Inter-Warehouse Transfer, Inventory Adjustment. Two buttons at the top of the page: "New Template" and "Build Template with AI" (drafts a template with the help of the system's AI assistant).

Template Editor

  • Header — issuing-section chip (locked), smart account-mapping button, save, and cancel.
  • Template details — "Template title" and a "Set as default template" toggle. Each issuing section can have several templates, but only one can be the default.
  • Voucher description — a text editor with a "quick insert" bar that shows variables as insertable chips: accounting voucher code, voucher date, total amount, invoice number, invoice date.
  • Live validation bar — for example, "2 debit rows · 2 credit rows · 4 of 4 accounts linked" along with the message "Both sides are filled." Until this bar turns green, the template is incomplete.
  • Two columns, Debit and Credit — each row is a card with a row role (dropdown list), a linked account with its code and full tree path, a detail account, and a "row description" with quick-insert variables: account name, account code, line debit amount, line credit amount, invoice number.

Example — the "System Sales Invoice Voucher" template:

Side Row Role Account
Debit Accounts Receivable 1/3/1/1
Debit Discounts Account 4/1/1/2 — Sales Returns and Discounts
Credit Sales Revenue Account 4/1/1/1 — Operating Revenue / Goods Sales
Credit VAT Account 2/1/2/2 — VAT Payable

Changing the account on these four rows determines the accounting behavior of the entire sales cycle. Before starting operational work, review these rows with the organization's accountant.

"Chart of Accounts" and "Detail Accounts Tree"

Menu path: Accounting ← Chart of Accounts ← Chart of Accounts · Detail Accounts Tree

A two-column layout: on the right, the tree with a search box (Ctrl+/) and expandable nodes; on the left, a table of the children of the selected node. An "Add Account" button sits at the top of the page. Table columns: # · Account code · Account name · Subgroup status · Active · Actions.

The Six Main Coding Groups

1 Assets · 2 Liabilities · 3 Equity · 4 Revenue · 5 Expenses · 6 Memorandum and Control Accounts. Each level's code is appended to its parent's code with a slash (1/3/1/1).

Detail Groups

1 Persons and Business Parties · 2 Cash Resources, Banks, and Collection Instruments · 3 Goods and Classification · 4 Storage Locations, Branches, and Sales Channels · 5 Fixed Assets · 6 Legal Authorities · 91 Bank Accounts · 92 Cash Funds · 93 Petty Cash

Groups 91 through 93 are the same ones that the "Bank," "Cash Fund," and "Petty Cash" pages in Treasury work on: a bank account you create in Treasury sits in this very tree as a detail account.

Per-Account Actions Menu

Option Function
More info Full account details
Edit Change the name, code, and settings
Delete Only if the account has no transaction activity
Move account Move the account under a different parent — for correcting coding without losing history
Copy account Create a similar account; the fastest way to build several similarly structured accounts

Unlike the other lists, this page uses classic pagination: "Rows per page" (default 10), a page number counter, and four navigation buttons. This difference exists because the number of children under each node is small, and progressive loading offers no benefit.

The title at the top of the "Detail Accounts Tree" page may display as "Chart of Accounts." To make sure the correct page is open, check the tab title.

Financial Reports

"Account Overview"

The accountant's most frequently used everyday report: a single table that changes its aggregation level as you switch tabs. Tabs: General Ledger · Subsidiary · Account Level 3 · Account Level 4 · Detail Levels 1 through 4 · Account Movement. Below the tab bar, a status line shows what you're currently viewing on ("Next: Account | Level: 1").

Columns: # · selection checkbox · Account code · Account name · Debit movement · Credit movement · Diagnosis · Balance. Negative balances are shown in parentheses and in red — meaning a balance contrary to the account's natural nature.

The "General" level is for a management-level view, the "Subsidiary" level is for closing the month, and the detail levels are for answering "what is the balance of this customer / this project / this bank?"

"Balance Sheet"

The "Report Filters" card includes a start date, an end date, a "Show zero-balance accounts" toggle, and a "Generate Report" button. Before generation, the page shows an empty state: "No data available — generate the report to view the data." This is a deliberate design choice, because calculating the balance sheet is resource-intensive and should not run every time the tab is opened.

Output: three indicator cards (Total Assets in blue, Total Liabilities in red, Total Equity in green), followed by a balance status bar labeled Balanced or Unbalanced, and a hierarchical breakdown of Group ← Subgroup ← Account.

An "Unbalanced" state means the accounting equation does not hold; this is usually due to an unbalanced voucher or a missing opening voucher.

"Statements"

A balance and movement report broken down by counterparty. Columns: # · Account code · Account name · Debit movement · Credit movement · Debit balance · Credit balance. Splitting the debit balance from the credit balance into two separate columns makes the report easier to read for non-accountants.

Above the table are two buttons, Record Receipt and Record Payment, which are disabled until a row is selected. Selecting a counterparty and clicking opens the Treasury wizard for that same party. This bridge is the system's most important receivables-collection workflow.

"Dynamic Report Builder"

A tool for building custom reports without programming. On the right is the "Build Report" panel, and on the left is the results display area. Reportable entities: Currencies · Persons · Warehouse Receipt Items · Invoice Items · Payment Transactions · Accounts · Warehouse Receipts · Invoices · Product Prices · Products · Businesses · Service Point Sessions · Service Points · Product Units.

Workflow: select entity ← columns and filters ← run ← save ← schedule. The system explicitly warns that you must save the report before you can schedule it. Once scheduled, the report runs automatically at set intervals and its output is delivered — for example, a debtors' balance report every Monday morning.

"Year-End Processing"

Menu path: Accounting ← Year-End ← Year-End Processing

The page has two tabs. Closing voucher: "Zeros out the balance of all temporary accounts (revenue and expense) with a non-zero balance and transfers the difference to the profit-and-loss account." Opening voucher: "Transfers the balance of all permanent accounts (assets, liabilities, equity) from the source fiscal period to the active period." The opening tab has a required field, "Source fiscal period."

Toggle Default System description
Auto-promote to operational status On The voucher switches to operational status immediately after creation
Replace existing voucher Off If a previous voucher exists, deletes it and creates it again
  • The "Replace existing voucher" toggle deletes the previous voucher. Before enabling it, make sure the previous voucher was actually incorrect.
  • Before generating the closing voucher, the "Net balance total" in the journal must be zero and labeled "Balanced."
  • These two operations have dedicated, independent permissions and should not be granted to regular users.

Off-Menu Reports

Several accounting reports have no independent menu item and instead open from within other pages: by clicking an account name, via a link inside other reports, or through global search.

Report Content
General Ledger of All Accounts Movement of all general-ledger accounts
General Ledger of a Single Account Movement of one selected account
Detail Ledger Movement of all detail accounts
Account Ledger Itemized movement of an account
Profit and Loss Statement The period's performance result
List of Debtors / Creditors Persons with a debit or credit balance
Reconciliation Bank statement reconciliation — documented in Treasury

Permissions for This Module

Domain Coverage
Accounting vouchers Create, read (all / own vouchers only), edit, delete, restore, read deleted
Document templates Define and edit automatic voucher-generation templates
Chart of accounts and detail accounts Create and modify coding
Fiscal periods Define and manage the fiscal period
Opening and closing vouchers Dedicated, independent permission for year-end operations

The split between "all" and "own only" in the vouchers domain means you can allow a user to view and edit only the vouchers they themselves entered. The "read deleted" and "restore" permissions are a reminder that voucher deletion in Karitm is soft; a deleted voucher can be restored and remains in the system's event log.

Sample Workflows

Entering a Manual Adjustment Voucher

Voucher Entry ← date and description (leave the number blank) ← first row debit, second row credit ← check the "Total" row ← attach a file if needed ← Post voucher or Save draft.

Finding the Source of an Automatically Generated Voucher

Voucher List ← filter by today's date ← the Voucher type column tells you the operation type, and Created from links to the operation itself ← to understand the account selection, go to Document Templates.

Changing the Accounting Behavior of the Sales Cycle

Document Templates ← the "Sales Invoice" template marked default ← change the row accounts ← check the validation bar ← save. From then on, all invoices are posted with the new voucher structure.

Checking the Health of the Books Before Closing the Month

Journal ← filter by the month's date range ← "Net balance total" is zero and Balanced · Account Overview ← Subsidiary tab ← balances contrary to nature · Balance Sheet ← generate report ← Balanced status bar.

Closing the Fiscal Year

Confirm the books are balanced ← closing voucher ← change the active fiscal period ← opening voucher, selecting the source fiscal period ← check the balance sheet at the start of the new period.

Collecting Receivables from a Report

Statements ← sort by "Debit balance" ← select a counterparty ← Record Receipt ← Treasury wizard ← record documents and issue the voucher.

Frequently Asked Questions

I posted a voucher, but it's not in the voucher list.

Check that the status filter isn't left on "Operational"; if you clicked "Save draft," set the filter to "Draft" or "Show all."

The "Post voucher" button doesn't work.

The debit total and credit total in the "Total" row must be exactly equal.

My sales invoice isn't generating the voucher I want.

The voucher structure comes from the document template for the "Sales Invoice" issuing section. Edit the template; subsequent vouchers will be posted with the new structure.

The "Net balance total" in the journal isn't zero.

It means an unbalanced voucher has been posted — usually from data entered through an incomplete operation. Until this is fixed, the balance sheet will also remain unbalanced.

The balance sheet says "Unbalanced."

Three common causes: an unbalanced voucher in the books, a missing opening voucher for the period, or a date range that cuts through the middle of the period.

How do I void an accounting voucher?

An accounting voucher has no "Voided" status; corrections are made by posting a reversing voucher.

I created an account under the wrong parent group by mistake.

You don't need to delete and rebuild it; use "Move account" from the actions menu.

I can't schedule the Dynamic Report Builder.

You must save the report first; scheduling doesn't become available until after saving.

The currency unit differs between two reports.

The displayed currency unit comes from the organization's currency settings; if it differs between reports, check with your system administrator.