Shopify e-fatura ve e-arşiv entegrasyonu: kurulumun tamamı

Fatura entegrasyonunun zor kısmı belge üretmek değil; hangi siparişe hangi belgenin, hangi anda kesileceğine karar vermek. Alıcı sorgusundan iade akışına, KDV dağıtımından ihracat faturasına kadar kurulumu yazdık.

Fatura entegrasyonu, e-ticaret projelerinde en geç konuşulan ama en erken çalışması gereken kalemdir. Mağaza yayına çıkar, siparişler gelir, sonra muhasebe “bu faturaları kim kesecek?” diye sorar. O noktada verilen aceleci kararlar, ay sonunda mutabakat sorunu olarak geri döner.

İşin teknik tarafı aslında standarttır: bir sipariş verisi alınır, belge üretilir, gönderilir. Zor olan kısım kararlardır — hangi siparişe e-Fatura, hangisine e-Arşiv düzenlenecek, belge hangi anda kesilecek, iade geldiğinde ne olacak. Bu yazıda kurulumu bu kararlar üzerinden anlatıyoruz.

Baştan bir çerçeve: aşağıdakiler bir mali müşavirlik tavsiyesi değil, entegrasyonun teknik ve operasyonel kurulumudur. Belge türü, muafiyet ve süre gibi başlıklarda mevzuat düzenli olarak güncelleniyor; kurulum öncesi her projede mali müşavirinizle birlikte teyit ediyoruz.

e-Fatura mı, e-Arşiv mi? Kararı alıcı belirler

İkisi arasındaki fark, sizin tercihiniz değil alıcının durumudur. Alıcı e-Fatura sistemine kayıtlıysa belge e-Fatura olarak, kayıtlı değilse e-Arşiv olarak düzenlenir. E-ticarette alıcıların büyük çoğunluğu bireysel olduğu için hacmin ezici kısmı e-Arşiv tarafındadır; ancak kurumsal siparişler geldiğinde doğru yola çıkması gerekir.

Bu kararın elle verilmesi mümkün değil. Entegrasyonun yapması gereken şey, fatura kesilmeden önce alıcının vergi numarasını sorgulayıp hangi yola gideceğini kendi belirlemesidir.

Son madde önemli: bazı kurulumlarda sorgu başarısız olduğunda sistem varsayılana düşüp e-Arşiv kesiyor. Kurumsal bir alıcıya yanlış belge türü düzenlemenin düzeltmesi, bir siparişin beklemesinden çok daha zahmetlidir.

Kurumsal fatura bilgisi checkout'ta toplanmalı

Yukarıdaki akışın çalışabilmesi için gereken veri, sipariş anında toplanmış olmalı. Sonradan müşteriye e-posta atıp vergi numarası istemek, hem operasyon yükü hem gecikme üretir.

Ödeme adımına eklenen her alan bir maliyet olduğu için, bu kalemi mümkün olan en küçük haliyle kuruyoruz: koşullu açılan üç alan ve biçim doğrulaması. Fazlası gerekmiyor.

Fatura ne zaman kesilir?

Entegrasyonun en çok tartışılan kararı budur ve doğru cevap tek değildir; iş modelinize göre değişir. Üç yaygın kurgu var:

Kararı belirleyen soru şu: siparişin iptal olma ihtimali yüksek mi? Fatura kesildikten sonra iptal, iade belgesi gerektirir; kesilmeden önce iptal ise yalnızca bir sipariş iptalidir. Stok riski olan kataloglarda bu yüzden sevk anını tercih ediyoruz.

Kapıda ödemede ayrı bir kurgu gerekir: tahsilat teslimde gerçekleştiği için belge zamanlaması ve tahsil edilemeyen gönderilerin akışı önceden yazılır. Bu, entegrasyon projelerinde en sık atlanan senaryodur.

Bağlantı yöntemi: entegratör mü, doğrudan mı?

Belgelerin resmî sisteme iletilmesi için iki yol var ve e-ticaret tarafında pratikte tek bir doğru cevap oluyor.

Hangi yolu seçerseniz seçin, entegrasyonda bakılacak teknik başlıklar aynıdır: bağlantı arayüzü, test ortamının varlığı, belge tipi desteği, hata kayıtlarının görünürlüğü ve saklama süresi. Bunlardan “hata kayıtlarının görünürlüğü” maddesini özellikle soruyoruz; kesilemeyen bir faturanın sebebini göremediğiniz bir kurulumda, sorun ancak muhasebe fark ettiğinde ortaya çıkar.

Faturayı kim kesiyor: Shopify tarafı mı, ERP mi?

