# Tools & Assistants

&app; offers many specialized Tools. These tools enable access to the enhanced functionality of &app;. They are accessed via the Tools menu from any window that displays the &app; standard menu. Some of these tools may be deactivated for several reasons:

- the tools is not appropriate for the current window,

- the required software is not found on your system,

- the package maintainer disabled it in the build process.

## Find Dialogs

The &app; Find dialog can be used to find transactions or to perform business related research on your data file.

### Find Transaction

Find Transaction is used to search for transactions in &app; and display the results in a General Journal type tab. To open the Find Transaction dialog in you can type the keyboard shortcut Ctrl F or from the main menu use Edit Find... .

Search results differ depending on the tab from which you open it. Aside from the transaction fields Description, Number, Notes, and Date Posted, all of the searchable fields are part of individual splits, and splits are associated with a single account. When you open the Find Transactions dialog from an account register tab only the splits associated with that register will be searched. There is one exception, the All Accounts item, see the footnote about it in table below. For the transactions fields only transactions linked to a split in that register are inspecected and for the rest only the split attached to that account is, with one exception, All Accounts. If you filter the transactions in a register using View Filter By... , then only transactions in that account and shown by the filter will be searched. If you start from the Accounts page or a General Journal register then all splits in all applicable transactions (in the latter case those included in the register) are inspected.

The first row of the Find Transaction dialog indicates that you are performing a Split Search.

There are two panes in the Find Transaction dialog. The top pane contains the Search Criteria buttons and the bottom pane contains the Type of Search selection.

There are two buttons in the top of the Search Criteria pane. The left button allows you to Add another criteria row to search for multiple criteria. The existing criteria row needs to be completed before adding a new row. The right button is used to Search for items where all criteria are met or Search for items where any criteria are met. The all criteria are met search requires all of the criteria rows to have at least one match. The any criteria are met search requires only one of the criteria rows to be matched.

The criteria row in the Search Criteria pane is used to combine different criteria buttons (see table for a comprehensive list of combinations)

In the Type of Search pane there are five selections. The first option is always enabled, the following three are available when you invoke the Find... option from a register window or after performing the first Find if the Find... command was invoked from any other window. The last option is available only for Business search.

New Search

  Perform a new transaction search

Refine current search

  Search within the results of the previous search

Add results to current search

  Search based on the first set of criteria or the new criteria

Delete results from current search

  Discard any results that match the previous search results

Search only active data

  Search only if data are marked as active. This selector is greyed out for the Split Search as it is meaningful only for business related search

When selecting search criteria keep in mind that criteria are applied to individual splits or fields in transactions, and that the entire transaction is included in the results. There is no visual indication in the results to indicate which split or field met the search criteria.

Once you've set the search criteria, you can press the Find button. You will be presented with the search results in a new register tab. A report of the search results may created and printed using Reports Account Report . The Account Report has limited formatting options but, like all &app; reports, being in html format, can be copied and pasted into a spreadsheet for further formatting. Alternatively, the Account Report can be exported to an html file, and the html file may be opened in a spreadsheet.

Press the Close button to close the Find Transaction dialog.

Search criteria buttons - Split Search

Button 1 | Button 2 | Button 3 | Button 4 | Button 5 | Button 6 | Button 7 | Button 8
--- | --- | --- | --- | --- | --- | --- | ---
Description The Description, Number, Notes, and Date Posted fields belong to the transaction, all other searchable fields are part of individual splits. | contains | Criteria entry field | Is entry Case Insensitive? | Remove row |  |  |
matches regex regex means regular expression text search as used in various computer programs such as Perl
does not match regex
Notes | contains | Criteria entry field | Is entry Case Insensitive? | Remove row |  |  |
matches regex
does not match regex
Memo | contains | Criteria entry field | Is entry Case Insensitive? | Remove row |  |  |
matches regex
does not match regex
Description, Notes, or Memo Searches for a term in the transaction's Description and Notes fields and the Split's Memo field. | contains | Criteria entry field | Is entry Case Insensitive? | Remove row |  |  |
matches regex
does not match regex
Number | contains | Criteria entry field | Is entry Case Insensitive? | Remove row |  |  |
matches regex
does not match regex
Action | contains | Criteria entry field | Is entry Case Insensitive? | Remove row |  |  |
matches regex
does not match regex
Reconciled Date | is before | Date selection field | Remove row |  |  |  |
is before or on
is on
is not on
is after
is on or after
Date Posted | is before | Date selection field | Remove row |  |  |  |
is before or on
is on
is not on
is after
is on or after
Value | has credits or debits | less than | Amount entry field | Remove row |  |  |
less than or equal to
equal to
not equal to
greater than
greater than or equal to
has credits | less than
less than or equal to
equal to
not equal to
greater than
greater than or equal to
has debits | less than
less than or equal to
equal to
not equal to
greater than
greater than or equal to
Shares | is less than | Amount entry field | Remove row |  |  |  |
is less than or equal to
equals
does not equal to
is greater than
is greater than or equal to
Share Price | is less than | Amount entry field | Remove row |  |  |  |
is less than or equal to
equals
is not equal to
is greater than
is greater than or equal to
Reconcile The Reconcile option applies the selected criteria to each line of a transaction individually. Each transaction line may have only one of the indicated values, but there is often a mix of values within a complete transaction, so companion lines may not meet the selected criteria. See separate note defining status values. For a detailed description of transaction statuses see | is | Not Cleared | Cleared | Reconciled | Frozen | Voided | Remove row
is not
Closing Entries The Closing Entries selection will find transactions whose split is marked as a closing entry by Tools Close Book . | Check for true | Remove row |  |  |  |  |
Balanced Balanced finds transactions that are or are not balanced. Since &app; nearly always succeeds in balancing transactions this will almost always return all possible transactions. However it is possible to create a transaction containing multiple commodities that cannot be balanced and unchecking the box will find those transactions. | Check for true | Remove row |  |  |  |  |
Account When the Find Transactions dialog is started from the Accounts tab or a General Journal register the Account option performs a search where the accounts selected in the Choose Accounts dialog will both be searched individually for results. This means that a match in any of the selected accounts will either be displayed (matches any account) or discarded (matches no account). If the FindTransactions dialog is started in a regular account register and the current account is selected return all of the transactions or if it is not, no transactions. | matches any account | Choose Accounts | Remove row |  |  |  |
matches no accounts
All Accounts The All Accounts option performs a search where accounts selected in the Choose Accounts dialog will return transactions containing at least one split in every one of the accounts chosen. When run from a regular account register this is the only criterion that will inspect splits from other accounts so if you start the Find Transactions dialog from your Assets:Current Assets:Checking register and want to find all of the transactions in that account with a split in Expenses:Groceries, this is the criterion to use. Keep in mind, though, that it's an "and" search: If you also include Expenses:Misc it will find only those transactions with a split in each of the two, not transactions with a single split in either of them. | matches all accounts | Choose Accounts | Remove row |  |  |  |

