How to use Simkassa

1. First launch

Open @simkassa_bot in a private chat, tap Start or send /start. There is no separate registration or password: Simkassa verifies your profile through Telegram.

A personal family is created on first sign-in. You can change its name, starting balance, language and theme in the Mini App.

• Open budget launches the Mini App.
• User guide or /help opens this page before you begin.
• Ukrainian, Russian and English are supported, together with light and dark themes.

2. What the button bot can do

Use the bot to enter data quickly without opening the Mini App. Choose Add expense or Add income, select a saved or suggested category, enter the amount and review the transaction before saving.

• Create a custom category by sending a message such as “🍕 Cafe”.
• Send a voice message such as “Spent 50 hryvnias on coffee”: the bot detects the type, amount and category and asks for confirmation.
• Manage daily reminders with the button or /reminders — up to five times in the Europe/Kyiv time zone.
• View family limits with /limits; the family owner can create and delete them.
• Change language with /language and cancel unfinished input with /cancel.

3. Overview and transactions in the Mini App

Overview shows the total balance, income, expenses, recent transactions, active limits and useful sections. Balance equals the starting balance plus income minus expenses.

Add transaction lets you choose income or expense, date, category, amount and comment. A member can edit or delete their own transactions; the family owner can manage every transaction in that family.

• A standard suggestion becomes a family category after its first saved transaction.
• Custom categories have a name and icon and are shared by the family.
• The Mini App asks for confirmation before permanently deleting a transaction.

4. Adding an expense from a receipt QR code

In the new-expense form, choose Scan QR or select a photo or screenshot. A supported Ukrainian fiscal receipt QR fills in the amount and date automatically; choose a category and save the transaction.

The image is decoded on the device and is not uploaded to the server. The full QR value is not stored; only a fingerprint within the family is used to prevent duplicates.

5. History and statistics

History contains all family transactions and filters for dates, type and member. Income and expense totals are recalculated for the current filter.

Statistics can analyze the whole family or one member over the last 7 days, 6 weeks or 6 months. Bars compare income and expenses; the line shows the balance trend or the selected member’s accumulated contribution.

6. Family, members and invitations

The 👥 button opens family members. The owner can invite someone by Telegram username if they have already opened the Mini App, or create a universal link for any Telegram chat. A targeted invitation appears under the ✉️ button; if the recipient previously opened the bot chat, the bot also sends a message.

Invitations are valid for 7 days. Each user can belong to only one family.

• When a regular member joins another family, their previous transactions stay in the old family without being linked to that user.
• An owner joining another family must first select a new owner if other members remain.
• If the owner is alone, a warning explains that the old family, balance, categories and transactions will be deleted after explicit confirmation.
• The owner can remove a member; a new personal family is created for the removed user.

7. Spending limits and reminders

A category limit has an amount and a period from 1 to 365 days. It is shared by the family and counts every member’s expenses. If a new or edited expense exceeds an active limit, Simkassa does not save it and shows the amount spent, the remainder and the end date.

Reminders belong to an individual user. At the selected time the bot sends buttons for quickly adding income, an expense or opening the Mini App. Each reminder is sent no more than once per day.

8. Settings, feedback and security

The ⚙️ button opens the family name, starting balance, language and theme. Only the owner can change the name and balance. Feedback and complaints sends a message to the Simkassa team together with your Telegram profile and current family.

Simkassa is not a bank, does not connect to bank accounts, does not store card details and does not process payments. A user can access only their current family’s data.

• If buttons do not update, close the Mini App completely and reopen it from the bot’s current menu.
• If the bot cannot deliver a targeted invitation message, the recipient can still see it in the Mini App; they must open the bot at least once to receive chat messages.
• If unfinished bot input disappears after a restart, begin that transaction again — saved data is not lost.