This topic provides information about each transaction type used in transactional accounts in Morningstar Office and the security types to which they apply. You will learn the following:
in what situations each transaction type is used
the security types with which each transaction type can be used
whether Cash transactions are affected for each transaction type, and what the default cash flow type is (if any) for each transaction type, and
how to manually enter each transaction type.
Before reading about each transaction type, it is important to familiarize yourself with the following terms related to importing in Morningstar Office:
cash account
cash offset transactions, and
cash flow type.
This section explains the concepts behind the cash accounting methodology used in Morningstar Office when importing transactions. The following topics are covered:
Morningstar Office uses a cash accounting method for transactions, and each custodian has its own cash account with a name unique to that custodian. A cash account is a “passthrough” account required by Morningstar Office to track the cash flow of transactions (with the exception of certain accounts from Charles Schwab and DST Vision).
That is, every time a client purchases a security, a corresponding withdrawal from the cash account takes place as well. Likewise, when a client sells a security, a deposit is made into the cash account. These transactions are referred to as cash offset transactions.
Cash accounts typically maintain a zero balance since they represent funds for (or proceeds from) a transaction that are required to move through these accounts before the funds reach their final destination, either as a security a client owns, or in a client’s money market account. It is extremely important to use the proper cash account when entering manual transactions.
Click here to view the cash account that is used for a specific Custodian.
What is a cash offset transaction?
Cash offsets are transactions that are paired with certain non-cash transactions (i.e., Buy, Sell, etc.) to combine and create a balanced, auditable transaction process. For example, when a client sells a security, a cash offset transaction takes place to deposit cash into the proper cash account.
These cash offset transactions occur automatically at the custodian level, and are brought into Morningstar Office as part of the importing process. If you create a manual transaction in Morningstar Office, cash offsets are automatically generated for you.
What cash flow types are used in Morningstar Office?
The cash flow for a transaction will be either external to an account, or internal to it, depending on the transaction type. These cash flow types indicate whether funds are moving within an account, or coming from outside of it.
The following table further explains these cash flow types:
Cash Flow Type |
Description |
External cash flow |
This results from transactions where the funds or proceeds of a transaction move to (or from) an outside account, such as a Deliver-in or Deliver-out. Transactions with external cash flow do not have an offsetting cash transaction. |
Internal cash flow |
This results from transactions between securities within an account. These transactions always have an offsetting cash transaction. Users can change any transaction type that generates internal cash flow to external cash flow by manually coding the transaction as Out of Pocket. Note, though, that Out of Pocket transactions rarely occur. |
What is the transaction process when a cash account is involved?
For most custodians, cash and money market accounts are used for tracking cash flows. These are used to complete some, but not all, transactions. The following transaction process shows an example of buying a stock with funds not currently in a client’s account:
Deposit cash
Buy into money market account
Withdrawal of cash (a cash offset for step 2)
Sell from money market account
Deposit cash (a cash offset for step 4)
Buy security
Withdraw cash (a cash offset for step 6)
What transaction types are available in Morningstar Office?
Transaction types used in Morningstar Office are listed in the following table. Be sure to read the Description column for each one, as well as the Cash Offset Transaction column. The latter will tell you whether you should expect another transaction type to be paired with the one in the row you’re reading about.
If you need to enter a transaction manually, the steps in the Description column guide you on how to do this for each type.
Transactions are presented in two ways - the list below is alphabetical, while the table groups the transactions according to the type of activity in regard to the investment.
|
|||
|
Long-term Capital Gain Reinvest
|
|
|
Activity Type |
Transaction Type |
Description |
Use with these Security Types |
Cash Offset Transaction |
Default Cash Flow Type |
---|---|---|---|---|---|
Purchases |
Records the purchase of a security. When entering this transaction type manually, it requires a Withdrawal cash offset transaction.
|
All security types except Cash and Cash Equivalents |
Withdrawal |
Internal |
|
Purchases |
Deposit |
Records a deposit into a cash security.
When a linked cash security is selected, Deposits and Withdrawals are also automatically generated to accompany other transaction types such as buys and sells of securities. |
Cash and Cash Equivalents |
Varies |
Internal |
Purchases |
Deliver-in |
Records the transfer of assets from another account. This transaction is also used to establish initial positions when importing for the first time.
|
All security types |
None |
External |
Purchases |
Credit of Security |
Records the receipt of shares resulting from a merger, acquisition, spin-off, share class exchange, and/or split of a security already held in an account.
|
All security types |
None |
None |
Purchases |
Sell Short |
Records the short sale of a security.
|
Deposit |
Internal |
|
Purchases |
Transfer-in |
Same as Credit of Security. Although Transfer-in can be used as a way to categorize transactions, for simplicity in reporting and accounting practices, it’s a best practice to use Credit of Security instead. |
All security types |
N/A |
N/A |
Purchases |
Merge-in |
This is the same as Credit of Security. Although Merge-in can be used as a way to categorize transactions, for simplicity in reporting and accounting practices, it’s a best practice to use Credit of Security instead. |
N/A |
N/A |
|
Purchases |
Exchange-in |
Records the receipt (buy) of shares resulting from an exchange from another security. An Exchange-in occurs, for example, in portfolio re-allocation. An Exchange-in should always be accompanied by an Exchange-out with the same amount. This transaction does not generate external cash flow; it is a direct exchange from one security to another. Enter the transaction date and one of the following:
|
|
Exchange-out |
None |
Purchases |
Start Value |
This is the same as Deliver-in. Although Start Value can be used as a way to categorize transactions, for simplicity in reporting and accounting practices, it’s a best practice to use Deliver-in instead. |
N/A |
N/A |
|
Liquidations |
Records the sale of a security.
|
All security types except |
Deposit |
Internal |
|
Liquidations |
Withdrawal |
Records a withdrawal of a cash security.
When a linked cash security is selected, deposits and withdrawals are automatically generated to accompany other transaction types such as buys and sells of securities. |
|
Varies |
Internal or Out-of-Pocket |
Liquidations |
Deliver-out |
Records the transfer of assets out of an account. Enter the following information:
|
All security types |
None |
External |
Liquidations |
Debit of Security |
Records the removal of shares resulting from a merger, acquisition, spin-off, share class exchange, and/or split of a security already held in an account. Enter the following information:
|
All security types |
None |
None |
Liquidations |
Redeem |
Records the redemption of a fixed income class security at the maturity date.
|
|
Deposit |
Internal |
Liquidations |
Cover Short |
Records the purchase of a security to close an open short position. When entering this transaction type manually, it requires a Withdrawal cash offset transaction.
|
|
Withdrawal |
Internal |
Liquidations |
Expire |
Records the expiration of contracts for an option or other derivative security. Enter the expiration date. |
None |
None |
|
Liquidations |
Surrender |
Records the sale of a Variable Annuity or Variable Life subaccount resulting from the surrender or partial surrender of the policy.
|
|
Deposit |
Internal |
Liquidations |
Transfer-out |
Same as Debit of Security. Although Transfer-out can be used as a way to categorize transactions, for simplicity in reporting and accounting practices, it’s a best practice to use Debit of Security instead. |
All security types |
N/A |
N/A |
Liquidations |
Merge-out |
This is the same as Debit of Security. Although Merge-out can be used as a way to categorize transactions, for simplicity in reporting and accounting practices, it’s a best practice to use Debit of Security instead. |
N/A |
N/A |
|
Liquidations |
Exchange-out |
Records the removal (sale) of shares resulting from an exchange from another security. An Exchange-out occurs, for example, in portfolio re-allocation. An Exchange-out should always be accompanied by an Exchange-in with the same amount. This transaction does not generate external cash flow; it is a direct exchange from one security to another. Enter the transaction date and one of the following:
|
|
Exchange-in |
None |
Income / Distributions |
Distribution |
Records a distribution payment from a stock or fund.
|
|
Deposit |
Internal |
Income / Distributions |
Distribution Reinvest |
Records the payment and reinvestment of a cash distribution as a single transaction.
|
|
None |
None |
Income / Distributions |
Income |
Records an income payment from a fixed income security.
|
Deposit |
Internal |
|
Income / Distributions |
Income Reinvest |
Records the payment and reinvestment of a cash income payment as a single transaction. Enter the following information:
The number of shares bought will be automatically calculated. |
|
None |
None |
Income / Distributions |
Interest |
Records an interest payment from a cash security.
|
|
Deposit or None |
Internal or None |
Income / Distributions |
Accrued Interest Bought |
Records the purchase of accrued interest accompanying the purchase of a fixed income security. Note that when entering this transaction type manually, you must pair it with a Withdrawal transaction. Be sure to use the correct Cash source for this.
|
|
Withdrawal |
Internal |
Income / Distributions |
Accrued Interest Sold |
Records the sale of accrued interest accompanying the sale of a fixed income security. Note that when entering this transaction type manually, you must pair it with a Deposit transaction. Be sure to use the correct Cash source for this.
|
|
Deposit |
Internal |
Income / Distributions |
Margin Interest |
Records a cash withdrawal from an account to pay interest due on a margin balance. Enter the date and margin interest amount. |
|
None |
External |
Income / Distributions |
Long-term Capital Gain |
Records the receipt of a long-term capital gain payment from a security. Similar to Distribution. Enter the following information:
|
Deposit |
Internal |
|
Income / Distributions |
Long-term Capital Gain Reinvest |
Records the payment and reinvestment of a long-term capital gain payment as a single transaction. Similar to Distribution Reinvest. Enter the following information:
|
None |
None |
|
Income / Distributions |
Short-term Capital Gain |
Records the receipt of a short-term capital gain payment from a security. Similar to Distribution. Enter the following information:
|
Deposit |
Internal |
|
Income / Distributions |
Short-term Capital Gain Reinvest |
Records the payment and reinvestment of a short-term capital gain payment as a single transaction. Similar to Distribution Reinvest. Enter the following information:
|
None |
None |
|
Fees / Taxes |
Management Fee |
Records a withdrawal from the client’s account to pay a management fee to the advisor. Note that payments not related to management fees should be classified with the Expense transaction type. To understand how to handle sales related to paying management fees, see the Sell to Pay Fees transaction type. Enter the transaction date and management fee amount. |
|
None |
External |
Fees / Taxes |
Expense |
Records a withdrawal of cash from the client's account to pay an expense other than a management fee. This transaction applies either to a cash security, in which the transaction is similar to a Withdrawal, or to a money market fund, in which it is similar to a Sell. |
|
Withdrawal |
External |
Fees / Taxes |
Sell to Pay Expense |
Records the sale of a security to pay an expense other than a management fee.
|
None |
External |
|
Fees / Taxes |
Sell to Pay Fees |
Records the sale of a security to pay a management fee to the advisor.
|
None |
External |
|
Fees / Taxes |
Tax Withheld |
Records a withdrawal from the client’s account to deposit into an escrow account. Enter the date and tax withhold amount. |
|
None |
External |
Miscellaneous |
Reversal |
Cancels a previously entered transaction.
|
All security types |
Deposit, Withdrawal, or neither, depending on original transaction. For example, if you are reversing a Buy transaction, then the offsetting cash transaction the Reversal should be paired with is Deposit. |
External, Internal or neither, depending on original transaction |
Miscellaneous |
Split |
Records a stock split. Enter the following information:
|
None, unless fractional shares are paid out. In the latter case, a Split transaction should be paired with a Deposit transaction. |
None, unless fractional shares are paid out, in which case cash flow is internal. |
|
Miscellaneous |
Return of Principal |
Records a full or partial return of principal received.
|
Deposit |
Internal |
|
Miscellaneous |
Adjust Cost |
Adjusts the original cost basis of an existing tax lot. When entering this transaction type manually, note that it requires no cash offset transaction.
|
All security types except Cash and Cash Equivalents |
None |
None |
Miscellaneous |
Adjust Lot |
Adjusts the date and amount of the original purchase and/or the deliver-in of a security. When entering this transaction type manually, the type of offsetting cash transaction you need to enter depends on the type of transaction that was originally entered. For example, if you are adjusting a Deposit, you would need to enter a Withdrawal from Cash as well.
|
All security types |
Deposit, Withdrawal, or neither, depending on original transaction. For example, if you are reversing a Buy transaction, then the offsetting cash transaction the Reversal should be paired with is Deposit. |
External, Internal or neither, depending on original transaction |