BSMV BEYANNAME PROGRAMI v1.0 - KULLANIM KILAVUZU ================================================== Geliştirici: Burak Doruk Bu program, Excel'deki fonlar için BSMV (0021 BANKA) beyannamelerini E-Beyan üzerinden HAZIRLAR, ONAYLAR, İNDİRİR, Excel ile KONTROL EDER ve PDF'leri BİRLEŞTİRİR. GEREKENLER - Windows bilgisayar ve Google Chrome (ya da Microsoft Edge) - Kendi GİB / Dijital Vergi Dairesi kullanıcı kodunuz ve şifreniz - Kurulum gerekmez: BSMV_Beyanname.exe dosyasını bilgisayarınıza kopyalayıp çift tıklayın. (Windows "bilinmeyen yayımcı" uyarısı verirse: "Ek bilgi" > "Yine de çalıştır".) PROGRAM GİRİŞİ (LİSANS) - Program açılınca giriş ekranı gelir: geliştiricinin (Burak Doruk) size verdiği kullanıcı adı ve şifreyi yazın. Bu, GİB şifresi DEĞİLDİR; programın lisans hesabıdır. İnternet bağlantısı gerekir. - "Beni hatırla" işaretlenirse bu bilgisayarda bir dahaki açılışta şifre sorulmaz (ortak bilgisayarda işaretlemeyin). - Sol menünün altında lisans sahibi ve kullanıcı adı yazar; "Oturumu kapat" ile çıkış yapılır. - Hesap kapatılırsa ya da süresi dolarsa program açılmaz: geliştiriciyle görüşün. - Bir hesap yalnızca izin verilen sayıda bilgisayarda kullanılabilir. - Programa yalnızca kullanıcı adı ve şifre için internet üzerinden lisans sunucusuna bağlanılır; Excel, VKN, tutar ve PDF gibi veriler hiçbir yere gönderilmez. EXCEL DÜZENİ - En kolayı: programda "＋ Örnek Excel oluştur" butonu. Liste/şirket adını yazın; doğru düzende ve doğru adla boş bir Excel oluşturulur, Excel'de açılır ve programda seçilir. Fonları 'Fonlar' sayfasına 3. satırdan itibaren girin, KAYDEDİN, programda "↻ Yenile"ye basın. (Açıklama sayfasında örnek vardır.) - Dosya adı dönemi göstermeli: __.xlsx (ör. FPY_bsmv calisma_9_2026.xlsx) - Veriler 3. satırdan başlar: B = Fon kodu, C = Unvan, D = Vergi no, E = t-1 tutarı, F = t-2 tutarı - Tutar sütunları 1. satırdaki BAŞLIĞA göre bulunur ("T-1 ) ..." ve "T-2 ) ..."). Yalnızca t-2 verilecek bir listede T-1 sütununu silebilirsiniz: T-2 sütunu E'ye kaysa da doğru okunur, t-1 = 0 sayılır. (Bu durumda "Beyanname şablonu" = "Sadece t-2" seçin.) - Boş ya da "-" görünen tutarlar beyannameye 0,00 olarak girilir. - PDF'ler varsayılan olarak Excel'in yanında, Excel ile AYNI ADLI klasöre iner (ör. Masaüstü\FPY_bsmv calisma_9_2026\). Başka bir klasör isterseniz Fonlar ekranındaki "PDF klasörü" satırında "Değiştir…" ile seçin; seçim o Excel dosyası için hatırlanır. "Varsayılan" ile geri dönersiniz, "📁 Aç" klasörü Windows Gezgini'nde açar. İndirme, beyan, kontrol ve birleştirme hep bu klasörü kullanır. - "Dosya adının başına fon kodu ekle" açıksa inen PDF'ler FONKODU_ olarak kaydedilir (ör. NPE_1234567890_Banka_202609202609_Beyanname.pdf). Kapalıysa sitenin orijinal adı kullanılır. Seçim hatırlanır; klasörde zaten olan dosyaların adı değişmez. Kontrol ve birleştirme iki adı da tanır. EKRANLAR Sol menü: Fonlar · Kontrol & Birleştir · Ayarlar. Sol altta GİB bağlantı durumu ve "Giriş yap". 1) GİRİŞ "Giriş yap"a basın. İlk seferde kullanıcı kodu ve şifrenizi sorar (yalnızca rakam; şifre en fazla 6 hane). İsterseniz bilgiler bu bilgisayarda Windows Kimlik Bilgileri Yöneticisi'nde şifreli saklanır. Program Chrome'da https://ebeyan.gib.gov.tr/tr adresini açar, "Dijital Vergi Dairesi" butonuna basar, açılan giriş formunu doldurur ve DOĞRULAMA KODU resmini gösterir: kodu yazıp Enter'a basın. Giriş olunca Dijital Vergi Dairesi'nde "Geçiş Yapılabilecek Uygulamalar" bölümündeki e-Beyan'a tıklanır, "Yönlendirmeyi Onaylıyor Musunuz?" penceresinde ONAYLA'ya basılır ve E-Beyan açılır. Durum yeşil "● E-Beyan'a bağlı" olmalı. (Oturum zaten açıksa kod sorulmaz.) E-Beyan otomatik açılmazsa, Chrome'da Dijital Vergi Dairesi'nden e-Beyan'a kendiniz girip "Elle giriş yaptım / kontrol et"e basın. Program Chrome'u simge durumunda (görev çubuğunda) açar ve arkada tutar; doğrulama kodu programın penceresinde sorulur. Programın açtığı Chrome'u işlem bitene kadar KAPATMAYIN. 2) FONLAR EKRANI - "Excel seç…" ile listeyi seçin; fonlar tabloya gelir. Yıl/ay dosya adından gelir. "✕ Kaldır" listeyi programdan çıkarır ve tabloyu sıfırlar (Excel dosyası silinmez; program bir sonraki açılışta Excel'i kendiliğinden yüklemez, yeni Excel seçince bu geri gelir). Girilen ay BEYANNAMENİN DÖNEMİDİR. Excel adındaki dönemle seçilen dönem farklıysa işlem yapılmaz. - "Beyanname şablonu": beyannameye hangi 6802/29 istisna satırlarının gireceğini seçin: t-1 ve t-2 : 19 - t-1 (Excel E) ve 20 - t-2 (Excel F) Sadece t-1 : yalnızca 19 - t-1 (Excel E) Sadece t-2 : yalnızca 20 - t-2 (Excel F) Seçim her liste için hatırlanır (ör. FPY listesi bir kez "t-1 ve t-2" seçilince sonraki aylarda da öyle gelir). Şablon dışında kalan sütun tabloda "—" görünür. O sütunda Excel'de 0'dan farklı tutar varsa "⚠" ile işaretlenir ve o fon HAZIRLANMAZ/ONAYLANMAZ (yanlış şablon seçilmiş olabilir). Kontrol ekranı da seçili şablona göre denetler (şablonda olmayan satır beyannamede bulunmamalı). - "Durumları sorgula": her fonun o dönemdeki durumunu getirir. Satır renkleri: yeşil = Onaylandı · mavi = Onay bekliyor · turuncu = Taslak · beyaz = Beyanname yok · kırmızı = Hata Üstteki kartlar sayıları gösterir; "PDF klasörde" beyanname+tahakkuk PDF'i inmiş fon sayısıdır. Sorgu, beyanname varsa (onaylı / onay bekleyen / taslak) içindeki 6802/29 tutarlarını da okur: "Beyanname t-1 / t-2" sütunları beyannamedeki tutarlardır, "Excel = Beyan" sütunu karşılaştırmadır. Excel'den farklıysa (ya da beyannamede başka istisna satırı varsa) satır KIRMIZI olur, Not'ta farkın ne olduğu yazar, "Tutar Excel'den farklı" kartı sayar; "Göster: Tutar farklı" ile yalnızca onlar listelenir. Excel'i değiştirdiyseniz KAYDEDİP "↻ Yenile"ye, sonra "Durumları sorgula"ya basın. - "Ortam" (Gerçek E-Beyan / TEST e-Beyan) bu ekrandan da seçilebilir (bkz. 4) AYARLAR). - Seçim: satırın başındaki ☐ kutusuna tıklayın, "Tümünü seç" ya da başlıktaki ☐ ile hepsini seçin. Satırları fareyle (Ctrl/Shift) seçip BOŞLUK tuşuna basarak da işaretleyebilirsiniz. - "⇩ Excel'e aktar": tablodaki satırları (filtre/arama varsa yalnızca görünenleri) yeni bir Excel'e kaydeder ve açar: fon kodu, unvan, VKN, Excel ve beyanname t-1/t-2, Excel = Beyan, durum, beyanname ID, PDF, not. Dosya varsayılan olarak PDF klasörüne _durum_.xlsx adıyla kaydedilir. "Göster" ile yalnızca belirli durumdakileri listeleyip (ör. "Beyanname yok") sonra "Tümünü seç" deyin. - Seçili fonlar için: ✎ Beyan HAZIRLA : Taslak oluşturur, t-1/t-2'yi girer, kaydeder → "Onay bekliyor". ONAYLAMAZ. Başkasının açtığı taslak yalnızca içeriği Excel ile birebir aynıysa tamamlanır. 📄 Taslak İNDİR : Onaylamadan ÖNCE kontrol için: seçili "Taslak" / "Onay bekliyor" fonların beyanname PDF'ini PDF klasörü\Taslaklar altına indirir ve Excel ile karşılaştırır (Not'ta "TUTUYOR"/"SORUN"). Yalnızca butona basınca iner; PDF'i açmaz. Hiçbir şeyi onaylamaz/değiştirmez. (Taslak PDF'te "GEÇERSİZDİR" damgası olması normaldir; tahakkuk PDF'i onaydan sonra oluşur.) ✔ ONAYLA ve indir: Yalnızca "Onay bekliyor" olanlar. Onaydan HEMEN ÖNCE her şey yeniden doğrulanır: dönem, VKN, yalnızca t-1/t-2 olması, tutarların Excel ile aynı olması (taslak PDF üzerinden), tahakkukun Ayarlar'daki tutar (791 TL) olması. Tutmayan fon onaylanmaz. EVET yazmadan başlamaz. GERİ ALINAMAZ. Onaylanan fonun PDF'leri iner, Excel satırı sarıya boyanır. ⬇ PDF İNDİR : "Onaylandı" olanların beyanname ve tahakkuk PDF'lerini indirir (Excel'i boyamaz). - Durdur: o anki fon bittikten sonra durur (yarım işlem bırakmaz). ÖNERİLEN AKIŞ: Durumları sorgula → "Beyanname yok"ları seç → HAZIRLA → kontrol et (tablo/Chrome) → "Onay bekliyor"ları seç → ONAYLA → "Onaylandı" olup PDF'i eksik olanları seç → PDF İNDİR. 3) KONTROL & BİRLEŞTİR - Kontrol et: klasördeki tüm beyanname/tahakkukları Excel ile karşılaştırır (dönem, taslak olmaması, t-1/t-2 tutarları, başka kalem olmaması). Sonuç günlükte ve klasördeki _tutar_tablosu.csv dosyasında. - Birleştir: her fon ayrı / hepsi tek dosya / beyannameler-tahakkuklar ayrı. Dosyalar "Birlesik" alt klasörüne yazılır; orijinallere dokunulmaz. 4) AYARLAR Çalışma ortamı: "Gerçek E-Beyan" ya da "TEST e-Beyan" (GİB'in test sitesi, ebeyanpreprod.gib.gov.tr; Dijital VD'de "Test e-Beyan" kartı). Test ortamında: - sol menüde turuncu "⚠ TEST ORTAMI" yazar, pencere başlığında da görünür; - verilen beyannameler GERÇEK DEĞİLDİR; - PDF'ler PDF klasörünün içindeki "TEST_ORTAMI" alt klasörüne iner (gerçek PDF'lerle karışmaz); - Excel satırı sarıya boyanmaz. Ortamı değiştirdikten sonra "Giriş yap"a basın (Dijital VD'de ilgili karta geçilir). Gerçek beyannameye dönmeden önce ortamı "Gerçek E-Beyan" yapmayı unutmayın. Beyannameyi Düzenleyen: T.C. Kimlik No, Vergi Kimlik No, Adı Soyadı/Ünvanı, E-posta, Telefon. Sistem düzenleyen bilgisini getirir; boş gelen her alan (ya da hiç gelmezse hepsi) buradan doldurulur. Hangi alanların buradan alındığı fonun Not'unda yazar. Alan boş kalırsa beyan hazırlanmaz. Mükellef (sıfat) e-posta/telefon: sistemden boş gelirse kullanılır. Beklenen tahakkuk tutarı; GİB giriş bilgilerini girme/değiştirme/silme. SORUN GİDERME - "E-Beyan bağlantısı yok": tekrar giriş yapın (oturum zaman aşımına uğramış olabilir). - Satır kırmızı "Hata": Not sütununda nedeni yazar; işlem günlüğünde ayrıntı vardır. Not uzunsa satıra ÇİFT TIKLAYIN: fonun tüm bilgileri (tam not, Excel/beyanname tutarları) pencerede açılır. - "Önceki onaylı beyanname yok ve N şube var": fonun daha önce verilmiş beyannamesi yok ve birden fazla şubesi var; program şubeyi tahmin etmez. (Tek şube varsa otomatik o kullanılır.) - Excel satırı boyanamadıysa beyan yine verilmiştir; Not'ta "BOYANAMADI" yazar, satırı elle boyayın.