PHPackages profscode/nilvera - PHPackages - PHPackages [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register) 1. [Directory](/) 2. / 3. [API Development](/categories/api) 4. / 5. profscode/nilvera ActiveLibrary[API Development](/categories/api) profscode/nilvera ================= Laravel package for Nilvera E-Fatura and E-Arşiv integration. v1.0.8(1mo ago)014MITPHPPHP ^8.2 Since May 15Pushed 2mo agoCompare [ Source](https://github.com/YamanHafez/profscode-nilvera)[ Packagist](https://packagist.org/packages/profscode/nilvera)[ RSS](/packages/profscode-nilvera/feed)WikiDiscussions main Synced 3w ago READMEChangelogDependencies (4)Versions (10)Used By (0) ProfsCode Nilvera Laravel Paketi Kullanım Kılavuzu ================================================== [](#profscode-nilvera-laravel-paketi-kullanım-kılavuzu) Bu paket, Nilvera API'si ile E-Fatura, E-Arşiv ve E-İrsaliye süreçlerinizi Laravel üzerinde kolayca yönetmenizi sağlar. 1. Genel ve Dashboard İşlemleri ------------------------------- [](#1-genel-ve-dashboard-i̇şlemleri) Dashboard için özet verileri ve kredi durumlarını takip edebilirsiniz. ``` use ProfsCode\Nilvera\Facades\Nilvera; // Hesap Kredilerini Al $credits = Nilvera::getCredits(); // Güncel Döviz Kurlarını Al (Nilvera üzerinden) $rates = Nilvera::getExchangeRates(); // Dashboard Özet Verileri (Krediler, Kurlar, Son Faturalar, Günlük İstatistikler) // Parametre: mode ('einvoice' veya 'earchive'), params (SummaryPeriod: today, yesterday, week, month) $dashboard = Nilvera::getDashboardData('einvoice', ['SummaryPeriod' => 'month']); ``` --- 2. Fatura Listeleme ve Sorgulama -------------------------------- [](#2-fatura-listeleme-ve-sorgulama) Farklı durum ve yönlerdeki faturaları gelişmiş filtrelerle listeleyebilirsiniz. ``` // Gelen/Giden Faturaları Listele (Gelişmiş Filtreleme) // Yön: 'Sale' (Giden) veya 'Purchase' (Gelen) $invoices = Nilvera::getInvoices('Sale', [ 'StartDate' => '2024-01-01', 'EndDate' => '2024-01-31', 'PageSize' => 50, 'Search' => 'Müşteri Adı', 'StatusCode' => ['succeed', 'error'] // Opsiyonel filtre ]); // Eski (Arşivlenmiş) Faturaları Çek $oldInvoices = Nilvera::getOldInvoices('einvoice', ['Page' => 1]); // GIB E-Arşiv Gelen Faturaları Listele $gibInvoices = Nilvera::getGibInvoices(['Search' => 'VKN']); // Taslak Faturaları Listele $drafts = Nilvera::getDraftInvoices('einvoice', ['Page' => 1]); ``` --- 3. Fatura Detayları ve Görüntüleme ---------------------------------- [](#3-fatura-detayları-ve-görüntüleme) Fatura içeriğine, görseline ve eklerine erişebilirsiniz. ``` // Fatura HTML Görselini Al $html = Nilvera::getInvoiceHtml($uuid, 'einvoice', 'Sale'); // Fatura Tarihçesini (Loglarını) Al $history = Nilvera::getInvoiceHistories($uuid, 'Sale'); // Fatura Ek Dosyalarını Al $attachments = Nilvera::getInvoiceAttachments($uuid, 'Sale'); // Fatura Detay Bilgilerini Al $details = Nilvera::getInvoiceDetails($uuid, 'Sale'); // Taslak Fatura Modelini (Verisini) Al $model = Nilvera::getDraftModel($uuid, 'einvoice'); ``` --- 4. Fatura Oluşturma ve Gönderme ------------------------------- [](#4-fatura-oluşturma-ve-gönderme) Laravel verilerinizi Nilvera modeline dönüştürüp fatura oluşturabilirsiniz. ``` // 1. Laravel Verisini Nilvera Modeline Dönüştür $data = [ 'TaxNumber' => '1234567890', 'Title' => 'Örnek Limited Şirketi', 'Address' => 'Atatürk Cad. No:1', 'District' => 'Çankaya', 'City' => 'Ankara', 'CurrencyCode' => 'TRY', // Opsiyonel, varsayılan TRY 'Series' => 'HIZ', // Fatura Serisi 'Scenario' => 'Ticari', // Temel veya Ticari 'items' => [ [ 'Name' => 'Yazılım Hizmeti', 'Quantity' => 1, 'Price' => 5000, 'VatRate' => 20, 'UnitCode' => 'C62', // ADET için Nilvera kodu 'Description' => 'Ocak ayı bakım bedeli' ] ], 'Notes' => 'Fatura notu buraya yazılır.' ]; $model = Nilvera::mapToModel($data, $isArchive = false); // 2. Taslak Oluştur $result = Nilvera::createDraft($model, 'einvoice'); // 3. Faturayı Önizle (HTML döner) $preview = Nilvera::previewInvoice($model, 'einvoice'); // 4. Doğrudan Gönder (Create & Send) $sendResult = Nilvera::sendNewInvoice($model, 'einvoice'); // 5. Mevcut Taslağı Onayla ve Gönder (EditAndSend) $confirmResult = Nilvera::sendInvoice($uuid); ``` --- 5. Müşteri (Cari) Yönetimi -------------------------- [](#5-müşteri-cari-yönetimi) VKN/TCKN üzerinden mükellef sorgulama ve adres defteri işlemleri. ``` // Detaylı ve Normalize Edilmiş Müşteri Bilgisi Al // (CheckTaxNumber ve GlobalCustomerInfo'yu birleştirir) $customer = Nilvera::getCustomerDetails('1234567890'); // Nilvera Adres Defterine Müşteri Kaydet Nilvera::createCustomer([ 'Name' => 'Müşteri Ünvanı', 'TaxNumber' => '1234567890', 'Email' => 'email@example.com', 'City' => 'İstanbul' ]); ``` --- 6. Toplu İşlemler ve Operasyonlar --------------------------------- [](#6-toplu-i̇şlemler-ve-operasyonlar) ``` // Toplu Fatura Gönderimi Nilvera::bulkSendInvoices([['UUID' => '...', 'Alias' => '...']], 'einvoice'); // Toplu Taslak Silme Nilvera::bulkDeleteInvoices(['uuid1', 'uuid2'], 'einvoice'); // Toplu Arşivleme Nilvera::archiveInvoices(['uuid1', 'uuid2'], 'Sale'); // Toplu Okundu Olarak İşaretleme Nilvera::markAsRead(['uuid1', 'uuid2'], 'Purchase'); // Toplu ERP Aktarıldı İşareti Nilvera::markAsTransferred(['uuid1', 'uuid2'], 'Sale'); ``` --- 7. Dışa Aktarma (Export) ve Yükleme ----------------------------------- [](#7-dışa-aktarma-export-ve-yükleme) ``` // Faturaları PDF/XML Olarak Dışa Aktar // Formatlar: 'Pdf', 'OnePagePdf', 'Xml', 'Envelope' $binaryContent = Nilvera::exportInvoices($uuids, 'Pdf', 'Sale'); // XML/UBL Dosyası Yükleyerek Fatura Oluştur Nilvera::uploadXml($filePath, $fileName, 'einvoice'); // SGK PDF Yükleme Nilvera::uploadSgkPdf($filePath, $fileName, 'SAGLIK_ECZ', 'registerCode'); ``` --- 8. Ekstra Fonksiyonlar ---------------------- [](#8-ekstra-fonksiyonlar) ``` // WhatsApp Üzerinden Fatura Gönder (Taslaklar için) Nilvera::sendWhatsapp($uuid, '90555XXXXXXX'); // Fatura Serilerini Yönet $series = Nilvera::getSeries('einvoice'); Nilvera::createSeries('ABC', 'einvoice'); // Fatura Taslak Şablonlarını Al $templates = Nilvera::getTemplates('einvoice'); // Özel Kod (SpecialCode) Güncelle Nilvera::updateSpecialCode($uuids, 'PROJE-001', 'einvoice'); // Faturayı GİB üzerinden sorgula Nilvera::queryFromGib($uuid, 'Sale'); ``` --- Konfigürasyon ------------- [](#konfigürasyon) `config/nilvera.php` dosyası üzerinden API bilgilerinizi ve varsayılan şirket bilgilerinizi yönetebilirsiniz. ``` return [ 'base_url' => env('NILVERA_BASE_URL'), 'api_key' => env('NILVERA_API_KEY'), 'company' => [ 'name' => 'Varsayılan Şirket Adı', // ... diğer bilgiler ] ]; ``` ### Health Score 41 — FairBetter than 87% of packages Maintenance89 Actively maintained with recent releases Popularity8 Limited adoption so far Community6 Small or concentrated contributor base Maturity52 Maturing project, gaining track record Bus Factor1 Top contributor holds 100% of commits — single point of failure How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window. **Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores. **Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement. **Maturity (30%)** — Project age, version count, PHP version support, and release stability. ### Release Activity Cadence Every ~4 days Total 9 Last Release 36d ago PHP version history (2 changes)v1.0.0PHP ^8.4 v1.0.1PHP ^8.2 ### Community Maintainers ![](https://www.gravatar.com/avatar/2a222ca8933c72c3fc3715d66edac5ea7450656a7051af0b0a408b968ab6ac12?d=identicon)[YamanHafez](/maintainers/YamanHafez) --- Top Contributors [![YamanHafez](https://avatars.githubusercontent.com/u/88431093?v=4)](https://github.com/YamanHafez "YamanHafez (3 commits)") ### Code Quality TestsPHPUnit ### Embed Badge ![Health badge](/badges/profscode-nilvera/health.svg) ``` [![Health](https://phpackages.com/badges/profscode-nilvera/health.svg)](https://phpackages.com/packages/profscode-nilvera) ``` ### Alternatives [defstudio/telegraph A laravel facade to interact with Telegram Bots 813336.8k3](/packages/defstudio-telegraph)[simplestats-io/laravel-client Server-side analytics for Laravel that follows the full funnel from visit to registration to payment, attributed to the channel that drove it. Revenue, MRR, churn and ad-spend profit (ROAS/CAC) per channel. GDPR compliant, ad-blocker proof. 5022.6k](/packages/simplestats-io-laravel-client) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)