This module covers all of the organization's cash and instrument operations: bank, cash, and petty cash accounts, chequebooks, receipt and payment entry, the cheque lifecycle, bank reconciliation, cash-drawer and warehouse shift handover, and due-date averaging. Every transaction finalized here issues its own accounting document and updates the counterparty's account.
If you're just getting started, begin with Receipt Entry — that's the heart of this module, and every other page revolves around it.
Use the menu names exactly as they appear. In the menu subgroups, receipts and payments are shown under the names "Receivable Balance" and "Payable Balance." Use these same names when training users so they can find the item quickly.
Pages in This Module
Five menu subgroups, plus a few pages that are not in the menu.
Banking
Bank — define bank accounts; the detail account tree, account number, IBAN, and card.
Chequebook — define chequebooks and cheque leaves with a three-step wizard.
Received Cheques · Issued Cheques — two pages with an identical structure; bulk status changes and status history.
Bank Reconciliation — matching recorded transactions against the bank statement, for month-end closing.
Cash Management
Cash — the same interface as the Bank page, with classification code 1410.
Petty Cash — the same interface, with classification code 1420.
Shifts
Cash Shift — opening, counting, and closing a cash-drawer shift; handing over to the next person.
Warehouse Shift — the same inbox, for warehouse shifts; also listed under "Goods & Inventory ← Warehouse."
All Shifts — a shared inbox of every open and closed shift, both cash and warehouse; also repeated under "Goods & Inventory ← Warehouse."
Receivable Balance
Receipt Entry — a three-step wizard: counterparty, instruments (cheque, cash, transfer, card reader), document issuance.
Receipt List — a list of transactions with draft or finalized status; editing is only possible on drafts.
Receipt Details — a read-only view of a single transaction, with a due-date averaging calculation button.
Payable Balance
Payment Entry — the same wizard as Receipt Entry, in the payment direction; the first step's title is "Select Recipient."
Payment List — a list of payments with the same columns and filters as the Receipt List.
Payment Details — a read-only view, including related invoice information if applicable.
Accounts and Classification Code
The three pages Bank, Cash, and Petty Cash share an identical user interface and differ only in their classification code. Layout for all three: a right-hand column with the detail account tree featuring search and incremental loading, and a left-hand column with the data table showing code, name, and actions (edit / more info / delete) columns, along with Excel export. The Create button at the top of the page opens the add-account dialog.
| Page | Menu Location | Classification Code |
|---|---|---|
| Bank | Treasury ← Banking ← Bank | 1300 |
| Cash | Treasury ← Cash Management ← Cash | 1410 |
| Petty Cash | Treasury ← Cash Management ← Petty Cash | 1420 |
These three groups are the same groups 91 through 93 of the Detail Accounts Tree: the bank account you create here sits in Accounting as a detail account.
Bank Account-Specific Fields
| Field | Rule |
|---|---|
| Account number | Numeric only |
| IBAN | Prefixed with IR, exactly 24 digits |
| Card number | Exactly 16 digits |
| Account holder · Branch name | Text |
| Branch prefix | Numeric |
- An account used in a transaction cannot be deleted; check dependencies first.
- To create a chequebook, the bank account must have both an account number and an IBAN; otherwise the wizard will not allow you to proceed.
- Permissions: all three pages require the "Detail Account" permission family (create / read / edit / delete / restore).
Chequebook
List columns: bank account code · bank name · title · account number · number of leaves · IBAN · description · actions. Row actions: view leaves (dialog), edit, delete. The leaves dialog shows the columns Sayad number, series number, serial number, denomination, and description.
Defining a Chequebook — Three-Step Wizard
- Select the bank account. A table of bank accounts with code, bank name, branch, account number, IBAN, card, account holder, chequebook prefix, and active status. The "Create Bank" button lets you define a new account right there.
- Define the chequebook and leaves. Top form: account code, bank name, account number, and IBAN (read-only, from the bank), plus title (required), series number (4 numeric digits), and description. A leaves table with inline editing: Sayad number (16 digits, with QR scan support), series number, serial number (6 to 10 digits), denomination, description, and status.
- Operation report. Account summary, leaf count, and the final table. Saving registers the entire wizard.
The "Register Cheque Leaves" button takes the number of leaves and the first leaf's serial number, then auto-generates consecutive serials — the fastest way to register a 50-leaf book. The Enter key moves between cells, and bulk deletion of checked leaves is also possible.
If you exit while in progress, an "Exit Page" warning dialog appears so data isn't lost. Permissions: Chequebook (create / read / edit / delete) and Cheque Leaf.
Received and Issued Cheques
Columns: due date, base amount, cheque status (colored chip), actions. Filters: due-date range and cheque status.
| Value | Title | Meaning |
|---|---|---|
| 0 | Initial | The cheque is registered and no action has been taken on it yet (blue) |
| 1 | Payment Issued | The cheque has been issued and delivered (green) |
| 2 | Voided | The cheque has been voided (red) |
| 3 | Bounced | The cheque has bounced (red) |
| 4 | Cleared | The cheque's funds have been collected (green) |
| 5 | Transferred to Bank | A transitional status; selecting the destination account is required (light blue) |
| 6 | Transferred to Person | A transitional status; selecting the destination person is required (orange) |
Row actions: view details · edit · change status · status change history · view related documents · view transaction · delete.
Bulk status change. Selecting multiple cheques activates the "Bulk Change Cheque Status" button. Cheques are grouped by their current status, and for each group you set the destination status, the transfer account, and the date; the result for each group is shown with a success or failure icon. This is the fastest way to bulk-clear a batch of cheques on a single day.
The cheque details dialog shows a visual rendering of the actual cheque leaf, with the date in words, the amount in words, denomination, and IBAN, along with status and description. By selecting multiple cheques in this same list, the due-date averaging calculator produces the weighted-average due date right there — without going to the due-date averaging page.
Receipt and Payment Entry
The heart of the Treasury module. A receipt or payment transaction with one or more instruments (cheque, cash, transfer, card reader) is registered, and an accounting document is issued at the end. Editing an existing transaction also opens this same wizard.
Step 1 — Select the Counterparty
The title varies by type: "Select Payer" (receipt) or "Select Recipient" (payment). The transaction date is editable. Filters: person category and person type. Account selection uses a smart search card with incremental loading; once selected, a person info card (phone, national ID, city, and province) is displayed.
The optional invoice selection section: expanding the accordion lets you select the related sales or purchase invoice. Doing so automatically syncs the customer account and sets the invoice amount as the "target amount."
Step 2 — Register Instruments
When an invoice has been selected, a settlement progress bar is shown at the top of the page: total instruments, invoice amount, remainder, and settlement percentage, with a warning if it is exceeded.
| Instrument Type | Shortcut | Description |
|---|---|---|
| Cheque | 1 | A form shaped like an actual cheque leaf: date, bank, series and serial, Sayad number, amount, and denomination |
| Cash | 2 | Amount and account |
| Transfer / Withdrawal | 3 | Types: card-to-card, Satna, Paya, direct card reader |
| Direct Card Reader (POS) | 4 | Receipt mode only; connects to the POS device and queries the transaction status |
| Advanced Entry | A | Simultaneous entry of multiple instruments and automatic calculation of cheque installments |
Table of registered instruments: row, amount, type, date, transaction status (for POS), document template selection, and actions (view POS transaction, retry failed transaction, edit, delete). The total of the instruments cannot exceed the target amount.
Step 3 — Review and Issue the Document
A summary of the counterparty and instrument count, with the option to go back to previous steps, and the final instruments table. Two key buttons: "Issue Document" and "Issue Document per Instrument." The default value for "Issue Document" is read from General Settings.
Wizard keyboard shortcuts: Enter confirms and moves to the next step · Ctrl+Enter next step · Ctrl+Shift+Enter previous step · 1 through 4 instrument types · A advanced entry · Ctrl+S save · F1 help.
Permissions: Receipt Transfer and Payment Transfer (create / read / edit / delete) and "Operationalize" (all records or own only).
Receipt and Payment Lists and Details
Columns: transaction number · document date · account · total amount · number of instruments · description · status (draft or finalized) · actions. Filters: status, creation date range, document date range. Actions: view details, edit (draft only), delete. Due-date averaging is also available from within the table.
Receipt and Payment Details is a read-only view of a single transaction: a header with a direction icon and a "Calculate Due-Date Averaging" button, general information (code, date, total amount, status, counterparty, national ID, phone, number of instruments, description), invoice information if applicable, and the instruments table.
Quick Receipt and Payment Entry is a keyboard-driven input mode for high-volume operators: a document-type toggle key, header fields (auto-generated document number, date, counterparty, bank account, description), an amount rows table with a running total display, and the ability to save a draft. To open it, use Global Search (Ctrl+F) and type "quick entry."
Due-Date Averaging
Due-date averaging means calculating a weighted-average due date for a set of amounts each with its own due date, along with the average number of days from a reference date and validation against a maximum allowed number of days.
These pages are not in the menu. "Due-Date Averaging Calculation" and "Due-Date Averaging History" are opened in three ways: Global Search (Ctrl+F and typing "due-date averaging"), the "Calculate Due-Date Averaging" button inside the Receipt or Payment Details page, and the inline calculator on the Cheque List page. For everyday access, add these pages to your personal shortcuts.
Due-Date Averaging Calculation
A tabbed page with five tabs:
| Tab | Input |
|---|---|
| Manual | Free-form due date and amount rows |
| By Payment Transaction | Transaction number ← load instruments ← all or selected |
| By Invoices | Select multiple invoices |
| By Invoice Line Items | Select one invoice ← select goods line items |
| By Person | Select a person ← view their saved calculations |
Settings card (Manual tab): reference date, maximum allowed days (default 120), calculation title, description, and the related person, invoice, or transaction. Items table: due date, reference number, amount (with thousands separator), days from reference (colored chip), description. There is also an installment pattern that generates each row one month after the previous row.
Live preview: the result is calculated automatically after a short delay and shown in a card; a green card means it's within the allowed range, and red means it's outside it. Due-Date Averaging History keeps previously saved calculations and can be recalled per person.
Shift Handover / Cash Shift
This page tracks custody of the cash drawer (or a warehouse) between users: opening a shift, sales and manual movements during the shift, an end-of-shift count, and closing it or handing it over to the next person.
Opening a shift
At the start, the cash amount currently in the drawer ("Opening cash amount") is entered; it stays zero if the drawer is empty. In warehouse mode this field isn't shown at all and is recorded as zero. The shift holder and a related HR shift can also be set (both optional).
During the shift
Registered sales are automatically factored into the "system expected amount"; there's no need to log them manually. Deposits into the drawer, withdrawals from the drawer, drops to the safe, and corrections are all entered from the "Deposit / Withdraw" button (in warehouse mode: "Manual In / Out").
Counting
The end-of-shift count records the actual counted amount. Blind counting is a server-determined property, not a switch available to the user: when it's active for a shift, the system amount and the variance are hidden from the counter, and the shift's history isn't shown to them either; a supervisor still sees everything.
Variance
Variance is the difference between the count and the system-expected amount: short (less), over (more), or balanced (zero). If the variance is non-zero, a "Variance reason" field opens during counting; closing such a shift also requires supervisor approval.
Closing or handing over a shift
Closing a shift asks for a "Balance carried to next shift" amount (leave it empty and the system calculates it itself) and requires a reason if the variance is non-zero. Handing over to the next person first requires a submitted count; until the count is submitted, the message "Submit the count first, then hand over" is shown. A handover closes the current shift and opens a new one for the next person with the carried-forward amount.
Where the settlement document link goes depends on the resource type: for a cash shift it goes to the accounting document, for a warehouse shift to the inventory count document.
In the current version, closing a shift that has a non-zero variance sometimes isn't actually saved on the server, even though the app shows a success message. The app immediately re-reads the status from the server, and if the shift wasn't really closed, it locks the Close button to prevent retrying — each retry creates an extra, orphaned variance document. If you see this message, don't try again; notify a supervisor or support.
For in-person selling at the register, see the Point of Sale documentation.
POS Settlement Accounts
These accounts are set once so the cashier doesn't have to hunt for an account at the time of sale: every payment method received in an in-person sale or a quick invoice is booked to one of these accounts.
| Field | Determines |
|---|---|
| Cash receipt account | The cash taken at the register is booked to this account |
| Cheque receipt account | Cheques received at the register are booked to this account |
| Card-to-card receipt account | Card-to-card transfers and bank deposits are booked to this account |
| Cash-box account group | Only accounts in this group are shown in the storefront register |
| Bank parent account | Only sub-accounts of this account are shown in the storefront register |
| Selectable banks for cheques | The list of banks selectable when registering a cheque at the register |
The card-reader (POS) account isn't set here; it's read from the card reader device's own definition.
If these accounts aren't set, in-person selling has no pre-set account for that payment method, and the account has to be picked manually at settlement time. See these accounts in action, at the point of sale, in the Point of Sale documentation.
Permissions for This Module
- Detail Account — for Bank, Cash, and Petty Cash (create / read / edit / delete / restore).
- Chequebook and Cheque Leaf — for defining and editing chequebooks.
- Receipt Transfer and Payment Transfer — along with the "Operationalize" permission (all records or own only).
Sample Workflows
Receiving Funds From a Customer for an Invoice
Receipt Entry ← select payer ← expand the invoice accordion and select the invoice (the target amount is set) ← register instruments ← review and issue the document ← check the "Remainder" column of the invoice in the Sales list.
Lifecycle of a Received Cheque
The cheque enters via Receipt Entry (initial status) ← transferred to the bank by selecting the destination account ← at the due date, bulk status change to "Cleared" ← if bounced, the bounced status and reviewing related documents.
Closing the Month With Bank Reconciliation
Bank Reconciliation ← match recorded transactions against the bank statement ← resolve discrepancies ← close the session ← check the books in the Journal.
Cash-Drawer Handover at End of Day
Cash Shift ← register the count (blind counting if enabled for that shift) ← if there's a discrepancy, record the reason and get supervisor approval ← hand over to the next person or close the shift.
Frequently Asked Questions
I can't create a chequebook.
The bank account must have both an account number and an IBAN; complete the account information.
I can't edit a transaction.
Only a draft transaction can be edited; for a finalized transaction, use a reversal or correction.
I can't delete an account.
An account used in a transaction cannot be deleted; check dependencies first.
I can't register a total of instruments greater than the invoice amount.
That's correct; the total of the instruments cannot exceed the "target amount," and the settlement progress bar warns you if it is exceeded.
I can't find the due-date averaging page in the menu.
It's not in the menu. Use Global Search, the "Calculate Due-Date Averaging" button in the Receipt Details, or the calculator on the Cheque List.
I can't close the shift.
You have a discrepancy; supervisor approval is required to close it.
The system amount isn't shown in the count.
Blind counting is enabled — this is intentional, so your count remains independent; the shift's history also isn't shown to you while this is active.
I closed the shift and saw a success message, but it still shows "Pending review."
This is a known server-side bug that only happens when the variance is non-zero. Don't retry the Close action — every attempt creates an extra, orphaned variance document; notify a supervisor or support.
Where do I configure the POS settlement accounts?
System ← General Settings ← Public ← Settlement in the storefront register. If they aren't set, in-person selling has no ready account for that payment method.