#### Explanations of the Criteria

The Reconcile criterion deserves some more explanation. Think of the selected reconciliation status buttons (Not Cleared, Cleared, and so on) as a single group, joined with a logical or. In other words, the selection is or is not applies to the or of the selected status buttons. The buttons which are left unselected are simply ignored. (It’s not the same as saying the reconciliation status must not be one of these.)

For example: if you select Reconcile is Cleared Reconciled, that means you’re saying I want all transactions which contain cleared splits OR reconciled splits (imagine an invisible OR between all the selected status buttons). It’s the same as selecting Reconcile is Cleared, then adding another search criterion with the Add button, then on the new line selecting Reconcile is Reconciled, and finally selecting Search for items where any criteria are met. In either case, &app; will show you exactly the same set of transactions.

### Find Customer, Invoice, Job, Vendor, Bill, Employee, Expense Voucher

The business find assistant is used to search for business related items (Customer, Invoice, Job, Vendor, Bill, Employee, Expense Voucher). To open the business search dialog select the desired item to Find from the Business Customer/Vendor/Employee submenus.

The titlebar and the first row of the assistant dialog reports the item type you are searching for: Customer, Invoice, Job, Vendor, Bill, Employee, Expense Voucher.

There are two panes in the Find dialog. The top pane contains the Search Criteria buttons and the bottom pane contains the Type of Search selection.

#### Search Criteria section

There are two buttons in the top of the Search Criteria pane. The left button allows you to Add another criteria row to search for multiple criteria.

The existing criteria row needs to be completed before adding a new row.

The right button is used to Search for items where all criteria are met or Search for items where any criteria are met. The all criteria are met search requires all of the criteria rows to have at least one match. The any criteria are met search requires only one of the criteria rows to be matched.

The criteria row in the Search Criteria pane is used to combine different criteria buttons (see tables , , , , , for a comprehensive list of combinations)

#### Type of Search section

In the Type of Search pane there are five selections. The first and alst options are always selectable while the following three are available only when you perform the first search by setting some search criteria and pressing the Find button.

New Search

  Perform a new search

Refine current search

  Search within the results of the previous search

Add results to current search

  Search based on the first set of criteria or the new criteria

Delete results from current search

  Discard any results that match the previous search results

Search only active data

  Search only if data are marked as active.

#### The rest of the search dialog

When search criteria are selected, you can press the Find button. You will be presented with the list of search results in the same Find dialog.

Aside from the results, &app; gives you some buttons to manage the highlighted result.

In the bottom right of the Find dialog there is a button that allows you to create a New business item.

Press the Close button to close the Find assistant dialog.

#### List of search criteria buttons

Search criteria buttons - Customer Search

Button 1 | Button 2 | Button 3 | Button 4 | Button 5 | Button 6 | Button 7 | Button 8
--- | --- | --- | --- | --- | --- | --- | ---
Company Name | contains | Criteria entry field | Is entry Case Insensitive? | Remove row |  |  |
matches regex
does not match regex
Customer ID | contains | Criteria entry field | Is entry Case Insensitive? | Remove row |  |  |
matches regex
does not match regex
Billing Contact | contains | Criteria entry field | Is entry Case Insensitive? | Remove row |  |  |
matches regex
does not match regex
Shipping Contact | contains | Criteria entry field | Is entry Case Insensitive? | Remove row |  |  |
matches regex
does not match regex

Search criteria buttons - Invoice Search

Button 1 | Button 2 | Button 3 | Button 4 | Button 5 | Button 6 | Button 7 | Button 8
--- | --- | --- | --- | --- | --- | --- | ---
Invoice ID | contains | Criteria entry field | Is entry Case Insensitive? | Remove row |  |  |
matches regex
does not match regex
Company Name | contains | Criteria entry field | Is entry Case Insensitive? | Remove row |  |  |
matches regex
does not match regex
Date Opened | is before | Date selection field | Remove row |  |  |  |
is before or on
is on
is not on
is after
is on or after
Is Posted? | is | set true | Remove row |  |  |  |
is not
Date Posted | is before | Date selection field | Remove row |  |  |  |
is before or on
is on
is not on
is after
is on or after
Is Paid? | is | set true | Remove row |  |  |  |
is not
Billing ID | contains | Criteria entry field | Is entry Case Insensitive? | Remove row |  |  |
matches regex
does not match regex
Invoice Notes | contains | Criteria entry field | Is entry Case Insensitive? | Remove row |  |  |
matches regex
does not match regex
Invoice Owner | is | Customer | Criteria entry field | Select... | Remove row |  |
Vendor
Employee
Job
is not | Customer
Vendor
Employee
Job

Search criteria buttons - Job Search

