WalleK

Yatırım ALIM/SATIM kaydı (fon · hisse · altın/gümüş · kripto · döviz). Portföye düşer VE seçilen hesabın bakiyesini etkiler (alımda düşer, satışta artar) — bu yüzden HARCAMA olarak ayrıca YAZMA. Fon/hisse dekontundan gireceksen: adet + birim fiyat + tarih dekontta yazar; toplam tutar verilmişse ona DOKUNMA (fiili ödeme odur). ⛔ BES (bireysel emeklilik) fonları için DEĞİL → create_bes_trade.

create_investment

Hesap Kitap "çalışma"sı (defter) oluşturur. study_type: time (12-ay) / list (düz liste) / period (dönem) / sheet (cetvel) / custom.

create_ledger

Yeni ödeme yöntemi. Önce list_payment_methods (dupe).

create_payment_method

Maaş/BORDRO kaydı (dönem-bazlı). Önce list_salary (dupe). ⚠️ HER bordro AYRI (10 aylık = 10 çağrı, BİRLEŞTİRME). period_key=AİT OLDUĞU ay (YYYY-MM) ≠ payment_date=paranın YATTIĞI gün. Kalem-detayı varsa detail gönder.

create_salary

Bir kategori altına ÖZEL alt-kategori ekler. category = list_categories üst-KEY (üstler sabit, sadece alt).

create_subcategory

İki hesap/ödeme yöntemi arası para transferi. from/to = list_accounts/list_payment_methods adı. Döviz/altın/kripto alım-bozdurmada kind belirt. GELİR/GİDER DEĞİL (Transfer kategorisi YAZMA).

create_transfer

Kanonik satıcı oluşturur. SADECE kullanıcı açıkça "satıcı ekle" derse (normal harcamada AYRICA çağırma — add_expense vendor adı yeter). Önce list_vendors (dupe) + list_regions + list_categories. İkon gönderme (app logoyu isimden eşler).

create_vendor

TEK kaydı siler (harcama/satıcı/kredi/düzenli/maaş/ledger-kalemi/rapor) — onayla. Kart/ödeme aracı SİLİNMEZ (uygulamada yalnız gizlenir). SADECE belirli tek kalem; "hepsini/toplu" ASLA (reddet). Önce list_* ile bul.

delete_item

Banka/kart EKSTRE FORMAT bilgisi (global, kişisel değil): taksit/ödeme/puan satır desenleri, tarih-tutar formatı, dönem-meta alanları, bilinen tuzaklar. Bir ekstre işlemeye BAŞLAMADAN ÖNCE bankayı tanıyıp çağır.

get_bank_format

"Bütçem ne durumda / ne kadar kaldı": aylık bütçe (monthly_budget) + o ayın net harcaması (cashback/iade düşülmüş). Bütçe UYDURMA.

get_budget_status

"Toplam param / bu ay durumum / genel mali durum" için TEK özet: hesap bakiyeleri (PB bazında net worth) + ay gelir/gider/net + en büyük harcama kategorileri + kredi kalan + son maaş. Genel durumda önce BUNU çağır. Rakam UYDURMA.

get_financial_summary

Gönderdiğin önerilerin akıbeti: kaç pending/applied/dismissed + son kayıtlar. "Ekledin mi / bekleyen var mı" deyince BUNUNLA doğrula — "eklendi" VARSAYMA.

get_inbox_status

"Enflasyon/TÜFE kaç": ülke enflasyonu (yıllık cpi_yoy + aylık cpi). Web bilginden CEVAP VERME — buradan oku (TR=TÜİK/TCMB, US=FED, EU=Eurostat, UK=ONS). Genelde yıllığı söyle.

get_inflation

Bir Hesap Kitap çalışmasının kalemleri + gelir/gider/fark toplamı. Çalışma adını list_ledgers ile öğren.

get_ledger_entries

