Günde onlarca, bazen yüzlerce sipariş almak e-ticarette büyümenin işaretidir; ama her siparişin faturasını isim, adres ve T.C. kimlik numarasını elle girerek kesmek hem yavaş hem hataya açık bir yoldur. API entegrasyonu, satış kanallarınızı, e-belge sisteminizi ve muhasebenizi birbirine bağlayarak bu süreci otomatikleştirir. Bu rehberde entegrasyonun nasıl çalıştığını, e-ticaret faturasında yasal olarak neler bulunması gerektiğini ve doğru çözümü seçerken nelere bakmanız gerektiğini anlatıyoruz.
Kısaca
- API entegrasyonu; satış kanalınızı (web sitesi, pazaryeri), e-belge sistemini ve muhasebeyi birbirine bağlar. Sipariş verisi yeniden elle girilmeden faturaya ve muhasebe kaydına dönüşür.
- İnternet satışı faturasında web adresi, ödeme şekli ve tarihi, taşıyıcı bilgisi, gönderim tarihi ve “Bu satış internet üzerinden yapılmıştır.” ifadesi zorunludur; entegrasyon bu alanları eksiksiz doldurmalıdır.
- e-Belge uygulamalarından üç yöntemle yararlanılır: GİB Portal, özel entegratör, doğrudan entegrasyon. Sipariş hacmi arttıkça işletmeler genellikle elle portal kullanımından entegratör ya da entegre bir panele geçer.
- Entegrasyon hatayı kendiliğinden sıfırlamaz: ürün, KDV ve müşteri verisi eşlemesi doğru kurulmalı ve test siparişleriyle denenmelidir.
- Süreci bir özel entegratöre devretseniz bile belgeleri muhafaza ve ibraz ödeviniz sizde kalır.
API entegrasyonu nasıl çalışır?
API (Uygulama Programlama Arayüzü), iki yazılımın birbiriyle güvenli ve standart bir biçimde veri alışverişi yapmasını sağlayan köprüdür. Birçok pazaryeri (Trendyol, Hepsiburada, n11, Amazon gibi) ve e-ticaret altyapısı (Shopify, WooCommerce gibi) sipariş bilgisini bu tür arayüzlerle dışarıya açar. Tipik bir akış şöyledir:
- Müşteri pazaryerinde ya da kendi web sitenizde sipariş verir.
- Entegrasyon siparişi otomatik olarak çeker.
- Sipariş bilgilerinden e-Arşiv Fatura (alıcı e-Fatura kullanıcısıysa e-Fatura) oluşturulur ve elektronik sertifikayla imzalanır.
- Fatura müşteriye elektronik ortamda iletilir.
- Satış, muhasebe kaydına ve stok hareketine yansır.
Burada anahtar nokta, aynı bilginin bir kez girilmesi ve sonraki adımlarda yeniden yazılmamasıdır. Bu, hem zaman kazandırır hem de kopyalama kaynaklı hata riskini azaltır.
E-ticaret faturasında yasal olarak neler bulunmalı?
509 sıra no'lu Vergi Usul Kanunu Genel Tebliği, internet üzerinden mal ve hizmet satan e-Arşiv mükellefleri için ayrı kurallar koyar. Entegrasyonunuzun bu alanları eksiksiz ve doğru doldurması gerekir:
- Satış işleminin yapıldığı web adresi
- Ödeme şekli ve ödeme tarihi
- Mal satışlarında gönderiyi taşıyanın adı soyadı veya unvanı ile vergi kimlik / T.C. kimlik numarası
- Satışa konu malın gönderildiği veya hizmetin ifa edildiği tarih
- İade bölümü (malı iade edenin adı soyadı, adresi, imzası ve iade edilen mala ilişkin cins, miktar, birim fiyat ve tutar)
- Fatura üzerinde “Bu satış internet üzerinden yapılmıştır.” ifadesi
Faturanın müşteriye elektronik ortamda iletilmesi zorunludur. Satıcı ve alıcının ikisi de e-Fatura kullanıcısıysa aralarındaki faturanın e-Fatura olması gerekir. Zorunluyken kâğıt fatura düzenleyen ve (nihai tüketici dışındaki vergi mükellefi) alıcı için kâğıt fatura alan taraflar hakkında VUK 353. maddedeki ceza hükümleri uygulanır. Cezaların 2026 tutarlarını e-Fatura ve e-Arşiv rehberimizde bulabilirsiniz.
Kargoda unutulmasın: İnternet satışlarında sevk edilen malın yanında sevk irsaliyesi ya da e-İrsaliyenin bir örneği, veya sevk irsaliyesi yerine geçen e-Arşiv Faturanın kâğıt çıktısı ya da ÖKC fatura bilgi fişi bulunmalıdır. Entegrasyonunuz bu belgeyi kargo etiketiyle birlikte üretebiliyorsa depo süreciniz çok kolaylaşır.
Otomasyon size ne kazandırır?
- Daha az elle veri girişi: T.C. kimlik, adres ve tutar gibi alanların yeniden yazılması gerekmediği için kopyalama hataları azalır. (Hata riski sıfırlanmaz; kaynak veri yanlışsa fatura da yanlış çıkar.)
- Tutarlı stok ve kayıt: Satış, entegrasyonla stoğa ve muhasebeye yansır. Çok kanallı satışta “elde olmayan ürünü satma” riskini azaltmak için stok bilgisinin kanallar arasında senkron tutulması gerekir.
- Zaman ve müşteri deneyimi: Ekibiniz fatura kesmek yerine paketleme, iade ve müşteri desteğine odaklanır; müşteri faturasını sipariş tamamlanır tamamlanmaz alır.
- Denetlenebilirlik: Belgeler elektronik ortamda, imzalarıyla birlikte saklandığı için ibraz kolaylaşır.
Hangi yöntemle entegre olunur?
Tebliğe göre e-Belge uygulamalarından üç yöntemle yararlanılır:
| Yöntem | Özet | E-ticaret için anlamı |
|---|---|---|
| GİB Portal | GİB'in sunduğu portalda belge oluşturulur. | Sipariş sayısı az ise yeterli olabilir; sipariş arttıkça elle işlem zorlaşır. |
| Özel entegratör | GİB'den izin almış bir şirketin sistemi üzerinden belge oluşturulur, imzalanır ve gönderilir. | Çok kanallı e-ticarette sık tercih edilir; entegratörün sipariş kaynaklarınızı destekleyip desteklemediğine bakın. |
| Doğrudan entegrasyon | Kendi bilgi işlem sisteminizi GİB'e doğrudan entegre edersiniz; GİB başvurunuzu uygun bulmalıdır. | GİB'in belirlediği şartları sağlamanız gerekir; kurulum ve bakım yükü size aittir, genellikle kendi yazılım ekibi olan yüksek hacimli yapılar tercih eder. |
Hangi yöntemi seçerseniz seçin belgeleri imzalamak için mali mühür veya e-imza gerekir. Entegratör kullanıyorsanız GİB'in yayımladığı izinli entegratör listesini kontrol edin ve altyapının Türkiye sınırları içinde olduğundan, verilerinizin amaç dışı kullanılmayacağından emin olun. Özel entegratör kullanmak, belgeleri kanuni süreler boyunca muhafaza ve ibraz yükümlülüğünüzü ortadan kaldırmaz.
Kurulumdan önce kontrol listesi
- Başvuru ve imza: e-Arşiv/e-Fatura başvurusu ve mali mühür ya da e-imza hazır olsun.
- Veri eşleştirme: Ürün kodları, KDV oranları ve cari hesap eşleşmeleri baştan doğru kurulsun; yanlış eşleşme tüm siparişlerde aynı hatayı tekrarlar.
- İade ve iptal akışı: İade faturası ve iptal süreçleri entegrasyonda tanımlı olsun.
- Test siparişleri: Canlıya almadan önce farklı ödeme ve kargo senaryolarıyla deneme siparişi geçin.
- Erişim güvenliği: API anahtarlarını ve parolaları e-postayla veya mesajla paylaşmayın; yalnızca ilgili sisteme girin ve yetkileri en dar tutun.
- Muhasebeci ile uyum: Faturaların muhasebe kaydına nasıl düşeceğini mali müşavirinizle önceden netleştirin.
Kimler entegrasyonu önceliklendirmeli?
Birden fazla pazaryerinde ya da hem pazaryerinde hem kendi sitesinde satış yapan, iade ve iptal oranı yüksek olan, fatura kesmeye her gün saatlerini ayıran veya stok uyumsuzluğu yaşayan işletmeler için entegrasyon genellikle en hızlı geri dönüşü sağlayan yatırımlardan biridir. Sipariş sayısı çok düşükse GİB Portal ile başlamak da meşru bir seçenektir; önemli olan, büyüdükçe geçebileceğiniz bir yol seçmektir. Özel gereksinimleriniz için yazılım geliştirme hizmetimize, siparişten faturaya hazır bir panel için Gem Portal'a göz atabilirsiniz.
Sıkça Sorulan Sorular
API entegrasyonu nedir, basitçe anlatır mısınız?
API (Uygulama Programlama Arayüzü), iki yazılımın birbirinden veri isteyip veri gönderebilmesini sağlayan standart bir bağlantı noktasıdır. E-ticarette bu, pazaryerinde ya da web sitenizde oluşan siparişin; kimse yeniden yazmak zorunda kalmadan fatura sisteminize ve muhasebenize aktarılması anlamına gelir.
E-ticaret yapıyorum, e-Arşiv fatura düzenlemek zorunda mıyım?
Büyük olasılıkla evet. E-ticaret ortamında mal veya hizmet satanlar için e-Arşiv geçiş zorunluluğu brüt satış hasılatına bağlıdır (güncel sınırlar için 2026 e-Fatura ve e-Arşiv rehberimize bakın). Ayrıca e-Arşiv uygulamasına dâhil olmayan mükellefler için 1 Ocak 2026'dan itibaren faturanın tutarına bakılmaksızın e-Arşiv düzenleme zorunluluğu başlamıştır; basit usule tabi olanlar ile işletme hesabı esasına göre defter tutanlar için bu tarih 1 Ocak 2027'dir.
E-Arşiv faturayı müşteriye nasıl iletmem gerekir?
İnternet üzerinden mal ve hizmet satışı yapan e-Arşiv mükellefleri, faturayı elektronik ortamda iletmek zorundadır. Pratikte bu, faturanın müşteriye e-posta gibi bir yolla ulaştırılması demektir; entegrasyonlar bunu sipariş tamamlanır tamamlanmaz otomatik yapabilir.
Müşteri ürünü iade ederse ne olur?
Tebliğe göre müşteri, kendisine elektronik ortamda iletilen faturanın kâğıt çıktısını alıp fatura üzerindeki iade bölümünü (iade edenin adı soyadı, adresi, imzası; iade edilen malın cinsi, miktarı, birim fiyatı ve tutarı) doldurup imzalayarak malla birlikte satıcıya geri gönderir. Bu belge, satıcı tarafından düzenlenen gider pusulası yerine geçer. İade ve iptal akışınızı entegrasyon kurulurken mutlaka test edin.
Gönderilen malın yanında hangi belge bulunmalı?
İnternet satışlarında sevk edilen malın yanında; sevk irsaliyesinin ya da e-İrsaliyenin bir örneği (veya e-İrsaliyenin sorgulanmasını sağlayan özel kodlu belgenin çıktısı), ya da sevk irsaliyesi yerine geçen e-Arşiv Faturanın kâğıt çıktısı veya ÖKC fatura bilgi fişi bulunmalıdır.
Özel entegratör benim verilerimi başkalarıyla paylaşabilir mi?
Hayır. Tebliğe göre özel entegratörler, hizmet verdikleri mükelleflere ait ticari sır niteliğindeki bilgileri yalnızca belgelerin oluşturulması, imzalanması, gönderilmesi ve alınması amacıyla kullanabilir; işleme taraf olanların yazılı izni olmadan GİB dışındaki üçüncü kişilerle paylaşamaz. Bu kurala aykırı davranan entegratörün izni iptal edilebilir. Ayrıca e-Belge gönderip almada kullanılan sistemin yazılım ve donanım altyapısı Türkiye sınırları içinde bulunmalıdır.
Bu yazı genel bilgilendirme amaçlıdır; mali, hukuki veya vergisel danışmanlık yerine geçmez. Uygulamada resmî kaynakları ve mevzuatın güncel hâlini esas alın. Paron Teknoloji Editör Ekibi tarafından hazırlanmış ve 6 Ekim 2026 tarihinde gözden geçirilmiştir.
