=== AloFatura — e-Arşiv Fatura ===
Contributors: batuhanfirat
Tags: e-arşiv, fatura, gib, e-fatura, türkiye
Requires at least: 6.0
Tested up to: 6.8
Requires PHP: 8.1
Stable tag: 1.0.0
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

İşletmenizin kendi GİB e-Arşiv Portal hesabıyla e-Arşiv faturalarınızı WordPress yönetim panelinden listeleyin, taslak oluşturun ve SMS şifresiyle kesin.

== Description ==

**AloFatura resmî bir GİB uygulaması değildir; GİB ile bağlantılı değildir.** Kendi e-Arşiv Portal hesabınızla (kullanıcı kodu ve şifreniz) çalışır.

AloFatura, Gelir İdaresi Başkanlığı'nın e-Arşiv Portalı'ndaki işlemlerinizi WordPress yönetim panelinize taşır:

* GİB'deki taslak, onaylı ve silinmiş e-Arşiv faturalarınızı tarih aralığına göre listeleyin.
* Faturayı GİB görünümüyle açın, HTML ya da ZIP (HTML + XML) olarak indirin.
* Yeni fatura taslağı oluşturun: alıcıyı VKN/TCKN ile GİB'den sorgulayın; KDV, tevkifat ve "yazıyla" tutarı otomatik hesaplanır.
* Taslakları seçip GİB'e kayıtlı telefonunuza SMS şifresi isteyin. **Fatura yalnız siz SMS şifresini girip "geri alınamaz" onayını verdiğinizde kesilir.**
* Test portalı (earsivportaltest) ile deneyin, hazır olunca canlı portala geçin.

Yönetim menüsü: **AloFatura → Faturalar · Yeni fatura · Ayarlar · Lisans**. Yalnız `manage_options` yetkisi olan yöneticiler görür.

= Ücret ve lisans =

* **Aylık 999 TL. Bir abonelik 1 GİB e-Arşiv kullanıcı kodunu kapsar.** Lisans siteye değil kullanıcı koduna bağlıdır.
* **30 günlük ücretsiz süre**, eklentiyi kurduğunuzda değil, AloFatura ile GİB'de **ilk faturanızı listelediğiniz ya da kestiğiniz gün** başlar. Bağlantıyı sınamak ve GİB test portalında çalışmak süreyi başlatmaz.
* Aynı kullanıcı kodunu başka bir sitede kullanırsanız aynı lisans kalan süresiyle geçerli olur; ücretsiz süre ikinci kez başlamaz.
* Kullanıcı kodunu değiştirirseniz lisans eski koda bağlı kalır; yeni kod için yeni lisans gerekir.
* Süre ya da abonelik dolsa bile faturalarınızı **listelemeye, görüntülemeye ve indirmeye** devam edersiniz. Yalnız yeni taslak oluşturma, alıcı sorgulama ve SMS onayı kapanır. "Devam etmek için öde" düğmesi batuhanfirat.com üzerinden Stripe ödeme sayfasını açar. Ödemeden sonra lisans kendiliğinden açılır; "Lisansı şimdi yenile" ile hemen de açabilirsiniz.

== Installation ==

1. Eklentiyi yükleyip etkinleştirin. PHP 8.1 ya da üstü ile `sodium`, `curl`, `mbstring` ve `json` PHP eklentileri gerekir.
2. **AloFatura → Ayarlar**'dan e-Arşiv Portal kullanıcı kodunuzu ve şifrenizi girin, ortamı seçin (önce *Test portalı*).
3. **AloFatura → Faturalar**'dan faturalarınızı listeleyin.

Güvenlik için önerilir: fatura görüntüleri önbelleği varsayılan olarak `wp-content/uploads/alofatura-veri` dizinindedir (şifreli; her dosya web'den istendiğinde boş yanıt veren bir PHP dosyası olarak yazılır, Apache'de ayrıca `.htaccess` ile kapalı). Daha güvenli olsun isterseniz `wp-config.php` dosyasına web kökü dışında bir dizin yazın:

`define( 'ALOFATURA_VERI_DIZIN', '/home/kullanici/alofatura-veri' );`

== Frequently Asked Questions ==

= AloFatura GİB'in resmî uygulaması mı? =

Hayır. AloFatura resmî bir GİB uygulaması değildir; GİB ile bağlantılı değildir. Sizin e-Arşiv Portal hesabınızla, portalın tarayıcıda yaptığı işlemleri sizin adınıza yapar.

= Fatura yanlışlıkla kesilebilir mi? =