Bir kredi kartının DÖNEM EKSTRESİ özeti: dönem faizi/limiti/ücreti/SKT/kesim+son-ödeme (list_transactions vermez) + dönem harcama toplamı + ekstre PDF (statement_pdf_files). "Worldcard Mart ekstresi / kartımın faizi". Kart adını list_accounts ile öğren.

get_statement

TEK kartın/ekstrenin kalemlerini TAM içe aktarır (harcama+faiz+ücret+ödeme+iade + kesim/son-ödeme + otomatik mükerrer-atlama). ⚠️ HER ekstre/kart AYRI çağrı (2 ekstreyi BİRLEŞTİRME). card=bu ekstrenin TEK kartı (list_accounts ile eşleştir). Her kalemde kind ile tip. Ekstre PDF varsa attachment ile aynı çağrıda. Önce get_bank_format. Detay: wallek://rules.

import_statement

Finansal hesaplar + kartlar: yaklaşık bakiye (balance_estimate), kesim/son-ödeme günü, limit, IBAN, son4 (+ linked_last4 ek-kart). "Param ne kadar / kesim günüm / IBAN" için (bakiyeyi "yaklaşık" sun). ⚠️ **linked_last4 SALT-OKUNUR — SEN YAZAMAZSIN:** ek/yedek kart bağını hiçbir tool kabul etmez (create_account da update_card da). Yeni bir ek-kart bağlanacaksa kullanıcı UYGULAMADAN ekler: Kartlar → kartı seç → düzenle → "Bağlı / Ek Kartlar". Bunu bilmeden create_account önerirsen AYNI son-4 ile ikinci bir kart açtırırsın.

list_accounts

Geçerli kategori + alt-kategori KEY listesi. add_expense/create_vendor kategorisini BURADAN seç (uydurma).

list_categories

ÖĞRENİLMİŞ tercihler: satıcı takma adı (MIGROS TIC AS→Migros), satıcı→kategori/kart/klasör/etiket alışkanlıkları. Harcama eklerken cihazda OTOMATİK uygulanır; sen de bu kanonik ad/kategorilerle TUTARLI yaz.

list_helper

Hesap Kitap çalışmaları (defter) — add_ledger_entry öncesi eşleştirme.

list_ledgers

Kredi Hesaplama ekraninda KAYDEDILEN hesaplamalar (senaryo/simulasyon). "Hesapladigim kredi / kayitli hesaplamalarim" icin BUNU cagir. ⚠️ GERCEK kredi DEGIL — gercekler list_loans.

list_loan_calcs

Krediler (dupe önleme).

list_loans

Ödeme yöntemleri. Harcamaya ödeme atamadan önce eşleştir.

list_payment_methods

"Dolar/euro/altın kaç TL": uygulamanın KENDİ kur kaynağından (TCMB+piyasa) güncel/tarihli kur. Web bilginden kur SÖYLEME — buradan oku.

list_rates

