Money we owe (Debts)

User Need

Loans, installments, or money borrowed from friends directly affect your financial health. To allow the application to show a realistic picture, these obligations must be recorded.

The Money we owe feature acts as a “deduction” from your total Equity. The system automatically subtracts these amounts from your liquid funds and tangible assets. This allows you to calculate your true net worth and build the most realistic, conservative Goal Forecast for your financial goals.

Available only for Admins Only a user with the Admin role in a specific budget can create, edit, and view the detailed list of debts. Users with the Member role only see the final total amount of debts on the Equity tab, but do not have access to the creditor list and cannot make changes.

Where to find it

Managing your debts is located in the equity analytics section. UI Path: Money tab -> Select the desired budget -> In the top segmented control, select Result -> In the nested control, select Equity -> In the equity card, find the Money we owe row and tap the pencil icon to the right of it.

Steps: How to manage debts

By opening the Debts list screen, you can add new obligations or edit current ones (e.g., when making a partial loan repayment).

Adding a new debt

1. Tap the floating Add debt button with a plus icon at the bottom of the screen.
2. In the required To whom (Name) field, specify the creditor (e.g., bank name or person’s name).
3. In the required Amount field, enter your debt amount.
4. In the Currency dropdown list, select the currency (your base currency is used by default).
5. In the Issue date field, select the date you took the debt via the calendar.
6. In the Return date field, specify the planned date of full return.
7. Tap the main Save button at the very bottom of the screen.

Partial repayment and editing

If you made a loan payment or returned part of the debt, you don’t need to delete the record and create a new one.

1. In the list of debts, tap on the card of the required obligation.
2. In the Amount field, erase the old amount and enter the new remaining balance of your debt.
3. Tap the Save button. Note: The app will save your new amount and record the old data in the Valuation History section at the bottom of the screen. Amounts in the history are highlighted in red, emphasizing that these are your obligations.

Deleting a debt

1. Open the card of an existing debt.
2. Tap the Delete icon (trash bin) in the upper right corner.
3. In the pop-up Delete Debt? window, confirm the action by tapping the red Delete button (or Cancel to abort). Deletion will permanently erase the debt itself and its entire history of changes.

Expected Result

When you tap the Save button, the text on it will disappear, a white loading indicator (spinner) will appear, and the button will be blocked from repeated taps.

After successful saving, the form will close, and you will return to the debts list. A green pop-up notification (Toast) with the text Debt saved successfully (or Debt deleted successfully upon deletion) will appear at the top of the screen.

Frequently Asked Questions (Q&A)

How do my debts affect the Goal Forecast? The system automatically converts the debt amount into the main currency of your dashboard and subtracts it from the expected capital in the month you plan to return the debt (by Return date). This makes the forecast realistic.

What happens on the chart if I miss a debt payment? Small Metrics applies a pessimistic (conservative) approach to risk assessment. If the return date has already passed or falls in the current incomplete month, the outstanding debt amount will be automatically subtracted from your forecast for the current month.

Why don’t I see the “Add debt” button? Managing debts requires administrator privileges. If you only see the total debt amount, your role is Member. Ask the budget creator to update your role to Admin in the settings.

Possible Errors

When filling out the form, client validation may block saving and highlight errors with red text below the fields:

• Required: Appears if you left a mandatory field empty.
• Max 100 characters: Occurs if the creditor’s name is too long.
• Invalid number: Appears when an incorrect amount format is entered.
• Return date cannot be before issue date: Appears under the field and is duplicated by a red Toast notification if you selected a return date that precedes the day the debt was taken. The system blocks such actions to maintain chronological accuracy.

Server errors (API):

• “Only space admins can create debts.”: 403 Forbidden error. This means your rights were downgraded to Member at the moment of saving.
• “User is not a member of this space.”: 400 Bad Request error. A critical failure occurring if the system tries to link a debt to a budget you no longer have access to.