GİB Uyumlu · TÜRMOB Lisanslı

E-Fatura, E-Arşiv
ve E-SMM Platformu

GİB entegrasyonlu e-belge sistemi. Kontör paketi seçin, başvurun; faturaları portaldan ya da API ile kendi yazılımınızdan kesin ve takip edin.

TÜRMOB · İSMMMO üyesi
Desteklenen belgeler: e-Fatura e-Arşiv Fatura GİB e-Arşiv e-SMM
Portalın e-Fatura paneli: e-Fatura, e-Arşiv ve e-SMM belge sayaçları ile son belgeler listesi
Aynı panelin tablet görünümü

Portal ekranı · örnek verilerle

3 Adımda E-Belge Sistemi

Başvuru, kurulum ve kullanım; tamamı online, ofise gelmenize gerek yok.

1

Paketi Seçin

Aylık belge hacminize göre kontör paketi seçin ya da e-fatura başvurusu yapın.

2

Bilgilerinizi Girin

Şirket adı, vergi no ve iletişim bilgilerinizi form üzerinden iletin. Belge gerekmiyor.

3

Görüşme & Aktivasyon

İş günlerinde sizi ararız; teklif onayından sonra GİB kaydı ve portal erişimi açılır.

Başvuru formu

İş günlerinde dönüş · Kesin fiyat görüşmede belirlenir.

Hangi belgeleri kesebilirsiniz?

Dördü de aynı hesaptan, aynı kontör bakiyesiyle düzenlenir. Hangi belgeyi keseceğinizi alıcının e-Fatura mükellefi olup olmadığı belirler; sistem bunu sorgulayıp doğru belgeye yönlendirir.

e-Fatura

Şirketten şirkete (B2B) kesilen elektronik fatura. Karşı taraf da e-Fatura mükellefiyse belge kâğıda dökülmeden, GİB üzerinden alıcının gelen kutusuna düşer.

e-Arşiv Fatura

B2C: nihai tüketiciye, bireysel müşteriye ya da e-Fatura mükellefi olmayan firmalara kesilen fatura. Elektronik ortamda düzenlenir, e-postayla iletilir ve saklanır.

GİB e-Arşiv

Gelir İdaresi'nin kendi portalından tek tek düzenlenen standart e-arşiv faturası. Belge bedeli alınmaz; buna karşılık toplu gönderim ve muhasebe aktarımı yoktur.

e-SMM

Serbest meslek makbuzu: avukat, mali müşavir, doktor, mimar gibi serbest meslek erbabının düzenlediği belge. Stopaj ve KDV hesabı makbuz üzerinde yapılır.

Hizmet Kapsamı

Platformun sağladığı özellikler ve güvenceler.

GİB uyumlu e-Fatura ve e-Arşiv kurulum akışı
Kontör ihtiyacına göre paket seçimi ve kullanım planı
Gönderilen ve alınan faturaların panel üzerinden izlenmesi
Kurulum adımlarının mali müşavirlik süreciyle birlikte ilerlemesi

Entegrasyon ihtiyacınızı belirterek bize yazabilirsiniz.

Geliştiriciler için

API ile e-Fatura ve e-Arşiv Kesin

Kendi yazılımınızdan, e-ticaret sitenizden ya da ERP'nizden fatura kesin; portala girmeden. Aynı hesap, aynı kontör bakiyesi.

REST API, JSON

Token ile kimlik doğrulama (Bearer). Anahtar portalda Profil › Gelişmiş bölümünde oluşturulur; şirket her istekte company_id ile seçilir.

e-Fatura ve e-Arşiv oluşturma ve gönderme

JSON ya da hazır UBL ile belge oluşturma, güncelleme, gönderim; e-Arşiv iptali ve e-posta yeniden gönderimi.

Durum, PDF ve UBL

Gönderilen ve gelen belgelerin durumu, PDF / HTML / UBL / ZIP çıktısı, ret ve iade bilgisi.

Gelen faturalar

Gelen kutusu listesi, okunmadı işaretleme, ticari faturaya kabul / ret yanıtı.

Alıcı sorgulama

Alıcının e-Fatura mükellefi olup olmadığı (e-Fatura mı e-Arşiv mi kesileceği) ve posta kutusu etiketi.

Güvenli gönderim

Yazma işlemlerinde Idempotency-Key zorunlu: aynı istek iki kez gelse de tek fatura kesilir. Gönderim için ayrıca açık onay (confirm_send) istenir.

Test ortamı ve kontör

Canlıya geçmeden test hesabıyla deneme. Gönderimde kontör portaldaki bakiyenizden düşer; yetersizse belge gönderilmez.

# Hesabınızın e-belge yeteneklerini sorgulayın

curl https://efatura.vergimerkezi.com.tr/api/v1/agent/einvoice/capabilities?company_id=123 \ -H "Authorization: Bearer <api_token>"

