README

KDV Calculator Laravel Package

Laravel için yazılmış KDV Hesaplama paketi.
Dökümantasyon »

Demo · Buglar · İstekler

Laravel KDV Hesaplayıcı

Bu proje, Laravel için oluşturulmuş kolayca KDV hesaplamanızı sağlayacak bir paket. KDV oranını otomatik olarak .env dosyasından çekebilir veya kendiniz atayabilirsiniz.

Neden ihtiyaç var?

Kabul edelim, hiçbir developer tek seferde KDV'yi doğru hesaplayamaz. Bu paketi yazarken bile her yerden ayrı ayrı bakıp acaba doğru hesaplıyor mu diye kontrol etmek zorunda kaldım. Çok kolay olduğunu düşünüyor olabilirsiniz, fakat değil. Örneğin KDV %20 ise, 100₺ olan bir ürünün KDV'si 20₺'dir değil mi? Değil işte, 16,67₺...

Bug ve Hataları lütfen Issues kısmından bildirin. (Olabilir bu arada, bir şey yazdım ama doğru hesaplıyor mu diye hala kontrol ediyorum)

(Başa dön)

Başlarken

KDV oranının güncel olduğunu kontrol edin. Bu paket default olarak %20 oranla hesaplama yapıyor. PHP^8.0 kullanmanızı öneririm.

Projenize ekleme

Laravel projenizde terminali açarak şu komutu çalıştırın;

composer require theposeidonas/laravel-kdv-calculator

Eğer gerekiyorsa config dosyasını paylaşmak için şu komutu çalıştırın;

php artisan vendor:publish --tag=kdv-calculator-config --force

Eğer Laravel versiyonunuz eskiyse veya Auto-Discovery kapalıysa, her yerde kullanmak için config/app.php dosyasında 'aliases' kısmına şu kodu ekleyin;

'KDV' => Theposeidonas\LaravelKdvCalculator\Facades\KDV::class,

Konfigürasyon

Kullanım için projenize eklemeyi yaptıktan sonra, .env dosyası içerisinde KDV oranını düzenleyebilirsiniz.

KDV_PERCENTAGE='20'  // %20 oran için 20 girmeniz gerekir

(Başa dön)

Kullanım

Kullanacağınız Controller içerisine paketi dahil etmeniz gerekiyor;

use Theposeidonas\LaravelKdvCalculator\Facades\KDV;

Fonksiyonlar

Kullanabileceğiniz 2 farklı fonksiyon mevcuttur. Toplam tutar verip KDV ve Net tutarı geri alabilirsiniz (KDV dahil tutardan hesaplama yapma) veya NET tutar verip KDV dahil tutarı hesaplayabilirsiniz.

$result = KDV::calculate(100); // Toplam tutardan hesaplama
echo $result['total']; // (float) 100.00
echo $result['net']; // (float) 83.33
echo $result['kdv']; // (float) 16.67

$result = KDV::calculateNet(83.33); // Net tutardan hesaplama
echo $result['total']; // (float) 100.00
echo $result['net']; // (float) 83.33
echo $result['kdv']; // (float) 16.67

Notlar

Fonksiyon size her zaman bir float şeklinde veri döndürür. Noktadan sonra maksimum 2 basamak geri döner.

Changelog

V1.0.1

20 Mart 2024

• Geri dönüşlerde string olarak dönen veriler float'a çevirildi

V1.0.0

20 Mart 2024

• Initial Release

(Başa dön)

Lisanslama

MIT Lisansı altında dağıtılmaktadır. Daha fazla bilgi için 'LICENSE' dosyasına bakın.

(Başa dön)

İletişim

Baran Arda - @theposeidonas - info@baranarda.com

Proje Linki: https://github.com/theposeidonas/laravel-kdv-calculator

(Başa dön)