How to Configure GL Journal Generator in iDempiere

Configure the GL Journal Generator in iDempiere to automate store journal entries from posted accounting transactions.

Introduction

The GL Journal Generator is an iDempiere configuration window that reads posted Fact_Acct balances from a Source account and its full sub-account tree, recalculates them using multiplier and rounding rules, and generates a new GL Journal.

Businesses use it to automate recurring, rule-based entries such as inventory adjustments, fee allocations, and store-level reclassifications without manual journal entry.

Because the output posts directly to the general ledger, correct setup affects store-level P&L accuracy, financial reporting, and month-end closing time.

Process Flow

TenthPlanet iDempiere GL Journal Generator 1

Business Rules

  • Source Amount is read from the Source’s Account Element and its entire account-tree of sub-accounts.
  • Only Actual posting type, active, in-range Fact_Acct entries feed the calculation.
  • Source Amount is SUM(Debit – Credit), grouped by the Generator Line’s configured dimensions.
  • Multiplier and Round Factor apply twice: once at the Source, again at the Generator Line.
  • Same Product groups and carries the Product dimension separately for each product.
  • Type of BP Dimension controls Business Partner handling: Same, Fixed, or From Column.
  • Copy All Dimensions carries every Accounting Schema dimension and overrides BP/Product settings.
  • Fact_Acct rows with no Business Partner are grouped into one blank-BP bucket, not per partner.
  • Matching dimension groups from multiple Sources are combined into a single amount.
  • Zero calculated amounts never generate an output journal line.
  • Simulation mode calculates and logs results without creating or saving a GL Journal.
  • An unbalanced journal is auto-balanced using the configured Adjustment DR/CR accounts.

Prerequisites

  • Accounting Schema configured for the tenant.
  • Chart of Accounts structured correctly, since Source matching includes the full child-account tree.
  • Document Type “GL Journal” configured.
  • GL Category configured (e.g., Standard).
  • Organization structure configured (e.g., Chennai Store).

Navigation

Menu → Performance Analysis and Accounting → GL Journal Generator

Opening this window displays the Generator Header, with the Generator Line and Generator Source sub-tabs and a Generate GL Journal button used to run the process.

Configuration Steps

Step 1: Define the GL Journal Generator Header

Enter a Name and Description, select Document Type “GL Journal”, GL Category “Standard”, Posting Type “Actual”, and the Accounting Schema. Set Account Adjust DR/CR for balancing.

FieldSample ValueDescription
NameInventory Adjustment JournalIdentifies the generator template
Document TypeGL JournalDocument type used for the generated journal
GL CategoryStandardGroups journal entries for reporting
Posting TypeActualRestricts source entries to actual postings
Accounting SchemaPOTS UN/38 Indian RupeeSchema used for reading and posting amounts
Account Adjust DRB_ASSET_Checking AccountDebit account used to balance the journal
Account Adjust CRB_INTERESTEXP_Interest ExpenseCredit account used to balance the journal
TenthPlanet iDempiere Accounting GLJournalGenerator 3

Step 2: Configure the Generator Line

Add a Generator Line with a Sequence and Description. Select Account DR and Account CR. Choose either Copy All Dimensions, or set Type of BP Dimension and Same Product individually — not both approaches at once.

FieldSample ValueDescription
Sequence10Controls processing order of the line
DescriptionInventory Adjustment Expense EntryExplains the purpose of the line
Account DRB_ASSET_Checking AccountTarget Debit account for calculated amount
Account CRB_INTERESTEXP_Interest ExpenseTarget Credit account for calculated amount
Type of BP DimensionSame / Fixed / From Column / blankControls how Business Partner is assigned (ignored if Copy All Dimensions is checked)
Same ProductCheckedGroups and carries Product from the source entry
Copy All DimensionsUncheckedWhen checked, all Accounting Schema dimensions are copied instead of the two fields above
Multiplier Amount1.0Scales the combined source amount
Round Factor0Rounds the final calculated amount
TenthPlanet iDempiere Accounting GLJournalGenerator 1

Type of BP Dimension — Options

OptionBehaviorWhen to Use
SameGroups by the source row’s own Business Partner and carries it to the outputSource entries reliably carry a real Business Partner
FixedIgnores the source’s Business Partner; assigns one hard-coded BP to every output lineConsolidating many partners into one internal partner
From ColumnGroups by a related record’s key, then resolves the BP from a column on that recordThe real BP is reachable only through a linked record, not directly on Fact_Acct
Blank / noneBusiness Partner is not grouped by or carried at allSource account never carries a meaningful Business Partner

Step 3: Configure Generator Source

Under the Generator Line, add one or more Sources. Select the Account Element to read (a parent account matches its full subtree), an optional GL Category filter, and a Multiplier Amount or Round Factor if scaling is required.

FieldSample ValueDescription
Account ElementB_ASSET_Checking AccountSource account read from Fact_Acct, including all accounts below it in the tree
GL CategoryStandardOptional filter on source entries
Multiplier Amount2.0Scales the source amount before combining with other Sources
Round Factor0Rounds the source amount
TenthPlanet iDempiere Accounting GLJournalGenerator 2

Step 4: Run the Generate GL Journal Process

Click Generate GL Journal, enter the Processing Date range and Accounting Date, set Simulation to Yes to preview first, then rerun with Simulation set to No and a Document Action.

FieldSample ValueDescription
Processing Date From01-Jul-2026Start date for selecting Fact_Acct entries
Processing Date To31-Jul-2026End date for selecting Fact_Acct entries
Accounting Date31-Jul-2026Accounting date of the created GL Journal
SimulationYes / NoPreview only, or create the GL Journal
Document ActionPrepare / CompleteAction applied to the generated journal
Business PartnerABC Customer (optional)Filters source entries by partner
ProductProduct A (optional)Filters source entries by product

Note: In Simulation mode, the process log shows the resolved Account, Debit/Credit amount, Business Partner, and Product for each calculated line — always review this before running with Simulation set to No.

Common Issues and Resolutions

IssueCauseResolution
No journal lines generatedNo matching Fact_Acct entries in the date range, schema, or account treeVerify Processing Date range, Accounting Schema, and that the Source account tree contains posted entries
Source amount includes unexpected accountsThe Source’s Account Element matches its entire sub-account tree, not only the exact accountPoint the Source at a leaf account, or review which child accounts sit under the selected parent
Journal is unbalanced and fails postingAdjustment DR/CR accounts not configuredConfigure Account Adjust DR and Account Adjust CR at header level
Simulation shows amounts but no journal createdSimulation parameter left as YesRerun the process with Simulation set to No
Generated journal fails to completeAccounting period closed or invalid Document ActionConfirm the accounting period is open before processing

Next Steps

  • Confirm the GL Journal Document Type and numbering sequence.
  • Review Chart of Accounts structure, since Sources match entire account subtrees.
  • Verify GL Category setup used for reporting segmentation.
  • Check Period Control status before running the process each month.
  • Open the GL Journal window to review and post generated entries.