theposeidonas / laravel-kdv-calculator
KDV hesaplamak için oluşturulmuş Laravel Paketi
Requires (Dev)
- orchestra/testbench: ^6.0
- phpunit/phpunit: ^8.0
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)