Damga Vergisi Defteri Kullanım kılavuzu

1. Bu uygulama ne yapar?

Damga Vergisi Defteri, sürekli damga vergisi mükellefi firmalar ve onların defterini tutan mali müşavirlik ofisleri içindir. Her firmanın sözleşme ve kağıtlarını damga vergisi defteri olarak tutar: sıra numarası, düzenlenme tarihi, kağıt numarası, konu, karşı taraflar, işlem türü ve vergi. Vergiyi GİB'in işlem türleri tablosundaki oran ve maktu tutarlarla hesaplar. Sözleşme listenizi Excel'den aktarır. Her ay GİB'in üç Excel şablonuna (defter, taraf ve tür bilgileri) uygun dosyaları hazırlar.

• Birden fazla firmanın defterini aynı programda tutarsınız.
• Beyan ettiğiniz ayı kapatırsınız. Kapatılan ayın kayıtları ve sıra numaraları değişmez.
• Masaüstü: veriler yalnız bu bilgisayarda, Belgeler klasörünüzde durur. Hesap, üyelik veya giriş yoktur.
• Web: aynı program ofisinizin sunucusunda tarayıcıda çalışır (bkz. 2.4 Web sürümü: adres ve giriş). Ofisin çalışanları e-posta adresi ve şifreyle girer, aynı defteri paylaşır; her kişi rolüne göre çalışır.
• Program internete yalnız güncellemeler için bağlanır (maliofis.tr). GİB'e bağlanmaz ve beyanname vermez; hazırladığı dosyaları siz kullanırsınız.

2. Kurulum ve ilk açılış

Windows 10 ya da Windows 11 (64 bit) gerekir.

2.1 e-Dönüşüm Asistanı ile kurulum

1. e-Dönüşüm Asistanı'nda Uygulamalar sayfasını açın.
2. Damga Vergisi Defteri kartında Yükle'ye basın.
3. Onay penceresi indirilecek dosyayı ve kurulumu anlatır. İndir, kur ve aç ile onaylayın.
4. Dosya maliofis.tr'den iner. Boyutu ve SHA-256 özeti Asistan'daki doğrulanmış değerle tutmazsa kurulum başlamaz.
5. Kurulum arka planda yapılır; ayrı bir kurulum penceresi açılmaz. Kurulum doğrulanınca Asistan programı açar.

Kurulum yalnız sizin Windows kullanıcınız içindir ve yönetici izni istemez. Asistan'dan yapılan kurulum masaüstüne kısayol koymaz. Programı Asistan'daki Aç ile ya da Başlat menüsündeki Damga Vergisi Defteri ile açarsınız.

2.2 maliofis.tr'den indirerek kurulum

1. https://maliofis.tr/indir/damga-vergisi-defteri/ sayfasından kurulum dosyasını (DamgaVergisiDefteri-Kurulum-<sürüm>.exe) indirin.
2. Dosyayı çalıştırın. Kurulum dosyasında kod imzası olmadığı için Windows SmartScreen uyarı verebilir; Ek bilgi › Yine de çalıştır'ı seçin.
3. Türkçe kurulum sihirbazının adımlarını izleyin. Sihirbaz programı varsayılan olarak yalnız sizin için kurar; bilgisayardaki herkes için kurmayı seçerseniz Windows yönetici izni ister. Kurulum klasörünü değiştirebilirsiniz.
4. Sihirbaz masaüstüne ve Başlat menüsüne Damga Vergisi Defteri kısayolunu ekler. Programı bu kısayollardan açın.

2.3 İlk açılış

Program doğrudan Genel bakış sayfasıyla açılır. İlk açılışta henüz firma olmadığı için “Henüz firma yok” yazar. İlk firmayı ekleyin ile başlayın (bkz. 4.1 Firma eklemek).

• Pencerenin başlığında “Mali Ofis Damga Vergisi Defteri” ve sürüm yazar.
• Görünüm Windows'un açık ya da koyu ayarını izler; Ayarlar › Genel › Tema'dan Açık ya da Koyu seçebilirsiniz.
• Güncellemeden sonraki ilk açılışta Bu sürümde neler var penceresi yenilikleri bir kez gösterir; Tamam ile kapatın. Aynı liste Ayarlar › Hakkında'da durur.
• Daha önceki bir sürümü kullandıysanız verileriniz ilk açılışta yeni klasöre bir kez taşınır (bkz. 5.4 Eski klasörden taşıma).
• Program aynı anda tek pencerede çalışır. Açıkken yeniden açmaya çalışırsanız açık pencere öne gelir.
• Genel bakışın üstündeki İlk adımlar kartı ilk firmayı eklemeyi, Excel'den aktarmayı ve aylık çıktıyı adım adım gösterir; işi yaptıkça madde işaretlenir. Kartı Gizle ile kapatabilir, Yardım › İlk adımlar ile yeniden açabilirsiniz.

2.4 Web sürümü: adres ve giriş