# Yanıt: ortam (test/canlı), bağlantı durumu, kontör, # kullanılabilir işlemler ve gereksinimler

Altyapı: Turkcell e-Şirket özel entegratörü (GİB onaylı). e-Fatura'da gelen ve giden, e-Arşiv'de giden belge başına 1 kontör.

Ek belge türleri: e-Müstahsil makbuzu, e-SMM ve e-Adisyon işlemleri de API'de; Turkcell hesabınızda ayrıca açık olmaları gerekir.

Teknik doküman: Geliştirici rehberi (kimlik doğrulama, ilk çağrı, Turkcell bağlantısı, hata kodları, işlem referansı) ve Swagger / OpenAPI.

e-Fatura nasıl kesilir? Üç yol ve aralarındaki fark

e-Fatura üç yoldan kesilir: GİB'in kendi portalından, bir özel entegratörün programı üzerinden ya da kendi yazılımınızı bağladığınız API ile. Hangisinin size uyacağını aylık belge sayınız ve faturayı hangi sistemde ürettiğiniz belirler. Üçünde de belge GİB'e aynı biçimde ulaşır; fark, belgeyi oluştururken izlediğiniz yolda.

GİB portalı

GİB e-Arşiv Portalı üzerinden tek tek fatura düzenlersiniz. Belge bedeli alınmaz, ancak toplu işlem, muhasebe aktarımı ve kendi yazılımınızla bağlantı yoktur.

e-Fatura programı

Özel entegratörün portalı. Gelen–giden kutusu, taslak, toplu gönderim, PDF ve UBL çıktısı tek ekranda toplanır; muhasebe tarafına aktarım yapılabilir.

API bağlantısı

Faturayı kendi yazılımınız, e-ticaret siteniz ya da ERP'niz üretir; portala hiç girmeden gönderilir. Belge sayısı arttıkça tek pratik yol budur.

e-Fatura programı, portal ve özel entegratör aynı şey mi?

Günlük konuşmada üçü de birbirinin yerine kullanılıyor, ama aynı şeyi anlatmıyorlar. Özel entegratör, GİB'den izin almış ve belgeyi sizin adınıza GİB'e ileten kurumdur. e-Fatura programı ya da portal, o entegratörün size açtığı ekrandır — faturayı yazdığınız yer. Fatura kesme programı dediğinizde çoğunlukla kastedilen de budur. Yani entegratör kurumu, program ise o kurumun arayüzünü anlatır.

Özel entegratör nedir, nasıl seçilir?

Özel entegratör, e-belgeleri mükellef adına düzenleme ve iletme yetkisi GİB tarafından verilmiş kurumdur. Yetkili kurumların listesi Gelir İdaresi Başkanlığı'nın e-Belge sayfasında yayımlanır; listede olmayan bir firmadan hizmet alınmaz. Seçerken bakılacaklar: belge türlerinin kapsamı (e-Fatura, e-Arşiv, e-İrsaliye, e-SMM, e-Müstahsil), muhasebe yazılımınıza aktarım, API desteği ve saklama süresi. Entegratör değiştirmek mümkündür; eski belgelere erişim hakkınız sözleşmede yazılı olmalıdır.

Bu platformun altyapısında Turkcell e-Şirket özel entegratörü kullanılır. Yükümlülüklerin dayanağı 509 Sıra No'lu Vergi Usul Kanunu Genel Tebliği'dir.

API ile otomatik fatura kesme

Faturayı elle yazmak yerine kendi sisteminize kestirmek istiyorsanız REST API kullanılır. Sipariş tamamlandığında, abonelik yenilendiğinde ya da sevkiyat çıktığında fatura kendiliğinden oluşur ve gönderilir. İstek JSON ya da hazır UBL olarak iletilir; yanıt belge numarası, durum ve PDF/UBL çıktısını içerir. Aynı isteğin iki kez gelmesi hâlinde tek fatura kesilmesi için Idempotency-Key zorunludur. Ayrıntılar yukarıdaki API bölümünde ve geliştirici rehberindedir.

Yapay zeka asistanıyla fatura kesme

Portal ve API dışında üçüncü bir yol daha var: yapay zeka asistanı. Asistan, e-belge işlemlerini araç olarak çağırabiliyor — alıcının e-Fatura mükellefi olup olmadığını sorgulama, satış faturası taslağı oluşturma, belge durumunu okuma ve onay sonrası gönderme. Gönderim ayrı bir onay adımı gerektirir; asistan kendiliğinden belge göndermez.

UBL, XML ve fatura biçimleri

