e-Ticaret Entegrasyonları

Neden entegrasyon?

Günde onlarca sipariş alan bir mağazada faturaları elle kesmek hem saatler alır hem hata üretir: yanlış tutar, eksik müşteri bilgisi, unutulan belge. Entegrasyon bu zinciri koparır — sipariş verisi kaynağından gelir, belge tipi mükellefiyet sorgusuyla doğru seçilir, internet satışı bilgileri faturaya kendiliğinden yazılır.

İnternetten yapılan satışta e-Arşiv faturada satışın yapıldığı web adresi, ödeme şekli ve tarihi, kargolu gönderimde taşıyıcı firmanın unvanı ve vergi numarası gibi ek bilgiler bulunmak zorundadır (VUK Genel Tebliği Sıra No 509, IV.2.4.5). Elle kesilen faturada en sık unutulan alanlar bunlardır; ayrıntısı internet satışında e-Arşiv rehberinde.

Hangi kanal için hangi yol?

Nasıl çalışır?

1. Hesabınızı açın: ücretsiz kaydolun, firma bilgilerinizi ve fatura şablonunuzu tamamlayın.
2. Kanalı bağlayın: modül ya da API için Ayarlar → Entegrasyon bölümünden bir API anahtarı oluşturun; pazaryeri için satıcı panelinizdeki entegrasyon bilgilerini bağlantı ekranına girin.
3. Sipariş gelir: alıcının vergi ya da T.C. kimlik numarasıyla e-Fatura mükellefiyeti sorgulanır ve belge türü buna göre seçilir.
4. Belge doğrulanır: gönderimden önce kimlik numarası, tutar, KDV ve tarih kuralları kontrol edilir; sorunlu sipariş sebebiyle birlikte bekler.
5. Resmîleşir: belge onaylandığında PDF arşivinize alınır; modüllerde tahsilat kasanıza işlenir ve müşteriye e-posta gider.

WooCommerce eklentisi

WordPress mağazanıza eklentiyi kurup API anahtarınızı girdiğinizde, ödemesi alınan sipariş birkaç dakika içinde resmî faturaya dönüşür. Ödeme sayfasına "Kurumsal fatura istiyorum" seçeneği eklenir; kurumsal müşteriden unvan, vergi dairesi ve vergi numarası alınır. Alıcı e-Fatura mükellefiyse e-Fatura, değilse e-Arşiv kesilir; fatura toplamı müşterinin ödediği tutarla kuruşu kuruşuna aynıdır. Sürüm gereksinimleri ve kurulum adımları WooCommerce e-Fatura eklentisi sayfasında.

WHMCS & WiseCP modülleri

Hosting, alan adı ve SaaS aboneliği satan firmalar için WHMCS ve WiseCP modüllerimiz ücretsizdir. Modülü panelinize kurup API anahtarınızı girdiğinizde sipariş ve yenileme faturaları Faturika üzerinden kesilir; tahsilat düştüğü an belge hazırdır, mükellefiyet ayrımını (e-Fatura / e-Arşiv) sistem yapar.

WHMCS modülünün kurulum sihirbazı, kısmi ödeme ve geç ödenen fatura kuralları WHMCS e-Fatura modülü sayfasında anlatılır.

Pazaryeri satışları

Pazaryerinde satıyorsanız iki yönlü akış önemlidir. Satış tarafında Trendyol Pazaryeri siparişleriniz pazaryeri entegrasyonuyla kendiliğinden fatura taslağına dönüşür, resmîleşen faturanın bağlantısı pazaryerine iletilir; diğer kanallarda sipariş verilerinizi API ile aktarabilir ya da Excel'den toplu fatura kesebilirsiniz. Gider tarafında pazaryerinin adınıza kestiği komisyon, kargo ve hizmet e-Faturaları düzenli aralıklarla gelen kutunuza düşer; "İçeri Al" ile gider kaydına alınır ve KDV raporunuza işler. Aynı tedarikçiden gelen faturalar için gelen fatura kuralı tanımlarsanız kategori ve etiket kendiliğinden atanır.

Açık REST API

Kendi sitesi, ERP'si ya da özel yazılımı olanlar için Faturika'nın belgeli REST API'si var: fatura, cari, tahsilat ve mükellefiyet sorgusu uçlarıyla tam otomasyon kurarsınız (ayrıntı: e-Fatura API). API anahtarı bazlı kimlik doğrulama ve istek limitleriyle güvenlidir; yerel doğrulama katmanı hatalı belgeyi gönderim öncesi yakalar.

