e-Fatura İlk Kurulum
FinansZ'te giden fatura kesmeye ve taslak belgelerle çalışmaya başlamadan önce workspace'inizde GİB entegrasyonunun hazır olması gerekir. Bu rehber, e-Fatura İlk Kurulum ekranındaki adımları ve entegrasyonu atlamadan devam etme seçeneğini açıklar.
Bu Sayfada
Giden fatura ve taslak menülerine yönlendirme mantığı, kurulum kontrol listesi ve entegrasyonu tamamlamadan devam etme.
Ön Koşullar
- GİB e-Fatura / e-Arşiv mükellefi olmanız.
- Bir özel entegratör veya GİB portalı ile anlaşmanız ve API kimlik bilgilerinizin hazır olması.
GibService/InvoiceServiceizinleriniz.
Sayfaya Ulaşma
Sol menü → Muhasebe → Entegrasyon Merkezi → e-Fatura Kurulum.
Doğrudan adres: /accounting/integrations/onboarding.
Görsel: e-Fatura kurulum kontrol listesi
Ne Zaman Bu Sayfaya Yönlendirilirsiniz?
Aşağıdaki sayfalara girmeye çalıştığınızda sistem entegrasyon durumunu kontrol eder:
- Muhasebe → Taslaklar
- Muhasebe → Faturalar → Giden Faturalar
Entegrasyon hazır değilse ve daha önce “entegrasyonu atla” demediyseniz otomatik olarak bu kurulum sayfasına yönlendirilirsiniz.
Entegrasyon hazır olduğunda giden faturalar listesine geçersiniz.
Gelen faturalar ve irsaliye sayfaları bu kontrolden bağımsızdır; entegrasyon tamamlanmadan da açılabilir (gelen belge senkronu için yine entegratör gerekir).
Kurulum Adımları
Ekranda iki ana adım kartı görünür. Her adım tamamlandığında yeşil onay işareti gösterilir.
Adım 1 — Entegratör ve Kimlik Bilgileri
| Kontrol | Anlamı |
|---|---|
| Varsayılan entegratör ayarı tanımlı | Workspace için bir entegratör seçilmiş |
| Kimlik bilgileri girilmiş | API anahtarı / şifre vb. kayıtlı |
Yapmanız gereken: Entegratör Seçimi & Ayarları sayfasına gidin; entegratörü seçin, kimlik bilgilerini girin ve kaydedin.
Kart üzerindeki Ayarlara Git butonu sizi doğrudan bu sayfaya götürür.
Adım 2 — Gönderici Profili (VKN / Unvan)
| Kontrol | Anlamı |
|---|---|
| Gönderici VKN ve unvan | Faturada görünecek satıcı bilgileri tanımlı |
Yapmanız gereken: Gönderici Profilleri sayfasında şirketinize ait VKN, ticari unvan, adres ve fatura seri bilgilerini tamamlayın.
Kart üzerindeki Gönderici Profiline Git butonu bu sayfaya yönlendirir.
Kurulum Tamamlandığında
Her iki adım da tamamlandığında sayfada entegrasyon hazır mesajı görünür. Sonraki girişlerde giden fatura ve taslak sayfalarına doğrudan erişirsiniz.
Test için küçük tutarlı bir taslak fatura oluşturup kesinleştirmeniz önerilir → Taslaklar, Giden Faturalar.
Entegrasyonu Atlayarak Devam Etme
Henüz entegratör anlaşmanız yoksa veya sadece arayüzü incelemek istiyorsanız:
- Sayfanın altındaki uyarı kartını okuyun.
- Entegrasyon olmadan devam et seçeneğini kullanın.
Bu tercih tarayıcınızda saklanır; giden fatura listesine gidebilirsiniz. Ancak GİB'e gerçek gönderim yapılamaz; fatura kayıtları taslak veya yerel “kesildi” durumunda kalır.
Entegrasyonu tamamladığınızda bu tercih otomatik temizlenir.
Yenileme
Kurulum adımlarını tamamladıktan sonra durum güncellenmezse Yenile ile sunucudan son durumu çekin.
Sık Karşılaşılan Durumlar
| Durum | Sebep | Çözüm |
|---|---|---|
| Giden faturalara giremiyorum | Kurulum guard aktif | Onboarding sayfasındaki iki adımı tamamlayın veya geçici olarak atlayın |
| Adım 1 tamamlanmıyor | Entegratör seçilmemiş veya kimlik boş | Entegratör ayarlarında varsayılan kaydı ve credential satırlarını kontrol edin |
| Adım 2 tamamlanmıyor | VKN/unvan eksik | Gönderici profilinde zorunlu alanları doldurun |
| Gönderim hata veriyor | Kurulum tamam görünse bile entegratör reddi | Entegratör panelinde test ortamı / canlı anahtar uyumunu kontrol edin |