Düzenli ödemeler (dupe önleme). ⚠️ `amount` = ŞABLON tutarı; ileri döneme zam girilmişse SIRADAKİ taksit farklı olabilir. Böyle bir ayrışma varsa `next_amount` (+ gerekirse `next_amount_date`) alanı gelir — "önümüzdeki ay ne kadar" sorusunda ONU söyle. Alan YOKSA sıradaki taksit `amount` ile aynıdır. ⏸ **DURDURULMUŞ:** kayıt duraklatılmışsa `status` alanı gelir (ör. "paused"); **alan YOKSA kayıt AKTİFtir**. Duraklatılmış kayıt ÖDENMİYOR ⇒ "aylık sabit giderim/toplam ne kadar" hesabına KATMA (katarsan sessizce yanlış rakam verirsin). 🤖 **OTO:** otomatik ödenen kayıtlarda `is_auto: true` gelir; alan YOKSA elle ödenir. ⚠️ Bu `status` düzenli ödemenin KENDİ durumu (aktif/duraklatılmış) — `list_transactions`'taki `recurring_status` ise TEK bir taksidin durumu (pending/paid); KARIŞTIRMA. 💰 **VADELİ/FAİZ HESABI (kind=interest):** bu kayıtlarda hesabın parametreleri de gelir — `principal` (Ana Para = hesabın TAMAMI), `exempt_amount` (Faiz Uygulanmayan Tutar; **alan YOKSA/0 ise ana paranın TAMAMINA faiz işler**), `annual_rate_pct` (yıllık %), `tax_rate_pct` (stopaj %), `compound:false` (alan yoksa bileşik = net faiz her gün ana paraya eklenir). 📊 **KADEMELİ MUAFİYET:** hesabin faizsiz tutari bakiye araligina gore degisiyorsa `exempt_tiers` alanı gelir (`[{min_balance, exempt}]`); **alan YOKSA muafiyet tek sabit değerdir (`exempt_amount`)**. Kademe varsa o gunku bakiyeye UYAN satir gecerlidir (bakiye min_balance degerine ESIT veya ondan BUYUKSE; birden çok satır uyarsa EN YÜKSEK min_balance kazanır) ⇒ **`exempt_amount` alanini kullanarak faiz hesaplama**, önce kademeyi çöz. ⚠️ **BÖLÜŞÜM — kendi formülünü uydurma:** vadeli (faiz İŞLEYEN) = `principal − exempt_amount` · vadesizde duran (faiz işlemeyen) = `exempt_amount`. ⚠️ **`amount` = GÜNLÜK NET faiz, ana para DEĞİL** (brüt = (principal−exempt)×yıllık%/365, net = brüt×(1−stopaj%)). Hesabın bakiyesi ile `principal` arasındaki küçük fark (≈ bir günlük faiz) normaldir: o gün tahakkuk etmiş ama henüz ana paraya işlenmemiş faizdir, TUTARSIZLIK DEĞİLDİR. 🏦 **BİREYSEL EMEKLİLİK (BES):** BES kayıtlarında `kind:"bes"` gelir; **alan YOKSA o kayıt BES DEĞİLDİR.** Sözleşme bilgisi varsa `bes` objesi eklenir (`contract_no` · `provider` · `contract_start_date`). Sağlayıcı portalından besleme geldiyse **`bes_birikim`** objesi de gelir: `toplam_birikim` · `devlet_katkisi` · `katilimci_birikimi` · `getiri` · `fonlar` · `updated_at` (verinin OKUNDUĞU an). ⚠️ **`amount` = aylık KATKI PAYI, birikim DEĞİL** — "BES'imde ne kadar var" sorusunda `bes_birikim.toplam_birikim`'i söyle, `amount`'ı DEĞİL. ⚠️ **`bes_birikim` YOKSA birikim TUTARINI UYDURMA** ve katkı paylarını toplayıp birikim diye SUNMA (getiri/devlet katkısı o toplamda yoktur) — "sağlayıcıdan güncel veri gelmemiş" de. ⚠️ **STOPAJI SEN HESAPLAMA:** matrah yalnız GETİRİ'dir (anapara + devlet katkısı HARİÇ, 6327 sk.); toplam birikim üzerinden hesaplarsan vergi ~8 KAT şişik çıkar. ⚠️ BES bir HARCAMA DEĞİL yatırım katkısıdır (`type='transfer'`) ⇒ harcama toplamlarına KATMA. `updated_at` eskiyse rakamın ne kadar taze olduğunu kullanıcıya SÖYLE.

list_recurring

Geçerli bölge kodları (create_vendor region_code).

list_regions

Maaş kayıtları (dönem, net, brüt, işveren).

list_salary

ETİKETLER (Araç, Melis, Tatil). add_expense tags buradan seç (uydurma).

list_tags

