Issued Loans
User Need
If you have lent money to a friend, partner, or contractor, these funds are temporarily absent from your accounts, but physically they still belong to you and are part of your total capital (Net Worth).
The Issued Loans (Money owed to us) feature allows you to accurately track such assets. The added loan amounts are automatically added to your liquid funds. This helps the application calculate your true Net Cash Flow and form the most accurate Goal Forecast chart for reaching your financial goals.
Available only for Admins For financial privacy, the issued loans section is available exclusively to users with the Admin role in a specific budget. Members with the Member role do not have access to this data and will not see the loan amounts.
Where to find it
Issued loans management is located in the analytics section of your equity. 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 owed to us row and tap the pencil icon to the right of it.
Steps: How to manage loans
By opening the Issued Loans list screen, you can add new loans or edit current ones (for example, for partial repayment).
Adding a new loan
- Tap the large floating Add loan button with a plus icon at the bottom of the screen.
- In the required To whom (Name) field, enter the name of the debtor or company.
- In the required Amount field, enter the amount of the issued loan.
- In the Currency dropdown list, select the currency of the debt (your base currency will be selected by default).
- In the Issue date field, select the date the loan was issued via the calendar (today’s date is set by default).
- In the Return date field, select the expected return date (by default, the system sets the date exactly 30 days after issuance).
- Tap the main Save button at the very bottom of the screen.
Partial repayment and editing
If the debtor has returned part of the amount to you, there is no need to create a new entry.
- In the list of loans, tap on the card of the required debt.
- In the Amount field, erase the old amount and enter the new remaining balance.
- Tap the Save button. Note: The app will automatically save the previous amount and the exact date it was changed. The entire repayment chronology can be viewed in the Valuation History section at the bottom of the editing screen.
Deleting a loan
- Open the card of an existing loan.
- Tap the Delete icon (trash bin) in the upper right corner.
- In the pop-up Delete Loan? window, confirm the action by tapping the red Delete button (or Cancel to abort). Deletion will permanently erase the loan itself and its entire history of changes.
Expected Result
When you tap the Save button, the text on it will disappear, a white spinning loading indicator will appear, and the button itself will be blocked from repeated taps.
After successful saving, the form will close, and you will return to the list of loans. A green pop-up notification (Toast) with the text Loan saved successfully (or Loan deleted successfully upon deletion) will appear at the top of the screen.
Frequently Asked Questions (Q&A)
How do issued loans affect my Goal Forecast? The system automatically considers debts in your forecast. The debt amount is converted into your dashboard currency at the current exchange rate and is added to the expected equity in the month the Return date is scheduled.
What happens on the chart if the debtor is overdue? We use a conservative approach to forecasting. If the return date has already passed or falls in the current incomplete month, the amount of this debt is automatically added to the calculated forecast of the current month.
Can I set a return date in the past? The Return date must be equal to or later than the Issue date. You cannot specify that a debt should be returned earlier than it was issued.
Possible Errors
When filling out the form, client validation can block data submission and highlight errors in red under the fields:
- Required: Appears if you left any of the mandatory fields empty.
- Max 100 characters: Occurs if the debtor’s name exceeds the character limit.
- Invalid number: Appears when an incorrect amount format is entered (for example, letters or multiple dots).
- Return date cannot be before issue date: Appears under the field and is duplicated by a red Toast notification if the return date precedes the issue date.
Server errors (API):
- “Only space admins can create issued loans.”: 403 Forbidden error. This means you were downgraded to the Member role and lost the rights to manage loans.
- “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 from which you were excluded.