Button 1 | Button 2 | Button 3 | Button 4 | Button 5 | Button 6 | Button 7 | Button 8
--- | --- | --- | --- | --- | --- | --- | ---
Job Name | contains | Criteria entry field | Is entry Case Insensitive? | Remove row |  |  |
matches regex
does not match regex
Job Number | contains | Criteria entry field | Is entry Case Insensitive? | Remove row |  |  |
matches regex
does not match regex
Billing ID | contains | Criteria entry field | Is entry Case Insensitive? | Remove row |  |  |
matches regex
does not match regex
Only Active? | is | set true | Remove row |  |  |  |
is not
Owner's Name | contains | Criteria entry field | Is entry Case Insensitive? | Remove row |  |  |
matches regex
does not match regex

Search criteria buttons - Vendor Search

Button 1 | Button 2 | Button 3 | Button 4 | Button 5 | Button 6 | Button 7 | Button 8
--- | --- | --- | --- | --- | --- | --- | ---
Company Name | contains | Criteria entry field | Is entry Case Insensitive? | Remove row |  |  |
matches regex
does not match regex
Vendor ID | contains | Criteria entry field | Is entry Case Insensitive? | Remove row |  |  |
matches regex
does not match regex
Billing Contact | contains | Criteria entry field | Is entry Case Insensitive? | Remove row |  |  |
matches regex
does not match regex

Search criteria buttons - Bill Search

Button 1 | Button 2 | Button 3 | Button 4 | Button 5 | Button 6 | Button 7 | Button 8
--- | --- | --- | --- | --- | --- | --- | ---
Bill ID | contains | Criteria entry field | Is entry Case Insensitive? | Remove row |  |  |
matches regex
does not match regex
Company Name | contains | Criteria entry field | Is entry Case Insensitive? | Remove row |  |  |
matches regex
does not match regex
Due Date | is before | Date selection field | Remove row |  |  |  |
is before or on
is on
is not on
is after
is on or after
Date Opened | is before | Date selection field | Remove row |  |  |  |
is before or on
is on
is not on
is after
is on or after
Is Posted? | is | set true | Remove row |  |  |  |
is not
Date Posted | is before | Date selection field | Remove row |  |  |  |
is before or on
is on
is not on
is after
is on or after
Is Paid? | is | set true | Remove row |  |  |  |
is not
Billing ID | contains | Criteria entry field | Is entry Case Insensitive? | Remove row |  |  |
matches regex
does not match regex
Bill Notes | contains | Criteria entry field | Is entry Case Insensitive? | Remove row |  |  |
matches regex
does not match regex
Bill Owner | is | Customer | Criteria entry field | Select... | Remove row |  |
Vendor
Employee
Job
is not | Customer
Vendor
Employee
Job

Search criteria buttons - Employee Search

Button 1 | Button 2 | Button 3 | Button 4 | Button 5 | Button 6 | Button 7 | Button 8
--- | --- | --- | --- | --- | --- | --- | ---
Employee Name | contains | Criteria entry field | Is entry Case Insensitive? | Remove row |  |  |
matches regex
does not match regex
Employee Username | contains | Criteria entry field | Is entry Case Insensitive? | Remove row |  |  |
matches regex
does not match regex
Employee ID | contains | Criteria entry field | Is entry Case Insensitive? | Remove row |  |  |
matches regex
does not match regex

Search criteria buttons - Expense Voucher Search

Button 1 | Button 2 | Button 3 | Button 4 | Button 5 | Button 6 | Button 7 | Button 8
--- | --- | --- | --- | --- | --- | --- | ---
Voucher ID | contains | Criteria entry field | Is entry Case Insensitive? | Remove row |  |  |
matches regex
does not match regex
Employee Name | contains | Criteria entry field | Is entry Case Insensitive? | Remove row |  |  |
matches regex
does not match regex
Due Date | is before | Date selection field | Remove row |  |  |  |
is before or on
is on
is not on
is after
is on or after
Date Opened | is before | Date selection field | Remove row |  |  |  |
is before or on
is on
is not on
is after
is on or after
Is Posted? | is | set true | Remove row |  |  |  |
is not
Date Posted | is before | Date selection field | Remove row |  |  |  |
is before or on
is on
is not on
is after
is on or after
Is Paid? | is | set true | Remove row |  |  |  |
is not
Billing ID | contains | Criteria entry field | Is entry Case Insensitive? | Remove row |  |  |
matches regex
does not match regex
Voucher Notes | contains | Criteria entry field | Is entry Case Insensitive? | Remove row |  |  |
matches regex
does not match regex
Voucher Owner | is | Customer | Criteria entry field | Select... | Remove row |  |
Vendor
Employee
Job
is not | Customer
Vendor
Employee
Job

## Since Last Run Assistant

The Since Last Run assistant is run automatically when &app; is started. It is used to enter into the register any transactions that are due to be automatically entered (see ). The run on &app; start can be altered in the Scheduled Transactions tab of the &appname; Preferences. To run the Since Last Run assistant manually, go to Actions Scheduled Transactions Since Last Run...

In the Since Last Run assistant window you can see three columns:

Transaction

  The name assigned in the Scheduled Transaction Editor that identifies the scheduled transaction.

State

  The state column of the scheduled transaction can be one of the following:

  Click on the state field in the row of a transaction to change its state (this option is available only if the state field is not empty)

  Ignored

    If a scheduled transaction is being displayed, either to be created or as a reminder, the user can set the status to Ignored to skip this event. The scheduled transaction will not be entered in the register and the next reminder for this scheduled transaction will be the next occurrence. For instance, if you have a scheduled transaction set up with a reminder to transfer $500 at the end of the month to your savings account but you bought yourself a computer this month and don’t have the money for this month’s transfer then you would set the status to Ignored.

  Postponed

    If a scheduled transaction has been listed with a status To-create but you want to hold it and not have it entered to your register yet, then you can set it to Postponed. When at some later time you change it back to To-create it will be created with the original posted-date. If you want to change that you must edit the transaction after it's created.

  Reminder

    You are n days from the scheduled transaction due date. The number of days n to remind in advance, is set either in the &appname; Preferences Scheduled Transactions tab or in the Overview tab of the Scheduled Transaction Editor.

  To-create

    This scheduled transaction will be automatically created when you press OK.

  Empty

    An empty field means that no operations are pending for the scheduled transaction.