Web sürümü ofisinizin sunucusunda (ör. Synology NAS) çalışır; kurulumu Mali Ofis ya da ofisinizin bilgi işlemcisi yapar. Tarayıcıda ofisinizin adresini açın (ör. https://damga.maliofis.tr). Güncel Chrome, Edge, Firefox ya da Safari yeterlidir; telefonda da çalışır ve ana ekrana eklenebilir.

1. İlk kurulum (yalnız bir kez), iki adım: sunucu ilk açıldığında, sunucunun günlüğüne ve veri klasöründeki ilk-kurulum-kodu.txt dosyasına 8 karakterlik bir kurulum kodu yazar. Adresin sonuna /#/kurulum ekleyip açın. Adım 1 · Yönetici hesabı: kodu, ofisin adını, adınızı, e-posta adresinizi ve şifrenizi girin; bu hesap Ofis yöneticisi olur. Adım 2 · Sistem e-postası: davet, doğrulama ve şifre sıfırlama e-postalarının gideceği hesap. Gönderen adresinizi yazınca sağlayıcı (Gmail / Google Workspace, Outlook / Hotmail, Microsoft 365, Yandex, Yahoo, iCloud) kendiliğinden tanınır, sunucu ve kapı dolar; hesabınızın kendi şifresi değil, sağlayıcının uygulama şifresi gerekir (bağlantı ve adımlar formdadır). Deneme gönder kendi adresinize bir deneme iletisi yollar; başarılı olunca Kurulumu tamamla açılır. İnternet ya da e-posta hesabı hazır değilse E-postayı sonra ayarlayacağım ile geçebilirsiniz; o zaman yöneticiler sayfanın üstünde kapatılamayan bir uyarı şeridi görür ve Ayarlar › E-posta sekmesi Eksik rozeti taşır. Sunucunun kurulum dosyasında (.env) e-posta ayarlıysa adım dolu ve değiştirilemez gelir; yalnız deneme gönderirsiniz.
2. Giriş: e-posta adresiniz ve şifrenizle girersiniz. Şifre en az 10 karakterdir, harf ve rakam içerir. Üst üste 8 yanlış denemede hesap 15 dakika kilitlenir. Ofis yöneticisi seçeneği açtıysa giriş kartında Beni hatırla görünür; işaretlerseniz oturum bu tarayıcıda 30 gün sürer. Yoksa oturum tarayıcı kapanınca ya da 12 saat işlem yapılmayınca biter.
3. İlk giriş sihirbazı: Ofis yöneticisine dört adım: Büro bilgileri (ofis ünvanı; kurulumdaki ofis adıyla dolu gelir, Genel bakış başlığında görünür), Bilgileriniz (ad ve soyad), Aydınlatma metni (kişisel verilerinizin nasıl işlendiği; Okudum okundu kaydıdır) ve Hazırsınız. Öteki roller Bilgileriniz'den başlar. Her adım Devam et ile kaydedilir; Geri önceki adıma döner; yarıda bırakırsanız sonraki girişte kaldığınız adımdan sürer. Sihirbazı Ayarlar › Genel › Kurulum sihirbazını yeniden aç'tan, kayıtlı bilgilerle, yeniden açarsınız.
4. Hesabım: sol alttaki kullanıcı kartına basıp Hesabım'ı seçin; pencere açılır. Bilgileriniz (ad, soyad ve e-posta adresi; adresi değiştirirseniz şu anki şifrenizi sorar ve yeni adrese doğrulama bağlantısı gider), Şifre değiştir (şu anki şifre, yeni şifre ve tekrarı; şifre değişince öteki oturumlarınız kapanır) ve Oturumlar (Öteki oturumları kapat). Her bölüm kendi Kaydet'iyle kaydedilir.
5. Çalışan eklemek: Ofis yöneticisi Ayarlar › Kullanıcılar › Kullanıcı ekle ile adı, e-posta adresini ve rolü girer. Kişiye 72 saat geçerli bir davet e-postası gider; kişi bağlantıyla şifresini belirler. E-posta ayarlı değilse bağlantı ekranda gösterilir; kişiye siz iletirsiniz.
6. Şifremi unuttum: giriş ekranındaki bağlantı e-postanıza 1 saat geçerli bir şifre belirleme bağlantısı gönderir. E-posta ayarlı değilse şifrenizi Ofis yöneticisi sıfırlar.

• Roller: Ofis yöneticisi her şeyi yapar (kullanıcılar, ayarlar, yedek, güncelleme, dönemi yeniden açma). Ofis kullanıcısı firmaları ve kayıtları ekler ve düzenler, açık dönemin kayıtlarını siler, dönemi kapatır; firma silemez, kapatılmış dönemi açamaz. Ofis izleyicisi yalnız görür, dışa aktarır ve yazdırır. Rolünüzün yapamadığı işin düğmesi görünmez. Ayrıntılı tablo bu bölümün sonundaki Kim ne yapabilir'dedir.
• Aynı anda çalışmak: iki kişi aynı kaydı düzenleyip ikisi de kaydederse ikinci kaydeden “Bu kayıt siz düzenlerken değiştirildi.” iletisini görür; kaydı yeniden açıp değişikliği görerek kaydeder.
• Bağlantı koparsa: “Sunucuya ulaşılamıyor” iletisi çıkar; sunucu yeniden açılınca sayfayı yenileyin.
• Masaüstü ile web sürümü aynı defter biçimini kullanır: masaüstünden aldığınız yedeği web'e, web'den indirdiğiniz yedeği masaüstüne yüklersiniz (bkz. 5.5 Web sürümünde veriler ve yedekler).

2.5 Demo

Web sürümünü kurmadan denemek için demo kurulumu vardır: https://damga-demo.maliofis.tr. Giriş sayfasındaki Demo hesabı için tıklayın bağlantısı da oraya gider.

1. Hesap: Demo hesabı açın formuna adınızı, soyadınızı ve e-posta adresinizi yazın; Aydınlatma metnini okudum. kutusunu işaretleyin. Bilgilendirme ve kampanya e-postası almak istiyorum. kutusu isteğe bağlıdır; izninizi her e-postadaki bağlantıyla geri alabilirsiniz. Doğrulama bağlantısı gönder ile e-postanıza 24 saat geçerli, bir kez kullanılan bir bağlantı gelir. E-postayla şifre gönderilmez: bağlantıyı açınca Yeni şifre belirleyin kartında şifrenizi kendiniz belirler ve demoya girersiniz.
2. Rolünüz: demoda Ofis kullanıcısısınız (örnek büro “Örnek Mali Müşavirlik”): firma ve kayıt ekler, Excel'den aktarır, aylık çıktı alırsınız; kullanıcıları ve ayarları değiştiremezsiniz, öteki ziyaretçileri görmezsiniz. Demoda e-posta (doğrulama ve şifre sıfırlama dışında), güncelleme ve dış bağlantılar kapalıdır; bu düğmeler soluk görünür ve “Demoda kapalı” der.
3. Kayıtlar: her sayfanın üstündeki sarı şerit hatırlatır: demoya girdiğiniz kayıtlar her gece 03.00'te silinir, örnek kayıtlar baştan kurulur; demo hesabınız kalır. 30 gün kullanılmayan demo hesabı kişisel bilgileriyle birlikte silinir. Gerçek kişi bilgisi girmeyin.

İlk adımlar

Ana sayfanın en üstündeki “İlk adımlar” kartı şu işleri gösterir; iş yapılınca madde kendiliğinden işaretlenir. Kart “Bu kartı gizle” ile kapanır; Yardım › İlk adımlar ile yeniden açılır.

1. İlk firmayı ekleyin: Firmalar › Firma ekle.
2. Kayıtları Excel'den aktarın: Excel'den aktar: sözleşme listenizi dört adımda deftere alın.
3. Aylık çıktıyı alın: Aylık Excel çıktısı: GİB'in üç şablonu.

Kim ne yapabilir

Bu uygulamada hesap ve rol yoktur:

• Rol yoktur; programı açan Windows kullanıcısı her işi yapar. Koruma Windows hesabıdır.
• Geri alınamayan ya da bilgisayarın dışına etki eden her iş uygulamanın kendi onay penceresiyle başlar (varsayılan düğme “Vazgeç”): kurulum, kaldırma, güncelleme, geri yükleme, bütün veriyi ya da bir firmayı silme, uzak destek, sorun bildirimi.
• Program yönetici yetkisiyle çalışmaz ve kendini yükseltmez; yönetici yetkisi gereken adımı Windows sorar.

3. Ekranlar ve menüler

3.1 Sol menü ve firma seçimi

Sol menü her sayfada görünür. Görünümü bütün Mali Ofis uygulamalarında aynıdır:

• En üstte Mali Ofis logosu, altında program adı ve Sürüm satırı.
• Firma kartı: Seçili firmanın unvanı ve kimlik numarası (VKN ya da TCKN). Karta tıklayınca Firma seçin penceresi açılır (aşağıda).
• İşlemler: Genel bakış, Damga vergisi defteri, Excel'den aktar ve Aylık Excel çıktısı. Henüz firma yoksa son üçü soluk görünür ve Firmalar sayfasına götürür.
• Başvuru: İşlem türleri ve oranlar.
• Program: Firmalar ve en sonda Ayarlar.
• En altta, yardım (bütün Mali Ofis uygulamalarında aynı sırada): Kullanım kılavuzu (programla gelen bu kılavuzu varsayılan tarayıcınızda açar; F1 de açar), İlk adımlar (yalnız kartı gizlediyseniz ve adımlar bitmediyse), Klavye kısayolları, Sorun bildir ve Mali Ofis destek (bkz. 9. Destek).

Seçili firma, firmaya ait sayfaların başlığının altında da yazar.

Firma seçin penceresi

• Açılınca imleç arama kutusundadır. Unvanın ya da kimlik numarasının bir bölümünü yazın; liste yazdıkça süzülür. Türkçe harfler duyarsızdır: “cinar” yazınca “ÇINAR …” bulunur. Bulunamazsa “Bu aramayla firma bulunamadı.” yazar.
• Son kullanılanlar: bu bilgisayarda en son seçtiğiniz beş firma, en yenisi üstte.
• Tüm firmalar (A–Z): bütün firmalar Türkçe alfabe sırasıyla. Seçili firmanın yanında onay işareti vardır.
• ↑ ↓ ile gezinin, Enter ile seçin, Esc ile kapatın. Fareyle satıra tıklayarak da seçersiniz.
• Firmaları yönet Firmalar sayfasını, Yeni firma yeni firma formunu açar.
• Defter, Excel'den aktar ya da Aylık Excel çıktısı sayfasındaysanız seçtiğiniz firmanın aynı sayfası, başka bir sayfadaysanız defteri açılır.

3.2 Genel bakış

Bütün firmaların beyan dönemini bir arada gösterir. Beyan dönemi bir önceki aydır: sürekli damga vergisi mükellefiyetinde bir ayda düzenlenen kağıtların vergisi, izleyen ayın 26'sına kadar damga vergisi beyannamesiyle beyan edilip ödenir.

• Üstteki dört kutu: beyan döneminin toplam damga vergisi (kağıt ve firma sayısıyla), Beyan son günü ve kalan gün, Kapatılmayı bekleyen (beyan döneminde kaydı olup dönemi kapatılmamış firma sayısı) ve bu ayın (cari ay) toplamı.
• Her firma için bir kart (firmalar A'dan Z'ye): beyan dönemindeki kağıt sayısı ve vergi, bu ayki kağıt sayısı. Tutarlar “1.234,56 ₺” biçimindedir.
• Karttaki durum: Kapatıldı, Kayıt yok, … gün kaldı (5 gün ve daha azı kırmızı) ya da Beyan süresi geçti. O dönemin Excel çıktısı alındıysa Çıktı alındı da yazar.
• Karttaki Defter ve Çıktı düğmeleri o firmanın beyan dönemini açar.
• Başlığın altında Ayarlar › Genel'de yazdığınız ofis adı görünür.

3.3 Firmalar

Defterini tuttuğunuz mükellef firmaların listesidir (A'dan Z'ye). Sütunlar: Unvan (altında adres), Kimlik no (VKN ya da TCKN), Vergi dairesi, bu yılın Kağıt sayısı ve Damga vergisi toplamı, Son kapalı dönem. Seçili firmanın satırı renklidir.

• Arama kutusu unvan, kimlik numarası ve vergi dairesinde arar. Türkçe harfler ve büyük/küçük harf duyarsızdır: “cinar” yazınca “ÇINAR …” bulunur.
• Defter firmanın defterini açar. Düzenle firma bilgilerini sağdan açılan formda açar.
• Firma ekle yeni firma formunu açar (bkz. 4.1 Firma eklemek).
• 50'den çok firma varsa liste 50'şer satırlık sayfalara bölünür; alttaki Önceki ve Sonraki ile gezinirsiniz.
• Sütun başlığına basınca liste o sütuna göre artan, yeniden basınca azalan sıralanır; başlığın yanındaki ok yönü gösterir. Liste unvana göre (A'dan Z'ye, Türkçe sırayla) açılır.
• Excel'e aktar ekrandaki listeyi (arama ve sıralamayla) iletişim bilgileri ve bu yılın toplamlarıyla Firmalar - YYYY-AA-GG.xlsx dosyasına kaydeder.

3.4 Damga vergisi defteri

Seçili firmanın defteridir; bir ay ya da bütün yıl görünür.

• Ay şeridi: Yılın on iki ayı ve her ayın kağıt sayısı. Alttaki çizgi yeşilse ay kapatılmıştır, sarıysa açıktır, kırmızıysa beyan süresi geçmiş ve ay kapatılmamıştır; griyse ayda kayıt yoktur. Bir aya tıklayınca o ay açılır.
• Özet: dönemin damga vergisi ve kağıt sayısı, İçerdiği belli para (nispi türlerin toplamı), Sıra numaraları ve Beyan son günü.
• Dönem şeridi: Açık ve kaydı olan ayda sarı “Dönem açık” şeridi ve Dönemi kapat düğmesi; kapatılmış ayda yeşil “Dönem kapatıldı” şeridi, kapanış tarihi, notunuz ve Dönemi yeniden aç (bkz. 4.5 Dönemi kapatmak).
• Araç çubuğu: yıl seçici, Ay / Tüm yıl, arama (sıra, kağıt no, konu, taraf; Türkçe harf duyarsız: “ornek” yazınca “ÖRNEK …” bulunur), Excel'e aktar ve Yazdır. Satırları işaretlerseniz … kaydı sil düğmesi çıkar; program önce “… kayıt silinsin mi?” diye sorar.
• Tablo: Sıra, Tarih, Kağıt no, Açıklama / taraflar, Tür (kod ve kısa ad; birden çok nüshada ×2 gibi), Belli para (maktu türde “maktu”) ve Vergi; tutarlar “1.234,56 ₺” biçimindedir. Satıra tıklayınca kayıt açılır (bkz. 3.5 Defter kaydı). Kapatılmış ayın satırlarında onay kutusu yerine kilit vardır. Sütun başlığına basınca liste o sütuna göre sıralanır (yeniden basınca ters); liste sıra numarasına göre açılır.
• 50'den çok kayıt varsa liste 50'şer satırlık sayfalara bölünür; alttaki Önceki ve Sonraki ile gezinirsiniz. Alttaki toplam satırı bütün listenin toplamıdır.
• Başlığın yanında Excel'den aktar, Aylık çıktı ve Kayıt ekle. Kapatılmış ayda Kayıt ekle görünmez.

Sıra numarası. Program her firmanın kağıtlarına düzenlenme tarihine göre sıra numarası verir. Numara varsayılan olarak her yıl 1'den başlar. Ayarlar'da defter boyunca müteselsil numaraya geçebilirsiniz; kapatılmış dönem varken bu seçim değiştirilemez. Açık bir dönemde kayıt eklemek ya da silmek sonraki kayıtların numarasını kaydırır. Kapatılmış dönemlerin numaraları değişmez.

Excel'e aktarmak. Excel'e aktar ekrandaki listeyi (ay ya da yıl, arama ve sıralamayla) sıra no, tarih, kağıt no, açıklama, karşı taraflar, işlem türleri, belli para, vergi ve dönem durumuyla bir Excel dosyasına kaydeder; tutarlar sayı olarak yazılır, son satır toplamdır. Dosya adı Damga vergisi defteri - <firma> - YYYY-AA.xlsx biçimindedir. GİB'e verilecek dosyalar bu değil, Aylık Excel çıktısı'ndaki şablonlardır (bkz. 3.7).

Tüm yıl görünümü yılın bütün kağıtlarını tek listede ve yıl toplamlarıyla gösterir. Kapatılan dönem kutusu yılın kaç ayının kapatıldığını yazar.

Yazdırmak. Yazdır ekrandaki listenin (ay ya da yıl) bütün satırlarını yazdırır; liste sayfalara bölünmüş olsa da hepsi basılır. Sayfanın başına firma unvanı, kimlik numarası, vergi dairesi ve dönem yazılır; ay şeridi, özet ve araç çubuğu yazdırılmaz. Koyu temada da kağıda açık renklerle basılır. PDF dosyası için yazıcı olarak “Microsoft Print to PDF”i seçebilirsiniz.

3.5 Defter kaydı

Bir kağıdın (sözleşmenin) bilgileri kendi sayfasında açılır. Tablodaki bir satıra tıklayınca kayıt düzenlenmek üzere açılır; yeni kayıt için bkz. 4.3 Deftere kayıt eklemek. Deftere dön ya da Vazgeç değişiklikleri kaydetmeden deftere döner.

• Yıldızlı (*) alanlar zorunludur: Düzenlenme tarihi, Kağıt / sözleşme no, Açıklama (kağıdın konusu) ve en az bir karşı taraf. Eksik ya da hatalı alan varsa kaydederken alanın altında kırmızı ileti çıkar ve kayıt yapılmaz.
• Yurt dışında düzenlenmiş (Türkiye'de hükmünden yararlanılmıştır) ve Zaman aşımından sonra (hükmünden yararlanılmıştır) kutuları defter bilgileri şablonuna “EVET” ya da “HAYIR” olarak yazılır.
• Karşı taraflar: her taraf için kimlik türü (Vergi Kimlik No, T.C. Kimlik No, Yurt Dışı Kimlik No), kimlik numarası ve adı ya da unvanı. Taraf ekle yeni satır açar; satırın sonundaki × satırı kaldırır. Firmanın kendisi taraf olarak yazılmaz; yalnız sözleşmenin karşı tarafları girilir.
• İşlem türleri: her tür için İçerdiği belli para, Oran ve Nüsha. Maktu türde tutar ve oran yerine Maktu tutar görünür. Tür ekle aynı kağıda ikinci bir tür ekler.
• Devir var ve Aslından alınan vergi tür bilgileri şablonuna yazılır; hesaplanan vergiyi değiştirmez.
• Her türün altında o türün vergisi, formun sonunda Kağıdın damga vergisi yazar. Üst sınır uygulandıysa bu da yazar.
• Not (çıktıya yazılmaz) yalnız sizin içindir.
• Açık dönemdeki kaydı Değişiklikleri kaydet ile güncellersiniz. Kaydı sil önce “Kayıt silinsin mi?” diye sorar (Vazgeç varsayılandır); silerseniz sonraki kayıtların sıra numarası bir geri kayar.
• Kapatılmış döneme ait kayıt değiştirilemez. Formun üstünde “Bu kayıt kapatılmış bir döneme ait; değiştirmek için önce dönemi yeniden açın.” yazar.

Vergi nasıl hesaplanır? Nispi türlerde içerdiği belli para × oran × nüsha; maktu türlerde maktu tutar × nüsha. Tek nüshanın vergisi o yılın kağıt başına üst sınırını geçerse üst sınır alınır ve tabloda “üst sınır” yazar. Oranlar ve maktu tutarlar 3.8 İşlem türleri ve oranlar listesindeki değerlerdir.

3.6 Excel'den aktar

Sözleşme listenizi bir Excel dosyasından deftere aktaran dört adımlı sihirbazdır: Dosya seçimi, Sütun eşleştirme, Kontrol, Sonuç. Adım adım kullanımı 4.2'dedir.

Kontrol adımı, dosyanın her satırının deftere nasıl gireceğini ve vergisini gösterir:

• Üstte aktarılacak kayıt sayısı ve dönemleri, toplam damga vergisi, uyarılı satır sayısı ve aktarılmayacak (hatalı) satır sayısı.
• Tümü, Uyarılı ve Hatalı düğmeleri listeyi süzer. 50'den çok satır sayfalara bölünür.
• Durum sütunu: “Sorun yok”; sarı satır uyarılıdır ve aktarılır (ör. tür tanınmadı, kimlik numarası geçersiz, tutar 0); kırmızı satır aktarılmaz.
• Aktarılmayan satırlar: tarih okunamadı, kağıt no boş, açıklama boş, karşı taraf yok ya da eksik, dönem kapatılmış, defterde zaten var (aynı tarih ve kağıt no), dosyada tekrar ediyor.

3.7 Aylık Excel çıktısı

Seçili firmanın bir ayının kayıtlarını GİB'in üç damga vergisi defteri şablonuna (Versiyon 6) yazar:

• Ay seçiciyle dönemi değiştirirsiniz; yanında beyan son günü yazar. Sol menüden açıldığında beyan dönemi (bir önceki ay) seçilidir; defterdeki Aylık çıktı defterde açık olan ayı getirir.
• Özet: dönemin vergisi, sıra numaraları ve iki şablonun satır sayıları.
• Uyarılar: dönemde kayıt yoksa yalnız başlık satırlı boş şablonlar oluşur; geçersiz görünen kimlik numaraları ve karşı tarafı olmayan kayıtlar listelenir; dönemin açık ya da kapatılmış olduğu ve daha önce çıktı alındıysa tarihi yazar (Klasörü aç ile).
• Program GİB'in şablon dosyalarını kullanır ve yalnız veri satırlarını ekler. Sayfa koruması, açılır listeler ve hücre biçimleri değişmez.
• Tüm firmalar o dönemde kaydı olan bütün firmaların çıktısını tek seferde oluşturur. Program önce firma sayısını yazıp onay ister; klasörü bir kez seçersiniz, her firma için ayrı alt klasör açılır ve sonunda klasör Dosya Gezgini'nde açılır.

3.8 İşlem türleri ve oranlar

GİB'in DEFTERE_BAGLI_TUR şablonundaki (Versiyon 6) 57 işlem türünün listesidir: sözleşme, nispi ve maktu türler; her birinin oranı (yüzde ve binde olarak) ya da maktu tutarı. Liste yalnız bilgi içindir, değiştirilemez. Arama kutusu kod ya da adla arar (Türkçe harf duyarsız: “sozlesme” “sözleşme”yi bulur). Adlardaki * ve ** işaretleri şablondaki gibidir.

3.9 Ayarlar

Ayarlar tek sayfadır; üstteki sekmeler bütün Mali Ofis uygulamalarında aynı sıradadır. Değişiklikler anında kaydolur; sağ altta “Kaydedildi.” bildirimi çıkar.

• Genel: Tema (Açık, Koyu ya da Sistem; Sistem, Windows'un ayarını izler; seçim bu bilgisayarda saklanır) ve Ofis ya da kullanıcı adı (Genel bakış başlığında görünür).
• Defter: Yeni kayıtlarda varsayılan tür ve Defter sıra numarası (“Her yıl 1'den başlar” ya da “Defter boyunca müteselsil”). Sıra numarası seçimini değiştirirken program onay ister; kapatılmış dönem varken bu seçim değiştirilemez.
• Üst sınır: Kağıt başına azami vergi. Damga Vergisi Kanunu 14. madde gereği bir kağıttan alınacak vergi bu tutarı geçemez. Program 2024, 2025 ve 2026 tutarlarıyla gelir. Yeni yılın tutarını siz girersiniz (bkz. 4.6). Bu yılın tutarı yoksa sekmede uyarı çıkar ve o yılın kağıtlarında sınır uygulanmaz.
• Gizlilik (masaüstü): verilerin yeri ve programın dışarıya ne gönderdiği.
• Firma: seçili firmanın bilgileri; Firma bilgilerini düzenle, Başka firma seçin ve Firmaları yönet.
• İşlem geçmişi: silme, geri yükleme, dönem kapatma ve açma, Excel'den aktarma ve ayar değişiklikleri; kim, ne zaman, hangi kayıtta. Tarihe, kişiye (web) ve işleme göre süzülür, Excel'e aktarılır. Masaüstünde bir yıl, web'de iki yıl saklanır.
• Yedekleme ve veri: son yedeğin zamanı, veri klasörü, Şimdi yedek al, Dosyadan geri yükle, Veri klasörünü aç ve alınmış kopyaların listesi (bkz. 5. Verileriniz ve yedekler).
• Güncelleme: kurulu sürüm, son denetim zamanı, güncellemenin durumu, Güncellemeleri denetle ve güncelleme tercihi (bkz. 6. Güncelleme).
• Hakkında: program adı, sürümü, yayın tarihi ve Masaüstü ya da Web; bu sürümün Yenilikler'i ve Bütün sürüm notları (indirme sayfası); Mali Ofis destek; Gizlilik (programın dışarıya ne gönderdiği ve aydınlatma metni); Lisanslar; Kullanım kılavuzu, Sorun bildir ve destekle konuşurken işe yarayan Bilgileri kopyala (program, sürüm, platform; kişisel veri yok).

Her sekme bir ya da birkaç bölüm kartından oluşur; değişiklikler anında kaydolur ve “Kaydedildi.” bildirimi çıkar. Sekmeler pencereye sığmazsa sekme çubuğu yana kayar.

Web sürümünde sekmeler rolünüze göre görünür. Ofis yöneticisi ayrıca şunları görür:

• E-posta: davet, doğrulama ve şifre sıfırlama e-postalarının gideceği sistem e-postası; kurulumdaki formun aynısı. Gönderen e-posta adresi yazılınca Sağlayıcı kendiliğinden seçilir (Gmail / Google Workspace, Outlook / Hotmail, Microsoft 365, Yandex / Yandex 360, Yahoo, iCloud; tanınmayan alan adında sunucu adresin posta kaydına bakar; yoksa Diğer); sunucu, kapı ve güvenlik Gelişmiş altında durur. Şifre alanına hesabınızın kendi şifresi değil, sağlayıcının uygulama şifresi yazılır; Uygulama şifresi oluştur bağlantısı ve iki satırlık adımlar formdadır. Deneme gönder kaydetmeden kendi adresinize deneme iletisi yollar; başarısız olursa nedeni (ör. uygulama şifresi) ve sağlayıcıya özel açıklama çıkar. Kayıtlı şifre korunur; değiştirmek için yenisini yazın. Sunucunun kurulum dosyasında ayarlıysa form değiştirilemez, yalnız deneme gönderilir. Altta gönderilemeyen e-postalar listelenir. Sistem e-postası ayarlı değilse sekmede Eksik rozeti ve sayfanın üstünde uyarı şeridi durur.
• Kullanıcılar: ofisin kişileri, rolleri ve durumları; Kullanıcı ekle, Daveti yeniden gönder, Sıfırlama bağlantısı gönder, rol değiştirme, Hesabı kapat ve Yeniden aç. Ofisin son Ofis yöneticisi kapatılamaz.
• Genel: giriş ekranındaki Beni hatırla seçeneğinin açılıp kapanması.
• Güncelleme: bkz. 6. Güncelleme.

• Genel: ayrıca Kurulum sihirbazını yeniden aç (bkz. 2.4).

Sol menünün altındaki adınıza basıp Hesabım'ı seçin: adınız, e-posta adresiniz (değiştirmek için yeni adrese doğrulama e-postası gider), Şifreyi değiştir, açık oturumlarınız ve Diğer oturumları kapat, aydınlatma metni, Kurulum sihirbazını yeniden aç. Çıkış aynı menüdedir. Sistem yöneticisi (birden çok ofis barındıran sunucuyu işleten) Bürolar sayfasında ofis ekler ve kapatır; ofislerin defterini görmez.

Klavye kısayolları

Aynı tablo uygulamada Yardım › Klavye kısayolları penceresinde de yazar.

4. Sık yapılan işler

4.1 Firma eklemek

1. Sol menüde Firmalar'ı açın ve Firma ekle'ye basın. Form sağdan açılır. Firma seçin penceresindeki Yeni firma ve ilk açılışta Genel bakış'taki İlk firmayı ekleyin de aynı formu açar.
2. Unvan / Adı soyadı alanına firmanın unvanını yazın. Yıldızlı (*) alanlar zorunludur.
3. Kimlik numarası alanına vergi kimlik numarasını (10 hane) ya da T.C. kimlik numarasını (11 hane) yazın. Kimlik türü hane sayısına göre kendiliğinden seçilir.
4. İsterseniz Vergi dairesi, Yetkili, Adres, Telefon ve Notlar'ı doldurun.
5. Kaydet'e basın. Zorunlu alan boşsa alanın altında yazar. Numara geçersiz görünüyorsa program “Firma yine de kaydedilsin mi?” diye sorar; Vazgeç numarayı düzeltmenize döner.
6. Yeni firma seçili firma olur ve defteri açılır.

Aynı kimlik numarasıyla ikinci bir firma eklenemez.

4.2 Sözleşme listesini Excel'den aktarmak

Listeniz .xlsx, .xls ya da .csv olabilir. Her satır bir kağıttır (sözleşme); ilk dolu satır başlık sayılır. Zorunlu sütunlar düzenlenme tarihi ile sözleşme ya da kağıt numarasıdır. Konu, tutar, tür (ör. “101” ya da “Kira sözleşmesi”), karşı taraf unvanı ve VKN/TCKN sütunları önerilir. Sütun adlarının programdakilerle aynı olması gerekmez.

Adım 1 · Dosya seçimi

1. Aktaracağınız firmayı sol menüdeki firma kutusundan seçin.
2. Sol menüde Excel'den aktar'ı açın.
3. Dosyayı kesikli çerçevenin içine sürükleyin ya da Excel dosyası seçin ile seçin. Örnek bir liste görmek için Örnek dosya'yı kaydedip açabilirsiniz.

Adım 2 · Sütun eşleştirme

1. Program her alanın hangi sütundan okunacağını başlıklardan tahmin eder ve altında ilk değerleri gösterir. Yanlışsa açılır listeden doğru sütunu seçin; bir sütun tek bir alana verilebilir. Yıldızlı (*) alanlara sütun seçilmezse alanın altında yazar.
2. Dosyada birden çok sayfa varsa Sayfa'yı, başlık ilk satırda değilse Başlık satırı'nı seçin.
3. Varsayılanlar bölümünde türü yazılmamış kağıtlar için türü ve nüsha sayısını seçin. İsterseniz türü açıklamadan tahmin etme (kira → 104, taahhüt → 102 …), boş açıklamaya tür adını yazma ve boş kağıt numarasına “NUMARASIZ-satır” yazma seçeneklerini işaretleyin.
4. Önizle'ye basın.

Adım 3 · Kontrol

1. Uyarılı ve hatalı satırları denetleyin (bkz. 3.6). Düzeltmek için Eşleştirmeye dön'e basabilir ya da Excel dosyanızı düzeltip yeniden seçebilirsiniz.
2. … kaydı deftere aktar'a basın. Hatalı satırlar aktarılmaz.

Adım 4 · Sonuç

1. Aktarılan kayıt sayısını ve atlanan satırları nedenleriyle kontrol edin.
2. Ay düğmesiyle (ör. Ekim 2026) deftere geçin. Yeni dosya aktar başka bir liste için sihirbazı baştan başlatır.

4.3 Deftere kayıt eklemek

1. Sol menüde Damga vergisi defteri'ni açın ve ay şeridinden kaydın ayını seçin.
2. Kayıt ekle'ye basın; kayıt formu kendi sayfasında açılır. Bu ay seçiliyse tarih bugündür, başka bir ay seçiliyse ayın ilk günüdür.
3. Düzenlenme tarihi, Kağıt / sözleşme no ve Açıklama (kağıdın konusu) alanlarını doldurun.
4. Karşı taraflar bölümünde kimlik türünü seçin, kimlik numarasını ve adı ya da unvanı yazın. Başka taraf varsa Taraf ekle'ye basın.
5. İşlem türleri bölümünde türü seçin; İçerdiği belli para ve Nüsha'yı yazın. Oran türe göre gelir. Vergi siz yazarken hesaplanır.
6. Kaydet'e basın. Program deftere döner. Sıradaki kağıt için Kaydet ve yeni aynı tarihle boş bir form açar. Kaydederken düğmede “Kaydediliyor…” yazar ve düğmeler bir an devre dışı kalır: iki kez basmak ya da Enter'a iki kez basmak ikinci bir kayıt açmaz.

En az bir karşı taraf gerekir. Eksik alan varsa alanın altında yazar. Kimlik numarası geçersiz görünüyorsa program kaydetmeden önce “Kayıt yine de kaydedilsin mi?” diye sorar. Kapatılmış bir aya kayıt eklenemez.

4.4 Aylık Excel çıktısını almak

1. Sol menüde Aylık Excel çıktısı'nı açın. Beyan dönemi (bir önceki ay) seçili gelir; başka bir ay için ay seçiciyi kullanın.
2. Uyarı kutularını okuyun (ör. geçersiz kimlik numarası, karşı tarafı olmayan kayıt).
3. Oluşturulacak şablonlar bölümünde istemediğiniz şablonun işaretini kaldırın. Üçü de varsayılan olarak seçilidir.
4. Firma ve dönem için alt klasör oluştur işaretliyse dosyalar seçtiğiniz klasörde <Unvan> (<kimlik no>)\<YYYY-AA> alt klasörüne yazılır.
5. Excel çıktılarını oluştur'a basın ve klasör seçme penceresinde klasörü seçin. İlk seferde Belgeler › MaliOfisApp › Damga Vergisi Defteri › Çıktılar önerilir; sonra son seçtiğiniz klasör önerilir.
6. Dosyalar <kimlik no>_<YYYY>_<AA>_<ŞABLON>.xlsx adıyla oluşur. Oluşturulan dosyalar bölümündeki Klasörü aç klasörü Dosya Gezgini'nde açar.

Aynı dönemin çıktısını aynı klasöre yeniden alırsanız dosyaların üzerine yazılır. Dosyaları GİB'in istediği biçimde siz yüklersiniz; program GİB'e bağlanmaz.

4.5 Dönemi kapatmak ve yeniden açmak

Damga vergisi beyannamesini verip ödedikten sonra ayı kapatın. Kapatılan ayın kayıtları değiştirilemez, silinemez ve o aya kayıt eklenemez; sıra numaraları sabitlenir.

1. Firmanın defterinde kapatacağınız ayı açın.
2. Sarı dönem şeridindeki Dönemi kapat'a basın.
3. “… dönemi kapatılsın mı?” penceresi firmanın o ayki kağıt sayısını ve toplam vergisini gösterir. O ayın Excel çıktısı alınmamışsa bunu da yazar.
4. İsterseniz Not alanına beyannameyle ilgili bir not yazın (ör. beyanname tarihi).
5. Dönemi kapat'a basın. Şerit yeşile döner, kapanış tarihi ve notunuz yazar.

Dönemler sırayla kapatılır: önceki aylarda kaydı olan açık dönem varsa program önce onları kapatmanızı ister. Kapatılmış bir dönemi yeniden açmak için:

1. O ayı açıp dönem şeridindeki Dönemi yeniden aç'a basın.
2. “… dönemi yeniden açılsın mı?” sorusunu Yeniden aç ile onaylayın.

Yalnız en son kapatılan dönem yeniden açılabilir.

4.6 Yeni yılın üst sınırını girmek

1. Sol menüde Ayarlar'ı açın ve Üst sınır sekmesine geçin.
2. Yıl ekle'ye basın. Listenin başına yeni yılın satırı gelir.
3. Yılın tutarını Resmî Gazete'de yayımlanan değerden denetleyerek yazın.
4. Alandan çıkın (Tab). Tutar kaydolur ve “Kaydedildi.” bildirimi çıkar.

Tutarı boş bırakılan yeni satır kaydedilmez. Yıl dört haneli değilse, aynı yıl iki kez yazılmışsa ya da tutar boşsa alanın altında yazar ve liste düzeltilene kadar kaydedilmez. Bir yılın satırını kaldırmak için sağdaki ×'e basın; kaldırma hemen kaydolur.

5. Verileriniz ve yedekler

5.1 Verilerin yeri

Program bütün verisini bu bilgisayarda, Belgeler klasörünüzde tutar: Belgeler › MaliOfisApp › Damga Vergisi Defteri. MaliOfisApp, Mali Ofis masaüstü programlarının ortak klasörüdür. Tam yolu Ayarlar › Yedekleme ve veri gösterir; Veri klasörünü aç klasörü Dosya Gezgini'nde açar.

• Program açıldıktan kısa süre sonra o gün için kopya yoksa Yedek › otomatik klasörüne Yedek - Damga Vergisi Defteri - YYYY-AA-GG SSDD.dvyedek adıyla bir kopya alır. Eski kopyalar kendiliğinden silinir.
• Kopyalar Ayarlar › Yedekleme ve veri'deki listede görünür; son yedek 48 saatten eskiyse ya da alınamadıysa sekmede uyarı çıkar.
• defter.json açılışta okunamazsa program defter.json.bak'ı kullanır.
• Çıktılar ve yedekler için başka bir klasör de seçebilirsiniz.

5.2 Yedek almak

1. Ayarlar › Yedekleme ve veri › Şimdi yedek al'a basın. Kopya Yedek › islem-oncesi klasörüne alınır ve listenin başına gelir.
2. Kopyayı bilgisayarın dışına (ör. USB bellek) almak için listedeki satırda Dışarı kaydet'e basın.
3. Yedek şifresi belirleyin penceresinde şifreyi iki kez yazın (en az 10 karakter; harf ve rakam). Yedek bu şifreyle şifrelenir (AES-256).
4. Kaydetme penceresinde yeri seçip Kaydet'e basın. Dosyanın adı Yedek - Damga Vergisi Defteri - YYYY-AA-GG SSDD.dvyedek biçimindedir.

Yedek; bütün firmaları, kayıtları, kapatılan dönemleri, çıktı kayıtlarını ve ayarları içerir. Yedeği ara ara bu bilgisayarın dışına da kopyalayın.

5.3 Yedekten geri yüklemek

1. Ayarlar › Yedekleme ve veri'de listedeki kopyanın Geri yükle'sine ya da dışarıdaki bir dosya için Dosyadan geri yükle'ye basın.
2. Yedek şifreliyse yedeği alırken belirlediğiniz şifreyi yazın.
3. Yedeğin özeti yedeğin tarihini, alındığı sürümü ve yeri (masaüstü ya da web), firmaları ve kayıt sayılarını gösterir. Doğru yedekse Devam et'e basın.
4. “Yedek geri yüklensin mi?” sorusunda kırmızı Geri yükle'ye basın. Vazgeç varsayılandır: Enter ve Esc vazgeçer.
5. Program önce şimdiki verinin güvenlik kopyasını Yedek › islem-oncesi'ne alır (alınamazsa geri yükleme yapılmaz), sonra bütün veriyi yedektekiyle değiştirir ve Genel bakış'ı açar. İşlem geçmişine “Yedekten geri yüklendi” yazılır.

5.4 Eski klasörden taşıma

Önceki sürümler verileri Belgeler › Damga Vergisi Defteri altında Veri, Yedek ve Çıktılar klasörlerinde tutuyordu. Bu sürüm ilk açılışta, defteri açmadan önce bu klasörleri yeni yere bir kez taşır:

• Veri klasörünün içeriği (defter.json) MaliOfisApp › Damga Vergisi Defteri klasörüne, Yedek ve Çıktılar aynı adla onun altına taşınır. Taşıma çoğunlukla klasörlerin yeniden adlandırılmasıdır ve hemen biter.
• Defterde saklanan çıktı klasörü yolları yeni yere göre düzeltilir.
• Yeni yerde aynı adla bir dosya varsa üzerine yazılmaz; dosya eski yerinde kalır ve bu bir kez bildirilir.
• Klasörler yeniden adlandırılamazsa (ör. başka bir sürücüdeyse ya da bir dosya kilitliyse) kopyalanır; kopya boyut ve SHA-256 özetiyle doğrulanır. Eski klasörler silinmez, Veri.tasindi-YYYYMMDD gibi bir adla yerinde kalır.
• Taşıma yarım kalırsa (ör. bir çıktı dosyası Excel'de açıkken) sonraki açılışta kaldığı yerden sürer.
• Yeni yerde de veri varsa iki veri birleştirilmez: program yeni klasördekini kullanır, eskisine dokunmaz ve bunu bir kez bildirir. Yeni yerde yalnız ilk açılışın boş defteri varsa o kenara alınır ve eski veri taşınır. Eski yerde yalnız eski bir sürümün ilk açılışta yazdığı boş defter varsa (ör. aynı OneDrive'ı kullanan başka bir bilgisayarda eski sürüm açıldıysa) bildirilmez.
• Taşıma bitince programın içinde bir kez Verileriniz yeni klasöre taşındı penceresi çıkar; verinin yeni yerini söyler.

Taşıma yalnız kurulu programda yapılır. Taşıma iletileri ve yapılacaklar için bkz. 8.2 Taşıma iletileri.

5.5 Web sürümünde veriler ve yedekler

• Veriler ofisinizin sunucusunda durur: her ofisin defteri ayrı bir dosyadır; kullanıcılar, oturumlar ve işlem geçmişi sunucunun yönetim veritabanındadır. Tarayıcıda defter verisi saklanmaz.
• Sunucu her gece 02.00'de ofisin yedeğini alır (son 30 gün ve her ayın ilki 12 ay). Şimdi yedek al ve işlem öncesi kopyalar ayrıca saklanır (son 10).
• İndir kopyayı yedek şifresiyle şifreleyip tarayıcınıza indirir. Bu dosya masaüstü programında da Dosyadan geri yükle ile açılır; masaüstünün yedeği de web'e yüklenir.
• Geri yükleme masaüstündeki adımlarla yapılır (özet, onay, güvenlik kopyası). Geri yüklemeden sonra ofisin öteki kullanıcılarının oturumları kapanır; kullanıcı hesapları ve işlem geçmişi yerinde kalır, yalnız defter değişir.
• Yedek alma ve geri yükleme yalnız Ofis yöneticisine açıktır.
• Sunucunun kendisinin (veri ve anahtar klasörleri) düzenli olarak dışarıya (başka disk ya da bulut) kopyalanması sunucuyu işletenin işidir.

Dışarı giden veri

Bu uygulama kullanım bilgisi ya da çökme raporu göndermez. Dışarı yalnız şunlar gider:

1. Güncelleme denetimi: maliofis.tr'ye uygulama adı, sürümü ve bilgisayarınızın IP adresi.
2. Sizin başlattığınız işler: e-posta, e-Belge, WhatsApp, destek.

6. Güncelleme

Program ilk açılışta güncellemelerin kendiliğinden denetlenmesi için izninizi sorar (“Güncellemeler kendiliğinden denetlensin mi?”): Evet, denetle, Hayır ya da Aydınlatma metni. İzin verirseniz program açıldığında ve açık kaldığı sürece 6 saatte bir maliofis.tr'de yeni sürüm olup olmadığına bakar; denetimde maliofis.tr'ye yalnız programın adı, sürümü ve bilgisayarınızın IP adresi gider. Tercihi Ayarlar › Güncelleme › Güncellemeleri kendiliğinden denetle ile değiştirirsiniz; kapalıyken de Güncellemeleri denetle elle çalışır.

Yeni sürüm varsa sayfanın üstünde bir şerit çıkar: “Yeni sürüm hazır: Damga Vergisi Defteri …” ve yeniliklerden en çok üç madde. Şerit logoyu ve menüyü örtmez.

1. Şimdi güncelle'ye basın ve açılan pencerede onaylayın. Program güncellemeyi indirir (ilerleme ve indirilen miktar görünür; Vazgeç indirmeyi yarıda bırakır), paketi doğrular, verilerinizin yedeğini alır ve kurar; sonra kapanıp yeni sürümle açılır. Açık formlarınızı önce kaydedin.
2. Şimdi kurmak istemiyorsanız Kapanışta kur'a basın: güncelleme indirilir ve program kapanırken, önce yedek alınarak kurulur.
3. Daha sonra yalnız şeridi kapatır; hiçbir şey kurulmaz. Bir sonraki denetimde şerit yeniden çıkar.

Güncelleme kendiliğinden indirilmez ve kurulmaz; yalnız siz Şimdi güncelle ya da Kapanışta kur deyince olur.

• Ayarlar › Güncelleme kurulu sürümü (yayın tarihiyle), son denetim zamanını ve güncellemenin durumunu bir kutuda gösterir; durumun düğmeleri kutunun sağındadır. Sayfanın üstündeki şerit bu sekme açıkken görünmez. Güncellemeleri denetle kartın sağ üstündedir ve hemen denetler.
• Bir sorun olursa kutuda ne olduğu yazar ve Tekrar dene ile Sorun bildir çıkar: “Güncellemeler denetlenemedi” (internet bağlantısı), “Güncelleme indirilemedi”, “Güncelleme doğrulanamadı” (paketin özeti ya da imzası tutmadı; paket kurulmaz), “Kurulum öncesi yedek alınamadı” (verileriniz korunsun diye kurulmaz; yedek klasörünün yazılabilir olduğunu denetleyin), “Güncelleme kurulamadı”.
• Kurulumdan önceki yedek Ayarlar › Yedekleme ve veri'de “Elle ya da işlem öncesi” kopyalar arasında durur.
• Güncellemeden sonraki ilk açılışta Bu sürümde neler var penceresi yeni sürümün yeniliklerini bir kez gösterir; birden çok sürüm atladıysanız hepsininkini sürüm sürüm gösterir. Bu sürümün yenilikleri Ayarlar › Hakkında'da da durur.
• Güncelleme verilerinize dokunmaz; veriler Belgeler'deki klasörde kalır.
• e-Dönüşüm Asistanı kuruluysa Uygulamalar sayfasındaki Güncelle programı açar; yeni sürümü program kendisi sorar.
• Yeni sürümün kılavuzu, o sürümün ekran görüntüleriyle birlikte programla gelir.

Web sürümünde güncellemeyi sunucu kurar; tarayıcıda bir şey kurmazsınız.

• Sunucu açılışta ve 6 saatte bir maliofis.tr'de yeni sürüme bakar; Ayarlar › Güncelleme son ve sonraki denetimin zamanını ve güncelleme yardımcısının (kurulumu yapan koruyucu) çalışıp çalışmadığını gösterir. İndirilen paketin SHA-256 özeti yayımlanan özetle tutmazsa kurulmaz.
• Gece kur işaretliyse yeni sürüm her gece 03.00'te, 02.00'deki gece yedeğinden sonra kurulur. Son 10 dakikada işlem yapan varsa kurulum bir saat ertelenir (kutuda nedeni ve yeni deneme saati yazar); üç ertelemeden sonra ertesi geceye kalır. Ofis yöneticisi sayfanın üstündeki şeritten ya da Ayarlar › Güncelleme › Şimdi güncelle ile hemen de kurabilir; indirme ilerlemesi görünür, Vazgeç indirmeyi yarıda bırakır.
• Kurulumdan önce açık olan herkes içeriğin üstünde “Güncelleme kuruluyor. Açık formlarınızı kaydedin.” şeridini 15 saniye görür; Ofis yöneticisi şeritteki Kurulumu durdur ile durdurabilir. Sonra bütün verinin yedeği alınır; yedek alınamazsa kurulum yapılmaz.
• Yeni sürüm 10 dakika içinde sağlıklı açılmazsa sunucu önceki sürümü ve kurulum öncesi yedeği kendiliğinden geri koyar; Ofis yöneticisi “Güncelleme geri alındı” iletisini görür. Ayarlar › Güncelleme › Önceki sürüme dön son iki sürüm için elle de kullanılır; o sürüme geçmeden önce alınan yedeğin tarihinden sonraki kayıtlar geri alınır.
• Kurulumdan sonra sayfa kendiliğinden yenilenir ve Bu sürümde neler var penceresi bir kez görünür.

7. Kaldırma

1. Programı kapatın.
2. e-Dönüşüm Asistanı'nda Uygulamalar › Damga Vergisi Defteri › Ayrıntılar › Kaldır'ı kullanın. Asistan programın kendi kaldırma programını arka planda çalıştırır; program açıksa önce kapatmanızı ister.
3. Asistan kullanmıyorsanız Windows'ta Ayarlar › Uygulamalar › Yüklü uygulamalar (Windows 10'da Uygulamalar ve özellikler) listesinde Damga Vergisi Defteri'ni kaldırın.

Kaldırma verilerinizi silmez: Belgeler › MaliOfisApp › Damga Vergisi Defteri klasörü, yedekleriniz ve çıktılarınız yerinde kalır. Programı yeniden kurduğunuzda aynı veriyle açılır. Tema ve son kullanılan firmalar gibi küçük program ayarları da (%APPDATA%\Damga Vergisi Defteri) kalır. Verileri de silmek isterseniz önce bir yedek alın, sonra bu klasörleri kendiniz silin.

8. Sorun giderme ve sık sorulan sorular

8.1 Sık görülen iletiler

8.2 Taşıma iletileri

Eski klasörden taşıma (bkz. 5.4) sorunsuz biterse yalnız bilgi iletisi çıkar. Aşağıdaki iletiler bir kez gösterilir:

8.3 Sık sorulan sorular

• Firmanın kendisini neden taraf olarak yazamıyorum? GİB'in taraf şablonuna yalnız sözleşmenin karşı tarafları yazılır. Program firmanın kendi kimlik numarasını taraf listesine almaz.
• Programı başka bir bilgisayara nasıl taşırım? Eski bilgisayarda yedek alın, yeni bilgisayara programı kurun ve yedeği geri yükleyin (bkz. 5.2 ve 5.3).
• Aynı ayın çıktısını yeniden alabilir miyim? Evet. Aynı klasöre alırsanız dosyaların üzerine yazılır. Kapatılmış dönemin çıktısı kapanıştaki kayıtlarla aynıdır.
• Oranı değiştirebilir miyim? Kayıt formunda her türün oranı seçilebilir; seçmezseniz türün oranı kullanılır. İşlem türleri listesi değiştirilemez.
• Ekranı koyu yapabilir miyim? Evet: Ayarlar › Genel › Tema › Koyu. Sistem Windows'un açık ya da koyu ayarını izler.
• Silme sorusunda yanlışlıkla Enter'a basarsam ne olur? Hiçbir şey silinmez: onay pencerelerinde Vazgeç varsayılandır; Enter ve Esc vazgeçer. Silmek için kırmızı düğmeye basmanız gerekir.

9. Destek

Aynı bilgiler programda da durur: sol menünün altındaki Mali Ofis destek e-posta, telefon ve WhatsApp bağlantılarını ve çalışma saatlerini gösterir. E-postanın konusu “Damga Vergisi Defteri <sürüm> destek talebi”, WhatsApp iletisi “Merhaba, Damga Vergisi Defteri <sürüm> için destek istiyorum.” olarak hazır gelir; bütün Mali Ofis uygulamalarında aynı biçimdedir. Aradığınızda programın sürümünü (sol üstte, adının altında), sorun bildirdiyseniz bildirim kodunu ve ekrandaki iletiyi söyleyin.

Sorun bildirmek

1. Sorunun görüldüğü sayfadayken sol menünün altındaki Sorun bildir'e basın.
2. Ne oldu? alanına ne olduğunu kısaca yazın. Şifre ya da T.C. kimlik numarası yazmayın.
3. Pencerenin ekran görüntüsünü ekle işaretliyse programın penceresinin görüntüsü (masaüstünüzün değil) hazırlanır; küçük önizlemesi pencerede görünür. Görüntüde ekrandaki firma adları ve tutarlar da görünür; istemezseniz işareti kaldırın. Web sürümünde Ekran görüntüsü ekle ile bir görüntü dosyası seçersiniz; görüntüyü açılan iletiye siz eklersiniz.
4. Gönderim yolunu seçin (E-posta ya da WhatsApp) ve Gönder'e basın. Pencerenin altındaki Bildirim kodu (ör. MO-20261019-0700-4F2A) Gönder'den sonra sağ alttaki bildirimde de yazar; destekle konuşurken bu kodu söyleyin.

Program e-posta programınızı ya da WhatsApp'ı hazır metinle açar; hiçbir şeyi kendisi göndermez. E-postanın konusu “Damga Vergisi Defteri <sürüm> sorun bildirimi <kod>”, WhatsApp iletisi “Merhaba, Damga Vergisi Defteri <sürüm> sorun bildirimi <kod>.” ile başlar; ardından yazdığınız metin, sayfa ve Windows sürümü gelir. Kişisel veri eklenmez. Ekran görüntüsü eklediyseniz dosya Dosya Gezgini'nde seçili açılır: iletiye sürükleyip ekleyin. Bu görüntüler 14 gün sonra silinir.

e-Dönüşüm Asistanı kuruluysa destek ekibi bilgisayarınıza bağlanması gerektiğini söylediğinde Asistan'daki Uzak destek AnyDesk'i açar. Bağlantıyı siz kabul edersiniz ve istediğiniz an kapatabilirsiniz.

10. Bu sürümde değişenler

Bu kılavuz 1.4.2 sürümünü anlatır. Önceki kılavuz sürümü: 1.4.1.

Yenilikler

• Web: Güvenlik başlığı: maliofis.tr'deki uygulama durumu denetimi artık uygulamanıza ulaşabiliyor; başka sitelerden erişim yine engellenir.

Yenilenen ekranlar

• Şekil 1 — İlk açılış: Genel bakış, henüz firma yok
• Şekil 2 — Firma kartına tıklayınca açılan Firma seçin penceresi
• Şekil 3 — Genel bakış: beyan dönemi Eylül 2026, üç firma
• Şekil 4 — Firmalar ekranı
• Şekil 5 — Damga vergisi defteri: açık dönem (Eylül 2026)
• Şekil 6 — Tüm yıl görünümü
• Şekil 7 — Defter kaydı: var olan bir kaydı düzenleme
• Şekil 8 — Excel'den aktar: kontrol
• Şekil 9 — Aylık Excel çıktısı: kapatılmış ve çıktısı alınmış dönem
• Şekil 10 — İşlem türleri ve oranlar
• Şekil 11 — Ayarlar › Genel
• Şekil 12 — Yeni firma formu
• Şekil 13 — Excel'den aktar: dosya seçimi
• Şekil 14 — Excel'den aktar: sütun eşleştirme
• Şekil 15 — Excel'den aktar: sonuç
• Şekil 16 — Yeni defter kaydı
• Şekil 17 — Aylık Excel çıktısı: şablon seçimi
• Şekil 18 — Aylık Excel çıktısı: oluşturulan dosyalar
• Şekil 19 — Dönemi kapatma penceresi
• Şekil 20 — Kapatılmış dönem: kayıtlar ve sıra numaraları kilitli
• Şekil 21 — Ayarlar: yeni yıl için üst sınır satırı
• Şekil 22 — Ayarlar › Yedekleme ve veri
• Şekil 23 — Geri yüklemeden önce yedeğin özeti
• Şekil 24 — Yeni sürüm şeridi (sürüm numarası ve not örnektir)
• Şekil 25 — Ayarlar › Güncelleme

Sürüm geçmişi