> ## Documentation Index > Fetch the complete documentation index at: https://docs.investsync.co.nz/llms.txt > Use this file to discover all available pages before exploring further. # Transactions > Record, review, filter, export, and support the investment activity behind your portfolio ## Overview Transactions are the ledger behind each investment. They explain how a position changed over time and support the values shown in investment views and reports. Use transactions to record purchases, sales, income, PIE income, fees, capital calls, capital repayments, bonus issues, rights issues, redemptions, buybacks, liquidations, revaluations, stock splits, and write-offs. You can work from the central **Transactions** page or from the transaction tab inside a single investment. ## Before you start Confirm the investment exists and check the source record. For buys, sells, revaluations, and write-offs, make sure you have the date, amount, currency, and units where relevant. ## Basic and advanced use * **Basic use**: add, review, edit, and export investment activity. * **Advanced use**: use document upload, CSV import, filtered exports, linked documents, and invoice status checks where your organisation uses them. ## Transaction types For a fuller explanation of how each type affects units, cost basis, market value, income, and reporting, see [Transaction types](/features/transaction-types). * **Buy**: units purchased, price paid, fees, and currency. * **Sell**: units sold, sale amount, fees, and realised gain or loss where available. * **Bonus issue**: extra units issued at no cost. The unit count increases, while the existing cost basis is spread across the larger holding. * **Rights issue**: extra units taken up through an entitlement offer, rights issue, or share purchase plan. The unit count and cost basis increase by the amount paid. * **Redemption**: units repaid, matured, or redeemed by the issuer. Units reduce and proceeds are recorded. * **Capital call**: capital paid into an existing investment without changing units. This increases cost basis and value. * **Buyback**: units bought back by the issuer. Units reduce and proceeds are recorded. * **Liquidation**: a wind-up or final repayment that reduces or closes the holding. * **Dividend**: dividend income, including ex-dividend date where relevant. * **Interest**: interest income for income-producing investments. * **PIE unlisted attribution**: attributed income from an unlisted PIE fund. * **PIE listed distribution**: a listed PIE distribution paid or reinvested. * **PIE unlisted excluded distribution**: an excluded PIE distribution shown on a tax statement. * **Fee**: management, transaction, administration, or other investment-related costs. * **Capital repayment**: capital returned to you without selling units. This reduces the investment's cost basis while the unit holding stays the same. For private or manually valued holdings, the displayed value is reduced by the repayment amount. * **Revaluation**: an updated valuation for private or unlisted investments. * **Stock split**: a share split or consolidation that changes the number of units while keeping the overall holding value unchanged by the split itself. * **Write-off**: a reduction of remaining value when an asset is written down. ## Add a transaction 1. Go to **Transactions**, or open an investment and select **Transactions**. 2. Choose **Add transaction**. 3. Select the investment if you are on the central Transactions page. 4. Enter the transaction date, type, amount, currency, and any relevant units, price per unit, fees, or FX rate. 5. Attach any source documents you want kept with the transaction. 6. Save the transaction. For buy, sell, bonus issue, rights issue, redemption, buyback, liquidation, stock split, revaluation, and write-off entries, units are important because they affect the holding position. For income, PIE income, fee, capital call, and capital repayment entries, focus on the amount, currency, date, and supporting notes. The form helps reduce manual entry: * Currency is selected from a single list in the transaction form. * Transaction type fields are searchable, so you can quickly find entries such as dividend, capital call, or write-off. * FX rates use the most recent available rate on or before the transaction date, so weekends, market holidays, and rates not yet published for today still fill from the last available rate. * Price per unit is calculated when you enter the amount and units. * Dividend, interest, partnership allocation, and PIE income entries keep income and tax details together. There are no separate top amount, units, or price per unit fields for these entries; enter gross income and the tax items shown on the source document, and the net amount and per-unit values are calculated for you. * Income entries can include the relevant reporting date, such as an ex-dividend date or IRD reporting date, so period reports place the income in the right review period. * If the investment domicile has not been set, the form asks you to confirm it before adding income tax rows. The country picker is searchable, with common countries shown first and the remaining countries listed underneath. * Once domicile is known, the form suggests tax rows that match the investment, such as resident withholding tax, imputation credits, franking credits, or foreign withholding tax. * Documents selected in the modal are attached once the transaction is saved. * After you add, edit, or delete a transaction, the list updates straight away so you can continue working. InvestSync only shows an alert if the change cannot be saved, and the transaction details stay available so you can review and try again. ## Quick add several transactions When you are working inside a single investment, you can record many transactions in one go using a spreadsheet-style grid. 1. Open an investment and select **Transactions**. 2. Choose **Quick add**. 3. Each line is one transaction. Fill in the date, type, units, price per unit, amount, fees, currency, and FX rate. 4. Add as many lines as you need with **Add row**, or remove a line with the bin icon. 5. Choose **Save** to record every completed line at once. This view is built for speed: * You can paste rows straight from a spreadsheet. Copy your columns in the order Date, Type, Units, Price, Amount, Fees, Currency, FX, then paste into the first cell — extra rows are added automatically. * Amount is calculated for you when you enter units and a price per unit. * The FX rate is set to 1 automatically when the line uses your reporting currency. * Lines that need attention are highlighted, with a short note explaining what to fix, so you can correct them and save again. * If some lines save and others do not, the saved lines are kept and only the lines that need fixing stay on screen. Income transactions such as dividends, interest, partnership allocations, and PIE income are not available in Quick add, because they keep tax and reinvestment detail. Use **Add transaction** for those entries. ## Review transactions The Transactions page gives you a portfolio-wide ledger. You can: * Search by transaction or investment. * Filter by investment, transaction type, and date range. * Open an investment by selecting its name in the ledger. * Show, hide, and reorder columns. * View linked documents from the table. * Open the source Xero transaction where an imported bank income item came from Xero. * Check invoice status where your organisation uses accounting workflows. * Export the visible transaction set to Excel, CSV, or PDF. Useful columns include date, investment, type, units, price per unit, amount, currency, fees, realised gain/loss, net income, income reporting date, FX rate, last updated, linked transaction, documents, and transaction ID. Transactions are recorded against the investment once. If the investment has ownership weights, entity-filtered dashboards and reports show the selected entity's share of the relevant income, fees, gains, losses, and activity. ## Review transaction history Click a transaction row to open its detail panel. The panel shows the transaction summary, a **Documents** tab, and a **History** tab. For dividend, interest, partnership allocation, and PIE income transactions, the detail panel also shows recorded income and tax information so reviewers can check gross income, net received, tax deducted, credits, reporting date, and reinvestment details without reopening the edit form. On the mobile app, open **Portfolio → Transactions** and tap a transaction to review the same core details in a focused view. Linked source documents appear below the transaction details and can be opened directly from the app. ## Attach documents after saving Use the **Documents** tab in the transaction detail panel when you need to add a source file after the transaction has already been recorded. 1. Open **Transactions**. 2. Select the transaction row. 3. Open **Documents**. 4. Choose the contract note, statement, receipt, or supporting file. 5. Select **Attach document**. Attached documents stay linked to that transaction. You can preview or download them from the same panel, and the Documents column shows when supporting files are present. Admins can use the history to review when a transaction was created, changed, or deleted, who made the change, and whether it came from a person, document review, email automation, or another system process. For income transactions, the history also keeps the related tax entries, such as withholding tax, credits, treaty details, and reinvestment information. If a transaction is deleted, the normal ledger removes it, but the admin history keeps a read-only snapshot so the decision can still be reviewed later. ## Edit or delete a transaction Use **Edit** when the transaction is valid but has an incorrect date, amount, currency, units, price, fees, or FX rate. Use **Delete** only when the entry should not remain in the ledger. Deleting a transaction can change the later position and reporting values for that investment, so review the impact before confirming. After you confirm deletion, the entry is removed from the visible ledger straight away. InvestSync then refreshes the investment's values in the background, including the transaction view inside the investment record. ## Delete several transactions at once If you have the **Bulk delete transactions** permission, each transaction row has a tick box. 1. Tick the transactions you want to remove. 2. Review the selected count shown above the table. 3. Choose **Delete selected**. 4. Confirm the deletion. Selected transactions are removed from the visible ledger straight away. InvestSync then refreshes values for the affected investments in the background. Use this only when the selected entries should not remain in the ledger. ## Use documents to reduce manual entry When you have statements or contract notes, upload them through **Add investments > Upload documents**. Review the extracted transaction details, correct anything that does not match the source document, and only then save the transaction. This is useful for busy periods, bulk document processing, and keeping an audit trail with the source document close to the transaction. Documents received through managed email workflows should be reviewed in the same way before any transaction is accepted. If extraction misses a unit count, amount, currency, date, tax entry, or reinvestment detail, correct the review fields before saving. InvestSync keeps the uploaded source document available during review so the entry can be fixed without starting again. InvestSync may also prepare future dividend entries for listed holdings when an upcoming payment is detected. Review the amount, payment date, ex-dividend date, and units before relying on it for client reporting. ## Use CSV import for batches Use **Add investments > CSV import** when you have transactions in a spreadsheet-style file. Download the template, complete the required fields, upload the file, then review each row. Before importing, check: * The investment match is correct. * New investments are intentional. * Possible duplicates are resolved. * Transaction dates use the actual trade or effective date your team reports on. * Amounts, units, prices, fees, and currencies match the source record. ## Export transactions Exports use your current filters and visible columns. Before exporting: 1. Set the date range. 2. Apply any investment or transaction type filters. 3. Choose the columns your reviewer needs. 4. Export to Excel, CSV, or PDF. Use Excel or CSV when the recipient needs to analyse the data further. Use PDF when you need a readable transaction schedule for review or distribution. ## Good practice Enter activity close to the transaction date so holdings and reports stay current. Agree whether your team uses trade date or another effective date, then apply it consistently. Fees and FX rates can materially affect performance and tax review, especially for offshore holdings. Link statements, contract notes, and correspondence so the entry can be checked later. If a transaction has already flowed into reports, confirm the downstream impact before removing it.