A local-first personal finance app
Update Reconciliation document to current UI - follows #6220 (#6225)
Juulz52d013cb8655
diff --git a/packages/docs/docs/accounts/reconciliation.md b/packages/docs/docs/accounts/reconciliation.mdindex 16b623e6c9..d07ee7bc83 100644--- a/packages/docs/docs/accounts/reconciliation.md+++ b/packages/docs/docs/accounts/reconciliation.md@@ -1,52 +1,77 @@# Reconciliation-Keeping your Actual account ledgers consistent with your bank ledgers is important to maintain a healthy budget and know exactly how much currency is available to spend. Some choose to reconcile monthly, weekly, or even daily. Actual provides the Reconciliation tool to help manage this process.+Keeping your Actual account ledgers consistent with your bank ledgers is important to maintain a healthy budget and know exactly how much currency is available to spend. Some choose to reconcile monthly, weekly, or even daily. Actual provides a Reconciliation tool to help manage this process.## Work Flow-When you reconcile, you will be comparing your bank statement, print or online, against Actual's ledger for that account. If you have made transactions against the budget that have not been verified against your account the **cleared** flag will be shown in gray. If the transaction has been moved out of the pending section of your (online) bank statement, click the gray circle to turn it green. This is a visual indication that the transaction is in both your budget and in your account statement, and they match.+When you reconcile, you compare your bank statement, print or online, against Actual's ledger for that account. If you have transactions in Actual that have not been verified against your bank account the **cleared** flag will be shown in gray (pending). If the transaction is finalized (cleared) on your bank statement, click the gray circle to turn it green. This is a visual indication that the transaction is in both your budget and in your account statement, and they match.-By clicking on the green balance in the header of the account view, two more category balances will come into view. The **cleared total** only includes transactions that have been cleared while the **uncleared total** will represent the transactions you have entered but may not have entered the bank statement yet.+Click on the green balance in the header of the account view to bring two more category balances into view. The **cleared total** only includes transactions that have been matched to the bank while the **Uncleared total** shows the sum of the transactions that aren't yet matched to the bank statement.-+## Starting the Reconciliation Tool-Click the π lock icon in the top right-hand corner of the account ledger.+Click the π lock icon in the top right-hand corner of the account ledger. Notice that the last date the account was reconciled is shown on hover.-+-Let's imagine that we have just checked our account balance for our Ally Savings account and the current balance is 3012.13. We enter the balance we want to match into the Reconciliation tool and press **Reconcile**.+Let's imagine that you checked your account balance for Chase Amazon and the current balance is -310.80. The tool will default to the **Cleared total**. Enter the balance you want to match into the Reconciliation tool and click **Reconcile**.-+:::tip-The tool will tell us exactly how much is different than the budget ledger. Now we can check the Actual ledger against the bank ledger and watch the difference come closer to 0 as you change the cleared status of transactions. In this case, we're looking for transactions that add up to 324.82. This is much easier by looking at the Actual ledger and bank statement side by side to match the transactions.+Remember to use a negative number for the balance on credit or loan accounts-+:::-When the cleared amount of the Actual account ledger and the value you entered into the Reconciliation tool are the same, the tool will let you know that you are reconciled and you can press done.+-+Or, if you use certain bank sync providers, the last synced balance will be shown. You can use that balance by clicking the **Use last synced total** button.-Upon pressing done, all cleared transactions will receive a lock icon. This represents the fact that they were included in a reconciliation and makes it harder to accidentally change.+-+The tool will tell you exactly what the difference is between the bank statement and your Actual ledger. Click the gray circles as you match each Actual transaction to the bank ledger and watch the difference come closer to 0 as you change the status of each transaction to green (cleared). In the example, the cleared transactions need to add up to -82.60 This is much easier if you look at the Actual ledger and bank statement side by side to match the transactions.-Of course, there's always the possibility you need to change a locked transaction. You can click on the lock of any transaction to open a dialog to unlock it.+-+When the cleared amount of the Actual account ledger and the value entered into the Reconciliation tool are the same, the tool will let you know that you are _All reconciled!_ Click on the **Lock transactions** button to complete the reconciliation and lock the cleared transactions. If you want to leave reconciling for a later time, click **Exit reconciliation** to cancel.++:::warning++If you fail to click the **Lock transactions** button after the _All reconciled!_ message appears, you will not change the status of the cleared transactions to locked.++:::+++++++If you ever need to unlock a transaction. Click on the lock of any transaction to open a dialog to unlock it. After you unlock a transaction this way, the status will revert to "Cleared". A reconcile will need to be performed to re-lock the transaction.++++If you try to edit a locked transaction, the following warning will appear. Click **Confirm** to proceed. Once confirmed, the edit will be made and the transaction will remain locked.++## Using the Reconciliation Tool for Off Budget Asset Tracking-Some people use off budget accounts to track values of assets such as vehicles, real estate, retirement accounts, or other investment accounts or property. The reconciliation tool is useful to update these values as well. Let's say we have a house that was valued at 367,800 but with current changes in the market it is now valued at 385,000. We go to the ledger for the house, choose the reconciliation tool, and enter 385,000 as the new value into the tool.+Off budget accounts can easily be used to track values of assets such as vehicles, real estate, retirement accounts, or other investment accounts or property. The reconciliation tool is useful to update these values using the **Create reconciliation transaction** button.++For example, on 10-Nov-2025, my house was valued at 231,100 then some houses sold in my neighborhood and a few days later it was valued at 234,600. Go to the House Asset account, choose the reconciliation tool, and enter 234600 as the new value into the tool.++++The tool tells us that we have a gain of 3,500.++-+Click on the **Create reconciliation transaction** button to easily create a new transaction that automatically brings the value of the asset in line with the new valuation. Now the reconciliation tool reports that it is _All reconciled!_ Click the **Lock transactions** button to complete the task.-The tool tells us that we have a gain of 17,200.+-+-We can use the "Create reconciliation transaction" button to easily create a new transaction that brings the value of the account in line with the new valuation. You should now have a reconciliation tool that is reporting that it is finished and you can enjoy a new higher net worth.-diff --git a/packages/docs/static/img/reconcile/reconcile-10-2025.png b/packages/docs/static/img/reconcile/reconcile-10-2025.pngnew file mode 100644index 0000000000..3159a19c80Binary files /dev/null and b/packages/docs/static/img/reconcile/reconcile-10-2025.png differdiff --git a/packages/docs/static/img/reconcile/reconcile-11-2025.png b/packages/docs/static/img/reconcile/reconcile-11-2025.pngnew file mode 100644index 0000000000..00b34fdd8cBinary files /dev/null and b/packages/docs/static/img/reconcile/reconcile-11-2025.png differdiff --git a/packages/docs/static/img/reconcile/reconcile-12.png b/packages/docs/static/img/reconcile/reconcile-12.pngnew file mode 100644index 0000000000..72ead46639Binary files /dev/null and b/packages/docs/static/img/reconcile/reconcile-12.png differdiff --git a/packages/docs/static/img/reconcile/reconcile-2-2025.png b/packages/docs/static/img/reconcile/reconcile-2-2025.pngnew file mode 100644index 0000000000..c0b5d6b7caBinary files /dev/null and b/packages/docs/static/img/reconcile/reconcile-2-2025.png differdiff --git a/packages/docs/static/img/reconcile/reconcile-3-2025.png b/packages/docs/static/img/reconcile/reconcile-3-2025.pngnew file mode 100644index 0000000000..5c4758aeaeBinary files /dev/null and b/packages/docs/static/img/reconcile/reconcile-3-2025.png differdiff --git a/packages/docs/static/img/reconcile/reconcile-3a-2025.png b/packages/docs/static/img/reconcile/reconcile-3a-2025.pngnew file mode 100644index 0000000000..e25b0a3d0bBinary files /dev/null and b/packages/docs/static/img/reconcile/reconcile-3a-2025.png differdiff --git a/packages/docs/static/img/reconcile/reconcile-4-2025.png b/packages/docs/static/img/reconcile/reconcile-4-2025.pngnew file mode 100644index 0000000000..c83fcda33cBinary files /dev/null and b/packages/docs/static/img/reconcile/reconcile-4-2025.png differdiff --git a/packages/docs/static/img/reconcile/reconcile-5-2025.png b/packages/docs/static/img/reconcile/reconcile-5-2025.pngnew file mode 100644index 0000000000..f56e36dcfaBinary files /dev/null and b/packages/docs/static/img/reconcile/reconcile-5-2025.png differdiff --git a/packages/docs/static/img/reconcile/reconcile-6-2025.png b/packages/docs/static/img/reconcile/reconcile-6-2025.pngnew file mode 100644index 0000000000..8ebfa3aae9Binary files /dev/null and b/packages/docs/static/img/reconcile/reconcile-6-2025.png differdiff --git a/packages/docs/static/img/reconcile/reconcile-8-2025.png b/packages/docs/static/img/reconcile/reconcile-8-2025.pngnew file mode 100644index 0000000000..55cd1ae617Binary files /dev/null and b/packages/docs/static/img/reconcile/reconcile-8-2025.png differdiff --git a/packages/docs/static/img/reconcile/reconcile-9-2025.png b/packages/docs/static/img/reconcile/reconcile-9-2025.pngnew file mode 100644index 0000000000..f03aaafee5Binary files /dev/null and b/packages/docs/static/img/reconcile/reconcile-9-2025.png differ