man LedgerSMB::DBObject::EOY (3): End of Year handling module

SYNOPSYS

This class contains methods for end of year entry.

end_date specifies the end date for a closed period.
reference specifies the gl reference field associated with the account closure
description specifies the gl description field associated with the account closure
retention_acc_id specifies the account id used as a retaining account.

$eoy->checkpoint_only();: This creates account checkpoints at $eoy->{end_date}. This has two uses: 1) Can be used to ``close'' books without zeroing income/expense accounts. This prevents data from being inserted for earlier dates.
2) This can be used to improve performance by creating a ``lookback'' point.
$eoy->reopen_books(): This reverses any end of year transaction on $eoy->{reopen_date}, and deletes checkpoints later than that and creates a checkpoint for the prior day.
$eoy->latest_closing(): Needs no properties set (other than internal private ones). Retrieves the latest closing date and returns it.
$eoy->close_books(): Requires all properies in BASIC PROPERTIES to be set. This creates a gl yearend transaction, and moves income/expenses to the selected equity account for retained earnings.
$eoy->list_earnings_accounts: Returns a list of equity accounts, and sets $eoy->{earnings_accounts} to a list of hashrefs. These are used to select retained earnings accounts in closing books.