Gelir İdaresi Başkanlığı , mükelleflerin beyanname alınması işlemlerinde daha kaliteli hizmet sunmak, teknolojik yeniliklere uyum sağlamak ve beyannamelerin daha hızlı, kesintisiz ve güvenli bir şekilde sunulmasını sağlamak amacıyla başlatılan “e-Beyan” projesi başlatmıştır.
.
e-Beyan projesinin devreye alınmasıyla beyanname göndermek için API entegrasyonu oldukça önem arz etmektedir. Bu süreç, beyannamelerini dijital ortamda göndermek için kullanılmaktadır. Bu yazıda, Dijital Vergi Dairesi’nden e-Beyan için API Key oluşturma adımlarını ve Zirve 2.0’a nasıl tanımlandığını ayrıntılı olarak inceleyeceğiz.
.
API Key Nasıl Oluşturulur?
API Key oluşturmak için Dijital Vergi Dairesi sayfasına giriş yapılır ve “Kullanıcı Girişi” butonuna tıklanır.

Açılan ekranda müşavire ait “T.C. Kimlik No/Vergi Kimlik No/Kullanıcı Kodu”, “Şifre” ve “Doğrulama Kodu” yazıldıktan sonra “Giriş Yap” butonuna tıklanır.

Dijital Vergi Dairesine giriş yapıldıktan sonra “e-Beyan” uygulamasına tıklanır.

e-Beyan butonuna tıklanmasıyla ekrana yönlendirme metni gelecektir. Gelen yönlendirme metni okunduktan sonra “Onayla” butonuna tıklanır.

Onayla butonuna tıklandıktan sonra yeni sekmede e-Beyan sayfası açılacaktır.

Sağ üst köşede yer alan “Hesap” butonuna ardından “Entegrasyon Yönetimi” butonuna tıklanır.

Entegrasyon yönetimi sayfasında “Oluştur” butonuna tıklanır.

Oluştur butonuna tıklanmasıyla “Bilgilendirme Metni” ve “Oluşturulan Token” bilgileri ekrana gelecektir. “Kopyala” butonuna tıklayarak token kopyalanabilir. Token Zirve Masaüstü programına kaydedilmeden ekran kapatılmamalıdır.

Not: Oluşturulan Token’e tekrar ulaşılamaz. Token’a tekrar ulaşılması gerekiyorsa Mevcut tokeni silip yeni bir token oluşturulması gerekmektedir.

Zirve Nova 2.0’a API Key Nasıl Tanımlanır?
Oluşturulan API Key’i Zirve Nova 2.0’a kaydetmek için “Admin İşlemleri”, “Müşavir Bilgileri” adımları takip edilir.

“Şifre İşlemleri” sekmesine geçiş yapılarak oluşturulan token “e-Beyanname APİ KEY” alanına yapıştırılarak süreç tamamlanır.