At the bottom of the window there are two buttons:

- The Cancel button is used to exit the Since Last Run window without creating the transactions scheduled to be entered.

- The Ok button closes the Since Last Run window and applies the pending operations.

At the bottom right of the Since Last Run window there is also an option that allows to Review created transactions. If this option is enabled when there are one or more transactions To-create, pressing OK will open a register window in which are shown the details of the scheduled transactions splits entered automatically by &app;.

## Mortgage & Loan Repayment Assistant

This assistant creates a loan repayment scheduled transaction. When used to setup a scheduled transaction, the assistant creates a variable formula so that the compounding interest is correctly calculated. To start this assistant manually go to Actions Scheduled Transactions Mortgage and Loan Repayment... .

It does not support zero-interest loans, but one doesn't really need an assistant for that: Just create a scheduled transaction for the principal divided by the number of payments that lasts for the number of payments. For example, if one has borrowed $1200 for a year at no interest and promised to pay it back in monthly installments, the repayment schedule is $100 monthly for twelve months.

The Mortgage and Loan Repayment assistant opens with a screen that briefly describes what this assistant does. The three buttons at the very bottom of the screen will not change while using the assistant.

- The Cancel button is used to exit the assistant and cancel creating the scheduled transaction. Any selections you have made in this assistant up to this point will be lost.

- The Back button will bring up the previous screen so you can change a selection made on that screen.

- The Forward button will bring up the next screen so you can continue though the assistant.

The next screen allows you to enter the basic loan information. This is usually the information provided by the bank when loan and disclosure documents are given to the borrower. Here you can also setup an account that the scheduled transaction will use to enter the payment transaction.

- Loan Account Choose an account for the loan payment transactions or use New... to setup a new account for the transactions.

- Loan Amount Enter the amount of the loan.

- Interest Rate Enter the loan interest rate in percent per compounding period. The Assistant supports rates between .001% and 100%.

- Type Choose the type of loan. If an adjustable rate is used the frequency screen is enabled.

- Interest Rate Change Frequency Choose the frequency for the rate change and the start date of the rate change.

- Start Date Choose the date the loan is starting on.

- Length Enter the length of the loan with the number and period, e.g. 60 months or 5 years.

- Months Remaining This tells the Assistant how many months remain on the loan. The default value assumes that the loan is paid up through today. For example, if a 5-year loan started on 1 January 2012 and today is 12 July 2015, the default months remaining is 18. If you want to create past payment transactions you'll set the months remaining accordingly: In our example, if you wanted to create all of the payments you'd set "months remaining" to 60; if you wanted to start tracking the payments at the beginning of 2015 you'd enter 24.

The next screen is used to set escrow, insurance and tax options for the loan. It is mainly used for mortgage payments. When each of the options here is set, this enables additional pages in the assistant to setup those portions of the payments. All of the pages will be described here, even though some may not show if that option is not chosen.

- ... utilize an escrow account for payments?: This selection enables the use of an account setup for tracking escrow payments. If the mortgage or loan uses an escrow account to pay taxes, insurance, etc then setup an account here.

- ... pay "Taxes"?: adds an additional page to setup a scheduled transaction to pay taxes.

- ... pay "Insurance"?: adds an additional page to setup a scheduled transaction to pay insurance payments.

- ... pay "PMI"?: adds an additional page to setup a scheduled transaction to pay PMI payments.

- ... pay "Other Expense"?: adds an additional page to setup a scheduled transaction to pay other expenses.

The next screen is used to setup the details of the scheduled transaction for the Loan Repayment.

- Transaction Memo: The name entered here will be used as the name for the scheduled transaction, the description of the scheduled transaction and the memo.

- Payment Amount: Shows the variable used to calculate the payment amount.

- Payment From: Choose an account to pay the loan amount from.

- Principal To: Choose an account to transfer the principal part of the loan to.

- Interest To: Choose an account to transfer the interest part of the loan to.

- Repayment Frequency: Select the Frequency and start date for loan repayments. Note that the start date will be the posted date of the first scheduled transaction. This is not taken into account for calculating the remaining duration of the loan, see Months Remaining. Make sure that you set both to reflect your intentions or you may get surprising results.

The next screen is used to setup the details of the scheduled transaction for the Tax payment.

- Transaction Memo: The name entered here will be used as the name for the scheduled transaction, the description of the scheduled transaction and the memo.

- Amount: Enter the payment amount.

- Payment From: Choose an account to pay the tax amount from.

- Payment To: Choose an account to transfer the tax payment to.

- Repayment Frequency: Select the Frequency and start date for tax payments.

The next screen is used to setup the details of the scheduled transaction for the Insurance payment.

- Transaction Memo: The name entered here will be used as the name for the scheduled transaction, the description of the scheduled transaction and the memo.

- Amount: Enter the payment amount.

- Payment From: Choose an account to pay the insurance amount from.

- Payment To: Choose an account to transfer the insurance payment to.

- Repayment Frequency: Select the Frequency and start date for insurance payments.

The next screen is used to setup the details of the scheduled transaction for the PMI payment.

- Transaction Memo: The name entered here will be used as the name for the scheduled transaction, the description of the scheduled transaction and the memo.

- Amount: Enter the payment amount.

- Payment From: Choose an account to pay the PMI amount from.

- Payment To: Choose an account to transfer the PMI payment to.

- Repayment Frequency: Select the Frequency and start date for PMI payments.

