Report Optimizations

August 19, 2026 26 views admin

Report Optimizations — Complete User Guide — Two Accounts Web

A comprehensive guide covering how a user reaches Reports > Report Optimizations, how the feature is enabled and configured, every field of the template and of a generated report, and how the figures are calculated from the general ledger and validated against accounting practice.


Table of Contents

  1. 1. What Are Report Optimizations?
  2. 2. Prerequisites Before You Can Use Them
  3. 3. How the Feature Becomes Available
  4. 4. Related Configuration in Settings
  5. 5. Designing a Template — Field-by-Field
  6. 6. Generating a Report — Step by Step
  7. 7. Field-by-Field Guide to a Generated Report
  8. 8. How Each Value Is Calculated
  9. 9. Sample Data and Output
  10. 10. Effects on the Rest of the System
  11. 11. Behaviour Nuances and Cautions
  12. 12. Accounting Standards Considerations

1. What Are Report Optimizations?

Report Optimizations are user-designed report templates. With them you build your own tabular reports — row by row, column by column — that pull figures directly from the general ledger. Under Reports, the “Report Optimizations” category collects the templates you have published; inside each template you create dated report instances, and the system renders each one as a formatted, printable table of ledger figures.

Two distinct parts:
  • Design (configure) — under Settings, you build a template: its name, default period, number of columns, report rows, the figures each cell sums, optional per-supplier and per-employee breakdowns, instructions, and a publish flag.
  • Publish and run (report) — under Reports, each published template is listed; you create report instances for chosen periods and view or print the populated report.

Key characteristics:

  • It is a customisable reporting engine, not one fixed statement. The layout, labels, and figures are defined once in a template and reused.
  • Its figures are computed from the general ledger at view time — the report is derived, never imputed.
  • Generated reports are read-only; they post no transactions.
  • They are management / entity-specific reports (for example VAT-style returns or segment statements), not the statutory Financial Statements themselves.

2. Prerequisites Before You Can Use Them

  1. User permission. The user must have permission to view the Report Optimizations area; without it, the category is not shown.
  2. A template must exist and be published. Only templates marked Published appear under Reports > Report Optimizations. (Country-localized templates supplied with the system may also appear if the business’s country provides them.)
  3. Reporting building blocks must be present for whatever figures the template uses — typically Reporting Categories (which amounts are summed) and optionally Report Optimization Labels (static text) and Custom Fields (entity details).
  4. Ledger activity must exist in the report period, with appropriate tax codes / reporting categories assigned on transactions, so the chosen figures can be resolved.
No published template, nothing to open: The “Report Optimizations” heading under Reports lists only published templates. If none are published (and none are supplied for the country), the category is simply not displayed for the user.

3. How the Feature Becomes Available

Unlike many other reports, Report Optimizations is not governed by a switch in the Customize Menu on the navigation bar. Its availability is driven by three facts working together:

  1. Feature permission — the user’s profile must be allowed to view the Report Optimizations namespace.
  2. Published templates — at least one template must have been created and marked Published (or the country configuration must supply templates).
  3. No templates requirement — if the country is not configured to supply templates and none have been published, the section is hidden.

In practice, the enable-and-run sequence is:

  1. Go to Settings and open the Report Optimizations configuration screen.
  2. Create template(s) with the desired rows/columns, then set Published on the ones you want visible.
  3. Open Reports; the “Report Optimizations” category now lists each published template.
  4. Click a template to open its reports, generate a new report for a period, and view it.
Important: Because the Customize Menu does not add or remove this category, there is no navigation-bar toggle for it. Making the feature useful is the combination of creating templates in Settings and publishing them; the reports themselves always come from the general ledger.

4.1 The Report Optimizations Configuration Screen

Where: Settings > Report Optimizations.

This screen lists all report templates you have created (alphabetically, by name) and offers a New action to create one. Each template can be opened (viewed/previewed), edited, or cloned. The list is empty until you create a template.

4.2 Reporting Categories

Where: Settings > Reporting Categories.

