Prepare Dividend Distribution
prepare_dividend_packageCalculate dividend corporate income tax under Estonian rules and draft corresponding journal entries, ensuring compliance with retained earnings and net asset requirements.
Instructions
Calculate dividend CIT (22/78 from 2025-01-01; earlier dates date-gated) and create draft journal entries. Only the NET dividend debits retained earnings (Jaotamata kasum); the CIT books as a current-period income-tax expense (P&L 'Tulumaks' line), never a direct reduction of retained earnings — so the ENTIRE retained-earnings balance is distributable as net dividend (ÄS § 157 lg 1). Hard-blocks a net dividend exceeding retained earnings, or a distribution whose gross effect (net + CIT) would push net assets below share capital + restricted reserves (ÄS § 157 lg 2), unless force=true. Reports max_net_dividend. Requires an approved annual report and a profit-distribution decision — attach the decision to the journal with attach_document.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| force | No | Create journal even if retained earnings are insufficient (default false) | |
| dry_run | No | Preview calculation and postings without creating journal (default false) | |
| net_dividend | Yes | Net dividend amount to shareholder (EUR) | |
| effective_date | Yes | Distribution date (YYYY-MM-DD) | |
| tax_payable_account | No | Dividend income-tax payable (liability) account (default: auto-detect 'Dividenditulumaksu võlg', standard 2656) | |
| share_capital_account | No | Share capital account for ÄS §157 net-assets check (default: auto-detect 'Osakapital', standard 2900) | |
| shareholder_client_id | Yes | Shareholder client ID | |
| dividend_payable_account | No | Dividend payable account (default: auto-detect 'Dividendivõlad', standard 2650) | |
| retained_earnings_account | No | Retained earnings account debited with the NET dividend (default: auto-detect 'jaotamata kasum', standard 2960) | |
| income_tax_expense_account | No | Income-tax expense account debited with the CIT — the P&L 'Tulumaks' line (default: lowest Kulud account in 8900–8999, else 8900) | |
| restricted_reserve_accounts | No | Accounts whose balances ÄS §157(2) makes non-distributable (net assets must stay above share capital + these reserves). Default: auto-detect every 'Kohustuslik reservkapital' account (active or inactive) AND always the standard reserve number 2940, so a funded-but-renamed 2940 is never missed; only booked balances raise the floor, so unfunded accounts add nothing. If your chart has REPURPOSED 2940 to a distributable reserve, pass this list explicitly (e.g. [] for no floor, or your real reserve account) to override the 2940 default. |