Contents
First setup: chart of accounts and mappingsGenerating a period and keeping the ledger in syncRules: which document goes whereDocument differences and the suspense account (VAT withholding)Unmapped documents and warningsSpecial cases: zero exchange rate, zero-amount invoice, free-of-charge issue, manual entryEntries, drilling to the document, manual journalFinancial statements and check badgesVAT / PPN return summaryPeriod lockFX revaluation and the depreciation templateAccounting on the phonePermissionsMessages and what to doAccounting steps on the phoneAccounting — Automatic Journal and Financial Statements
Invoices, receipts and payment vouchers, cheque and note slips and production confirmations are already recorded in HNR. The Accounting window generates the journal entries itself from these documents: every document type has a debit/credit rule, the entries are written to the Corporate Backbone's financial ledger (a single ledger), and the trial balance, balance sheet, income statement, cash flow statement and VAT return summary are produced from it. When a document changes, its entry changes too; nothing is keyed in twice.
First setup: chart of accounts and mappings
- On the Chart of accounts tab click Load package chart: depending on the company country (Settings › Company Information › Country) the Turkish Uniform Chart of Accounts or, for Indonesia, a chart mapped to SAK EP lines is loaded. Existing accounts are not touched.
- On the Mappings tab review the cash and bank accounts, the purchase/sales/stock accounts by line type (raw material, finished goods, expense…) and the portfolio accounts of document types. An empty box uses the package default (grey text).
- On the Periods tab choose the month, click Preview first, then Generate period entries.
Generating a period and keeping the ledger in sync
Generation reads every document of the month and computes an entry for each document from its rule. Every entry has a signature (date + account/party/debit/credit lines). When you generate again: an unchanged document is not touched; the old entry of a changed document is closed with a reversing entry on the same date and a new one is written; the entry of a deleted document is closed with a reversing entry. Generation can therefore be run as often as you like. Preview writes nothing and only shows the figures.
A background task (every 15 minutes by default, and also when the Accounting window is opened) regenerates the current and the previous month when the source tables change. The task is on by default; the system administrator can turn it off on the server with MUHASEBE_GOREV=0.
Rules: which document goes where
Default rules come from the country package (Türkiye below). On the Rules tab choose an event and change its lines (side, account or a placeholder such as @cari, amount), deactivate the rule, or go back to the default with Revert to package rule. Changes apply at the next generation.
| Event | Debit | Credit |
|---|---|---|
| Sales invoice | Customers (120) — party amount | Domestic Sales (600) — line base · Calculated VAT (391) — gross; withholding debited to 391 |
| Purchase invoice | 150/151/152/153/770/253 by line type — base · Deductible VAT (191) — gross | Suppliers (320) — party amount · Taxes Payable (360) — withholding |
| Sales / purchase return | exact reverse of the sale / purchase | (610 Sales Returns) |
| Cost of goods sold | Cost of Merchandise / Finished Goods Sold (621/620) | Stock account (153/150/152…) — the same unit cost as the card reports |
| Receipt, payment, transfer, cash↔bank transfer | the voucher's two legs in the party ledger: cash (100) / bank (102) / party | |
| Debit / credit note | party or 659 | 649 or party |
| Cheque / note received | Cheques Received (101) · Notes Receivable (121) · card and DBS (108) | Customers (120) |
| Cheque / note issued | Suppliers (320) | endorsed customer document (101/121) or own document: Cheques Issued (103) · Notes Payable (321) · company card (309) · DBS (329) |
| Document collection / payment | bank or document | document or bank |
| Production confirmation | Finished Goods (152) / Semi-finished (151) — total cost | Raw materials (150) — material · 721 — labour · 731 — subcontracting |
| FX revaluation | party account (gain) or 656 | 646 or party account (loss) |
7/A absorption. A production confirmation credits the 7x1 absorption accounts (721 labour, 731 subcontracting); the period-end absorption closing (721 → 720, 731 → 730), the reclassification of production expense accounts to 720/730 and, in the standard costing method, the variance entries are made on the Period and accounting tab of the Standard Cost window.
Document differences and the suspense account (VAT withholding)
Sales revenue is posted from the invoice's line base (the same figure as the Sales Analysis report), and VAT is split with the same classification as the VAT return breakdown: the header VAT is VAT collected, the difference to the line VAT is VAT withheld. The party line is always the amount in the party statement. When these three do not agree the entry still balances: a difference up to 1 TRY goes to the rounding accounts (649/659), a larger one to the suspense account (336 Other Payables / 136) and the document appears in the warning list.
Most common case: on a withholding invoice the full VAT was charged to the customer and the customer paid all of it; the withheld share then shows in 336 — VAT collected from the buyer that will not be declared. Check with your accountant.
Unmapped documents and warnings
No entry is written for a document at the block level: the rule's account is not in the chart or is a summary account, the document type is not mapped to an event, or the document changed while the period was locked. Add the account or fix the mapping, then generate the period again. A document at the warning level is posted but should be reviewed (a difference in the suspense account, a product whose cost is unknown so no cost of goods sold was written, a voucher treated as a cheque because the document record was missing). Mark a reviewed line with Acknowledge; the acknowledgement survives the next generation. A period cannot be locked while blocks are open.
Special cases: zero exchange rate, zero-amount invoice, free-of-charge issue, manual entry
- Zero exchange rate: if a line of a foreign-currency invoice has a zero or empty rate, no entry is written and the document is listed with the block "Exchange rate is zero or empty on a line" (the same criterion as the Sales Analysis rate warning). Correct the line rate and generate the period again — the amount is not pushed into the suspense account.
- Zero-amount invoice: no invoice entry is created but the document is listed with the "Zero-amount invoice" warning; for a sales invoice the issued stock is costed as a free-of-charge issue.
- Free-of-charge issue: a sales line with price zero (sample, free delivery) does not enter revenue; its cost is posted with the separate Free-of-charge issue rule (Türkiye default 621, description "bedelsiz çıkış") instead of cost of goods sold. It can be redirected to another expense account on the Rules tab.
- Corporate Backbone manual entry: if a document was posted manually in the Corporate Backbone, no automatic entry is generated (warning) and the earlier automatic entry is reversed; conversely a document with an automatic entry cannot get a manual one.
- Re-running the FX revaluation is idempotent: the old revaluation of a party without a difference and its next-month reversal are undone. In a locked period FX revaluation and the depreciation template are not written and return a clear error. A depreciation template entry can be undone with a reversing entry that states a reason.
- Deleting a period's automatic entries removes the whole document chain: a reversal dated in another month or an FX reversal goes too; if an entry of the chain is in a locked period, the deletion is refused.
- Cash or bank: an account counts as cash only by its account type (cash card), not by its name; otherwise assign an account on the Mappings tab.
Entries, drilling to the document, manual journal
The Entries tab is filtered by date, account, party, event and text; clicking an account in a statement opens that account's entries. In the entry detail, Open document opens the source invoice, production order or the cheque/cash/bank window. An automatic entry is never edited by hand: fix the document or the rule and generate the period again. For records without a source document (correction, opening, accrual) use Manual entry; if four-eyes control is on in the corporate controls the entry is saved as a draft and another authorised user approves it. An approved manual entry can only be undone with a reversing entry that states a reason.
Financial statements and check badges
- Trial balance: opening, period debit/credit and balance per account; level (class, group, ledger account, sub-account) and comparison (previous period, last year). Badge: debit = credit.
- Balance sheet (as at the chosen date): Turkish uniform asset/liability groups, or the SAK EP statement of financial position for Indonesia. Profit for the period comes from that year's income statement; unclosed profit/loss of earlier years is a separate line. Badges: assets = liabilities and equity, income statement net profit = balance sheet profit for the period.
- Income statement: uniform chart lines A–K (7/A cost accounts are attached to the related lines) or SAK EP profit or loss.
- Cash flow (indirect method): net profit + adjustments + working-capital change + investing + financing = change in cash and cash equivalents (badge).
Every statement downloads as CSV and XLSX. Without an opening entry the balances are only the movements of the generated periods (the screen shows the date of the ledger's first record).
VAT / PPN return summary
The summary is the monthly VAT statement of the Official Obligations module (it is not recalculated); the equivalents in the ledger are placed next to it: collected sales VAT = 391 net, withheld sales VAT, calculated VAT (gross), deductible VAT = 191 net, VAT to be declared as the responsible party = 360. The base and VAT of a foreign-currency invoice are added at their TL equivalent (at the document rate); a foreign-currency invoice with no rate is not included in the base and is counted in the warning. A difference of up to 5 kuruş comes from per-voucher rounding. It is not a return; the accountant fills the return in with these values.
Period lock
Lock period (a reason is required) freezes the month with a single gate: all documents, receipts and stock movements dated in that month (invoice, receipt, dispatch note, order, goods receipt) cannot be written, edited, deleted or moved in or out with another date; a manual voucher is not written either (409). The refusal sentence says “A {belgeTuru} dated {tarih} falls in the locked accounting period {donem}; first unlock the period with a reason.” The period lock and period close in the corporate controls are the same gate: nothing is posted to a closed date.
Locking is done with the Accounting right; only the Administrator unlocks and writes a reason of at least 5 characters when doing so. Locking and unlocking are written to the audit trail (Cockpit › Audit › the “Period lock — lock” and “Period lock — unlock” rows). In a locked month the generation counts no new voucher and says “{sayi} documents were not posted to the ledger because the period is locked; first unlock the period with a reason.” Opening the Periods tab does not run the generation; you press Preview and Generate the period yourself. To lock again after unlocking and changing documents, resolve or accept the unmapped blockers.
The lock also covers HR records. A locked month admits not only documents, receipts and stock movements but also human-resources writes: advances, bonuses, piecework, travel allowance, garnishment, hiring/leaving, pay contracts, leave (request, approval, cancellation, bulk), absence, overtime, attendance punches (manual, phone, Pulse, portal, MES terminal) and day close are refused with 409. The sentence writes the period as mm.yyyy and the date as dd.mm.yyyy: “The personnel transaction dated 03.10.2026 falls in the locked accounting period 10.2026; first unlock the period with a reason.” A month whose net payroll is finalised is a separate rule (422; Human Resources › Finalised payroll period).
FX revaluation and the depreciation template
Revalue exchange differences values open foreign-currency account balances at the CBRT (TCMB) foreign-exchange selling rate (the same as Company reports › Exchange difference): a gain goes to 646 Exchange gains and a loss to 656 Exchange losses. The valuation date is the last day of the month and an automatic reversal is posted on the first day of the next month, so the account statement and the ledger stay consistent. Because it works with the current rate, only the current month and the previous month can be done. When no voucher results, the screen gives the reason with one of three sentences: a position with no rate found (“No exchange difference entry was posted: there are {pozisyon} open foreign-currency positions at period end and no current rate was found for {kurYok} of them. Enter the rate and revalue again.”), no difference to post, or no foreign-currency position; “no account” appears only when there truly is no foreign-currency account. Fixed assets are carded in the Accounting › Fixed assets window and their depreciation is run there; their vouchers are created in the period generation. Depreciation voucher (template) is only for assets not carded in the module: the amount is entered by hand and is posted at period end with the depreciation template in Rules (770 / 257). If depreciation was run from the module for that period, the template voucher stops with a double-expense warning. If the trial balance has months not posted (not generated) to the ledger, the trial balance says so with a warning and they are processed with Periods › Generate the period.
Accounting on the phone
On a screen smaller than 7 inches the window opens in four steps: Summary (balance sheet totals, the month’s income statement, the VAT summary and audit badges), Vouchers (a card list; tapping a card opens the voucher detail), Unmapped (blockers and warnings, Accept; Preview and Generate the period in the bottom bar) and Periods (lock the period / unlock, revalue exchange differences, depreciation voucher). The chart of accounts, rules and mappings are on the desktop.
Permissions
The window is open to the Administrator and to users who have the Accounting permission in their rights. Write actions also need the server’s write gate; a read-only user cannot write. Locking a period is done with the Accounting right; unlocking a period and deleting the automatic vouchers of a period are open only to the Administrator. Every action is written to the audit trail.
Messages and what to do
| Message | What to do |
|---|---|
| "The chart of accounts is empty." | Click Load package chart on the Chart of accounts tab. |
| "The accounting tables (MUH_*) have not been set up in this company yet." | The tables are created when the core server opens the company; the system administrator must restart the core server. |
| "DONEM_KILIDI" (period lock) | The date is in a locked or closed period. The administrator unlocks it with a reason. |
| "ESLENMEYEN_VAR" (unmapped documents open) | Resolve or acknowledge the block-level documents, then lock. |
| "HESAP_YOK" / "DENGESIZ" (account missing / unbalanced) | An account in the entry is not an active detail account, or debit ≠ credit. Correct the lines of a manual entry; for automatic entries fix the mapping or the rule. |
Related guides: Finance · Official Obligations · Reports · Mobile.
Accounting steps on the phone
On the phone (Garden + Steps) the Accounting window has the Chart of accounts, Rules and Mappings steps; they show the same information as the matching desktop tabs in a card layout.
Related guides
- Finance Module — A Guide from Scratch for Cashiers and AccountingThis guide is for someone who has never used accounting software. You know how to count money; what you will learn here is which document each movement of.
- Standard Cost and Variance AnalysisThe Standard Cost window calculates the "should-be" unit cost of every product (material, labour, manufacturing overhead and subcontracting) from the recipe.
- Official Obligations — A Guide from ScratchThis window answers a single question: what must this company, in this country, for this period, file — by when, and in what form; which one is ready.
- Bank Transactions — A Guide from ScratchEvery sum that moves through the bank is a collection from a business partner, a payment to a supplier, a bank fee or a transfer between your own accounts.
- Live Bank Connection — A Guide from ScratchIf you have an agreement with your bank, you can receive account transactions directly from the bank without downloading a statement file.
- Late Payment Interest, Collection Reminders and Sales Representative CommissionA late-paid invoice creates three jobs: working out the cost of the delay and passing it on to the customer, reminding the customer of invoices that are.