e-Fatura ve e-Arşiv belgeleri UBL-TR adı verilen XML biçiminde üretilir; PDF yalnız okunabilir çıktıdır, belgenin kendisi XML'dir. Kendi yazılımınız UBL üretebiliyorsa belgeyi hazır XML olarak gönderebilir, üretemiyorsa alan alan JSON iletip UBL'i sistemin oluşturmasını isteyebilirsiniz. Gelen faturaları da UBL, PDF, HTML ya da ZIP olarak alabilirsiniz.

Sık Sorulan Sorular

E-fatura kontör ne demektir?

E-fatura sistemi, GİB (Gelir İdaresi Başkanlığı) altyapısı üzerinden belge gönderimine dayalıdır. Kontör, her e-fatura, e-arşiv fatura veya e-irsaliye gönderimi karşılığında tüketilen birimdir. Kontör paketleri, ihtiyaca göre önceden satın alınan bu kullanım haklarını kapsamaktadır.

E-Fatura kontörü nedir ve nasıl kullanılır?

Kontör, e-belge sistemlerinde her bir belgenin (e-Fatura, e-SMM, e-Arşiv Fatura) gönderiminde tüketilen birimdir. Satın alınan kontörler Vergi Merkezi | Mali Müşavirlik portal bakiyesine eklenir; her belge gönderiminde ilgili kontör miktarı düşülür. Kontörler kullanım süresi kısıtlaması olmaksızın bakiyede tutulur.

250 kontörlük paket aylık kaç e-belge için yeterlidir?

Aylık 250 adet e-Belge düzenleyen bir işletme için yaklaşık bir aylık kullanımı karşılar. Birden fazla belge türü düzenliyorsanız toplam gönderi sayısı dönemsel kullanımı belirler.

500 kontörlük paket hangi ölçekteki işletmeler için uygundur?

Aylık 500 adet e-Belge düzenleyen orta ölçekli işletmelerin bir aylık ihtiyacını karşılar. Sezonsallık veya proje bazlı yoğunlaşma varsa birden fazla paket satın alınması ya da daha büyük paket tercih edilmesi kullanım sürekliliğini sağlar.

1.000 kontörlük pakette birim kontör maliyeti küçük paketlerden daha düşük müdür?

Evet. Büyük paketlerde birim kontör başına maliyet daha düşüktür. Bu fark, yüksek hacimli e-Belge kullanan işletmeler için uzun vadede tasarruf sağlar.

2.500 kontörlük paket hangi ölçekteki işletmeler için uygundur?

Aylık 500–1.000 adet e-Belge düzenleyen küçük-orta ölçekli işletmeler için 2–5 aylık kullanımı karşılar. Çok sayıda belge türü kullanan veya mevsimsel yoğunluğu yüksek işletmeler bu paketi tercih edebilir.

3.500 kontörlük pakette kontörler süre dolmadan kullanılmak zorunda mı?

Hayır. Kontörler süre kısıtlaması olmaksızın hesapta bekler; acele tüketme zorunluluğu yoktur. Bu nedenle toplu alımlar birim maliyet avantajı sunar ve kullanım kendi takviminde gerçekleştirilir.

5.000 kontörlük pakette tek bir fatura gönderisi kaç kontör tüketir?

Her fatura veya belge gönderimine karşılık bir kontör düşülür. Müşteriye 5.000 ayrı e-Belge gönderilen dönemlerde 5.000 kontör tüketilir; toplu gönderimler de her biri ayrı sayılmaktadır.

7.500 kontörlük paket hangi hacimde belge düzenleyen işletmeler için önerilir?

Aylık 1.000–2.000 e-Belge düzenleyen işletmeler için yaklaşık 4–7 aylık kullanımı karşılar. Sezonsallık veya sipariş yoğunluğuna bağlı belge artışları göz önünde bulundurularak paket seçimi yapılması önerilmektedir.

10.000 kontörlük paket hangi hacimli işletmeler için uygundur?

Aylık 2.000–3.000 e-Belge düzenleyen yüksek hacimli işletmeler için yaklaşık 3–5 aylık kullanımı karşılar. E-ticaret, perakende ve üretim gibi yoğun belge trafiği olan sektörlerde bu paket verimli maliyet-kontör dengesi sağlar.

12.500 kontörlük paket kurumsal işletmeler için kaç aylık kullanım sağlar?

Aylık 2.500–3.500 e-Belge düzenleyen kurumsal işletmeler için yaklaşık 3–5 aylık kullanımı karşılar. ERP veya muhasebe yazılımıyla entegre e-Belge sistemleri kullanan işletmelerde otomatik kontör izlemesi süreç verimliliğini artırır.

15.000 kontörlük paket acele kullanılmak zorunda mıdır?

Hayır. Kontörler bakiyeye eklenerek süresiz tutulur; acele tüketme zorunluluğu yoktur. Büyük paketler hem birim maliyet avantajı hem de uzun vadeli kontör güvencesi sağlar.

E-fatura kontör paketi satın almak için portal müşterisi olmak gerekli mi?