Reporting Categories are the “figure building blocks” a template’s cells use. They attach labels and rules to amounts that flow through the ledger — for example separate categories for net sales, tax on sales, net purchases, tax on purchases, reverse-charged amounts, and payslip income items. When a template places one of these in a column, the cell becomes the sum of that category’s ledger amounts for the report period. Configuring these well is what makes a template's figures correct and complete.

4.3 Report Optimization Labels

Where: Settings > Reporting Categories > Labels (Report Optimization Labels).

Labels are simple static text values (for example a company suffix, a title line, or a fixed note) that can be placed in a cell alongside or instead of a numeric figure. They give you control over the wording that appears in your custom report.

4.4 Custom Fields

Where: Settings > Custom Fields.

Custom fields capture extra details against employees, suppliers, or the business itself. A template figure can display such a value (for example a supplier registration number or an employee identifier) in a column, which is useful for return-style reports that carry reference numbers.


5. Designing a Template — Field-by-Field

5.1 Template Header Fields

Field Meaning Notes
Name The template’s display name (and the report title). Shown in Settings, under Reports, and printed as the report heading.
From Date / To Date The default reporting period used when a new report is generated. Set once on the template; can be overridden per report instance.
Accounting Method A switch to control the basis used for the figures. When on, chooses Accrual or Cash basis; when off, accrual is used.
Employee Restricts the whole report to one employee’s transactions. Only shown/used when the per-employee breakdown is not enabled.
Number of Columns How many figure columns the report will have. Between 2 and 6 columns, plus the row-label column.

5.2 Report Items (Rows)

Each template contains a list of report items, one per row of the report. Each item has:

Field Meaning
Row Name The row label printed in the first column. If the name ends with a line of dashes, the row is rendered as a section header/banner spanning the width of the report.
Column 1 – Column 5 The set of figures shown in each of the report’s columns for that row (only the columns allowed by the chosen number of columns are used).

5.3 Figures per Column

A column is not limited to a single amount — it can hold several figures whose values are combined to produce the cell. Figures can be:

Figure type Behaviour in the cell
Reporting Category Sums that category’s ledger amounts for the period (including amounts posted under its “reversed” counterpart, which are subtracted).
Tax on Sales / Tax on Purchases Limits the category to sales-only, or purchases-only, transactions respectively.
Label Adds fixed text to the cell.
Custom Field value Displays a stored value for the employee, supplier, or business (e.g., a registration number or date).
Dynamic field Displays employee name/e-mail, supplier name, business name, the report’s From Date, or its To Date.
Period “from 1 July” Starts the summing window at 1 July of the period’s year (for July-to-June fiscal-type periods).
Reverse sign Inverts the resulting figure (used where a category is naturally shown on the opposite side).
Set zero if negative Floors the figure at zero when the net result is negative.
Hide if empty Hides the cell (and its row when all cells are hidden) if there is no value or a zero amount.
Combining figures: When several numeric figures are placed in one column they are added together to form the cell value. When any text figure is present, the values are joined with spaces into a single text cell. Each cell also links to its own transaction listing so a printed amount can be traced to the ledger.

5.4 Special Sections

Section Behaviour
Suppliers Enables a per-supplier breakdown. After the main rows, the report prints a block per supplier. You may restrict which suppliers appear using a supplier custom field (a condition such as a field being set to a chosen value). Each supplier block repeats the rows you define under “For Each Supplier”.
Employees Enables a per-employee breakdown. After the main rows, the report prints a block per employee repeating the rows defined under “For Each Employee”.
Instructions Adds a numbered instruction list shown at the bottom of the report (for example, how to complete or file the return).
Script Adds custom script used to transform/export the report content (for example to prepare a CSV for electronic filing).

5.5 Publishing the Template

Set Published to make the template appear under Reports > Report Optimizations. Unpublished templates remain fully editable in Settings but are not listed under Reports. You can preview a template’s figures from its view in Settings before publishing.


