Kurulum ve ilk ayarlar
Eklentiyi kurun, lisansı ve e-Logo hesabını doğrulayın; önce test moduyla deneyin.
Gereksinimler
- WISECP 5.0-beta.2 veya üzeri (5.0-beta.3 ile denendi), PHP 8.1 ve üzeri.
- PHP eklentileri: cURL, OpenSSL, Zip, DOM ve mbstring.
- e-Logo web servis hesabı (kullanıcı / firma kodu ve şifre). Test için e-Logo’nun pb-demo ortamı kullanılır.
- WISECP’de fatura vergilendirmesi açık olmalıdır.
- Paraşüt eklentisi kapalı olmalıdır; aynı faturanın iki kez resmileşmemesi için eklenti Paraşüt etkinken ayarları kaydetmez.
- Çalışan WISECP cron görevi (gönderim, durum takibi ve otomatik tarama bu kuyrukla ilerler).
Eklentiyi kurun
- Lisansı alın. hostimor.com’dan Hostimor | e-Logo lisansını WISECP lisansınızın alan adı için sipariş edin; lisans ücretsizdir.
- Yedek alın. Dosya ve veritabanı yedeğinizi kontrol edin.
- Kurun. Eklentiyi WISECP Pazar Yeri’nden kurun; WISECP
coremio/modules/Addons/HostimorELogoklasörünü kendisi oluşturur. Paketi hostimor.com müşteri panelinizden indirdiyseniz klasörü aynı yola yükleyin. - Ayarları açın. Araçlar › Eklentiler › Hostimor | e-Logo › Ayarlar sayfasını açın.
- Lisans kartını kontrol edin. Sayfanın en üstündeki Lisans kartında durum Etkin, paket bütünlüğü Doğrulandı görünmelidir; gerekirse Yeniden doğrula’ya basın.
Hostimor | e-Logo 1.2.0, 24 Ekim 2026’da WISECP Pazar Yeri’nde yayımlandı. Kurulum paketi ve sonraki güncellemeler Pazar Yeri üzerinden alınır. Lisans ücretsizdir ve hostimor.com’dan alınır.
e-Logo hesabı
Test Modu açıkken eklenti e-Logo test ortamına (pb-demo), kapalıyken canlı adrese bağlanır; servis adresi otomatik seçilir. Kullanıcı / Firma Kodu ve Şifre e-Logo web servis bilgilerinizdir. Şifre WISECP’de şifreli saklanır; ekran görüntüsü veya destek talebiyle paylaşmayın.
Satıcı (firma) bilgileri
Faturada satıcı olarak görünen bilgilerdir; ilk açılışta WISECP’nin fatura bilgilerinden doldurulur. VKN / TCKN e-Logo hesabınızdaki numarayla aynı olmalıdır: şirketler için 10 haneli VKN, şahıs firmaları için 11 haneli TCKN. Şahıs firmasında unvan ad soyad olarak yazılır; son kelime soyadı olarak kullanılır. Vergi dairesi, adres, ilçe, il, posta kodu, telefon, e-posta ve web sitesi faturaya taşınır.
Fatura ayarları
| Ayar | Ne işe yarar? |
|---|---|
| e-Fatura Senaryosu | Temel: fatura iletildiğinde kesinleşir. Ticari: alıcı 8 gün içinde kabul veya ret verebilir. Yalnız e-Fatura kayıtlı alıcılar için geçerlidir. |
| KDV %0 sebep kodu (yurt içi) | Yurt içinde KDV’siz satılan kalemler için. 351 (İstisna Olmayan Diğer) satış faturası olarak gönderilir; başka bir istisna kodu girerseniz fatura tipi İSTİSNA olur. |
| Yurt dışı istisna kodu | Yurt dışı müşterilere e-Arşiv, VKN 2222222222 ve KDV %0 ile kesilir. Hosting, sunucu, alan adı ve yazılım hizmetleri için 302 (Hizmet İhracatı). |
| e-Fatura / e-Arşiv tasarım UUID | Önerilen: e-Logo’nun hazır tasarımı (GİB logosu, karekod, imza). Ayrıntı aşağıda. Boş bırakılırsa eklentinin kendi tasarımı kullanılır. |
| Fatura notu | İsteğe bağlı; her faturanın not alanına eklenir (örneğin banka / IBAN bilgisi). |
e-Logo hazır tasarımını bağlayın
- Tasarımı seçin. e-Logo portalında Tasarımlar › Hazır Tasarım Aracı bölümünden bir tasarıma Ön Değer Ata deyin.
- ETTN’yi kopyalayın. Tasarımlar › Tasarım Aracı listesinde o tasarımın ETTN sütunundaki değeri kopyalayın.
- Ayarlara yapıştırın. e-Fatura ve e-Arşiv için ayrı alanlara yapıştırıp kaydedin.
Portaldaki “Ön Değer” tasarımı web servisle gönderilen belgelere kendiliğinden uygulanmaz; tasarım UUID’si girilmezse eklenti kendi tasarımını belgeye ekler. Test ve canlı hesapların tasarım ETTN’leri farklıdır.
Test moduyla deneyin
Test modunda belgeler e-Logo test ortamına gider, resmi değildir: müşteriye gösterilmez ve e-posta gönderilmez. Yönetici fatura kartında Test belgesi, resmi değil etiketi görünür. Test modunu kapattığınızda bu faturalar kartta Test belgesi; canlı için yeniden gönderin olarak işaretlenir ve e-Logo’ya yeniden gönderilebilir.
Canlıya geçiş kontrol listesi
- Test modunu kapatın. Ayarlarda Test Modu’nu kapatın.
- Canlı hesap bilgilerini girin. Canlı e-Logo kullanıcı / firma kodu ve şifresini kaydedin.
- Canlı tasarımları bağlayın. Canlı hesabın e-Fatura ve e-Arşiv tasarım ETTN’lerini girin.
- Modu seçin. Manuel veya otomatik resmileştirmeyi seçin; otomatik modda yalnız açıldıktan sonra ödenen faturalar resmileşir.
- İlk faturayı izleyin. Bir faturayı resmileştirip kartın Resmi ve PDF eklendi durumuna geçtiğini, müşteri faturasında belgenin göründüğünü kontrol edin.
Devre dışı bırakma ve kaldırma
Eklentiyi Araçlar › Eklentiler ekranından devre dışı bırakıp coremio/modules/Addons/HostimorELogo klasörünü silebilirsiniz. Kesilmiş belgelerin bilgileri ve resmi PDF’ler faturaların üzerinde kalır.