The next screen is used to setup the details of the scheduled transaction for the Other Expense payment.

- Transaction Memo: The name entered here will be used as the name for the scheduled transaction, the description of the scheduled transaction and the memo.

- Amount: Enter the payment amount.

- Payment From: Choose an account to pay the other expense amount from.

- Payment To: Choose an account to transfer the other expense payment to.

- Repayment Frequency: Select the Frequency and start date for other expense payments.

The last screen gives you a list of three choices to finish the assistant.

- The Cancel button is used to exit the assistant and cancel creating a new loan scheduled transaction. Any selections you have made in this assistant up to this point will be lost.

- The Back button will bring up the previous screen so you can change a selection made on that screen.

- The Finish button creates the scheduled transaction.

You should now have the Mortgage or Loan Repayment scheduled transaction setup.

## Stock Transaction Assistant

While with practice you can quickly enter any stock transaction directly in the register as explained in the Investments chapter in the guide, &app; provides an assistant that can help walk you through most common transactions and several less common ones that you might encounter.

The assistant is accessed from the Action menu when the current register is for a Stock or Mutual Fund account.

Types of stock transactions supported by the Stock Transaction Assistant

- Buy

- Sell

- Dividend

  This is for cash dividends; use Stock Split for share dividends.

  The assistant does not support recording reinvested dividends in a single transaction. If you reinvest dividends, even if it's done automatically by your broker, mutual fund company, or the issuer of the shares, you must record the share purchase with a second pass through the assistant.

- Return of Capital

- Notional Distribution

- Stock Split

- Reverse Split

The assistant recognizes long and short positions in the account and adjusts pages it presents to you depending on the transaction type and whether the position is long or short. It optionally capitalizes commissions and fees.

### Transaction Details Page

Enter the transaction post date and description on this page.

### Transaction Type Page

Select the type of transaction from the list. The assistant will display a description of what it will do when you make a selection.

### Stock Amount Page

This page is displayed for Buy, Sell, Stock Split, and Reverse Split transactions to collect the new share information. For a Buy or Sell it will display the current share balance, ask for the number of shares traded, and once that's entered it will display the new share balance. For a Stock Split or Reverse Split it will ask for the new balance after the split and display the split ratio.

### Stock Value Page

Displayed for Buy and Sell to collect the value of the shares bought or sold net of commissions and fees, which are collected on another page. For example if you sell 100 shares of stock for $10.00 per share with a 2% commission and a $10.00 SEC fee the net value for this page is $1000.00.

### Cash Page

Displayed for all transaction types.

Enter the asset account to or from which the money for the transaction will go.

Only asset accounts denominated in the stock account's currency—that of the nearest parent account denominated in currency—will be offered. The stock assistant does not support multi-currency stock trading.

For a stock split or reverse split this entry is only to balance any fees entered on the following page. Any cash in lieu of fractional units must be recorded as a separate sell or cover-buy transaction.

Enter the gross amount of the transaction including commissions and fees. In the example from the Stock Value Page that would be $970.00: $1000.00 for the stock less $20 for the 2% commission and the $10.00 fee. Had it been buy you would have added the commission and fees to the amount.

There is a field for you to enter a memo on the cash split. It defaults to Cash.

### Fees Page

Displayed for all transactions. There is a checkbox to select whether the fees will be incorporated into the value of the stock split (capitalized) or separately credited to an expense account.

If the amount is to be expensed select the account. Expense acconts will be offered and there's a button to create a new one.

Amount: Enter the total of any commissions, fees, or taxes on the transaction.

There's only one amount and one account. If you want separate accounts for say commissions and taxes, enter the total and one of the accounts here and then edit the transaction afterwards to create the extra splits.

As with the Cash Page there's a memo field for this split's memo.

### Dividend Page

Displayed only for Dividend transactions. Select or create an income account and enter the gross amount of the dividend. There's a memo field as usual.

### Capital Gains Page

Displayed only for Sell of a long position or Buy of a short position. As with the Dividend Page select an income account for the capital gain or create a new one, enter the amount of the gain—losses should be entered as a negative amount—and optionally edit the memo for the capital gain split.

The assistant doesn't do any calculating for you: It's up to you to determine the basis by whatever strategy you choose subject to the tax laws in your jurisdiction and to compute the difference between the basis and the proceeds.

If you prefer to use the View Lots dialog to compute capital gains/losses you should leave the Amount field in this page blank.

### Finish Page

The final page displays a list of the splits the assistant will create along with errors that would prevent the transaction from being complete. If there are errors the Apply button will be disabled. You must use the Back button to navigate to the appropriate page and correct the error. Once all of the errors are resolved click the Apply button to create the transaction.

The assistant provides a Finish button to move to the Finish Page from any other.

## Online Banking Setup Assistant

The Online Banking Setup Assistant is used to create or edit the configuration to enable interaction with your bank. For this purpose the package AqBanking is used. It contains several modules with different abilities. Their availability depends on the region. But all can fetch the current balance and recent transactions.

AqBanking Supported Protocols

Module | Send Orders | Region | Notes
--- | --- | --- | ---
EBICS | Yes | AT, CH, DE, FR | Usually available for business customers.
FinTS | DE | Submodules: HBCI, PIN/TAN.
OFX DirectConnect | No | US If you know about banks in other countries, update the wiki table. | Not to confuse with OFX WebConnect!
PayPal | intl. |

If Online Banking Setup does not appear in your Tools menu, verify that you are in an Account Tree or Register tab.

The currently available instructions are still kept in the &app; wiki and depend on the used module:

EBICS

  No users shared their experience util now.

FinTS

  This module is only documented in German. Overview , usage of the , and details of the different methods.

OFX DirectConnect

  Instruction for this process are in English at .

PayPal

  This module is only documented in German .

## Price Editor

