Laravel için yazılmış KDV Hesaplama paketi.
Dökümantasyon »
Demo
·
Buglar
·
İstekler
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.
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)
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.
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,
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)
Kullanacağınız Controller içerisine paketi dahil etmeniz gerekiyor;
use Theposeidonas\LaravelKdvCalculator\Facades\KDV;
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
Fonksiyon size her zaman bir float şeklinde veri döndürür. Noktadan sonra maksimum 2 basamak geri döner.
20 Mart 2024
- Geri dönüşlerde string olarak dönen veriler float'a çevirildi
20 Mart 2024
- Initial Release
(Başa dön)
MIT Lisansı altında dağıtılmaktadır. Daha fazla bilgi için 'LICENSE' dosyasına bakın.
(Başa dön)
Baran Arda - @theposeidonas - info@baranarda.com
Proje Linki: https://github.com/theposeidonas/laravel-kdv-calculator
(Başa dön)