Self-hosted faturalandırma yazılımı karşılaştırması
Invoice Ninja, InvoiceShelf, InvoicePlane, Kimai ve ERPNext seçeneklerini inceleyin. Yinelenen faturalar, vergi yönetimi, müşteri portalı ve lisans farklarını öğrenin.
Hangi self-hosted faturalandırma yazılımını seçmelisiniz?
Self-hosted faturalandırma yazılımları söz konusu olduğunda tek bir VPS üzerinde kullanılabilecek beş gerçekçi seçenek mevcuttur ve bunlar birbirinin tam alternatifi değildir. Invoice Ninja en eksiksiz üründür: yinelenen faturalar, müşteri portalı, ödeme ağ geçitleri ve e-fatura formatlarının tümü kurulumun yapıldığı gün çalışır durumdadır. InvoiceShelf daha hafif ve tamamen açık kaynaklı bir seçenektir. InvoicePlane, herhangi bir orkestrasyon gerektirmeyen basit bir PHP uygulamasıdır. Kimai, kalem kalem ürün yerine takip edilen saatleri faturalandırır. ERPNext ise fatura da kesebilen tam kapsamlı bir muhasebe sistemidir.
Self-hosted bir faturalandırma kurulumunu, eksik bir özellikten çok daha sık batıran iki sorun vardır. Birincisi e-postadır. Spam klasörüne düşen bir fatura, ödenmemiş bir faturadır ve bunun gerçekleştiğine dair size hiçbir bildirim gelmez. İkincisi ise yedeklemelerdir. Bu, kaybı sadece bir rahatsızlık değil, vergi sorunu haline gelen tek self-hosted veritabanıdır.
Özellik listesini okumadan önce lisansı okuyun. Bu beş yazılımdan üçü copyleft, biri izin verici (permissive), biri ise üzerinde yapabilecekleriniz konusunda gerçek kısıtlamaları olan kaynak-erişilebilir (source-available) lisansa sahiptir.
Beş seçenek ve her birinin hedef kitlesi
Invoice Ninja
Şu anda v5 serisinde olan bir Laravel uygulamasıdır. Self-host kurulumu ücretsizdir ve kısıtlamasızdır: yinelenen faturalar, teklifler, projeler, zaman takibi, giderler, müşteri portalı ve Stripe ile PayPal dahil ödeme ağ geçitleri sunar. Proje kendisini "Laravel ile oluşturulmuş, kaynak kodu erişilebilir bir fatura, teklif, proje ve zaman takibi uygulaması" olarak tanımlar. Self-host kullanıcıları iki kalem için ödeme yapar. İlki markalamadır. Projenin kendi ifadesiyle: "Uygulamanın müşteriyle etkileşimli kısımlarından Invoice Ninja markasını kaldırmak için yıllık 40 USD tutarında bir white-label lisansı sunuyoruz". Bu fiyat Ekim 2026 itibarıyla günceldir. İkincisi ise, Invoice Ninja'nın kendi barındırma platformu üzerinden çalışan ve aşağıda muhasebecinizin talep edeceği konular başlığı altında ele alınan Peppol ağı üzerinden e-fatura gönderip almaktır.
En kapsamlı ürünü istiyorsanız ve en büyük yazılım yığınını çalıştırmayı kabul ediyorsanız bu seçeneği tercih edin.
InvoiceShelf
GNU Affero General Public License sürüm 3 (AGPL-3.0) altında lisanslanmış bir Crater çatallamasıdır (fork). Faturalar, tahminler, yinelenen faturalandırma, giderler, vergiler, çoklu para birimi, müşteri portalı ve çoklu şirket desteği sunar. Ödemeler ve white-label özellikleri, her ikisi de AGPL-3.0 lisanslı ve ücretsiz olan ayrı resmi modül depolarında bulunur. Kartlı ödemeler Stripe checkout üzerinden gerçekleştirilir. Üretim ortamı için desteklenen 2.x sürümünü kullanın: varsayılan 3.x dalı bir alfa önizlemesidir ve mevcut ödemeler modülü bu sürümde çalışmaz.
Küçük, tamamen açık kaynaklı bir uygulama istiyorsanız ve otuz farklı ödeme ağ geçidine ihtiyacınız yoksa bu seçeneği tercih edin.
InvoicePlane
MIT lisansı ile yayınlanan ve dosyaların bir web kök dizinine açılmasıyla kurulan, CodeIgniter tabanlı bir PHP uygulamasıdır. Yayın arşivi için Docker veya Node derleme adımı gerekmez. PDF'ler mPDF üzerinden oluşturulur, bu nedenle şablonlar HTML ve CSS tabanlıdır. Müşteriler, faturayı görüntülemek ve ödemek için bir misafir bağlantısı alır.
Ödemeler geçmişte sorun teşkil ediyordu. InvoicePlane 1.6.0, yalnızca Stripe etkinleştirilmiş ve diğer tüm sağlayıcılar devre dışı bırakılmış şekilde yayınlanmıştı. PayPal, 1.6 serisi içinde geri döndü: 19 Ocak 2026 tarihli 1.6.4 sürümü PayPal Advanced Credit Cards ve Venmo desteği ekledi; 1.6.5, 1.7.1 ve 1.7.2 sürümlerinin tümü Stripe ve PayPal etkinleştirilmiş şekilde gelirken diğer sürücüler devre dışı bırakılmış durumdadır. 28 Ağustos 2026 tarihli güncel 1.7.2 sürümüyle birlikte gelen kurulum kılavuzu, PHP 8.2 veya üzerini (8.3 ve 8.4 desteklenir) ve MariaDB gerektirir; ancak proje wikisinin gereksinimler sayfası hala PHP 8.0 ile 8.1 arasındaki eski aralığı göstermektedir. İndirdiğiniz sürümün notlarını mutlaka okuyun.
Paylaşımlı hosting veya 512 MB RAM'e sahip bir VPS kullanıyorsanız bu seçeneği tercih edin.
Kimai
Zaman çizelgelerinden fatura oluşturan, AGPL-3.0 lisanslı bir zaman takip aracıdır. Saatlik ücretlendirme yapan herkes için doğru çözümdür. Fatura şablonları, belgelerin kabul edilen tek format olduğunu doğruladığı DOCX, ODS veya XLSX dosyaları olarak yüklenir ve PDF veya HTML olarak çıktı alınır. Faturanızı CSS yazmak yerine bir kelime işlemcide tasarlarsınız; çoğu kullanıcı bunu daha kolay bulur.
Kimai'nin yerleşik bir ödeme ağ geçidi yoktur ve mağazasında hiçbir ödeme eklentisi listelenmez, bu nedenle PDF'i e-posta ile gönderirsiniz. Customer Portal adlı ücretsiz bir satıcı eklentisi, müşteri ve proje istatistiklerini ve zaman çizelgelerini, isteğe bağlı olarak parola korumalı gizli bir URL üzerinden paylaşır ancak bu eklenti faturaları değil, zaman çizelgelerini gösterir. Yapılandırılmış e-fatura özelliği, Ekim 2026 itibarıyla yıllık KDV hariç 99 EUR olarak listelenen E-Invoice Plus adlı ücretli bir mağaza eklentisidir. Bu eklenti, CII veya UBL formatında EN16931, Extended ve XRechnung 3.0 profillerini, beta aşamasındaki Peppol UBL'i ve ZUGFeRD ile Factur-X hibrit PDF'lerini kapsar.
Faturanız, takip edilen sürenin bir çıktısıysa bu seçeneği tercih edin.
ERPNext
GPL-3.0 lisanslıdır ve farklı bir yazılım kategorisindedir. Satış faturası; hesap planı, yevmiye kayıtları, stok ve bordro içeren tam kapsamlı bir muhasebe sistemindeki belge türlerinden yalnızca biridir. Faturalandırma işin tamamı olmaktan çıktığında doğru cevap budur. Sekiz müşterisi olan tek bir serbest çalışan için bu yazılım çok fazla karmaşıklık içerir. Kurulumu başlı başına bir projedir ve VPS üzerinde ERPNext çalıştırma bölümünde ele alınmıştır.
Yinelenen faturalar görünmeyen bir zamanlayıcıya bağlıdır
Invoice Ninja, InvoiceShelf, InvoicePlane ve ERPNext uygulamalarının tümü yinelenen faturalar oluşturabilir. Kimai'nin çekirdek özelliklerinde yinelenen fatura özelliği bulunmaz; çünkü Kimai'de fatura, belirli bir dönemdeki zaman çizelgesi girişlerinden oluşturulur.
Hata durumu, Laravel tabanlı tüm uygulamalarda aynıdır ve sessizce gerçekleşir. Yinelenen faturalar, her dakika tetiklenmesi gereken Laravel zamanlayıcısı tarafından oluşturulur. Bu tetikleme, cron aracılığıyla php artisan schedule:run çağrılarak veya uzun süre çalışan bir php artisan schedule:work süreci ile sağlanır. Eğer tetikleyici çalışmıyorsa, yinelenen fatura listesinde bir sonraki gönderim tarihi görünmeye devam eder ve bu tarih geçip gider. Hiçbir fatura oluşmaz. Kod çalışmadığı için herhangi bir hata günlüğü de tutulmaz.
Bu nedenle, ilk yinelenen faturanızı oluşturduktan sonra bir sonraki gönderim tarihini birkaç dakika sonrasına ayarlayın ve bekleyin. Eğer fatura ulaşmazsa, zamanlayıcı çalışmıyor demektir. Docker kurulumlarında bu durum genellikle zamanlayıcı servisinin veya sürecinin hiç başlamadığı ya da kapandığı anlamına gelir. Mevcut Invoice Ninja ve InvoiceShelf imajlarında zamanlayıcı, ayrı bir servis yerine uygulama container'ı içinde çalışır; bu nedenle incelenmesi gereken günlükler o container'a aittir.
docker compose ps
docker compose logs --tail 50Dosyadaki her servis running durumunu bildirmelidir. exited durumunda bekleyen bir servis, günlüklerini okumanız gereken servistir.
Çoklu para birimi ve vergi: onaylamadan önce kontrol edilmesi gerekenler
Özellik listelerinde geçen "çoklu para birimi" ifadesi, her yazılım için farklı anlamlar taşıyabilir. Kendi işletmenizden gerçek rakamları kullanarak bir demo kurulumu üzerinde şu dört kontrolü gerçekleştirin; çünkü bu konudaki bir hata, sizin tarafınızdan değil muhasebeciniz tarafından fark edilecektir.
- Fatura, düzenlendiği tarihteki döviz kurunu saklıyor mu? Saklamalıdır. Uygulama toplamları canlı kur üzerinden yeniden hesaplıyorsa, geçen çeyreğe ait raporlar her açılışta değişir ve kayıtlarınız daha önce beyan ettiklerinizle uyumsuz hale gelir.
- Vergi kalem bazında mı, fatura bazında mı yoksa her ikisinde birden mi uygulanıyor? Tek bir fatura seviyesinde vergi oranı, bir kalem vergi dışı bırakılana kadar yeterlidir.
- Fiyatları vergi dahil ve vergi hariç olarak girebiliyor musunuz? Sonradan dönüştürme yapmak, kalem başına bir kuruşluk yuvarlama farklarına yol açar ve bu kuruşlar bir yıl boyunca birikerek büyür.
- KDV borcu olmayan başka bir ülkedeki müşteri için belge ne gösteriyor? Fatura üzerinde sadece vergi sütununda bir sıfır değil, muafiyet notunun yazılı olması gerekir.
Invoice Ninja ve ERPNext bu dört maddeyi de karşılar. InvoiceShelf, vergileri ve çoklu para birimini özellikleri arasında listeler. InvoicePlane ve Kimai daha basit yapıda olduklarından, bu yazılımları en kolay faturanızla değil, en karmaşık faturanızla test edin.
Müşteri portalı ve ödeme ağ geçitleri
Müşteri portalı, müşterinin faturalarını görüntülediği, PDF dosyalarını indirdiği ve ödeme yaptığı bir sayfadır. Bu, kulağa geldiğinden daha önemlidir; çünkü e-posta yoluyla ödeme kovalamak, faturayı oluşturmaktan daha fazla zamanınızı alır.
Invoice Ninja, tam teşekküllü bir portal, çok sayıda ağ geçidi, kayıtlı ödeme yöntemleri ve yinelenen faturalarda otomatik faturalandırma özellikleri ile bu konuda en güçlü seçenektir. InvoiceShelf bir müşteri portalına sahiptir ve ödeme modülü aracılığıyla Stripe checkout desteği ekler. InvoicePlane her faturaya bir misafir bağlantısı sağlar ve Stripe ile PayPal desteği sunar; PayPal desteği 1.6.4 sürümüyle geri dönmüştür. Kimai'de ödeme ağ geçidi bulunmamaktadır ve ücretsiz Customer Portal eklentisi faturalar yerine zaman çizelgelerini ve istatistikleri paylaşır, bu nedenle PDF dosyası ek olarak gönderilir.
Sürekli karıştırılan bir nokta vardır. Faturalandırma uygulamasını kendi sunucunuzda barındırmak, kart numaralarını tuttuğunuz anlamına gelmez. Stripe checkout kullanıldığında müşteri Stripe sayfasına yönlendirilir, kart bilgilerini oraya girer ve VPS sunucunuz bu numarayı hiçbir zaman görmez. Ödeme formunu siz oluşturmadığınız için PCI (ödeme kartı endüstrisi) kapsamınız tam olarak bu sayede küçük kalır. İleride birden fazla işlemciye ihtiyaç duyarsanız veya ödemeleri ülkeye göre yönlendirmek isterseniz, bu konu Hyperswitch ile kendi sunucunuzda ödeme orkestrasyonu gibi ayrı bir katmanın kapsamına girer.
PDF kalitesi ve düzenleyeceğiniz şablon
Şablonu siz düzenleyeceksiniz. Buradaki varsayılan ayarlar, adresinizi ülkenize göre yanlış yere yerleştirir.
Invoice Ninja, HTML ve CSS şablonlarını PDF'e dönüştürmek için imajın içine gömülü (arm64 üzerinde Chromium) başsız bir Chrome kullanır; bu nedenle container boyutu büyüktür. Bunun için bellek ayırın: Başsız tarayıcı, yığındaki en ağır süreçtir, bu yüzden 1 GB RAM'li bir VPS oldukça kısıtlı kalacaktır. InvoicePlane, tamamen PHP tabanlı ve hafif olan mPDF kullanır, ancak bunun bedeli bazı modern CSS özelliklerini görmezden gelmesidir. Kimai ise tam tersi bir yaklaşım benimser ve DOCX veya ODS dosyası yüklemenizi sağlar; böylece düzen, stil sayfası yazmamış biri tarafından LibreOffice veya Word üzerinde yapılır.
Eğer tasarlanmış bir fatura sizin için önemliyse ve CSS ile uğraşmak istemiyorsanız, Kimai'nin yaklaşımı daha avantajlıdır. Eğer şablonun sürüm kontrolünde olmasını ve farklarının (diff) izlenebilmesini istiyorsanız, HTML yaklaşımı daha uygundur.
Lisans ticari kullanıma izin veriyor mu?
Beş yazılımın tamamı kendi müşterilerinize fatura kesmenize olanak tanır. Farklılıklar, bunun ötesinde bir işlem yaptığınızda ortaya çıkar.
Invoice Ninja, Elastic License 2.0 altındadır. İki madde önem taşır.
Yazılımı, kullanıcılara yazılımın özelliklerinin veya işlevlerinin önemli bir kısmına erişim sağlayan barındırılan veya yönetilen bir hizmet olarak üçüncü taraflara sunamazsınız.
Yazılımdaki lisans anahtarı işlevini taşıyamaz, değiştiremez, devre dışı bırakamaz veya atlatamazsınız.
Dolayısıyla, yazılımı kendi işiniz için çalıştırmanızda bir sakınca yoktur, ancak müşteriler için bir ürün olarak örnekler (instance) çalıştırmanız yasaktır. İkinci madde, marka işaretlerini kaldırmanın kaynak kod üzerinde bir yama yapmak yerine neden 40 USD tutarında bir lisans gerektirdiğinin nedenidir.
InvoiceShelf, Kimai ve Crater, AGPL-3.0 lisansına sahiptir. Üçü için de ticari kullanım ücretsizdir. Kimai mağazası, ücretsiz kurulumda bulunmayan E-Invoice Plus, özel alanlar ve gider yönetimi gibi özellikler için yıllık 99 EUR bedelle ücretli eklentiler satmaktadır. Eklenti abonelikleri kalıcı bir yedek lisans içerir: satın alınan sürümler abonelik iptalinden sonra çalışmaya devam eder, ancak güncellemeler aktif bir abonelik gerektirir. Lisans yükümlülüğü 13. bölümdedir: kodu değiştirirseniz ve başkalarının değiştirdiğiniz sürümü bir ağ üzerinden kullanmasına izin verirseniz, yaptığınız değişikliklerin kaynak kodunu onlara sunmanız gerekir. Değiştirilmemiş bir örnek zaten geliştiricinin herkese açık kaynak kodu kapsamındadır, bu nedenle çoğu self-host kullanıcısı bu durumla karşılaşmaz.
InvoicePlane, gruptaki en hafif yükümlülüğe sahip olan MIT lisanslıdır; ancak README dosyası, isim ve logonun projeye ait kaldığını belirtir.
ERPNext, GPL-3.0 lisanslıdır. Dağıttığınız değişikliklerin paylaşılması gerekir; özel olarak çalıştırmanın ise herhangi bir yükümlülüğü yoktur.
Bu metin, lisans metninin bir açıklamasıdır ve hukuki tavsiye niteliği taşımaz.
Proje hala güncel mi? Commit günlüğünü kontrol edin
Crater, birkaç yıl boyunca popüler bir açık kaynak faturalandırma uygulamasıydı ve birçok rehber hala bu uygulamayı önermektedir. 10 Ekim 2026 tarihi itibarıyla, varsayılan dalında 19 Şubat 2023'ten bu yana 1329 gündür herhangi bir commit yapılmamıştır.
Bu grafiğin arkasındaki veriler
[
{
"label": "ERPNext",
"commit_gap": 0
},
{
"label": "InvoicePlane",
"commit_gap": 0
},
{
"label": "Kimai",
"commit_gap": 4
},
{
"label": "InvoiceShelf",
"commit_gap": 11
},
{
"label": "Invoice Ninja",
"commit_gap": 22
},
{
"label": "Crater",
"commit_gap": 1329
}
]Bu bloktaki 6 projeden beşi, söz konusu kontrolden önceki dört hafta içinde, üçü ise önceki hafta içinde commit almıştır. InvoiceShelf, Crater'ın çalışmalarını aynı AGPL-3.0 lisansı ve aynı veri modeliyle devam ettiren çatallanmış (fork) projedir; bu nedenle geçiş yapmak, yeniden yazmaktan ziyade bir veri taşıma işlemidir. Crater'ı değil, InvoiceShelf'i kurun.
Her birinin bir VPS üzerinde kurulumu
InvoicePlane dışındaki her şey Docker Compose altında en kolay şekilde çalışır. Eğer bu sizin için yeniyse, bir VPS üzerinde ilk Docker Compose yığını ile başlayın ve buraya geri dönün.
Invoice Ninja kendi compose deposunu sunar. Mevcut talimatlar debian dalını kullanır ve compose dosyası aynı isimli bir alt dizin içerisindedir.
git clone https://github.com/invoiceninja/dockerfiles.git -b debian
cd dockerfiles/debian
docker run --rm -it invoiceninja/invoiceninja-debian php artisan key:generate --showÇıktının tamamını o dizindeki .env dosyasının içindeki APP_KEY kısmına, gerçek APP_URL değerlerinizle birlikte kopyalayın. İlk hesabınız için IN_USER_EMAIL ve IN_PASSWORD değerlerini de ayarlayın; çünkü bunları boş bırakırsanız giriş bilgileri varsayılan olarak admin@example.com kullanıcı adı ve changeme! şifresi olur. Ardından başlatın.
docker compose up -dPaketle birlikte gelen nginx servisi 80 numaralı portu ana makine üzerinde yayınlar; bu yüzden TLS proxy'nizi önüne yerleştirin veya bu eşlemeyi değiştirin. Kurulum sihirbazında, compose ağı üzerindeki servis adı olduğu için veritabanı sunucusu olarak mysql değerini girin. Oradaki localhost, doğrudan uygulama container'ını işaret eder.
InvoiceShelf, veritabanı motoru başına bir tane olacak şekilde hazır compose dosyaları sunar.
curl -fLO https://raw.githubusercontent.com/InvoiceShelf/docker/master/docker-compose.mysql.yml
mv docker-compose.mysql.yml docker-compose.ymlBaşlatmadan önce o dosyayı açın. İçindeki her şifre bir yer tutucudur ve dosya kendi yorum satırlarında bunu belirtir. APP_URL, SESSION_DOMAIN ve SANCTUM_STATEFUL_DOMAINS değerlerinin tamamı varsayılan olarak localhost şeklindedir ve her üçü de ilk girişten önce gerçek ana makine adınızla ayarlanmalıdır. Ardından ayağa kaldırın.
docker compose up -dAna makine üzerinde 8090 numaralı portu yayınlar ve container içerisinde 8080 üzerinden hizmet verir. Tek bir istemciyi bile yönlendirmeden önce önüne TLS (transport layer security) destekli bir reverse proxy yerleştirin.
Kimai üretim compose dosyası, proje dokümantasyonundan
services:
sqldb:
image: mysql:8.3
volumes:
- mysql:/var/lib/mysql
environment:
- MYSQL_DATABASE=kimai
- MYSQL_USER=kimaiuser
- MYSQL_PASSWORD=kimaipassword
- MYSQL_ROOT_PASSWORD=changemeplease
command: --default-storage-engine innodb
restart: unless-stopped
healthcheck:
test: mysqladmin -uroot -p$$MYSQL_ROOT_PASSWORD ping -h 127.0.0.1 --silent
interval: 10s
timeout: 5s
retries: 12
start_period: 30s
kimai:
image: kimai/kimai2:stable
depends_on:
sqldb:
condition: service_healthy
restart: true
volumes:
- data:/opt/kimai/var/data
- plugins:/opt/kimai/var/plugins
ports:
- 8001:8001
environment:
- APP_SECRET=your-fantastic-long-random-and-ultra-secure-secret
- TRUSTED_HOSTS=kimai.example.com
- ADMINMAIL=admin@example.com
- ADMINPASS=changemeplease
- DATABASE_URL=mysql://kimaiuser:kimaipassword@sqldb/kimai?charset=utf8mb4&serverVersion=8.3.0
restart: unless-stopped
volumes:
data:
mysql:
plugins:APP_SECRET değerini kendi oluşturduğunuz uzun ve rastgele bir diziyle, TRUSTED_HOSTS değerini ise gerçekten kullanacağınız alan adıyla değiştirin. ADMINMAIL ve ADMINPASS ilk açılışta ilk yöneticiyi oluşturur; bu yüzden arayüz üzerinden şifreyi daha sonra değiştirin ve dosyadan kaldırın.
InvoicePlane, geliştirme ve test için Docker kurulumları içerir. Arşiv kurulumu için önce boş bir veritabanı oluşturun.
sudo mysql -e "CREATE DATABASE invoiceplane CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;"Arşivi projenin sürümler sayfasından indirin, web kök dizininize çıkartın, ipconfig.php.example dosyasını ipconfig.php olarak kopyalayın ve dosya içindeki yorumları takip ederek URL'nizi ayarlayın. Ardından https://your-domain.example/index.php/setup dosyasını açın ve kurulum adımlarını tamamlayın.
Faturanız neden spam klasörüne düşer
Bu hata size para kaybettirir ve uygulama faturayı gönderilmiş olarak gösterebilir.
Fatura e-postalarını VPS'in kendi IP adresinden göndermeyin. Yeni bir VPS IP adresinin gönderim geçmişi yoktur. Büyük alıcılar, barındırma aralığındaki bilinmeyen bir adresten gelen ilk iletiyi varsayılan olarak şüpheli kabul eder. Bunun yerine, kimlik doğrulaması yaptığınız bir alan adında çalışan bir SMTP (simple mail transfer protocol) relay üzerinden gönderim yapın. Bu işlemin uçtan uca yapılandırılması ayrı bir rehber konusudur. self-hosted bir uygulamadan güvenilir e-posta gönderme başlıklı içerikte relay, DNS kayıtları ve test işlemleri ele alınır.
Faturalama yapılandırmalarında en sık hata From adresinde yapılır. Bu adres, relay'inizi yetkilendiren bir alan adında bulunmalıdır. Bunu garanti etmenin en kolay yolu, kontrol ettiğiniz ve relay'in DKIM (domainkeys identified mail) ile imzaladığı bir alan adı kullanmaktır. İstemcinin kendi adresini From alanına yazmak kibar görünür, ancak genellikle teslimatı bozar. Gmail'in gönderen yönergelerine göre bir ileti, yalnızca SPF veya DKIM doğrulamasından geçerse ve kimlik doğrulanan alan adı From başlığındaki alan adıyla uyumluysa DMARC doğrulamasından geçer. Relay'iniz istemcinizin alan adını değil, sizin alan adınızı doğrular. Bu durum yalnızca istemci tarafında düzeltilebilir. İstemcinin kendi SPF kaydına relay'inizi eklemesi veya alan adı için relay üzerinden DKIM imzalama yapılandırması gerekir. Google, bir sağlayıcı üzerinden gönderim yapan herkes için bunu ister: "Bir e-posta hizmet sağlayıcısı kullanıyorsanız alan adınızdaki e-postaların SPF ve DKIM ile kimlik doğrulamasından geçtiğini doğrulayın." İstemci bunu yapmadığı sürece ileti DMARC doğrulamasından geçemez. Gmail, kimlik doğrulanmamış iletilerin "spam olarak işaretlenebileceğini veya 5.7.26 hatasıyla reddedilebileceğini" belirtir. Bu tür bir ret aşağıdaki gibi görünür:
550 5.7.26 Unauthenticated email from example.com is not accepted due to domain's DMARC policyFrom alanında kendi adresinizi kullanın ve istemciyi Reply-To alanına yazın. Gerçek gönderim yapmadan önce yayımladığınız kayıtları kontrol edin.
dig +short TXT example.com
dig +short TXT _dmarc.example.com
dig +short TXT selector1._domainkey.example.comİlk komut, relay'inizi belirten bir SPF (sender policy framework) kaydı döndürmelidir. İkinci komut, bir DMARC (domain-based message authentication, reporting and conformance) politikası döndürmelidir. Üçüncü komutun sonucu, relay'in size verdiği selector değerine bağlıdır. Boş yanıt, DKIM kaydının eksik olduğunu veya yanlış ad altında yayımlandığını gösterir. Bu durumda gönderdiğiniz her ileti imza denetiminden geçemez.
Ardından gerçek bir faturayı büyük bir sağlayıcıdaki sahibi olduğunuz bir hesaba gönderin ve ham başlıkları okuyun. Authentication-Results başlığındaki dkim=pass ve spf=pass, dikkate alınması gereken tek kanıttır. Uygulamanın kendi "sent" işareti yalnızca iletinin relay'e teslim edildiğini gösterir.
Yedeklemeler: kaybetmeyi göze alamayacağınız tek veritabanı
Bir medya sunucusunu kaybetmek, dosyaları yeniden indirmek anlamına gelir. PhotoPrism veya Immich gibi self-hosted bir fotoğraf sunucusu dahi, genellikle orijinal dosyaların çekildiği telefonda hala var olan ikinci bir kopyasını tutar. Faturalandırma veritabanınızı kaybetmek ise neyi faturalandırdığınızı, ne kadar ödeme aldığınızı veya ne kadar alacağınızın kaldığını gösteremeyeceğiniz anlamına gelir. Buna göre hareket edin.
Dört şeyi yedekleyin. Veritabanı. Logoları, oluşturulan PDF'leri ve gider makbuzlarını tutan depolama birimi. Uygulamanın environment dosyası. Ve normal dosyalar olarak saklanan oluşturulmuş PDF'ler; çünkü bir PDF, onu üreten uygulama olmasa bile on yıl sonra açılabilir.
Environment dosyası, insanların beklediğinden daha önemlidir. Laravel, ödeme geçidi kimlik bilgileri de dahil olmak üzere hassas saklanan değerleri, o dosyadaki APP_KEY kullanarak şifreler. Veritabanını yeni oluşturulmuş bir anahtarın yanına geri yüklerseniz, bu değerlerin şifresi çözülmez. Faturalarınızın tamamı mevcuttur ancak geçit ayarlarınız okunamaz haldedir.
InvoiceShelf yığınından alınan bir döküm şu şekilde görünür. Veritabanı servisi mariadb:10 üzerinde çalışır, bu nedenle container içindeki araç mariadb-dump'tür.
docker compose exec -T database mariadb-dump \
--user=root --password=YOUR_ROOT_PASSWORD \
--single-transaction --databases invoiceshelf > invoiceshelf.sql--single-transaction, InnoDB tablolarının tutarlı bir anlık görüntüsünü onları kilitlemeden alır, böylece döküm çalışırken uygulama hizmet vermeye devam eder. -T, Docker'ın bir terminal ayırmasını engeller; aksi takdirde bu durum yönlendirilen çıktıyı bozar ve içe aktarılamayacak bir döküm dosyasına neden olur.
Bunu şifreli restic yedeklemeleri ile sunucu dışı depolama alanına düzenli olarak gönderin ve saklama süresini muhasebecinizin belirttiği dönemi kapsayacak kadar uzun tutun.
Ardından geri yükleyin. Dökümü geçici bir container içinde ayağa kaldırın, giriş yapın ve geçen ayın faturasını açın. Bunu bir kez yapana kadar, yedeğin çalışıp çalışmadığını bilemezsiniz.
Muhasebecinizin talep edeceği bilgiler
Bu rehberden vergi tavsiyesi almayın. Aşağıdaki liste, bu yazılımın üretebildiği verileri içerir; bu listeyi danışmanınızla paylaşabilirsiniz.
Dışa aktarılabilir veriler. Faturalarınızı ve ödemelerinizi, bir veritabanı istemcisine ihtiyaç duymadan veya destek talebi açmadan, arayüz üzerinden CSV formatında dışa aktarabilmelisiniz. SQL dökümü bir yedeklemedir, dışa aktarma değildir; çünkü muhasebeciniz bunu açamaz.
Değiştirilemez numaralandırma. Fatura numaraları sıralı ilerlemeli, asla yeniden kullanılmamalı ve aralarında boşluk olmamalıdır. Bir faturayı silmek, açıklanması gereken bir boşluk yaratır. Bunun yerine iptal veya alacak dekontu işlemlerini kullanın; bu rehberdeki tüm uygulamalar bunu destekler. Boşluksuz numaralandırma zorunluluğu kayıtlı olduğunuz bölgeye göre değişir, bunu erkenden sormanızda fayda vardır.
Saklama. Veritabanı dökümlerini ve oluşturulan PDF dosyalarını, yerel mevzuatınızın gerektirdiği süre boyunca saklayın. Fatura itiraz durumunda esas alınacak belge, karşı tarafa gönderilen PDF dosyasıdır.
Değişiklik geçmişi. Bir faturayı kimin ve ne zaman düzenlediğini görebilmek önemlidir; bu özellik uygulamalar arasında farklılık gösterir. Invoice Ninja, kayıt bazlı bir etkinlik günlüğü tutar.
Yapılandırılmış e-fatura, AB'nin bazı bölgelerinde artık isteğe bağlı bir özellik değil, gerçek bir zorunluluk haline gelmiştir. Invoice Ninja; ZUGFeRD, XRechnung, Facturae, FatturaPA ve genel EN16931 dahil olmak üzere yaygın formatları üretir. Ancak dokümantasyonu, İtalya'nın SDI sistemine bağlantı canlı olmadığı için FatturaPA özelliğinin üretime hazır olmadığını belirtir. Self-hosted bir kurulumdan Peppol ağı üzerinden gönderim, Invoice Ninja'nın barındırılan platformu aracılığıyla gerçekleşir. Satıcının dokümantasyonuna göre, kurumunuzu Invoice Ninja'ya kaydedersiniz, sistem sizin için bir tüzel kişilik kimliği oluşturur, kurulumunuz e-faturaları kendi servisi üzerinden proxy eder ve gelen e-faturalar sunucuları dört saatte bir sorgulayan bir cron işiyle ulaşır. Invoice Ninja'nın e-fatura sayfası, Peppol erişimini aylık 18 dolardan başlayan ve 250 Peppol kredisi içeren Enterprise planının bir parçası olarak satar; her e-fatura gönderimi bir kredi tüketir. 15 Kasım 2026 itibarıyla, self-hosted kurulumlarda ücretsiz kredi bulunmaz ve aynı paketlerin satın alınması gerekir. Kimai'nin ücretli E-Invoice Plus eklentisi EN16931, XRechnung, ZUGFeRD, Factur-X ve beta aşamasındaki Peppol formatlarını kapsar ancak Facturae veya FatturaPA desteği sunmaz. InvoicePlane bir e-fatura kancasına sahiptir ancak çekirdek sürümünde hiçbir formatla gelmez: ZUGFeRD, Factur-X ve UBL örneklerini içeren InvoicePlane-e-invoices deposundan şablonlar eklemeniz gerekir. ERPNext, ALYF tarafından sunulan ücretsiz GPL-3.0 lisanslı eu_einvoice uygulaması ile XRechnung, ZUGFeRD ve Factur-X formatlarını destekler; ancak yalnızca CII formatındadır, UBL veya Peppol desteği yoktur. InvoiceShelf, 3.x alpha önizlemesi için ücretsiz resmi E-Invoicing modülü aracılığıyla EN16931 ZUGFeRD / Factur-X hibrit PDF'leri sunmaktadır; proje, üretim ortamındaki kullanıcıları hala 2.x sürümüne yönlendirmektedir. Invoice Ninja, tüm bu özellikleri yerleşik olarak sunan tek uygulamadır; AB içinde fatura kesiyorsanız bu uygulamayı seçmeniz için en güçlü neden budur.
FAQ
Crater mı yoksa InvoiceShelf mi kurmalıyım?
InvoiceShelf. Crater'ın varsayılan dalına 10 Ekim 2026 itibarıyla 1329 gündür hiçbir commit gönderilmemiştir ve InvoiceShelf'in kendi taşıma kılavuzu, projeyi "artık terk edilmiş Crater projesi" olarak tanımlamaktadır. InvoiceShelf, aynı AGPL-3.0 lisansına ve aynı veri modeline sahiptir; bu nedenle aralarındaki geçiş, yeniden yazım gerektirmeyen bir veritabanı taşıma işlemidir. Crater'ı hala öneren tüm kılavuzlar, proje sessizliğe bürünmeden önce yazılmıştır.
Invoice Ninja'yı kendi işim için ücret ödemeden kullanabilir miyim?
Evet. Self-hosted Invoice Ninja, Elastic License 2.0 kapsamında yinelenen faturalar, müşteri portalı ve ödeme ağ geçitleri dahil olmak üzere hiçbir ücret ödemeden tam işlevsellikle kullanılabilir. İki özellik ekstradır. Müşteriye dönük sayfalardan Invoice Ninja markasını kaldırmak için, projenin Ekim 2026 itibarıyla kendi ifadesiyle "yıllık 40 dolar" olan white-label lisansı gerekir. Peppol ağı üzerinden e-fatura gönderip almak, Invoice Ninja'nın barındırılan platformu üzerinden yürütülür. 15 Kasım 2026 itibarıyla, self-hosted kurulumlar Peppol kredisi satın alır ve pakete dahil kredi bulunmaz: 500 kredi için 50 dolar veya 1.000 kredi için 100 dolar; krediler bir yıl geçerlidir. Gönderilen her e-fatura bir kredi tüketir. Lisansın yasakladığı husus, yazılımı başkaları için barındırılan bir servis olarak çalıştırmaktır.
Fatura e-postalarım neden spam klasörüne düşüyor?
Neredeyse her zaman, mesajın From adresindeki alan adı için kimlik doğrulaması yapılmadığından kaynaklanır. E-postaları doğrudan VPS üzerinden değil, bir SMTP aktarıcısı (relay) üzerinden gönderin; ardından alan adınız için SPF ve DMARC kayıtlarını yayınlayın ve aktarıcınızın size verdiği seçici (selector) altında DKIM kaydını ekleyin. From kısmında kendi adresinizi tutun ve müşteriyi Reply-To kısmına yerleştirin. Müşterinin adresini gönderen olarak ayarlamak, müşterinin sizin aktarıcınızı kendi SPF kaydına eklemediği veya alan adı için bu aktarıcı üzerinden DKIM imzalamayı yapılandırmadığı sürece mesajın DMARC kontrolünden geçememesine neden olur; Gmail bu durumda mesajı spam olarak işaretleyebilir veya 550 5.7.26 Unauthenticated email from example.com is not accepted due to domain's DMARC policy gibi bir hata ile reddedebilir. Çözümü doğrulamak için bir test mesajının Authentication-Results başlığında dkim=pass ve spf=pass ifadelerini bulun.
Saatlik ücretlendirme yapıyorsam hangisini seçmeliyim?
Kimai. Öncelikle bir zaman takip aracıdır, bu nedenle fatura onaylanmış zaman çizelgesi girişlerinden oluşturulur ve kalemler kaydettiğiniz işlerden oluşur. Şablonlar, bir kelime işlemcide tasarladığınız DOCX, ODS veya XLSX dosyalarıdır; bu, CSS düzenlemekten daha kolaydır. Bunun karşılığında Kimai çevrimiçi ödeme almaz. Ücretsiz Customer Portal eklentisi, zaman çizelgelerini ve proje istatistiklerini gizli bir bağlantı üzerinden paylaşır ancak faturaları paylaşmaz; bu nedenle PDF'i e-posta ile gönderip ödemeyi havale ile alırsınız. Invoice Ninja da zaman takibi yapar ve kartlı ödeme içeren tam bir fatura portalına sahiptir; bu nedenle çevrimiçi kartlı ödeme sizin için zaman çizelgesi detayından daha önemliyse onu seçin.
Tam olarak neleri yedeklemem gerekiyor?
Veritabanı, logoları ve oluşturulan PDF'leri tutan depolama birimi, environment dosyası ve düz dosyalar olarak saklanan oluşturulmuş PDF'ler. Environment dosyası, insanların gözden kaçırdığı dosyadır: Invoice Ninja ve InvoiceShelf gibi Laravel uygulamaları, saklanan kimlik bilgilerini APP_KEY ile şifreler; bu nedenle yeni oluşturulmuş bir anahtarın yanında geri yüklenen veritabanı, ödeme ağ geçidi ayarlarınızı okunamaz hale getirir. Her şeyi bir kez geçici bir instance üzerinde geri yükleyin ve eski bir faturayı açın; çünkü yedeğin çalıştığını bilmenin tek yolu budur.