&app; uses the term commodity to mean anything that it counts: Currencies, securities (i.e intangible assets like stock or mutual fund shares and bonds), or tangible assets like trucks and computers. When valuing one commodity in terms of another it uses the term Exchange Rate between two currencies and Price between a non-currency commodity and a currency commodity. For the rest of this section we'll use "price" to mean both price and exchange rate and "commodity" to mean any sort of commodity except where currency behavior is different.

The Price Editor is used to list and edit the price of one commodity in another commodity. New prices can be added, existing prices can be edited, and prices can be retrieved from a variety of sources on the World-Wide Web when the commodity is properly configured.

Each commodity pair can have one price per day. An existing price will be overwritten by a newer one if the newer one has the same or a more preferred source. The order of source preference (1 is most preferred) is:

1. user:price-editor: Prices created manually in the Price Editor

2. Finance::Quote: Online quotes

3. user:price: Prices entered explicitly in the Exchange Rateentry of the Transfer Funds dialog box or in the Price column of a register for an account of types STOCK or MUTUAL

4. user:xfer-dialog: Prices calculated from an entry in the To Amount entry of the Transfer Funds dialog box.

5. user:split-register: Prices calculated from the Shares and Debit or Credit columns of a register for an account of types STOCK or MUTUAL

6. user:stock-split: Prices entered in the Stock Split Assistant

Prices created manually in the Price Editor are preferred over prices retrieved via Finance::Quote so Finance::Quote will fail to update such manually-created prices.

The Price Editor displays existing prices as follows:

- Security: The Security/commodity being priced. The display is sorted by the Namespace that the individual securities are listed on. The list is expanded by clicking on the caret on the left of the name.

- Currency: The currency the price is recorded in.

- Date: The date the price was recorded.

- Source: The source of the commodities price quote, listed above.

- Type: There are several different types of stock price quotes.

  - Bid: Indicates what a specialist dealer is prepared to pay for a stock.

  - Ask: Indicates at what price the dealers are prepared to sell a stock.

  - Last: Indicate the price at which the last trade in that stock/security occurred at. This is the price most commonly quoted in the media.

  - Net Asset Value: Are typically used for mutual funds. They are calculated on the net value of the fund’s assets each day around the time of the market close and are in effect until the next recalculation.

  - Unknown: Use this if the type of price quoted is not known.

- Price: The actual price of the commodity.

### Adding a stock price manually

To add a new price, click on Add, and enter the details of the security and price into the dialog box. To edit an existing price, select the price in the price list, click the Edit button, and edit the figures.

To remove just one price, select the price and click the Remove button. If you want to remove all prices older than a certain date, click on the Remove Old button and enter the details in the dialog box.

A pop-up will display with the message "Delete all stock prices based upon the criteria below:". Enter the date of the last price you wish to delete.

Two check-boxes are below the date field;

- Delete manually entered prices - If checked, delete manually entered stock prices dated earlier than the specified date. Otherwise only stock prices added by Finance::Quote will be deleted.

- Delete last price for a stock - If checked, delete all prices before the specified date. Otherwise the last stock price dated before the date will be kept and all earlier quotes deleted.

### Configuring for use of the Get Quotes button

To support on-line quotations for a particular stock or mutual fund account, you must first enable on-line price quoting and select a price source in the Security. This is described in detail in . Once on-line quotes are enabled, and Finance::Quote is installed, you can update prices for your stocks and mutual funds manually by clicking the Get Quotes button.

## Security Editor

The Security Editor is used to create and edit commodities that are used by mutual fund and stock type accounts. It also shows the details of National Currencies that are used by &app;.

To show the details for National Currencies click the Show National Currencies check-box at the bottom of the screen.

Each entry in the editor shows the details used by the security/currency:

- Full name: The full name of the commodity is a recognizable name such as US Dollars or IBM Common Stock.

- Symbol/abbreviation: Indicates the symbol or abbreviation for the commodity. This is usually the ticker symbol (for stocks) or other unique abbreviation for the commodity. If the commodity is traded on any public exchange, it is important to use the same identifier used on that exchange. For national currencies the symbol is the ISO-4217 currency code.

- Display symbol: This optional field allows the user to specify a symbol to use in the GUI display. It's primarily there to allow users to override the hard-coded symbol for currencies but it might also be useful for displaying a different symbol from the one used to retrieve price quotes.

- Namespace: An optional field to allow you to create categories for your securities. You may use any string you like except Currency and Template: Those are reserved for &app;'s use.

- ISIN, CUSIP, or other code: This optional entry may be any informative code for the commodity. If present it is used only for display. An ISIN or International Security Identification Number is associated with every stock, bond or mutual fund, and most kinds of traded options, futures and commodities. CUSIP (Commitee on Uniform Securies Identification Procedures) is a similar code used in the North America. Other regions have similar codes, for example Germany's WKN (Wertpapierkennnummer).

- Fraction traded: This is the smallest traded unit of the commodity, expressed as a fraction of a single nominal unit. &app; rounds entered and calculated amounts and values to this fraction.

### Adding or Editing a Commodity

To add a new commodity (stock, or mutual fund), click on Add, and enter the details of the commodity into the New Security dialog box. To edit an existing commodity, select the commodity from the Commodities list, click the Edit button, and edit the Edit Security dialog box. To remove a commodity, select the commodity and click the Remove button.

The fields in the New/Edit Security screens are the same as defined for the Security Editor . Below these fields are the options for Online Quotes.

### Configuring Securities/Currencies for On-Line Retrieval of Prices

To support on-line quotations for a particular stock or mutual fund account, you must first enable on-line price quoting and select a price source in the Security Editor. Online currency quotes require only that the check-box for Online quotes and the timezone be selected, and that the Get Quotes box be checked in the Security Editor.

Detailed instructions are in the section on Creating New Accounts.

## Loan Repayment Calculator

The Loan Repayment Calculator is used to calculate compound interest. It provides a way of entering four of the five parameters of a compound interest calculation and then calculating the remaining figure.