6. Generating a Report — Step by Step

  1. Ensure the feature is available (Section 3) and a template is Published.
  2. Open the Reports area; scroll to the “Report Optimizations” category.
  3. Click the published template you want to use.
  4. The system shows the list of report instances already created from that template (each with From Date, To Date, Employee where applicable, and Description), plus a “New Report” button.
  5. Click New Report.
  6. Enter the From Date and To Date for this particular report (pre-filled from the template’s default period).
  7. Choose the Accounting Method (only if the template enables it) — Accrual or Cash basis.
  8. Choose the Employee (only if the template targets a specific employee).
  9. Enter an optional Description for the report instance.
  10. Save, then open (View) the report to see the populated table.
Re-running: To produce the same template for another period, simply create a new report instance with new dates. Each instance is computed live from the ledger at open time, so the figures are always current for its period.

7. Field-by-Field Guide to a Generated Report

7.1 Fields You Set When Creating a Report Instance

Field Type Required Description
From Date Date Yes The first day of the report period. Pre-filled from the template.
To Date Date Yes The last day of the report period (inclusive). Pre-filled from the template.
Accounting Method Accrual / Cash Only if template enables it Selects how invoices are counted — on issue (accrual) or on cash received/paid (cash).
Employee Employee Only if template targets one Limits the report to a single employee’s transactions.
Description Text No A free-text label for the report instance, shown in the report list.

7.2 What the Report Shows

A generated report is a printed-style table with:

Element Description
Business name The business’s name centred at the top of the report.
Template title The template’s Name as the report heading.
Period line “For the period from {From} to {To}.”
Accounting basis (when enabled) A line stating Accrual or Cash basis.
Main rows The report items (row names) with the configured figure columns; header-style rows span the full width.
Per-supplier sections If enabled: a highlighted banner per supplier, each repeating the supplier rows with that supplier’s amounts.
Per-employee sections If enabled: a highlighted banner per employee, each repeating the employee rows with that employee’s amounts.
Instructions If enabled: a numbered “Instructions” list below the table.
Actions Print, export (e.g., CSV when a script supplies it), e-mail, plus Edit / Clone / inline-edit of the report instance.

8. How Each Value Is Calculated

8.1 Figure Basis

