butce.app User Guide

AI Guide

Quick Start

You need only four steps to make your first entries and see your real picture.

  1. Define your accounts. On the Accounts page, add your bank, cash, credit card and (if any) gold and silver accounts one by one. Enter today's real balance for each one (for credit cards, enter your debt as a negative value, e.g. -8,500 ₺).
  2. Set up your categories and tags. The system comes with common categories preinstalled. On the Data Management page, edit the ones that don't fit and add the missing ones. If you want to group transactions by person, project or store, you can also create tags on the same page.
  3. Record your first transactions. On the Transactions page, open the Income, Expense or Transfer tab and add a few entries. You can attach a document on the same form.
  4. Plan your budget. On the Budget page, set a monthly cap per category. The Home and Budget pages will warn you when you exceed it.
Tip

If you realize your opening balance was wrong, edit the account and enter the correct balance. Your past transactions are preserved, the system simply recalculates the opening figure.

Core Logic

butce.app uses cumulative balance logic. Every entry directly affects the related account's balance.

One Account = One True Balance

Each account has a single live balance. Income increases it, expense decreases it, transfers move it between accounts. The same balance is shown consistently across all pages.

Period Totals Are Separate

"Total Income", "Total Expense" and "Net Balance" on the Home page are for the selected period (e.g. this month) and are different from account balance.

Editing in the Past

You can delete or edit any transaction. Every change is automatically reflected in the related account's balance; no manual fix needed.

Important

The system does not use soft delete. A deleted transaction cannot be recovered, but your balance stays consistent. Linked documents are removed with the transaction.

Accounts

Anywhere you keep money is an account: your wallet, bank, credit card, even your gold.

Account Types

TypeUsed for
Bank AccountChecking accounts, salary accounts
CashWallet, safe, money in hand
Credit CardBonus, World, Maximum etc. Limit is tracked separately.
OverdraftOverdraft-enabled bank accounts that go negative
Investment AccountTerm deposits, funds, stocks
Meal CardMeal cards such as Sodexo, Multinet, Setcard
Crypto WalletExchange or wallet balances (if you keep their fiat value)
E-MoneyDigital wallets like Papara, ininal
GoldBalance is held in grams
SilverBalance is held in grams

Adding an Account

  1. Open the Accounts page from the side menu.
  2. Pick a type, currency and opening balance. For credit cards, a limit field appears.
  3. Save. The new account appears in the list and is selectable on transaction forms.

Fixing the Balance

When you edit the account and enter the new correct balance, the system does not touch your past entries; it only recalculates the opening balance so totals match the new figure.

Archiving

Instead of deleting unused accounts, archive them. Archived accounts disappear from the active list and forms but keep their history.

Credit Card Statement Breakdown

Once you enter a statement day and a payment due day, the account card shows a four-line breakdown. The lines always add up to the card's total debt.

LineWhat it means
Statement balanceThe closed statement waiting to be paid. Its due date is shown next to it.
Current period transactionsSingle-payment spending since the last statement day. It lands on the next statement.
Current period installmentsInstallments falling on this period's statement.
Future installmentsInstallment load left for the coming months.

The statement closes on the evening of the statement day, so a purchase made that day is still on the same statement. If the statement or due day falls on a weekend, the displayed date shifts to the next business day.

Expenses Pending Authorization

Banks hold some transactions for a few days before posting them, which pushes them onto the next statement. When that happens, the statement balance here differs from the one at your bank.

  1. Find the expense on the Transactions page and click the edit (pencil) icon.
  2. If the account is a credit card, the Pending authorization, will post to next statement box appears. Tick it and save.
  3. The expense date stays as is and the row gets a Pending badge.

The item then counts toward the next statement period. The shift happens once; it is not pushed again in later months. Whether the hold lasts three days or twenty makes no difference, because the item moves by statement period, not by days.

One tick fixes three places: the statement breakdown on the account card, the card payment schedule on the Cash Flow page (the amount leaves your cash in the right month) and the statement comparison result (the item matches against the correct statement).

It does not touch the balance or the limit. The amount is already blocked on your card and your available limit is already reduced. If the authorization was cancelled (a hotel or car rental deposit, for example), delete the record instead of unticking the box.

Should I enter the credit card as negative?

Yes. If you owe money, enter the opening balance as a negative value. Example: for 8,500 ₺ debt, enter -8,500. As you pay, the balance moves toward 0; above 0 the card has spare cash on it.

Gold and Silver Accounts

Track your physical gold and silver in grams. The system converts to TRY automatically using the current rate.

