E-fatura Entegrasyonu: E-fatura ve E-arşiv Faturayı Siparişe Bağlamak

Günde birkaç sipariş alırken faturayı elle kesmek sorun gibi görünmez. Sipariş sayısı arttığında ise her akşam portal ekranında müşteri adı, vergi numarası ve tutar kopyalamak hem saatler alır hem de hataya kapı açar. E-fatura entegrasyonu, web sitenizdeki ya da yazılımınızdaki satış verisinin, kullandığınız e-fatura hizmetine otomatik olarak gönderilip faturaya dönüşmesi demektir. Bu yazıda sistemin nasıl kurulduğunu, hangi bilgilerin doğru tutulması gerektiğini ve projeye başlamadan önce netleştirmeniz gereken soruları anlatıyorum.

E-fatura ve e-arşiv fatura arasındaki fark

Entegrasyona geçmeden önce iki belge türünü ayırmak gerekir. E-fatura, e-fatura sistemine kayıtlı iki mükellef arasında düzenlenen ve elektronik ortamda karşı tarafa iletilen faturadır. E-arşiv fatura ise alıcı e-fatura mükellefi değilse, örneğin bireysel bir müşteriye satış yaptığınızda düzenlenir ve müşteriye genellikle e-posta ya da bağlantı olarak ulaştırılır.

Bir e-ticaret sitesinde bu ayrım her siparişte yeniden yapılır. Müşteri kurumsal fatura istediyse ve vergi numarası e-fatura kayıtlı bir firmaya aitse e-fatura, değilse e-arşiv fatura kesilir. İyi kurulmuş bir entegrasyon bu kontrolü sizin yerinize yapar; hangi belge türünün gerektiğini kullandığınız hizmetten sorgular ve doğru senaryoyu seçer.

Hangi belgeleri düzenlemek zorunda olduğunuz, mükellefiyet durumunuz ve faaliyet alanınıza göre değişir. Bu konuda kesin bilgi için mali müşavirinize danışın.

E-fatura entegrasyonu nasıl çalışır?

Çoğu işletme faturalarını bir özel entegratör ya da e-fatura hizmeti sunan bir yazılım firması üzerinden düzenler. Bu firmalar, yazılımların bağlanabilmesi için genellikle bir API sunar. Entegrasyon, sizin sisteminizle bu API arasında köprü kuran yazılım katmanıdır. Temel akış şöyledir:

1. Müşteri siparişi tamamlar ve ödeme onaylanır.
2. Sistem sipariş verisini (alıcı bilgileri, ürünler, miktar, birim fiyat, KDV oranı, indirim, kargo) faturaya uygun biçime çevirir.
3. Alıcının e-fatura mükellefi olup olmadığı sorgulanır ve belge türü belirlenir.
4. Fatura verisi hizmet sağlayıcının API’sine gönderilir; sağlayıcı faturayı oluşturur ve numara verir.
5. Dönen fatura numarası ve PDF ya da görüntüleme bağlantısı siparişe kaydedilir, müşteriye e-posta ile iletilir.

Bu adımların tamamı birkaç saniye içinde, kimse panele girmeden gerçekleşir. İptal ve iade durumlarında da benzer bir akış çalışır; iade faturası ya da iptal işlemi ilgili kurallara göre tetiklenir.

Hangi verilerin temiz olması gerekir?

Entegrasyonun başarısı büyük ölçüde sizin ürün ve müşteri verinizin düzenine bağlıdır. Projeye başlamadan önce şunları kontrol etmenizi öneririm:

• KDV oranları: Her ürünün doğru vergi sınıfında olması, fiyatların KDV dahil mi hariç mi girildiğinin net olması.
• Birim ve stok kodları: Adet, kilogram, metre gibi birimlerin tutarlı kullanılması.
• Fatura adresi alanları: Kurumsal müşteriler için firma unvanı, vergi dairesi ve vergi numarası; bireysel müşteriler için ad soyad ve gerekiyorsa kimlik bilgisi alanlarının ödeme sayfasında doğru toplanması.
• İndirim ve kupon kurgusu: Sepet indiriminin satırlara nasıl dağıtılacağının belirlenmesi; aksi halde fatura toplamı sipariş toplamıyla kuruşu kuruşuna tutmayabilir.

Entegrasyon seçenekleri: Hazır eklenti mi, özel geliştirme mi?

WooCommerce gibi yaygın altyapılarda bazı e-fatura hizmetlerinin kendi eklentileri bulunur. Basit bir mağaza için bu eklentiler yeterli olabilir. Ancak birden fazla satış kanalınız varsa, faturayı muhasebe programınıza da aktarmanız gerekiyorsa ya da özel indirim kurallarınız varsa hazır eklentinin sınırlarına çabuk ulaşılır.