For each figure = the sum, in the base currency, of general ledger transactions that:

  - belong to the figure's reporting category  (or its reversed counterpart, subtracted), and
  - fall within the report period:  From Date <= date <= To Date
     (or from 1 July of the period's year when that period figure is used)

Text figures (labels, custom fields, dynamic fields) are displayed as-is.
The cell = the combined value (numeric figures added; text figures joined)

The numbers printed are therefore exactly the ledger’s own amounts — the report adds nothing of its own and never creates entries.

8.2 Accrual vs. Cash Basis

Accrual basis:  sums all posted transactions in the period (sales and purchase invoices
                are counted on their invoice dates, whether or not cash has moved).

Cash basis:     sales and purchase invoices are converted to a cash basis first —
                the system matches invoices with their receipts/payments and counts
                only the amounts whose cash was actually received/paid in the period.

A report that enables the accounting method lets you choose which basis to use for each report instance, giving figures consistent with the intended accounting basis.

8.3 Entity and Tax Filters

  • Single employee: when the template targets an employee, only that employee’s transactions are included.
  • Per-supplier sections: each supplier block uses only that supplier’s transactions; a supplier is included only if it has activity inside the period and, when set, satisfies the supplier custom-field condition.
  • Tax on sales: keeps only transactions that are sales (or have no tax code).
  • Tax on purchases: keeps only transactions that are purchases.

8.4 Special Period and Sign Modifiers

Reversed category : the category amount is subtracted (its ledger lines are reversed).
Reverse sign      : the whole figure is multiplied by -1.
Set zero if neg   : a negative figure is floored to zero.
Hide if empty     : the cell (and, if all its cells are empty, the row) is hidden.

8.5 Row, Column Layout and Output

The template’s chosen number of columns determines how many figure columns are printed after the row-label column. Report items render in order; items marked as headers span the full width. Per-supplier and per-employee blocks follow the main rows. The report is printable and can be exported; every numeric cell links to the underlying transactions for audit.


9. Sample Data and Output

The following example uses base currency BDT and a simple VAT-style template.

9.1 Sample Setup

Item Details
Business ABC Enterprises Ltd
Base Currency BDT
Reporting Period 01-Jan-2026 to 31-Mar-2026
Suppliers S1 Traders (net purchases), S2 Supplies

9.2 The Template

Template “Quarterly Sales & Purchases”:

  • Columns: 3 (Net, Tax, Total)
  • Rows:
    • “Sales” — Column 1: Net Sales category; Column 2: Tax on Sales; Column 3: Total Sales = Net + Tax
    • “Purchases” — Column 1: Net Purchases; Column 2: Tax on Purchases; Column 3: Total Purchases
  • Suppliers: Enabled, with one “Purchases” row per supplier
  • Published: Yes

9.3 Ledger Data (Period)

Date Transaction Net (BDT) Tax (BDT) Total (BDT)
10-Jan-2026 Sales invoice A1 50,000 5,000 55,000
05-Feb-2026 Sales invoice A2 30,000 3,000 33,000
15-Mar-2026 Sales invoice A3 20,000 2,000 22,000
12-Jan-2026 Purchase from S1 Traders 25,000 2,500 27,500
20-Feb-2026 Purchase from S2 Supplies 15,000 1,500 16,500

9.4 Report Output

Quarterly Sales & Purchases — for the period 01-Jan-2026 to 31-Mar-2026 (Accrual basis)

Item Net Tax Total
Sales 100,000.00 10,000.00 110,000.00
Purchases 40,000.00 4,000.00 44,000.00

Per-supplier breakdown (from the supplier rows):

Supplier Purchases — Net Purchases — Tax Purchases — Total
S1 Traders 25,000.00 2,500.00 27,500.00
S2 Supplies 15,000.00 1,500.00 16,500.00

9.5 Verification

Sales:        Net = 50,000 + 30,000 + 20,000 = 100,000.00
              Tax =  5,000 +  3,000 +  2,000 =  10,000.00
              Total = 100,000 + 10,000       = 110,000.00   ✓  (Net + Tax = Total)

Purchases:    Net = 25,000 + 15,000 = 40,000.00
              Tax =  2,500 +  1,500 =  4,000.00
              Total = 40,000 + 4,000 = 44,000.00           ✓

Per-supplier tie-out:
              S1  Total 27,500.00  +  S2  Total 16,500.00  =  44,000.00   ✓
              S1  Net 25,000 + Tax 2,500  = 27,500.00      ✓
              S2  Net 15,000 + Tax 1,500  = 16,500.00      ✓

All figures equal the base-currency sums of the posted invoices:
              110,000 + 33,000 + 22,000 (sales totals)  = 165,000.00 cash on invoices issued
              (accrual includes every invoice dated in the period regardless of payment)   ✓

9.6 Cash-Basis Illustration

Suppose the 15-Mar invoice A3 (22,000, of which tax 2,000) had not been paid by 31-Mar, while all purchases had been paid. Re-running the same report on Cash basis would produce:

Cash-basis sales:  55,000 + 33,000       =  88,000.00   (tax 8,000.00)
Cash-basis purchases: 27,500 + 16,500    =  44,000.00   (tax 4,000.00)

  (The unpaid 22,000 A3 invoice is excluded because its cash had not been received;
   its amounts would appear in the period in which it is actually settled.)
Basis effect: The choice of basis is a policy/return decision, and the template lets you print the same layout under either basis. Whichever basis you pick, the printed figures always equal the ledger’s amounts under that basis — nothing is invented.

10. Effects on the Rest of the System

Report Optimizations are derived and create no ledger entries. Their relationships with the rest of the system:

Area Relationship
General Ledger Every figure is read from the general ledger (in the base currency) and links back to its transactions, so the report is fully traceable and cannot disagree with the books.
Reporting Categories & Tax Codes The categories assigned to transactions determine which amounts land in which cell. Configuring categories consistently is what keeps template figures correct and comparable period after period.
Suppliers / Employees Per-supplier and per-employee breakdowns reuse the same ledger data, filtered by entity, so each block reconciles back to the totals.
Sales & Purchase Invoices On cash basis the system matches invoices to their receipts/payments; the report therefore follows the same cash-flow logic used elsewhere in the accounting engine.
Custom Fields Entity reference details shown in figure cells come from the same custom fields maintained on suppliers, employees, and the business.
Payslips Reporting categories that sum payslip income items allow templates to build payroll-style returns from the same payslip data.
Deep-dive impact: The most important consequence is consistency and control. Because the template only describes layout and which categories to read, the underlying data remains one source of truth. Re-running the same template over different periods or different entities yields comparable figures, and the entire report is auditable back to the ledger — satisfying the control objective behind regulatory returns.

11. Behaviour Nuances and Cautions

  • Not a standard statement. A report optimization is a management/return-style custom report, not a statutory Financial Statement; statutory statements remain the standard balance sheet, profit and loss, and cash flow reports.
  • Publishing controls visibility. Only Published templates appear under Reports. Keep the flag off while designing; switch it on when the template is ready.
  • User permission is required. The category is not shown to users without permission to the Report Optimizations area.
  • No Customize-menu switch. You cannot toggle this category from the navigation-bar customize menu; it follows templates/permissions instead.
  • Figures tie to the ledger. A cell is only as correct as the categories assigned to transactions — check reporting-category assignment on the actual transactions if a figure looks incomplete.
  • Cash basis changes the timing. Switching a report instance to cash basis moves unsettled invoices out of the period; make sure the basis matches the intended accounting policy for that return.
  • Text vs numeric cells. When a column contains a mix of text and amounts, it becomes a single text cell; design columns to be consistently numeric (or text-only) for clean printed tables.
  • Hidden/zero rows. Cells marked “hide if empty” disappear when empty; rows whose cells are all hidden are dropped from the report.
  • Read-only output. Opening and printing a report changes nothing; corrections are made on the source transactions and the report re-computed.
  • Clone before major edits. Use the Clone action to create a variant of a template before changing the original.

12. Accounting Standards Considerations

Report Optimizations is a custom reporting tool, but its design supports sound accounting practice.

12.1 Faithful Representation and Traceability — IASB Conceptual Framework

Principle: Information must faithfully represent the transactions it claims to represent and be verifiable.

Alignment: Every figure is an exact base-currency sum of posted general-ledger transactions and links to those transactions. There is no estimation, no imputation, and no opportunity for the printed report to diverge from the books without explanation.

12.2 Consistency and Comparability — IAS 1 and IAS 8

Principle: The same accounting policies and classifications should be applied consistently so results are comparable between periods.

Alignment: A template fixes the layout and the categories it reads, so identical reports can be generated for consecutive periods using the same definitions. Choice of accrual or cash basis is explicit and recorded on each report instance.

12.3 Cash vs. Accrual Basis

Principle: Accounting results depend on the basis adopted (accrual is usual under IFRS; cash basis may be used where the framework allows).

Alignment: The template lets you state the basis and the report prints it. When cash basis is selected, the system matches invoices to their receipts/payments before summing, mirroring the cash-basis measurement principle.

12.4 Revenue and Tax Classification — mapping to VAT / GST frameworks

Principle: Returns for sales tax regimes (e.g., VAT/GST) require net amounts, tax amounts, and totals to be correctly separated and attributed by period.

Alignment: Reporting categories together with the Tax-on-Sales / Tax-on-Purchases figures and per-supplier breakdowns allow a template to reproduce the box layout of a VAT-style return — e.g., net purchases by supplier, tax amounts, and totals — computed directly from transactions that carry the appropriate tax codes.

12.5 Internal Control and Approval

Principle: Reports that feed filings or management decisions should be repeatable, reviewable, and permission-controlled.

Alignment: Templates are only visible when published and permissioned; report outputs are read-only; every figure is drillable. This gives reviewers an auditable path from a printed figure back to the underlying posting — a strong control trait for any report used for filing or for management conclusions.

Best practice: Design one template per distinct return/report (for example a separate one for each VAT box-set and each management segment), keep reporting-category assignments up to date on transactions, publish only approved templates, and generate a fresh report instance per period so the printed date range always matches its heading.

End of Report Optimizations Guide