ERP kullanan mağazalarda bu soru baştan cevaplanmalı, çünkü iki ayrı yerden fatura kesilen bir kurulum numara çakışması üretir.

Son madde entegrasyon projelerinde altını çizdiğimiz kuraldır. “Bazı siparişleri panelden keselim” diye başlayan istisnalar, ay sonu mutabakatını saatlerce süren bir işe çevirir.

Tutarların birebir tutması: KDV ve indirim dağıtımı

Faturadaki toplam ile siparişteki toplamın kuruşu kuruşuna eşit olması gerekir. Uyuşmazlıkların neredeyse tamamı üç yerden çıkar.

Kampanya kurgusu karmaşıklaştıkça bu dağıtımın önemi artar. Sepet bazlı indirim, kargo bedava eşiği ve ürün bazlı indirimin aynı siparişte üst üste geldiği bir senaryoyu, kurulum sırasında mutlaka test ediyoruz — çünkü hata tam olarak orada çıkıyor.

Taksitli satışta vade farkı uyguluyorsanız, bu tutarın faturada nasıl gösterileceği de ayrı bir karardır ve mali müşavirle birlikte netleştirilir.

İade, iptal ve değişim

Fatura entegrasyonunun ileri yönü kolaydır; geri yönü kurgu ister. Teklif aşamasında en çok atlanan başlık da budur.

Bu senaryoların her biri için “ne olacak” cevabını yazmadan yayına çıkmıyoruz. İlk iki hafta içinde hepsi mutlaka tetikleniyor ve hazırlıksız yakalandığında düzeltmesi elle yapılıyor.

Yurt dışına satış yapıyorsanız

Yurt dışı siparişleri yurt içi akışın içine sokulamaz; belge türü ve vergi kurgusu farklıdır. Markets üzerinden yurt dışına satan mağazalarda bunu ayrı bir akış olarak kuruyoruz.

Bu başlıkta genelleme yapmıyoruz; ihracat kurgusu satış modeline ve gümrük yöntemine göre değişiyor. Kurulumu, sizin gümrük müşaviriniz ve mali müşavirinizle birlikte tasarlıyoruz.

Pazaryeri siparişleri

Aynı stoğu pazaryerlerinde de satıyorsanız, faturayı kimin keseceği kanal bazında değişebilir. Karışıklığı önlemek için tek bir kural koyuyoruz: her kanalın belge sorumlusu yazılı olsun ve aynı siparişe iki kanaldan belge üretilmesin.

Pratikte en sık görülen hata, pazaryeri entegrasyonunun da fatura kesmesi ve aynı siparişin iki belgeyle kayda geçmesidir. Kurulum sırasında hangi kanalın hangi belgeyi ürettiğini tek bir tabloya döküyoruz.

Kesilemeyen fatura sessizce bekler

Fatura entegrasyonu bozulduğunda mağaza çalışmaya devam eder; siparişler gelir, kargolar çıkar, yalnızca belgeler üretilmez. Bunu genellikle ay sonunda muhasebe fark eder. İzleme kurmamanın maliyeti burada ortaya çıkıyor.

Uyarıların kime gideceği de yazılı olmalı. Kimseye gitmeyen uyarı, olmayan uyarıdır.

Kurulum takvimi

Standart bir kurulum için tipik süre 1–3 hafta. Süreyi uzatan şey geliştirme değil, karar ve mutabakat adımlarıdır.

Dördüncü maddeyi özellikle vurguluyoruz: test siparişlerini gerçek senaryolarla yapıyoruz. Tek ürünlü, indirimsiz, tek KDV oranlı bir test siparişi hiçbir şey doğrulamaz.

Sık yapılan hatalar

Özet

e-Fatura ve e-Arşiv entegrasyonu teknik olarak öngörülebilir bir iştir; belirsizliği yaratan şey kararlardır. Belge türünün nasıl belirleneceği, faturanın hangi anda kesileceği ve geri yöndeki akışların nasıl işleyeceği yazılı hale geldiğinde kurulum birkaç haftalık bir işe iner.

Günlük sipariş adedinizi, kurumsal satış oranınızı, kullandığınız muhasebe ya da ERP sistemini ve satış yaptığınız kanalları paylaşın; akışı çıkarıp kapsamı kalem kalem yazalım. Mevcut kurulumunuz ihtiyacınızı karşılıyorsa bunu da açıkça söyleriz.

Not: Bu yazı entegrasyonun teknik ve operasyonel kurulumunu anlatır; mali müşavirlik ya da hukuki danışmanlık niteliği taşımaz. Belge türü, muafiyet ve süre başlıklarındaki güncel yükümlülükleri mali müşavirinizle teyit ediniz.