HasfiyatKuyumcu e-fatura entegrasyonu İçin Eksiksiz Kılavuz
Kuyumcu e-fatura entegrasyonu, kuyumcu yazılımınızın ürettiği altın satış belgelerini GİB sistemine ve alıcının posta kutusuna otomatik iletmesini sağlayan teknik bağlantıdır. Kısa cevap: doğru entegrasyon, satış programınızı bir entegratör ve mali mühür aracılığıyla GİB'e bağlar; özel matrah (805 kodu) ve işçilik KDV'sini taşıyan belgeleri manuel yükleme olmadan iletir. Kuyumcuda entegrasyonun standart işletmelerden farkı, altına özgü özel matrah şemasını doğru taşımasıdır. Bu kılavuzda entegrasyon modellerini, kurulumu, mali mühür ve VKN kontrolünü, sık yaşanan hataları ve maliyet kalemlerini kuyumcuya özel örneklerle ele alıyoruz.
E-fatura entegrasyon modelleri: hangisi kuyumcuya uygun?
E-faturaya geçişte üç temel model vardır. Birincisi GİB portalı: doğrudan GİB'in web arayüzünden belge girmek. Düşük hacimli işletmeler için ücretsizdir ama her belgeyi elle girmek gerektiğinden kuyumcunun özel matrah hesabını otomatikleştirmez. İkincisi özel entegratör: belgeleri sizin adınıza GİB'e ileten yetkili bir firma; kuyumcu yazılımınız API ile entegratöre bağlanır, o da GİB'e taşır. Üçüncüsü doğrudan entegrasyon: kendi sisteminizin GİB ile doğrudan konuşması ki bu yüksek teknik kapasite ister ve genelde büyük kurumlar tercih eder. Kuyumcuların çoğu için en pratik model, yazılımın bir özel entegratörle entegre çalışmasıdır.
Model seçiminde belirleyici olan, kuyumcu yazılımınızın özel matrahı ve 805 kodunu doğru üretip entegratöre iletebilmesidir. GİB portalını elle kullanmak, altın satışının matrah ayrımını her belgede manuel yapmayı gerektirir ki bu yoğun bir dükkanda sürdürülemez. Özel entegratör modelinde ise yazılımınız belgeyi özel matrah kırılımıyla hazırlar, entegratör yalnızca iletim ve GİB onayını üstlenir. Bu, hem hız hem doğruluk sağlar. Belgeyi üreten satış tarafını da güçlendirmek için altın satış faturası programı yazımız programın taşıması gereken özellikleri ayrıntılandırır.
Model seçiminde ölçeklenebilirlik de göz önünde tutulmalıdır. Bugün tek dükkanlı bir kuyumcu, yarın şube açtığında veya çevrimiçi satışa başladığında entegrasyonun bu büyümeyi taşıması gerekir. Özel entegratör modeli, artan belge hacmini ve çok şubeli yapıyı genelde sorunsuz karşılar çünkü altyapı sağlayıcı tarafında ölçeklenir. GİB portalı ise hacim arttıkça sürdürülemez hale gelir. Bu nedenle model seçilirken yalnızca bugünkü belge adedine değil, önümüzdeki dönemde artması muhtemel zorunluluklara ve büyüme planlarına da bakmak gerekir. Doğru model, kuyumcuyu birkaç yıl sonra sistem değiştirme zahmetinden kurtarır ve entegrasyon yatırımını uzun ömürlü kılar.
Mali mühür, sertifika ve GİB başvurusu
E-fatura entegrasyonunun olmazsa olmazı mali mühürdür. Tüzel kişiler için mali mühür, gerçek kişi işletmeler için ise elektronik imza veya mali mühür belgeleri elektronik olarak imzalar; bu imza, belgenin hukuki geçerliliğini sağlar. Kuyumcu, önce Kamu Sertifikasyon Merkezi üzerinden mali mühür başvurusu yapar, ardından GİB e-fatura ve e-arşiv uygulamalarına kayıt olur. Bu adımlar tamamlanmadan yazılım ne kadar hazır olursa olsun belge iletemez. Başvuru sürecinde mükellefiyet bilgilerinin, adres ve faaliyet kodunun güncel olması reddi önler. Mali mühür sertifikasının geçerlilik süresi de takip edilmeli, süresi dolan sertifika belge üretimini durdurur.
Mali mühür kurulduktan sonra, kuyumcu yazılımı veya entegratör bu sertifikayla eşleştirilir. Bulut tabanlı çözümlerde mali mühür genellikle güvenli bir donanım modülünde veya entegratörün ortamında saklanır; yerel kurulumlarda ise kart okuyucu ve sürücü gereksinimleri doğar. Kuyumcu için pratik olan, mühür yönetimini entegratörün üstlendiği bulut modelidir; böylece sertifika yenileme ve yedekleme yükü azalır. Entegrasyon canlıya alınmadan test ortamında birkaç örnek belge imzalanıp GİB şemasına uygunluğu doğrulanır. Tahsilat verisini de bu akışa bağlamak isterseniz banka hareketinden otomatik fatura yazımız banka ile entegrasyonun nasıl kurulacağını gösterir.
Mali mühür ve sertifika yönetiminde süreklilik, entegrasyonun kesintisiz çalışmasının anahtarıdır. Sertifikanın geçerlilik süresi dolmadan yenilenmesi, aksi halde belge üretiminin bir anda durması riskini taşır; yoğun bir satış gününde bunun yaşanması ciddi aksama yaratır. Bu yüzden sertifika bitiş tarihini takip eden hatırlatma mekanizmaları önemlidir. Bulut tabanlı entegratör modelinde bu takibi genelde sağlayıcı üstlenir, yerel kurulumda ise sorumluluk kuyumcudadır. Ayrıca birden fazla şubesi olan kuyumcularda mühür ve entegrasyon yapılandırmasının her şube için doğru tanımlanması gerekir; belgelerin doğru mükellef ve şube bilgisiyle üretilmesi, GİB nezdinde tutarlılık için şarttır. Bu yönetsel ayrıntılar, teknik kurulum kadar entegrasyonun günlük güvenilirliğini belirler.
Özel matrah şemasının entegrasyonda doğru taşınması
Kuyumcu e-fatura entegrasyonunun en kritik ve en çok gözden kaçan noktası, özel matrah bilgisinin GİB şemasına doğru yerleştirilmesidir. Altın satış belgesi, has altın karşılığını özel matrah (805) satırında KDV'siz, işçiliği ise KDV'li satırda taşır. Entegrasyon sırasında bu kırılımın UBL-TR formatındaki doğru alanlara yazılması gerekir; yanlış alana yazılan tutar belgenin reddine veya vergisel hataya yol açar. Yazılımınız belgeyi doğru üretse bile, entegratöre iletim sırasında matrah alanları hatalı eşleştirilirse GİB belgeyi kabul etmez ya da yanlış vergilendirilmiş belge oluşur. Bu nedenle entegrasyon testinde özel matrah senaryolarının ayrıca sınanması şarttır.
Test aşamasında en az üç senaryo denenmelidir: yalnızca altın satışı, altın artı yüksek işçilik ve iade/iptal durumu. Her senaryoda özel matrah tutarının, işçilik matrahının ve KDV'nin doğru alanlara oturduğu GİB test yanıtından kontrol edilir. İade senaryosunda özel matrahın ters uygulanıp uygulanmadığı özellikle önemlidir. Bu senaryolar doğrulanmadan canlıya geçmek, yüzlerce hatalı belge ve düzeltme yükü demektir. Özel matrahın hesap mantığını ve 805 kodunu derinlemesine kavramak için altın özel matrah fatura programı yazımız, entegrasyonun bu en hassas kısmını netleştirmenize yardımcı olur.
VKN kontrolü, belge tipi ve iletim akışı
Entegrasyonun günlük işleyişinde ilk kontrol, alıcının e-fatura mükellefi olup olmadığıdır. Yazılım, alıcının VKN'sini GİB mükellef listesiyle karşılaştırır; kayıtlıysa belge e-fatura olarak alıcının posta kutusuna iletilir, değilse e-arşiv faturası olarak entegratör üzerinden raporlanır. Bu ayrım otomatik yapılmazsa yanlış kanaldan gönderilen belge reddedilir. E-fatura tarafında senaryo seçimi (temel/ticari) ve alıcının kabul-ret süreci de akışın parçasıdır. İyi kurulmuş bir entegrasyon, bu kararları kullanıcıya sormadan verir ve yalnızca istisnai durumlarda onay ister; böylece tezgahta işlem hızı korunur.
İletim akışının izlenebilir olması, entegrasyonun kalitesini belirler. Her belgenin durumu (üretildi, imzalandı, GİB'e iletildi, kabul edildi, reddedildi) takip edilebilmeli; reddedilen belgeler nedeniyle birlikte raporlanmalıdır. Toplu satış günlerinde bu izleme daha da kritiktir çünkü tek tek kontrol imkansızdır. Reddedilen belgeleri düzeltip yeniden gönderme mekanizması entegrasyonun standart parçası olmalıdır. Yoğun günlerde çok sayıda belgeyi tek seferde üretip iletmek isteyenler için kuyumcu toplu fatura kesme yaklaşımı entegrasyonla nasıl birleşeceğini anlatır. Bu bütünlük, gün sonu mutabakatını ve olası bir denetimi kolaylaştırır.
İletim akışında bir diğer önemli konu, e-arşiv raporlama süreleridir. E-arşiv faturaları, düzenlendikten sonra belirli bir süre içinde GİB'e raporlanmalıdır; entegratör bu raporlamayı otomatik yapsa da kuyumcunun sürecin işlediğini periyodik kontrol etmesi iyi bir alışkanlıktır. Raporlanmamış belgeler, ileride mutabakat sorunları doğurur. E-fatura tarafında ise gönderilen belgenin alıcı posta kutusuna ulaşıp ulaşmadığı ve ticari senaryoda kabul edilip edilmediği izlenmelidir. İyi bir entegrasyon paneli, tüm bu durumları tek ekranda gösterir. Böylece kuyumcu, hangi belgenin nerede takıldığını anında görür ve müdahale eder. Bu görünürlük, özellikle yüksek tutarlı altın satışlarında belge güvenliğini ve müşteriyle olan kaydın netliğini garanti altına alır.
Entegrasyon maliyeti, ücretsiz seçenekler ve 2026
Kuyumcu e-fatura entegrasyonunun maliyeti üç kalemden oluşur: entegratör aboneliği, e-belge kontör bedeli ve kuyumcu yazılımının lisansı. GİB portalı ücretsizdir ama otomasyon sağlamadığı için kuyumcuda pratik değildir. Özel entegratör modelinde entegratör aylık veya kontör bazlı ücret alır; kuyumcuda belge adedi düşük olduğu için kontör maliyeti genelde küçük kalır. Bazı yazılımlar entegratör anlaşmasını pakete dahil sunarak süreci basitleştirir. Ücretsiz sürümler çoğunlukla sınırlı belgeyle test amaçlıdır; özel matrah ve tam entegrasyon için ücretli paket gerekir. Maliyeti değerlendirirken 805 kodu desteğinin ve iade senaryosunun pakete dahil olduğunu teyit edin.
2026'ya doğru e-fatura ve e-arşiv zorunluluk eşiklerinin kademeli düşmesi bekleniyor; bu, bugün gönüllü geçmeyen küçük kuyumcuların da entegrasyona ihtiyaç duyacağı anlamına geliyor. Erken kurulan doğru bir entegrasyon, zorunluluk geldiğinde telaş yaşamamanızı sağlar. Entegratör seçerken hizmet sürekliliği, GİB şema güncellemelerini otomatik yansıtması ve kuyumcuya özel özel matrah desteği belirleyici olmalıdır. Doğru kurulmuş bir entegrasyon, hatalı belge ve düzeltme maliyetini düşürerek kendini amorti eder. Kuyumcuya özel tüm e-fatura ve e-arşiv sürecini bir arada görmek için kuyumcu e-fatura ve e-arşiv rehberimizi başlangıç noktası olarak kullanabilirsiniz.
Kesinti yönetimi, yedeklilik ve destek
E-fatura entegrasyonunda kesinti senaryolarını önceden planlamak, kuyumcuyu beklenmedik durumlarda korur. İnternet kesintisi, entegratör kaynaklı geçici aksama veya GİB sistemlerindeki yoğunluk gibi durumlarda belge iletimi gecikebilir. İyi tasarlanmış bir sistem, üretilen belgeleri kuyruğa alıp bağlantı geri geldiğinde otomatik iletir; böylece satış kesintiye uğramaz, yalnızca iletim ertelenir. Kuyumcunun bu senaryoda ne yapması gerektiğini bilmesi önemlidir: satışı kaydetmeye devam eder, belgeler kuyrukta birikir ve sistem düzelince topluca gönderilir. Bu esneklik, özellikle bayram öncesi yoğun günlerde tek bir kesintinin tüm satışı durdurmasını önler. Yedekli bir entegratör altyapısı ve sağlam bir kuyruk mekanizması, entegrasyonun gerçek dünyada güvenilir çalışmasının temelidir.
Teknik destek kalitesi, entegrasyon sağlayıcısı seçiminde çoğu zaman fiyat kadar belirleyicidir. Bir belge reddedildiğinde, mali mühür sorunu çıktığında veya GİB şeması güncellendiğinde, hızlı ve kuyumculuğu anlayan bir destek ekibine ulaşabilmek kritik önem taşır. Kuyumcuya özel özel matrah ve 805 kodu konularında deneyimli bir sağlayıcı, genel bir destek hattından çok daha değerlidir çünkü sorunun kaynağını hızla teşhis eder. Sağlayıcı seçerken destek kanallarını, yanıt sürelerini ve mevzuat güncellemelerini nasıl yansıttıklarını sorgulamak gerekir. Belge üreten satış tarafını da sağlam kurmak isteyenler için altın özel matrah fatura programı yazımız, entegrasyonun beslendiği kaynağın doğru yapılandırılmasını tamamlar.
Sıkça Sorulan Sorular
E-fatura entegrasyonu için mutlaka özel entegratör şart mı?
Şart değil ama kuyumcu için en pratik yoldur. GİB portalı ücretsizdir fakat her belgeyi elle girmek ve özel matrahı manuel hesaplamak gerekir. Özel entegratör, yazılımınızın ürettiği 805 kodlu belgeleri otomatik ilettiği için yoğun bir dükkanda tek sürdürülebilir seçenektir.
Mali mühür olmadan belge iletebilir miyim?
Hayır. Mali mühür veya elektronik imza, e-belgenin hukuki geçerliliğini sağlar; bu olmadan GİB belgeyi kabul etmez. Önce mali mühür başvurunuzu tamamlayıp GİB uygulamalarına kayıt olmanız, sonra yazılımı bu sertifikayla eşleştirmeniz gerekir.
Alıcının e-fatura mükellefi olduğunu nasıl anlarım?
Yazılım, alıcının VKN'sini GİB mükellef listesiyle otomatik karşılaştırır. Kayıtlıysa e-fatura, değilse e-arşiv üretilir. Bu kontrol otomatik yapılmazsa yanlış kanaldan gönderilen belge reddedilir; bu yüzden VKN sorgusu entegrasyonun standart parçası olmalıdır.
Özel matrah entegrasyonda yanlış taşınırsa ne olur?
Belge reddedilebilir ya da altın kısmı KDV'li görünen hatalı bir belge oluşur. Bu, hem müşteriye yanlış vergi yansıtır hem de beyanı bozar. Bu nedenle canlıya geçmeden önce yalnızca altın, altın artı işçilik ve iade senaryolarını test ortamında doğrulamak gerekir.
Entegrasyon kurulumu ne kadar sürer?
Mali mühür başvurusu ve GİB kaydı birkaç iş günü sürebilir; yazılım-entegratör eşleştirmesi ve test senaryoları ise genelde birkaç gün içinde tamamlanır. Toplam süre, ürün ve cari verilerinizin ne kadar hazır olduğuna bağlıdır. Temiz veriyle geçiş belirgin şekilde hızlanır.
E-Fatura · Tüm blog yazıları · Ücretsiz Dene