The calculator is split into two panes. The left pane has five fields with a Calculate button and a Clear button. The Calculate button is used to select the figure to calculate. The Clear button is used to clear any amount in the field.

- Payment Periods: This field is used to select the number of payments you wish to use in the calculation.

- Interest Rate: This field is used for the interest rate percentage.

- Present Value: This field usually contains the amount you have borrowed. It is the base amount you wish to compound.

- Periodic Payment: This field contains the amount that is the payment for the period selected (IE monthly, weekly, etc). If it is for repaying a loan it should be a negative number.

- Future Value: This field contains the final value at the end of the periods above. If we are repaying a loan in full it would be 0.

The right pane contains buttons to select what sort of payments and compounding is used for the left pane calculations.

- Compounding: This button allows you to select the interval used if the Discrete Compounding button is selected.

- Payments: This button allows you to select the interval used for the Payment Periods field.

- End of Period Payments: Use this button if the payment is at the end of the period.

- Beginning of Period Payments: Use this button if the payment is at the beginning of the period.

- Discrete Compounding: This button is used where interest is charged at a discrete interval defined by the Compounding button above.

- Continuous Compounding: This button is used when the interest is charged continuously.

- Payment Total: This field shows the total amount paid.

Examples of using the Loan Repayment Calculator are given in the Tutorial and Concepts Guide. &app; Tutorial and Concepts Guide’s Chapter on Loans

## Close Book Tool

The Close Book dialog box is used for closing the books, an accounting process that resets the balances of the income and expense accounts. In this process, income account balances are transferred into an income equity account, while expense account balances are transferred into an expense equity account. You must specify both these accounts, which may be the same. You must also specify the date for the closing transfer.

### Dialog Box Details

The dialog box has the following parts:

- Closing Date Specify the date for the closing transfer. You can type in a date or choose one from the drop-down.

- Income Total Specify the account into which the total balance of all income accounts will be transferred. Optionally you can create a new account to receive the transfer using the New button.

- Expense Total Specify the account into which the total balance of all expense accounts will be transferred. Again, you can optionally create a new account to receive the transfer using the New button.

- Description Specify the description that will be entered in the closing entry.

### How It Works

&app; closes books by creating one transaction per currency for income accounts, and one transaction per currency for expense accounts. The transactions all use the date selected by the user, and each transaction may contain any number of splits. Each split moves the balance out of one income or expense account. The last split in each closing transaction moves the total offsetting debit/credit balance into the specified equity account.

Each transaction will use the description provided by the user in the Description entry.

The fact that &app; just uses transactions to close the books makes it very simple to undo a book closing: just delete the closing transactions.

### What It Doesn’t Do

The book closing tool does not delete any accounts or transactions; create any new files; or hide any accounts.

### Necessity

Note that closing the books in &app; is unnecessary. You do not need to zero out your income and expense accounts at the end of each financial period. &app;’s built-in reports automatically handle concepts like retained earnings between two different financial periods.

In fact, closing the books reduces the usefulness of the standard reports because the reports don’t currently understand closing transactions. So from their point of view it simply looks like the net income or expense in each account for a given period was simply zero.

### Conclusion

If you close your books, be prepared to see inaccuracies in the standard reports. On the other hand, you will see current-period income and expense figures in the chart of accounts.

## Lots Editor

&app; uses lots in 2 ways:

- To link security buy transactions to sell transactions so the real cost of the sold securities can be used to calculate capital gain or loss. See .

- To link payments or credit notes to the invoices to which they apply in the Business Features. See .

### Lots for Capital Gains of Securities

The Lots in Account Name window, where Name is the security account, is used to manually or automatically link security transaction splits to lots and create capital gain or loss transactions to account for the difference between the costs of buying a security and the value received by selling it.

To open the Lots in Account window, open the security account register, then select Actions View Lots .

Lots in Account window for Security Capital Gains

An image of the Lots in Account window for a security account.

#### Screen Elements

Adjusting the Size of Screen Elements

As well as adjusting the size of the whole window, it is possible to adjust the proportions of the window elements both horizontally and vertically.

There are 2 bars for adjusting the window horizontally. One between the Title and the Lots in This Account panel, and the other between the Splits free panel and the >> and << buttons.

The window proportions may be adjusted vertically by dragging the vertical bar located to the right of Show only open lots.

These resizing bars can be hard to see, so move the mouse pointer until it changes to the resize pointer then click and drag the bar. The resize pointers are different depending on your operating system and theme. Here are some examples of resize pointers:

<->

It is not possible to individually adjust the size of panel columns.

Fields

- Title Shows the title for the highlighted (selected) lot in the Lots in This Account panel. When a new lot is created by clicking the New Lot button, it has a default title of Lot n where n is a number starting at 0 (for each security account) and incrementing by 1. Deleting a lot does not reset the next number to be used, but the title can be changed as required.

- Notes Notes for the highlighted lot. Users are free to enter anything they wish and the notes can be changed as required.

Panels

The order of the items in all the panels in this window can be adjusted by clicking on the column headings.

- Lots in This Account panel

  This panel shows lots for this security account.

  If Show only open lots is checked, only lots that have not been completely sold are shown.

  Columns

  - Type Always blank for security lots. This window is also used for business lots (which link payments to invoices) when coming from an Accounts Payable or Receivable account and in that case, Type will be I for invoice. Credit Notes are also Type I.

  - Opened Open if there are no splits in the lot, otherwise the date of the earliest split in this lot.

  - Closed Open if the lot is not fully sold, otherwise the date of the last sell split.

  - Title Lot Title.

  - Balance Number of unsold securities in this lot.

  - Gains Calculated gains or losses for this lot.

