KolayBi E-Fatura / e-Arşiv Entegrasyonu

Kategori: E-Fatura Versiyon: 1.0.0

KolayBi eklentisi, KolayBi muhasebe platformu aracılığıyla satış faturası, e-Fatura ve e-Arşiv resmileştirme işlemlerini yapmanızı sağlar.

Desteklenen Özellikler

  • e-Fatura oluşturma ve gönderme
  • e-Arşiv fatura oluşturma
  • Bağlantı testi

1. Ön Hazırlık — KolayBi'den API Bilgilerini Alın

  1. developer.kolaybi.com/docs/getting-started adresindeki rehberi inceleyin.
  2. API Key'i KolayBi panelinizden alın.
  3. Channel ID için api.support@kolaybi.com ile iletişime geçin.

⚠️ Channel ID panelden kendiniz alamazsınız; KolayBi destek ekibinden talep etmeniz gerekir. Bağlantı kurmadan önce bu adımı başlatın.

📸 KolayBi paneli, API Key alanı

2. Eklentiyi Mağaza Panelinde Yapılandırın

  1. Sol menüden Eklenti Mağazası sayfasına gidin ve KolayBi E-Fatura kartındaki Eklentiyi Yapılandır butonuna tıklayın.
  2. Bağlantı Ayarları sekmesine tıklayın.
KolayBi entegrasyon sayfası, Bağlantı Ayarları sekmesi
KolayBi entegrasyon sayfası, Bağlantı Ayarları sekmesi
  1. Aşağıdaki alanları doldurun:
AlanAçıklama
API KeyKolayBi panelinden alınan anahtar (değiştirmemek için boş bırakın)
Channel IDKolayBi destek ekibinden aldığınız kanal kimliği
Şirket ID (company_id)Opsiyonel. Boş bırakılırsa tek şirket otomatik seçilir
Sandbox (test) ortamıGerçek fatura kesmeden önce açık tutun
  1. Kaydet butonuna tıklayın.

Bağlantı kurulduğunda sayfanın üstünde "Bağlı: [şirket adı]" bilgisi görünür. Hesabınızda birden fazla şirket varsa listesi alanın altında gösterilir.

3. Bağlantıyı Test Edin

Bağlantıyı Test Et butonuna tıklayın ve başarılı mesajı bekleyin.

📸 KolayBi bağlantı testi başarılı bildirimi

Hata alırsanız: "KolayBi API bilgileri yapılandırılmamış. API Key ve Channel ID girin." mesajı görünür.

4. Fatura Oluşturma

  1. Onaylanan Siparişler sekmesine gidin.
  2. Fatura kesmek istediğiniz siparişin satırında fatura tipine göre e-Arşiv veya e-Fatura butonuna tıklayın.
  3. KolayBi faturayı oluşturup resmileştirir.

ℹ️ Fatura tipi, tıkladığınız butonla belirlenir; ayrı bir tip seçim adımı yoktur.

📸 Onaylanan Siparişler sekmesi, e-Arşiv ve e-Fatura butonları

Sık Karşılaşılan Sorunlar

"KolayBi API bilgileri yapılandırılmamış" hatası: API Key ve Channel ID alanlarının dolu olduğunu ve Kaydet'e basıldığını kontrol edin.

Channel ID'yi nereden alacağım? KolayBi panelinde bu bilgi görünmez. api.support@kolaybi.com adresine e-posta atarak talep edin.

Şirket ID nedir? Hesabınızda birden fazla şirket varsa hangisine fatura keseceğinizi belirler. Tek şirket yönetiyorsanız boş bırakın.