How to Open One

  1. On the Accounts page click New Account and choose Gold or Silver as the type.
  2. Enter the opening balance in grams. Example: 25.5 for 25.5 grams of gold.
  3. The currency is automatically set to grams; you don't need to change it.

Buying and Selling Gold

Buying: use a Transfer from your TRY account to the gold account. Source: bank, Destination: gold account. The system uses the current rate to compute grams.

Selling: a Transfer in the opposite direction. Grams leave the gold account and TRY enters your bank account.

Total Wealth View

The Accounts page and Home page convert your total wealth to your preferred currency. Gold and silver grams are converted using the current TCMB gold/silver rate.

Quarter, half, full gold coins

A quarter gold coin is roughly 1.75 g, half is 3.5 g and a full coin is about 7 g. For Cumhuriyet coins, ask your jeweler for the exact gram weight and add it to your total.

Multi-Currency

Each account is kept in its own currency. Totals are converted to your preferred currency using TCMB rates.

Supported Currencies

TRY
Turkish Lira
$
USD
US Dollar
EUR
Euro
£
GBP
Pound Sterling
C$
CAD
Canadian Dollar
CHF
CHF
Swiss Franc
¥
JPY
Japanese Yen
¥
CNY
Chinese Yuan
RUB
Russian Ruble
AZN
Azerbaijani Manat
PLN
Polish Zloty
gr
XAU / XAG
Gold and Silver (grams)

Rate Updates

Currency and precious metal rates are fetched daily at 13:00 from TCMB. On weekends and holidays, the most recent business day rate is used.

Preferred Currency

Use the currency selector in the top right to change your preferred unit. Totals, charts and reports are shown in this unit. Each account's own currency stays unchanged.

Cross-Currency Transfers

When transferring between accounts in different currencies you enter the source and destination amounts separately. The system computes the rate. Example: you send 100 USD, 4,000 ₺ is received. The system records this as 1 USD = 40 ₺.

Transactions (Income, Expense, Transfer)

Income, expense and transfer records are managed in one place on the Transactions page. There is no separate "Income page" or "Expense page".

Recording Income

  1. On the Transactions page, open the Income tab.
  2. Pick the amount, account, category and date.
  3. Optionally add tags and upload a receipt.
  4. Save. The account balance is increased by the amount.

Recording an Expense

Use the Expense tab the same way. Expenses also support line items: instead of one 850 ₺ grocery entry, you can break it down ("bread 20, cheese 180, detergent 250..."). Item totals must equal the main amount.

Transfer

Use Transfer when moving money between your own accounts. Paying a credit card, withdrawing cash, buying gold or exchanging currency are all transfers.

  • Same currency: enter one amount used for both accounts.
  • Different currency: enter source and destination amounts separately; the rate is computed.

Filter and Search

The filters at the top of the Transactions page let you narrow by date range, account, category, tag or type. With bulk select you can change the category or tag of many entries at once.

Attach documents

You can attach a receipt, invoice or photo from the transaction form. PDF, JPG and PNG are accepted, with a 5 MB per-file limit. The document is automatically linked to the transaction.

Categories and Tags

Categories answer "where did it go", tags answer "who, why, which project".

Categories

Each transaction has exactly one category. Categories are either income (Salary, Rent, Interest, Loan...) or expense (Grocery, Utilities, Education...). The system seeds common defaults; you can customize them on the Categories page.

Tags

A transaction can have many tags. Use them for horizontal grouping: family members (Can, Özge), projects (Holiday 2026, Wedding), trips (Antalya), work items, etc.

Special Categories

CategoryUsed for
Non-Budget IncomeMoney received on behalf of others. Excluded from monthly income totals.
Non-Budget ExpenseSpending on behalf of others. Excluded from monthly expense totals.
LoanThe income category used when a bank loan principal is deposited. Managed by the Loans page.
Loan PaymentThe expense category created automatically when a loan installment is paid.
Example: Non-Budget usage

A friend spent 500 ₺ on your card and later sent it back via Papara. Record the 500 ₺ purchase as Non-Budget Expense and the incoming 500 ₺ as Non-Budget Income. The two offset each other and don't pollute your budget.

Credit Card Installments

Enter an installment purchase once and the system creates a separate record for each month.

Adding an Installment Purchase

  1. On the Transactions page open the Expense tab.
  2. Choose your credit card as the account.
  3. Enable the Installment option and enter the number of installments (e.g. 6).
  4. If there is a total surcharge, enter it in the surcharge field; the system distributes it across the installments automatically.
  5. Save. 6 separate installment records are created starting today and continuing monthly.