- Splits free panel

  This panel shows buy and sell splits for this security account which are not linked to a lot. Capital Gains splits (Shares and Price are 0) are not shown.

  Columns

  - Date Transaction Date Posted.

  - Num Transaction Num.

  - Description Transaction Description.

  - Amount Number of shares bought or sold from the transaction split. Positive for buys, negative for sells. If the security transaction split has been split into multiple subsplits (because a split may only be linked to 1 lot), this amount will not be the full transaction amount, but only the amount for this split.

  - Value Amount x split price.

  - Gain/Loss For sell splits, shows calculated gain or loss. This will be recalculated during scrubbing.

  - Balance Cumulative number of unsold shares for free splits.

- Splits in Lot panel

  This panel shows splits linked to the highlighted lot in the Lots in This Account panel. This panel will be empty until a lot is highlighted in the Lots in This Account panel. Capital Gains splits (Shares and Price are 0) are not shown.

  Columns

  - Date Transaction Date Posted.

  - Num Transaction Num.

  - Description Transaction Description.

  - Amount Split number of shares bought or sold. Positive for buys, negative for sells. If the security transaction split has been split into multiple subsplits (say by scrubbing because a split may only be linked to 1 lot), this amount will not be the full transaction amount, but only the amount for this split.

  - Value Amount (No of Shares) x split price.

  - Gain/Loss For sell splits, shows calculated gain or loss. This will be recalculated during scrubbing.

  - Balance The number of unsold shares in this lot after this transaction.

Buttons

- >> Links a free split (buy or sell) to a lot. This button is not enabled until both a lot and a free split are highlighted. The split moves from the Splits free panel to the Splits in lot panel.

  Multiple buy splits and multiple sell splits may be linked to the same lot. Refer to following section about the Scrub Account button for details of the capital gains transactions created in these situations.

- << Unlinks a split from a lot. The split moves from the Splits in lot panel to the Splits free panel. This button is not enabled until a split in the Splits in lot panel is highlighted. When the last split is unlinked from a lot, the lot is automatically deleted if there is no capital gain/loss transaction.

- New Lot Creates a new lot which shows in the Lots in This Account panel. The new lot is not linked to any split.

- Scrub Account

  - Creates a lot for each buy transaction split that is not already linked to a lot.

    A new lot is created for each unlinked buy transaction split because gains on investments, in some jurisdictions, may be taxed at different rates depending on how long they were held before being sold. As a separate capital gains transaction is created for each lot, this makes it easier to determine tax on the capital gains based on the lot opened and closed dates.

    If you know that the capital gains from a sale are all to be taxed at the same rate, you can manually link multiple buys to a lot so scrubbing will only create 1 capital gains transaction.

    It is also possible to manually link multiple sell transaction splits to a lot. In this case scrubbing creates a capital gains transaction per sell transaction split based on the average cost of securities held at the time of each sale, assuming acquisitions are allocated to sales using the security account costing method (currently only FIFO). As this makes it complicated to manually verify the costs are correct, it may be wise to limit this to specific situations, say for example if there are multiple sales on the same day.

  - Links buy and sell transaction splits to lots using FIFO method.

  - Calculates gain/loss and creates a separate capital gain/loss transaction for each lot that does not already have one.

    If gain/loss splits have been manually entered as part of a sell transaction, scrubbing does not recognize them, so if manually adding gain/loss, always separate the gain/loss splits from the transaction that reduces the No of Shares, by putting them in a separate transaction.

- Scrub Scrub only the highlighted lot. This button is only enabled if a lot is highlighted. If no buy splits are linked to the highlighted lot, nothing is done. The Scrub button will link any free sell splits to the lot as required until the sum of the sell split amounts equals the sum of the buy split amounts. If the sum of the sell split amounts is greater than the sum of the buy split amounts, a sell split will itself be split into 2 splits, with the remaining amount in an unlinked split.

  For both the Scrub Account and the Scrub buttons:

  The Gain/Loss for each lot is recalculated and a capital gain transaction is created if needed. The transaction has 1 split for the security account and the other with account Orphaned Gains-CCC where CCC is the security currency. The Orphaned Gains-CCC account is used because &app; doesn't know which capital gain or loss account should be used, so the user must change it to the required income (or expense) gain or loss account.

- Delete Delete the highlighted lot. Any linked splits are automatically freed (unlinked). This button is only enabled if a lot is highlighted.

- Close Close the Lots in Account SSSS window.

For more details, see:

- Tutorial and Concepts Guide, Automatic Calculation of Capital Gain or Loss Using Lots.

- Investment Lots report.

### Lots for Business Features

#### Introduction

For business features, lots are used to link payments or credit notes to the invoices to which they apply. This is for both customer invoices and vendor bills.

There are 2 main uses for the Lots in Account window in relation to the business features:

1. To enquire about which payments or credit notes offset particular invoices. For each invoice and credit note, &app; automatically creates 1 (and only 1) lot. By selecting the lot for the invoice or credit note in the Lots in This Account panel, all the transaction splits for that lot show in the Splits in Lot panel.

   Alternatively, print the invoice and check the Payments option on the Display tab in the report options. The Tax Invoice always shows payments so does not have the Payments option.

2. To correct mistakes that are hard to correct otherwise (either due to bugs in past versions of gnucash or due to unintended use of said features). Some of these use cases are found on this wiki page. In the context of the normal operation of business features , the Lots in Account window is not used to create, delete, link or unlink lots. Lots are usually generated and manipulated internally only by the business features programs.

To open the Lots in Account AAAA window, where AAAA is the Accounts Receivable (AR) or Accounts Payable (AP) account, open the AR or AP account register, then select Actions View Lots .

Lots in Account window for business features

An image of the Lots in Account window for an Accounts Receivable account.

#### Screen Elements

The screen elements of the Lots in Account window for an AR or AP account are the same as for a security account, although the actions and data are different. As this window is only used for creating, deleting, linking or unlinking lots in exceptional circumstances, the differences are not described. See for a description of the screen elements and what the buttons do when used with the lots of a security account.