GERÇEK işlem/harcama geçmişi (id, tarih, satıcı, tutar, PB, kategori, tip — EN YENİ ÖNCE). "Son alışverişim / bu yıl Migros / 1000 TL üstü" için BUNU çağır (uydurma). Filtreler backend'de; id = update_transaction/delete_item için. ⚠️ **BEKLEDİĞİNDEN AZ KAYIT GÖRÜRSEN "EKSİK/SİLİNMİŞ" SANMA — pencereye bak:** varsayılan `limit` 200 ve sıralama EN YENİ ÖNCE, yani filtre vermeden çağırırsan yalnız son birkaç ayı görürsün; eski kayıtlar SİLİNMİŞ değil, sayfanın DIŞINDADIR. Geçmişi tarıyorsan `from`/`to` ver ve `more` uyarısı geldikçe `offset` ile SAYFALA. Bir düzenli ödemenin/faturanın geçmişi için `recurring_id` filtresini kullan (tüm geçmişi çekip elle süzme). Kullanıcıya "veriniz kayıp/eksik" demeden ÖNCE bu iki şeyi doğrula. 📁 **KLASÖR:** harcama Bireysel dışındaki bir klasördeyse (Ticari/özel defter) satırda `mali_hesap` alanı gelir; **alan YOKSA o satır Bireysel'dir**. Klasör bazlı toplam sorulursa (ör. "ticari harcamalarım") bu alana göre KIR. 🏷️ **ETİKET:** satır etiketliyse `tags` alanı gelir (AD listesi, ör. ["Araç","Tatil"]); **alan YOKSA o satırın etiketi yoktur**. `tag` parametresiyle süzdüğün alan budur. 🧾 **FATURA DÖNEMİ:** satırda `bill_period` ("YYYY-MM") varsa o faturanın AİT OLDUĞU dönemdir — ödeme tarihinden FARKLIDIR (Haziran dönemi 15 Temmuzda ödenir). "Haziran faturası" gibi sorularda `date` değil BUNU kullan — "hangi etiketleri var / Arac etiketli harcamalar" sorularını bununla cevapla, uydurma.

list_transactions

Satıcı listesi. Yeni satıcıdan önce q ile ara (q:"mig"→Migros var mı) — dupe önle. q'suz ilk 300 döner; belirli satıcıda HER ZAMAN q kullan.

list_vendors

"X faturasını/aboneliğimi ÖDEDİM" → MEVCUT düzenli ödemenin bekleyen taksidini ödendi işaretler. ⚠️ add_expense KULLANMA (bağımsız İKİNCİ kayıt = çift). Önce list_recurring. Belirsiz tutarda amount ZORUNLU. Faiz girişinde amount=NET (brüt−stopaj). Dönem biliniyorsa period, vade biliniyorsa due gönder (aşağıda) — doğru dönemin taksidi seçilir ve döneme damgalanır. Aynı gün aynı tutarda GERÇEKTEN iki ayrı ödeme varsa ikincisine allow_duplicate:true ekle (yoksa mükerrer sayılıp reddedilir).

mark_recurring_paid

Ekstre kalemlerini kullanıcının GEÇMİŞİYLE server-side eşleştirir (tutar ±0.01 + tarih ±3g + aynı PB) — binlerce işlem çekmeden. Döner: eşleşme istatistiği + alias_candidates (ham ad ↔ kanonik satıcı). Çok-ekstre analizinde import ÖNCESİ çağır; alias_candidates'ı özetle, onaylanırsa teach_alias.

match_statement_history

"Kredi taksitimi ödedim" → MEVCUT kredinin taksitini ödendi işaretler. ⚠️ add_expense KULLANMA (bağımsız çift kayıt). Önce list_loans.

pay_loan_installment

