Rehber
E-fatura entegrasyonu nasıl yapılır?
Güncelleme:
Teknik kısım genelde birkaç günlük iştir. Projeleri geciktiren şey neredeyse her zaman hazırlık ve mutabakat tarafıdır — ve bu rehber onu da anlatıyor.
E-fatura entegrasyonu, satış sisteminizin (e-ticaret sitesi, ERP ya da özel yazılım) fatura belgesini elle müdahale olmadan düzenleyip alıcıya ulaştırmasıdır. Bu rehber teknik akışı, seçenekleri ve gerçek dünyada nerede tıkandığını anlatıyor.
Kapsam uyarısı: burada anlatılan teknik taraftır. Hangi belge tipinin size uygun olduğu, vergi ve muhasebe soruları mali müşavirinizin alanıdır; bu ikisini karıştıran teklifler dikkat ister.
Önce karar: entegratör mü, doğrudan mı?
İki yol var ve çoğu işletme için doğru cevap birincisidir.
| Yol | Kime uygun | Artısı | Eksisi |
|---|---|---|---|
| Özel entegratör üzerinden | İşletmelerin büyük çoğunluğu | Kurulum hızlı; mevzuat ve şema değişikliklerini sağlayıcı takip eder | Aylık/kontenjan bazlı ücret |
| Doğrudan entegrasyon | Çok yüksek hacim, özel gereksinim | Aracı maliyeti yok | Sertifika, şema ve mevzuat takibi tamamen sizde; bakım yükü sürekli |
Dürüst tavsiye: hacminiz aracının maliyetini gerçekten aşmıyorsa entegratör kullanın. Doğrudan entegrasyon, kurulduğu gün biten bir iş değildir; mevzuat ve belge şeması zaman içinde değişir ve her değişikliği izlemek kalıcı bir yüktür.
Teknik akış: sipariş → fatura → alıcı
Kurulan akış tipik olarak şöyle işler:
En sık nerede tıkanıyor?
Entegrasyon projelerinde gecikmenin sebebi genelde kod değil, aşağıdakilerdir:
Sözleşmeye yazdırılacaklar
Bizimle çalışmasanız bile bu dört maddeyi isteyin:
Sık sorulanlar
E-fatura entegrasyonu ne kadar sürer?
Entegratör üzerinden, tek yönlü standart bir akış (sipariş → fatura) genellikle 1–3 hafta içinde çalışır hâle gelir. Süreyi uzatan şey kod değil hazırlıktır: test hesabının açılması, vergi ve muafiyet kurallarının yazılı olarak netleşmesi ve alıcı bilgisi alanlarının sitede toplanıyor olması. Bu üçü hazırsa iş hızlı ilerler; hazır değilse kod tarafı beklemek zorunda kalır.
Hangi entegratörü seçmeliyiz?
Bu bir yazılım kararından çok ticari bir karardır: fiyatlandırma modeli, kontenjan yapısı, destek kalitesi ve mali müşavirinizin alışık olduğu sistem belirleyicidir. Teknik tarafta bizim için önemli olan üç şey vardır: belgelenmiş bir API, çalışan bir test ortamı ve anlamlı hata mesajları. Bu üçü varsa entegrasyon sorunsuz kurulur. Seçimi mali müşavirinizle birlikte yapmanızı, teknik değerlendirmeyi bize bırakmanızı öneriyoruz.
Mevcut muhasebe programımızla çalışır mı?
Bir bağlantı noktası varsa evet: API, veritabanı erişimi ya da düzenli dosya aktarımı. Türkiye’de yaygın muhasebe ve ERP sistemlerinin çoğunda bir entegrasyon yolu bulunur. Kapalı sistemlerde dosya tabanlı ara çözümler kurulabilir — bunlar kırılgandır ve program sürümü değiştiğinde bakım gerektirir; bunu baştan söyleriz.
İade olduğunda ne oluyor?
İade ayrı bir belge akışıdır ve baştan kapsama alınmalıdır. Kurgu şöyle olur: iade onaylandığında ilgili belge tipi düzenlenir, kendi sisteminizdeki sipariş kaydına bağlanır ve durum geri yazılır. Bu akış kapsam dışı bırakılırsa ilk iade geldiğinde iş elle yürümeye başlar; pratikte bir daha da otomatikleşmez, çünkü "zaten elle yapıyoruz" alışkanlığa döner.
Entegrasyon bozulursa fark eder miyiz?
Doğru kurulmuşsa evet, hemen. Kurduğumuz akışlarda başarısız belgeler bir kuyrukta bekler, otomatik olarak yeniden denenir ve belirli bir eşiği aştığında uyarı gider. Yanlış kurulmuş bir entegrasyonun en tehlikeli yanı sessiz kalmasıdır: sorun genelde ay sonu mutabakatında, yani onarması en pahalı olduğu anda ortaya çıkar.
Fatura akışınızı çıkaralım
Hangi sistemleri kullanıyorsunuz, fatura şu an nasıl kesiliyor — anlatın. Hangi adımların otomatikleşebileceğini net söyleriz.