Installments Page

From the Credit Card Installments menu you can see all active and completed installments. Click a group to open its payment plan.

Cancelling an Installment

Deleting an installment group removes all of its installments together. Linked documents are also removed. To cancel only part of a group, split off the paid installments first.

Bank loans are different

Credit card installments and bank loans are managed in different places. Add personal, vehicle or mortgage loans from the Loans page.

Loans and Installment Debt

Personal, vehicle and mortgage loans. The system manages both the cash inflow and the monthly payments automatically.

How a Loan Appears in the System

When you add a loan, the system does two things:

  • Records income on your account. The principal deposited by the bank is added to the chosen account and a "Loan" income entry is created.
  • Creates a debt and installment plan. Total debt, remaining installments and the payment day are tracked on the Loans page.
Why does it show as income?

The loan principal is real money entering your account, so it increases your balance and is recorded as income. Debt tracking is handled separately on the Loans page.

Adding a Loan

  1. Open the Loans page from the side menu and click New Loan.
  2. Enter the name, type (Personal, Vehicle, Mortgage), currency, principal, interest rate, installment count and installment amount.
  3. Pick the first installment date and the day of the month you pay on.
  4. If you made payments before you started using butce.app, enter the count in Pre-paid Installments. The system calculates the remaining installments from this.
  5. Pick the account where the principal will be deposited. For historical loans, leave this blank to track only the remaining debt without affecting your balance.
  6. Pick the income category (default: Loan) and the expense category (default: Loan Payment). You can set tags separately for each.
  7. Save. The loan appears in the list as active.
How do I add a loan that already started?

Enter the correct first installment date, fill in the number of installments already paid, and leave the account blank. The system tracks only the remaining debt and installments without touching your balance.

Closing Past Installments

On the loan detail page, if there are unpaid installments with past due dates, the system shows a yellow warning. Use the Close Installments button to select how many to close. Closed installments do not affect your account balance and no expense entry is created. Useful for payments made before you started using butce.app.

Paying an Installment

Open the loan from the Loans page and click Pay Installment. The system marks the installment as paid, deducts its amount from your account, and creates an expense under "Loan Payment". Remaining installments and total debt are updated.

Early / Extra Payment

To pay off early or make an extra payment, use Extra Payment on the loan's detail page. The system applies the amount to the principal and recalculates the remaining schedule.

Editing and Deleting

You can edit or delete a loan. Deleting also removes all payment records, the principal income entry and linked documents. Your account balance is corrected automatically.

Budget Planning

Set a monthly cap per category. Get warned as you approach the limit.

Adding a Budget Line

  1. Open the Budget page from the side menu.
  2. Pick the month at the top.
  3. Enter a category and amount, then add. Each category can have only one budget per month.

Bulk Budget Template

Download Template gives you an Excel with all your categories. Fill the amounts and use Upload Template to import. Handy for planning many categories at once.

Copy From Previous Month

You can clone last month's budget in one click and then tweak it.

Overrun Warnings

When a category reaches 80% of its budget, the Home and Budget pages warn you. At 100%, it is highlighted in red. This is informational only; you can still record transactions.

Payment Calendar

See all upcoming payments at a glance on a calendar.

The Payment Calendar shows these on a monthly view:

  • Credit card installments
  • Bank loan installments
  • Watch List items with an upcoming due date (inspection, insurance, subscription...)
  • Recurring monthly expenses you marked as recurring

Click a day to see everything due that day. The daily total appears in the corner.

Cash Flow Beta

Shows how your money changes over the next 12 months, so you can see a tight month before it arrives.

The Core Rule

Cash flow covers your liquid accounts only. A credit card balance is debt, not cash, so it leaves the table in the month you pay the card, not when you spend. The remaining card debt appears at the bottom of the table for information and is never added to your cash.

The Rows

RowWhere it comes from
Opening cashMoney in every account except credit cards. Future-dated entries are removed from today and processed in their own month.
Forecast incomeEach income category's historical monthly average. Income already recorded this month is deducted from it.
Cash expensesThe part of your expense average that leaves cash accounts. Card spending appears in the card payment rows instead.
Card payment, scheduledClosed statement debt and installments falling due.
Card payment, forecastNew debt expected from your historical card spending average.
Loan paymentsUnpaid installments on the loan schedule. Overdue but unpaid installments land in the current month.
Closing cashOpening + income − cash expenses − card payments − loans. Each month's close is the next month's opening.