BES (bireysel emeklilik) BİRİKİM verisini sağlayıcı portalından okunmuş hâliyle kaydeder — kullanıcı ONAYI GEREKMEZ, çünkü bu bir işlem değil BESLEMEDİR (kur/enflasyon verisi gibi). ⚠️ SADECE sağlayıcının kendi ekranından OKUNAN veri için; tutar UYDURMA, hesaplama YAPMA, kullanıcıdan duyduğun rakamı buradan yazma (o zaman setup_recurring/mark_recurring_paid kullan). Finansal işlem YARATMAZ, harcama/gelir tablosuna DOKUNMAZ. snapshot = sağlayıcıdan gelen JSON (birikim, katkı payı, fonlar, değişim...). contract_no verilmezse snapshot.guncel.sozlesme_no kullanılır. Aynı sözleşme yeniden yazılırsa ÜZERİNE yazar (mükerrer kayıt olmaz).

push_bes_snapshot

HENÜZ ONAYLANMAMIŞ (pending) kendi önerini kullanıcının gelen kutusundan geri çeker — "yanlış gönderdim, doğrusunu göndereyim". SADECE pending etkilenir (kayıt SİLİNMEZ, "recalled" olarak arşivlenir); onaylanmışsa delete_item gerekir. which="last" (default) / "all". Şifreli-başlıklı öneride match yerine op kullan.

recall_suggestion

"X faturasının TUTARI BELLİ OLDU ama HENÜZ ÖDENMEDİ" → belirsiz tutarlı düzenli ödemenin o DÖNEMİNE tahakkuk yazar. ⚠️ mark_recurring_paid DEĞİL: o ÖDENDİ demektir ve kaydı YAKLAŞAN'dan düşürür; bu araç kaydı BEKLEYEN bırakır, yalnız tutarını doldurur. Vade gelmeden fatura tutarını öğrendiğinde (aidat/elektrik/doğalgaz/su portalı, fatura e-postası) BUNU kullan. ⭐ O dönem için bekleyen kalem HİÇ YOKSA cihaz onu YARATIR (pre-gen'in ulaşmadığı dönem) — add_expense kullanma, bağımsız ikinci kayıt = çift. Ödendiğinde ayrıca mark_recurring_paid gönder.

record_accrual

MEVCUT (geçmiş) işleme SONRADAN iade/puan ekler — "şu işlemi iade ettim / puan geldi". ÖNCE list_transactions (id al). Orijinal DEĞİŞMEZ; iade AYRI gelir satırı bağlanır. Yeni harcamayla iade için bunu DEĞİL add_expense cashback.

refund_transaction

Bir kredi SENARYOSUNU cihaza kaydeder (Ofis → Kredi Hesaplama → Kayıtlı hesaplamalar). Kullanıcı "bunu kaydet / hesaplamayı sakla" derse çağır. Girdiler calculate_loan ile AYNI; sunucu hesabı KENDİSİ yapar, sen taksit/toplam GÖNDERME. ⚠️ Gerçek kredi kaydı DEĞİL (o setup_loan) — bu bir simülasyondur. Onay kartı kullanıcının telefonuna düşer.

save_loan_calc

"10 Temmuzda 1,03 TL MKK/BSMV kesintisi oldu" → vadeli/faiz hesabının O TARİHİNE kesinti kaydı yazar. Aynı tarihte kesinti varsa DEĞİŞTİRİR (çift yazmaz); amount 0 → o tarihin kesintisini SİLER. Motor kesintiyi kapanış sonrası ANA PARADAN düşer ⇒ sonraki günlerin faizi doğru hesaplanır. ⛔ add_expense KULLANMA — bu kullanıcının harcaması değil, hesabın kendi kesintisidir (harcama toplamını yanlış şişirir). Önce list_recurring; yalnız vadeli/faiz kaydına yazılabilir.

set_interest_deduction

Kredi + taksit planı kurar (inbox onayı). Önce list_loans (dupe). Banka OTO tahsilat talimatı varsa is_auto:true. Vergi GÖNDERME (cihaz bölgeye göre hesaplar).

setup_loan