Durum	Hazır eklenti	Özel entegrasyon
Tek kanal, standart ürünler	Genellikle yeterli	Gerekli olmayabilir
Site, pazaryeri ve mağaza satışı birlikte	Sınırlı kalabilir	Tek merkezden yönetim sağlar
Muhasebe programına otomatik aktarım	Çoğu zaman yok	Akışa eklenebilir
Özel kampanya ve paket ürünler	Satır hesapları zorlaşabilir	Kurala göre hesaplanır

Faturanın kesildikten sonra muhasebe kayıtlarına da düşmesini istiyorsanız konuyu muhasebe programı entegrasyonu yazısında ayrıntılı ele aldım. İki entegrasyon genellikle aynı projede birlikte planlanır.

Sık yapılan hatalar ve önlemleri

Entegrasyon projelerinde gördüğüm sorunların çoğu teknik değil, süreçle ilgilidir. En sık karşılaşılanlar:

• Ödeme onayı beklenmeden fatura kesmek: Kapıda ödeme ya da havale siparişlerinde fatura, ödeme gerçekten alındığında tetiklenmeli.
• Hata durumunu izlememek: Sağlayıcının servisi o an yanıt vermezse fatura kaybolmamalı; sistem işlemi kuyruğa alıp yeniden denemeli ve başarısız kayıtları size bildirmeli.
• Aynı siparişe iki fatura: Sayfa yenilenmesi veya tekrar gelen bildirimler mükerrer faturaya yol açabilir. Her sipariş için tek seferlik işlem kontrolü şarttır. Ödeme sağlayıcılarından gelen bildirimlerin nasıl ele alındığını webhook nedir yazısında anlattım.
• Test ortamını atlamak: Çoğu sağlayıcı bir test ortamı sunar. Canlıya geçmeden önce e-fatura, e-arşiv, iade ve iptal senaryolarının hepsi orada denenmeli.

Sağlayıcıların API yapısı, ücretlendirmesi ve teknik şartları zaman içinde değişebilir. Bu yüzden entegrasyona başlarken güncel şartları ve dokümantasyonu sağlayıcının kendi sitesinden kontrol etmek gerekir.

Bu işi nasıl birlikte yaparız?

E-fatura entegrasyonu projelerinde izlediğim süreç kısa ve şeffaftır:

1. Mevcut durumu dinlerim: Hangi altyapıyı kullandığınızı, hangi e-fatura hizmetiyle çalıştığınızı, günlük sipariş hacminizi ve mali müşavirinizin beklentilerini öğrenirim.
2. Kapsamı ve teklifi netleştiririz: Hangi kanalların bağlanacağı, iade ve iptal akışı, muhasebe aktarımı gibi kalemleri yazılı hale getirir, buna göre teklif hazırlarım.
3. Test ortamında geliştiririm: Entegrasyonu sağlayıcının test ortamında kurar, örnek siparişlerle tüm senaryoları sizinle birlikte doğrularız.
4. Canlıya alır ve izlerim: İlk günlerde kesilen faturaları birlikte kontrol eder, hata bildirimlerini size ulaşacak şekilde ayarlarım. Sonrasında bakım ve destek devam eder.

Altyapınızı ve ihtiyacınızı konuşmak için iletişim sayfasından bana yazabilirsiniz.

Sık sorulan sorular

E-fatura entegrasyonu için hangi e-fatura hizmetini kullanmalıyım?

Çalıştığınız hizmetin bir API sunması ve test ortamı sağlaması yeterlidir. Mevcut sağlayıcınızı değiştirmeden entegrasyon kurmak çoğu durumda mümkündür.

Bireysel müşterilere de otomatik fatura kesilebilir mi?

Evet. Alıcı e-fatura mükellefi değilse sistem e-arşiv fatura düzenler ve müşteriye e-posta ile iletir. Hangi belgeyi düzenlemeniz gerektiğini mali müşavirinizle teyit etmeniz önerilir.

Sağlayıcının servisi çökerse siparişler ne olur?

Doğru kurulmuş bir entegrasyonda siparişler etkilenmez. Fatura işlemi kuyruğa alınır, servis düzelince yeniden denenir ve başarısız kalan kayıtlar size bildirilir.

Pazaryeri siparişleri de aynı sistemden faturalanabilir mi?

Pazaryeri siparişleri sisteminize aktarılıyorsa evet. Tüm kanalların faturası tek merkezden kesilebilir; bu, kapsam aşamasında planlanması gereken bir konudur.

Sonuç

E-fatura entegrasyonu, her siparişte tekrar eden elle işlemleri ortadan kaldırır, hata riskini azaltır ve size muhasebe yerine işinize ayıracak zaman bırakır. Başarılı bir kurulum için temiz ürün verisi, doğru belge türü seçimi ve hata durumlarının izlenmesi kritik önemdedir. Kendi altyapınız için uygun yolu birlikte değerlendirmek isterseniz bana ulaşabilirsiniz.