# E-fatura entegrasyonu kurulumu

> Uyumsoft, Paraşüt, Sovos, BirFatura, Bizimhesap veya Mikro'yu bağlayarak siparişleriniz için e-fatura ve e-arşiv belgelerini otomatik kesin.

Canonical page: https://magazamhazir.com/yardim/e-fatura-kurulumu
Menu path in the store admin: Ayarlar > Entegrasyonlar
Requires plugin(s): e-invoice
Last updated: 2026-09-01

E-fatura entegrasyonu, siparişleriniz için belgeyi elle kesme işini ortadan kaldırır. Birden çok sağlayıcı desteklenir ve aynı anda yalnızca biri aktif olur. Bu rehber sağlayıcı seçimini, bağlantı bilgilerini ve aktifleştirmeyi anlatır.

## Başlamadan önce

- E-Fatura eklentisinin açık olması
- Sağlayıcınızda açılmış bir hesap ve entegrasyon kullanıcı bilgileri
- Firma bilgilerinizin (ünvan, vergi dairesi, vergi no) eksiksiz olması

## Adımlar

### 1. E-Fatura Entegrasyonları sayfasını açın {#adim-1}

Ayarlar > Entegrasyonlar sayfasında E-Fatura kartından girin. Sayfa desteklenen sağlayıcıları kart hâlinde listeler ve her birinin durumunu Yapılandırıldı / Yapılandırılmadı olarak gösterir.

### 2. Sağlayıcınızı seçip bilgileri girin {#adim-2}

Kullandığınız sağlayıcının kartından Ayarları Düzenle deyin. İstenen alanlar sağlayıcıya göre değişir: Uyumsoft kullanıcı adı ve şifre ister, BirFatura API Anahtarı (X-Api-Key), Gizli Anahtar (X-Secret-Key) ve Entegrasyon Anahtarı (X-Integration-Key) ister.

### 3. Bağlantıyı test edin {#adim-3}

Sağlayıcı bir test butonu sunuyorsa (örneğin BirFatura Bağlantısını Test Et) önce onu çalıştırın. Bağlantı başarılı mesajını görmeden aktif etmeyin — yanlış bilgiyle aktif edilen bir sağlayıcı, her siparişte sessizce belge kesmemeye başlar.

### 4. Sağlayıcıyı aktif edin {#adim-4}

Ayarlar kaydedildikten sonra kartta Aktif Yap butonu belirir. Basıldığında Sağlayıcı aktif edildi mesajını görürsünüz ve sayfanın üstündeki Aktif Sağlayıcı alanı bu sağlayıcıyı gösterir. Aynı anda yalnızca bir sağlayıcı aktif olabilir.

### 5. Faturaları kontrol edin {#adim-5}

Finans > Faturalar sayfasından kesilen belgeleri görürsünüz. İlk birkaç siparişten sonra buraya bakıp belgenin gerçekten oluştuğunu doğrulayın.

## İpuçları

### E-fatura, ön muhasebe ve ERP farklı şeylerdir

E-fatura entegrasyonu belgeyi keser. Gelir-gider takibi için Ön Muhasebe, stok ve üretim için ERP ayrı çözümlerdir. Birini alıp diğerini beklemeyin.

### Sağlayıcı değiştirirken eskisini pasif yapın

Yeni sağlayıcıyı aktif ettiğinizde eskisi otomatik olarak pasife düşer, ama bilgileri kayıtlı kalır — geri dönmek isterseniz yeniden girmeniz gerekmez.

## Sık sorulan sorular

### Birden fazla sağlayıcıyı aynı anda kullanabilir miyim?

Hayır. Birden çok sağlayıcının bilgileri kayıtlı olabilir ama aynı anda yalnızca biri aktiftir.

### Kontörüm bitince ne olur?

Sağlayıcı belge kesmeyi reddeder. BirFatura gibi bazı sağlayıcılarda Kalan Kontör panelde görünür; düzenli kontrol edin.

### E-arşiv ve e-fatura arasındaki farkı sistem kendisi mi seçiyor?

Evet. Alıcının mükellef olup olmamasına göre doğru belge tipi seçilir; sizin ayrıca bir şey yapmanız gerekmez.