Hayır. Taslak oluşturmak faturayı kesmez. Fatura yalnız GİB'in telefonunuza gönderdiği SMS şifresini girip "geri alınamaz" onay kutusunu işaretlediğinizde kesilir. Kesilen fatura geri alınamaz.

= Ücretsiz süre ne zaman başlar? =

GİB'de ilk faturanızı listelediğiniz ya da kestiğiniz gün başlar ve 30 gün sürer.

= Bir lisansı kaç sitede kullanabilirim? =

Lisans 1 GİB e-Arşiv kullanıcı koduna bağlıdır, siteye değil. Aynı kod hangi sitede kullanılırsa kullanılsın aynı lisans geçerlidir.

= GİB şifrem nerede saklanıyor? =

Yalnız bu sitenin veritabanında, WordPress güvenlik anahtarlarından (wp-config.php) türetilen bir anahtarla şifreli olarak. Şifreniz yalnız GİB'e giriş için kullanılır, başka hiçbir yere gönderilmez. Güvenlik anahtarları değişirse GİB bilgilerinizi yeniden girmeniz gerekir.

= Eklentiyi silersem? =

Devre dışı bırakmak verileri silmez. Eklentiyi **silerseniz** bütün AloFatura kayıtları (GİB bilgileri, lisans kaydı, önbellekler) bu siteden silinir. Faturalarınız GİB'de kalır; lisansınız GİB kullanıcı kodunuza bağlı kalır.

== External services ==

Bu eklenti iki dış hizmete bağlanır.

= 1. GİB e-Arşiv Portalı (Gelir İdaresi Başkanlığı) =

Faturaları listelemek, görüntülemek, indirmek, taslak oluşturmak/silmek, alıcı sorgulamak ve SMS ile onaylamak için eklenti, Ayarlar'da seçtiğiniz portala bağlanır:

* Canlı: https://earsivportal.efatura.gov.tr
* Test: https://earsivportaltest.efatura.gov.tr

Gönderilenler: e-Arşiv Portal kullanıcı kodunuz ve şifreniz (giriş için), oluşturduğunuz faturanın alıcı ve kalem bilgileri, sorguladığınız VKN/TCKN, SMS şifresi. Bağlantı yalnız siz bir işlem yaptığınızda kurulur. Hizmet Gelir İdaresi Başkanlığı'na aittir; kullanım koşulları ve gizlilik için: https://www.gib.gov.tr

= 2. AloFatura lisans sunucusu (batuhanfirat.com) =

Lisans durumunu almak ve doğrulamak için eklenti https://batuhanfirat.com/alofatura/api.php adresine bağlanır:

* Etkinleştirmede (lisans kaydı), günde bir kez (WP-Cron ile doğrulama), "Lisansı şimdi yenile" düğmesinde ve GİB'de ilk başarılı listeleme/kesimden hemen sonra (ücretsiz sürenin başlatılması).
* Gönderilenler: **site alan adı**, **lisans anahtarı**, **eklenti sürümü** ve türü ("wp") ile ücretsiz süre başlatılırken ve doğrulamada **GİB kullanıcı kodunuzun geri döndürülemeyen özeti** (SHA-256). **Kullanıcı kodunuz, şifreniz, faturalarınız ve alıcı bilgileriniz gönderilmez.** Sunucu bu özeti de düz saklamaz; ek bir gizli anahtarla (HMAC) saklar. Her istekte IP adresiniz de doğal olarak sunucuya ulaşır.
* Ödeme: "Devam etmek için öde" düğmesi tarayıcınızda batuhanfirat.com'un ödeme sayfasını açar; ödeme Stripe üzerinden alınır. Eklentinin kendisi Stripe'a bağlanmaz ve kart bilgisi görmez.
* Hizmet sağlayıcı: Batuhan Fırat — https://batuhanfirat.com/alofatura/ · Kişisel veriler: https://batuhanfirat.com/alofatura/#kisisel-veri

== Privacy ==

GİB kullanıcı kodunuz ve şifreniz yalnız bu sitede, şifreli olarak saklanır ve yalnız GİB'e giriş için kullanılır. GİB kullanıcı kodunuz sunucumuza gönderilmez; yalnız geri döndürülemeyen özeti, ek bir gizli anahtarla saklanır. Faturalarınız ve alıcı bilgileriniz sunucumuza gönderilmez.

== Changelog ==

= 1.0.0 =
* İlk sürüm: faturaları listeleme, görüntüleme ve indirme; taslak oluşturma, alıcı sorgulama, SMS ile onay; GİB kullanıcı koduna bağlı lisans (aylık 999 TL, ilk GİB listelemesinde başlayan 30 günlük ücretsiz süre).