Kontör paketleri, Vergi Merkezi | Mali Müşavirlik portal üzerinden yönetilmektedir; bu nedenle aktif bir portal hesabına sahip olunması gerekmektedir. Mevcut portal müşterileri portal hesapları aracılığıyla kontör ekleyebilir ve kullanım geçmişlerini takip edebilir.

100 kontörlük paket hangi e-belge türleri için kullanılabilir?

E-Fatura, e-Arşiv Fatura ve e-Serbest Meslek Makbuzu (e-SMM) gönderimleri kontör tüketir. E-İrsaliye sistemi bazı entegratörlerde ayrı kota kullanırken diğerlerinde kontör sistemine entegre olabilmektedir.

Kontör bakiyesi nasıl takip edilir?

Vergi Merkezi | Mali Müşavirlik portal üzerinden kontör bakiyesi anlık olarak izlenebilir. Düşük bakiye uyarısı alınabilmesi için portal bildirim ayarlarının yapılandırılması önerilmektedir; böylece belge gönderimleri kesintisiz sürdürülebilir.

Kontör paketi satın alındıktan sonra iade edilebilir mi?

Kontör paketleri dijital ürün niteliğinde olduğundan kısmi veya tam iade genellikle yapılmamaktadır. Satın alma öncesinde kullanım hacminin gerçekçi biçimde tahmin edilmesi önerilmektedir.

Kontör paketi birden fazla işletme için kullanılabilir mi?

Hayır. Her kontör paketi belirli bir mükellefiyet (vergi numarası) ile ilişkilendirilir; farklı tüzel kişilikler için ayrı kontör hesabı tutulur. Grup şirketlerinde her şirketin bağımsız kontör bakiyesi bulunmaktadır.

Kontör bakiyesi sıfırlandığında belge gönderimi durur mu?

Bakiye tükendiğinde sistem e-Belge gönderimini durdurur; kesintisiz operasyon için bakiye takibi ve zamanında kontör yüklemesi önemlidir. Vergi Merkezi | Mali Müşavirlik portal düşük bakiye uyarısı sunmaktadır.

E-Arşiv Fatura ile e-Fatura kontör tüketimi aynı mı?

Genel uygulamada her bir belge gönderimi birer kontör tüketir; e-Fatura ve e-Arşiv Fatura arasında kontör miktarı farkı yoktur. Belge türüne göre oran farklılaşması varsa Vergi Merkezi | Mali Müşavirlik portal kullanım koşullarında belirtilmektedir.

Kontör paketi satın alımında vergi faturası düzenlenir mi?

Evet. Kontör paketi satışı KDV'ye tabi bir hizmet satışıdır; satın alma karşılığında e-Fatura veya e-Arşiv Fatura düzenlenir. Bu fatura işletmenin muhasebe kayıtlarında gider olarak gösterilebilir.

E-SMM gönderimlerinde kontör tüketimi e-Fatura ile aynı mı?

Evet, sistem genelinde her bir e-Belge gönderimi (e-Fatura, e-SMM, e-Arşiv) bir kontör olarak işlenmektedir. Kontör tüketim politikasında fark varsa Vergi Merkezi | Mali Müşavirlik portal kullanım koşullarında belirtilmektedir.

Büyük kontör paketleri neden küçük paketlere göre daha düşük birim maliyete sahiptir?

Toplu satışlarda ölçek ekonomisi uygulanır; birim başına işlem maliyeti düşer. Bu fiyatlama mantığı yüksek hacimli kullanıcıların sürekli küçük paket almak yerine büyük paket tercih etmesini teşvik eder ve tahmin edilebilir bütçeleme imkânı sunar.

Kontör paketi satın alındığında bakiyeye ne zaman eklenir?

Ödeme onaylandıktan sonra kontörler genellikle aynı iş günü içinde Vergi Merkezi | Mali Müşavirlik portal hesabına eklenmektedir. Gecikme yaşanması hâlinde Vergi Merkezi müşteri hizmetleriyle iletişime geçilerek durum teyit edilmelidir.

15.000 kontör ne kadar sürede tüketilir?

Aylık 3.000 e-Belge düzenleyen bir işletme için yaklaşık 5 aylık, aylık 5.000 belge düzenleyen bir işletme için ise yaklaşık 3 aylık kullanımı karşılar. Kontörlerin süresi sınırsız olduğundan tüketim hızı işletmenin trafiğine göre doğal olarak belirlenir.

TÜRMOB Lisanslı
İSMMMO Üyesi
· GİB Uyumlu Entegrasyon

E-Belge sistemine geçiş

Başvurunuzu iletin; iş günlerinde sizinle iletişime geçer, GİB kaydından portal kurulumuna kadar süreci birlikte yürütürüz.

+90 212 230 03 04 Hafta içi 09.00–18.00