Double-entry in al-Shamil

Who this page is for

For anyone who wants to understand how al-Shamil records financial movement, before working in the entry, invoice and voucher windows. This is not an accounting lesson — it is how the application applies accounting's rules.

Every movement is a balanced entry

Everything that reaches the books is a journal entry: lines, each with an account and an amount on one side — debit or credit. The application enforces both rules right where you type:

  • Typing a debit clears the credit on the same line, and the other way round. The refusal is explicit: “Each line needs an amount on one side, debit or credit.”
  • An entry whose debits do not equal its credits is not saved: “Debits and credits do not balance.” — and the window shows “Balanced {debit} = {credit}” as long as it balances.
  • A line books only to a posting account (an account that takes postings); the group accounts of the chart aggregate and are never booked to.

Diagram: from the movement to the books

Draft, then posted

An entry is born a draft, and a draft is edited and deleted freely. Posting is the final moment: a posted entry is neither edited nor deleted — it is corrected with a reversing entry (or, if it was generated from a document, by voiding and reissuing that document). When posting happens follows the accounting level: at Simple “an entry is posted when it is saved”, at Professional “Entries are saved as drafts and posted by hand”.

Entries you write, and entries generated for you

What you write yourself in the Journal Entries window is a manual entry. For invoices and payment and receipt vouchers you write the document and the server generates its entry — as the menus themselves say of a payment voucher: “Record cash and bank payments; the journal entry is booked for you”. A generated entry can be read in the Journal Entries window but is never edited there: “This entry was generated from a document. Change the document instead.” — the detail is in Documents and entries.

Entry types

Beside the Normal entry: Opening (the balances at the start of a year; “An opening entry is dated on the first day of its fiscal year.” and it uses balance-sheet accounts only), Adjustment and Correction (the period-end entries), and Closing — the last is written by the fiscal-year close alone: “Closing entries are booked by the close of a fiscal year only. Choose another type.”