GİB e-Arşiv portala giriş yapar ve oturum tokenı alır. testMode=true ve kullanıcı adı verilmezse otomatik olarak yeni bir test hesabı alınır. Gerçek kullanıcı bilgilerini muhasebecinizden veya GİB İnteraktif Vergi Dairesi'nden edinebilirsiniz.

Daha önce alınmış bir oturum tokenını tanımlar; token süresi dolana kadar login olmadan işlem yapılabilir.

GİB e-Arşiv portal oturumunu sonlandırır.

Mevcut oturum durumunu (token, kullanıcı, test modu) gösterir.

GİB e-Arşiv portalda e-Fatura taslağı oluşturur (Satış, İade, Tevkifat, İstisna, Özel Matrah). Tutar, iskonto, KDV ve vergi toplamları otomatik hesaplanır. uuid + belgeNumarasi birlikte verilirse portaldaki mevcut belge güncellenir. Belge taslak olarak kaydedilir; imzalanana kadar mali değeri yoktur.

GİB e-Arşiv portalda e-Müstahsil makbuzu taslağı oluşturur. GV stopajı ve toplamlar otomatik hesaplanır.

GİB e-Arşiv portalda Serbest Meslek Makbuzu (e-SMM) taslağı oluşturur. Stopaj, KDV, tevkifat ve net tutarlar otomatik hesaplanır.

Belirtilen tarih aralığında düzenlenen belgeleri (taslak + imzalı) listeler. Onay durumu, belge türü, alıcı adı/VKN, belge no ve ETTN filtreleri uygulanabilir.

Belirtilen tarih aralığında adınıza düzenlenen belgeleri listeler. (Not: GİB tarafında bu servis zaman zaman stabil çalışmayabiliyor.)

Portalda kayıtlı bir belgenin detaylarını UUID (ETTN) ile getirir.

Portalda en son oluşturulan belgenin detaylarını getirir (varsayılan olarak son 1 yıl içinde arar).

Portalda kayıtlı belgenin HTML çıktısını getirir.

Belgenin zip indirme adresini üretir. Not: Bu adrese yalnızca tokenın oluşturulduğu IP adresinden erişilebilir; farklı IP için gib_save_document_to_disk kullanın.

Portalda kayıtlı belgeyi zip olarak indirir ve diske kaydeder; kaydedilen dosyanın tam yolunu döndürür.

İmzalanmamış taslak belgeleri siler. Silinecek belgelerin UUID (ETTN) listesi verilmelidir.

Belge imzalamak için SMS doğrulaması başlatır: portalda kayıtlı GSM numarasına doğrulama kodu gönderilir ve imzalama adımında kullanılacak Operasyon ID (oid) döndürülür. SMS doğrulama test hesaplarıyla çalışmaz.

☢️ DİKKAT: Belge imzalama, faturanın/makbuzun resmen kesilmesi işlemidir ve vergi sisteminde mali veri oluşturur. İmzalanan belge değiştirilemez ve silinemez. SMS ile gelen kod, gib_start_sms_verification'dan alınan oid ve imzalanacak belgelerin UUID listesi gönderilmelidir.

İmzalanmış bir belge için iptal talebi oluşturur.

İmzalanmış bir belge için itiraz talebi oluşturur.

Belirtilen tarih aralığındaki iptal/itiraz taleplerini listeler.

Portalda kayıtlı kullanıcı (mükellef) profil bilgilerini getirir.

Portalda kayıtlı kullanıcı profil bilgilerini günceller. Önce mevcut bilgiler okunur, verilen alanlar üzerine yazılır ve kaydedilir.

TC Kimlik No veya Vergi Kimlik No ile mükellef bilgilerini (ünvan, ad, soyad, vergi dairesi) sorgular. Fatura kesmeden önce VKN doğrulamak için kullanılabilir. Test ortamında sonuç boş döner.

Belge oluştururken kullanılan sabit listeleri döndürür: birimler, vergiler, KDV tevkifat kodları, özel matrah nedenleri, fatura tipleri, para birimleri, itiraz yöntemleri.