The four cards on top summarise: cash today, credit card debt, the lowest month in the next 12 and the amount left after 12 months. The lowest month is there so you spot a squeeze in advance.

Card payment rows use the card's statement and due day. If you have not entered them, the 28th is assumed as the statement day and the 10th of the following month as the due day. If you flag an expense as pending authorization, the amount leaves your cash in the correct month.

How the Average Works

When a category's monthly average is calculated, its two highest months are left out and the rest are averaged. This stops a single large purchase from spreading across every month. Low and zero months are counted as they are, because they are part of the category's real pattern.

Items that occur once a month (rent, dues, bills) are expected at full amount until they are paid. Items spread across days (groceries, eating out) are scaled to the days left in the month.

Category Behaviour

Every category falls into one of three types. You can change the type from the Income breakdown and Expense breakdown dialogs; your choice overrides the automatic rule and is remembered.

TypeHow it is handled
RecurringWritten to every month using the average. Rent, groceries, bills.
SeasonalNot spread out; written at full amount to the calendar month it happened in before. Vehicle tax, insurance, school fees.
One-offNever enters the forecast but stays visible in the breakdown. A phone, an appliance.

Seasonal items are only recognised once the same calendar month completes for the second time. With less than a year of history, yearly items will not show up and you need to enter those months yourself.

Editing by Hand

  1. Click the cell you want to change and type the new figure.
  2. To apply one figure across all 12 months, turn on Apply to all months at the top.
  3. Press Save. Your value sticks for that month.
  4. Use Reset to go back to the automatic calculation. Reset clears cell edits only; it leaves your category behaviour choices alone.

Breakdowns

The Income breakdown, Expense breakdown, Card schedule and Loan schedule buttons above the table open the items behind a month's figure. That is where "what is the 1,369.91 ₺ in June" gets answered.

When History Is Short

Until you have at least 3 months of data, you fill in the forecast income, cash expense and forecast card payment rows yourself. Opening cash, scheduled card payments and loan installments already come from your records. Once the third month completes, the system starts calculating and offers to take those rows over; in any month you decline, your figure stays.

What is left out

The Non-Budget Income and Non-Budget Expense categories are excluded from the forecast entirely, so amounts paid on someone else's behalf and tracked on the Debts page do not inflate your cash flow. Installments are also kept out of the historical average; each one is processed on its own due date and stops producing monthly expense once it ends.

Beta

The figures are forecasts derived from your history, not a confirmed payment plan. The method keeps improving with feedback, so the same month's figure can change in later versions. If a row looks wrong, write to [email protected].

Financial Analysis

Extracts trends, category distribution and comparisons from your last 12 months.

What You See

  • Monthly trend: 12-month income and expense lines.
  • Category breakdown: how much you spent per category.
  • Typical monthly amounts: the highest and lowest months are removed before averaging, filtering out one-off anomalies.
  • Month comparison: where you spent more or less this month vs. last month.
Non-Budget categories are excluded

Non-Budget Income and Non-Budget Expense are excluded from analysis totals so your real budget is visible.

Watch List

Manage upcoming inspections, insurance, driver's license, passport, subscriptions and more from one place.

Categories

  • Vehicle: inspection, road tax, casco, traffic insurance
  • Insurance: DASK, home, health insurance
  • Document: driver's license, passport, ID card
  • Subscription: gym, magazine, internet, streaming
  • Other: anything else

Reminders

For each item you pick the due date and how many days in advance to remind you. As the date approaches, you receive an email and the day is marked on the Payment Calendar.

Complete and Renew

Mark an item Complete to close it. For periodic renewals (e.g. yearly casco) use Copy to create the next-period item from the existing one.

Documents

Receipts, invoices, contracts, vehicle papers... all in one place.

Uploading

You can upload documents two ways:

  • From a transaction form: when adding income, expense, transfer, loan or watch item. The file is auto-linked to that record.
  • From the Documents page: for standalone documents (contracts, warranty papers, etc.).

Limits

  • Accepted formats: PDF, JPG, PNG
  • Max per file: 5 MB
  • Content is validated (files with fake extensions are rejected)

Search and Filter

Search runs against the document name, notes and the linked transaction's description and category. Separate multiple terms with space or +; results contain all of them.

Data Management

Export, import and use bulk templates.

Export

Download all your income, expense, transfer, account, category and tag data as Excel. Each data type is on its own sheet for easy review.

Import

Download the template, edit it in Excel and upload it back. Valid rows are saved; invalid ones are shown with their reason. Dates, account names and category names must match exactly.