Teknik ekibiniz için hazırlık listesi e-Fatura API entegrasyonu rehberinde: mükellefiyet sorgusu, tekillik anahtarı, webhook imzası ve 7 gün kuralı.

Stok ve iade uyumu

Stok, fatura satırı kayıtlı bir ürüne bağlı olduğunda ve stok çıkışı istendiğinde düşer. WooCommerce, WHMCS ve pazaryeri belgelerinde satırlar sipariş metniyle gelir, ürün kartınıza bağlanmaz; bu kanallarda stoğu stok ekranından ayrıca yönetirsiniz. API ile kestiğiniz faturada ise satırı kayıtlı ürününüze bağlayıp stok çıkışı isteyebilirsiniz; ürün stok takipliyse belge gönderildiğinde depodan düşer.

İadede belgeyi malı iade eden taraf düzenler. Kurumsal müşteriniz e-Fatura mükellefiyse size iade faturası keser; bu fatura gelen kutunuza düşer ve "Depoya Stok Girişi" ile ürünler stoğa geri alınır. Nihai tüketici fatura düzenleyemediği için onun iadesinde Faturika'da gider pusulası hazırlanır, pusula kesinleşince stok girişi yazılır; internet satışında e-Arşiv faturanın iade bölümünün ne zaman yeterli olduğu rehberde anlatılır. Ayrıntılar: iade faturası rehberi.

Kimler için uygun?

• Pazaryeri satıcıları: günlük onlarca siparişi tek ekrandan kontrol edip toplu gönderenler.
• WordPress mağazaları: ödemesi alınan siparişin faturasının kendiliğinden kesilmesini isteyenler.
• Hosting ve abonelik işletmeleri: WHMCS'te her yenileme faturasını resmîleştirmesi gerekenler.
• Yazılımı olan işletmeler: kendi sipariş sisteminden API ile fatura kesmek isteyenler.

Örnek senaryo

Bir kozmetik markası hem kendi WooCommerce sitesinden hem Trendyol Pazaryeri'nden satıyor. Sitedeki kartlı siparişin ödemesi alındığı anda eklenti belgeyi keser; müşteri bireysel olduğu için e-Arşiv düzenlenir, web adresi ve kargo firması bilgisi faturaya yazılır, PDF müşterinin e-postasına gider. Kurumsal bir alıcının siparişinde vergi numarası sorgulanır; alıcı e-Fatura mükellefi çıkınca belge e-Fatura olarak gider. Pazaryeri siparişleri ise teslim edildiğinde taslağa dönüşür; muhasebe sorumlusu akşam taslakları gözden geçirip toplu gönderir. Ay sonunda pazaryerinin komisyon faturaları gelen kutusuna düşer ve kuralla "Pazaryeri komisyonu" kategorisine alınır.

Sık yapılan hatalar

• Her kurumsal alıcıya e-Fatura kesmek: vergi numarası olan her alıcı e-Fatura mükellefi değildir; belge türü sorguyla belirlenmelidir.
• Kargo firması bilgisini boş bırakmak: kargolu internet satışında taşıyıcının unvanı ve vergi numarası faturada yer almalıdır.
• Faturayı günlerce biriktirmek: fatura teslimden itibaren azami yedi gün içinde düzenlenir (VUK m.231/5); ayrıntı fatura düzenleme süresi rehberinde.
• Hazırlık sitesinden fatura kesmek: WooCommerce eklentisi site adresi değişince otomatik faturayı durdurur; canlı mağazayı bir kez onaylamanız gerekir.

Başlamadan önce kontrol listesi

• Firma bilgileri, e-Arşiv şablonu ve kontör bakiyesi hazır mı?
• Her kanal için ayrı bir API anahtarı oluşturdunuz mu?
• Kargo firmanızın unvanı ve vergi numarası elinizde mi?
• Kurulumdan önceki siparişlerin önceki sisteminizde faturalandığını teyit ettiniz mi?
• Stoğu hangi kanaldan yöneteceğinize karar verdiniz mi?

Sık sorulan sorular

İlgili sayfalar

Satış kanalınız büyürken belge operasyonu dert olmasın: sabit abonelik ve kontörlü modelle gönderdiğiniz ve aldığınız e-belge kadar kontör harcarsınız.