Financial Tools

Free calculators you can use without an account.

VAT Calculator
Convert between VAT-exclusive and VAT-inclusive amounts
Deposit Interest
Gross and net (after withholding) interest calculation
Loan Installment
Monthly installment and payment plan including KKDF and BSMV

Open Financial Tools

Account Management

Subscription, password and account deletion.

Trial and Subscription

You get a 14-day free trial on signup with all features. After the trial, your data is kept safely for one more month. Subscribe from Account Management to continue.

Month Start Day (Payday)

If you get paid on a day other than the 1st (e.g. 15th, 21st, 25th), open the Preferences card on the Account Management page and pick the day your month starts. Budget, analysis, cash flow and summary cards are computed against this period.

  • Range: 1-28 (29-30-31 not supported due to February).
  • Example: if you pick 21, your May period runs 21 May to 20 June.
  • Dashboard, Budget, Analysis, Loans "this month" summary, Cash Flow, Payment Calendar, CC Installments and Transactions all compute periods against your chosen day.
  • Transaction dates, installment schedules and loan payment dates are unaffected, they stay absolute.
  • Default is the 1st. If you don't change it, the system behaves exactly as before.

Security

  • Single-session policy: only one device can stay signed in at a time.
  • Two-step email verification.
  • SSL connection, hashed passwords, no bank or card details requested.
  • Each user's data lives in its own database.

Changing Password

Confirm your current password and set a new one on the Account Management page. Forgot it? Use Forgot Password on the login page for an email reset link.

Deleting Your Account

To fully delete your account, submit a deletion request from Account Management. All financial data, documents and login info are erased irreversibly.

FAQ

Is my data safe?

Each user's data is stored in a separate database. SSL, single-session security and GDPR-aligned infrastructure are in place. Your bank password or card details are never requested.

Why does the statement balance differ from my bank's?

The usual reason is expenses still pending authorization. Banks hold some transactions for a few days and post them to the next statement, while the app counts them on the date you made the purchase. Fix it by editing the expense on the Transactions page and ticking the Pending authorization box. The date stays unchanged, the item moves to the next statement, and the cash flow and statement comparison follow along.

Why did my balance increase when I added a loan?

A bank loan principal is real money entering your account. The system therefore adds the principal to the chosen account's balance and creates an income entry under "Loan". The debt side is tracked separately on the Loans page. Seeing the same loan as + on the account balance and as a debt in the Loans list is expected.

How does a gold or silver account work?

Open a Gold or Silver account and balances are kept in grams. Buy and sell with Transfer: from TRY to gold, source is the bank, destination is the gold account. The system uses the current TCMB rate to convert. In total wealth view, gold is converted to your preferred currency.

Do I need to record the loan twice?

No. When you create a loan, the system records the principal as income on the chosen account automatically. You don't need a manual income entry.

How do I pay my credit card debt?

On the Transactions page open the Transfer tab. Source: your bank account, Destination: your credit card. This reduces the bank balance and moves the card balance toward zero.

I entered an installment purchase wrong. What now?

Open the group on the Credit Card Installments page, delete it and create a new one with the correct details. Deletion removes all installments and linked documents together.

Can I share my account with family?

For security, each account is single-user. Use tags with family member names: "Can", "Özge" tags let you filter who spent what.

Can I export my data?

From Data Management you can download all your income, expense, transfer, account and category data as Excel. The same template can be used to bulk import.

Which currencies are supported?

TRY, USD, EUR, GBP, CAD, CHF, JPY, CNY, RUB, AZN, PLN currencies plus gold and silver in grams. Rates are updated daily from TCMB.

What happens after the trial?

After the 14-day trial, your data is kept for one more month. During that time only the Account Management page is accessible. Subscribe to continue with everything intact.

Is there a mobile app?

Yes! The Android app is live on Google Play: Download on Google Play. You can also use butce.app fully mobile-friendly from any browser.

Can I auto-connect my bank?

No automatic bank integration. You can enter transactions manually or bulk-import them using the Excel template from Data Management.

I get paid on the 21st, can I track my budget against that?

Yes. Open the Preferences card on the Account Management page and set "Month start day" to 21. Dashboard, Budget, Analysis, Cash Flow, Payment Calendar and other period-based pages will treat 21.X to 20.(X+1) as "this month". Transaction dates and installment schedules are not affected. Default is 1; the system behaves like a calendar month until you change it.

Ready to start?

14-day free trial, no card required.

Create Free Account