PHPackages                             bercanozcan/earsiv - 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. bercanozcan/earsiv

ActiveLibrary[API Development](/categories/api)

bercanozcan/earsiv
==================

Bu Laravel paketi, GİB e-Arşiv Portalı ile doğrudan bağlantı kurarak kullanıcıların e-Arşiv faturalarını otomatik olarak oluşturmasını, önizlemesini almasını, indirmesini ve yönetmesini sağlar.

v1(1y ago)09MITPHP

Since Apr 7Pushed 1y agoCompare

[ Source](https://github.com/bercanozcan/earsiv)[ Packagist](https://packagist.org/packages/bercanozcan/earsiv)[ RSS](/packages/bercanozcan-earsiv/feed)WikiDiscussions main Synced 1mo ago

READMEChangelog (1)DependenciesVersions (2)Used By (0)

Laravel e-Arşiv Fatura
======================

[](#laravel-e-arşiv-fatura)

Bu Laravel paketi, GİB e-Arşiv Portalı ile doğrudan bağlantı kurarak kullanıcıların e-Arşiv faturalarını otomatik olarak oluşturmasını, önizlemesini almasını, indirmesini ve yönetmesini sağlar.

---

Gereksinimler
-------------

[](#gereksinimler)

Depo Durumu
-----------

[](#depo-durumu)

[![PHP](https://camo.githubusercontent.com/428f3fbdcd6213c3c0246c3983d67c7da2f09aac9d6d1f82b116de04afb34bdd/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f646570656e64656e63792d762f62657263616e6f7a63616e2f6561727369762f7068703f7374796c653d706c6173746963)](https://camo.githubusercontent.com/428f3fbdcd6213c3c0246c3983d67c7da2f09aac9d6d1f82b116de04afb34bdd/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f646570656e64656e63792d762f62657263616e6f7a63616e2f6561727369762f7068703f7374796c653d706c6173746963)[![Laravel](https://camo.githubusercontent.com/9b4fc72cd5f465240255be37da386d93a8f4bfc7ccf6489d9704151f4f86a167/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f62657263616e6f7a63616e2f6561727369763f7374796c653d706c6173746963)](https://camo.githubusercontent.com/9b4fc72cd5f465240255be37da386d93a8f4bfc7ccf6489d9704151f4f86a167/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f62657263616e6f7a63616e2f6561727369763f7374796c653d706c6173746963)[![Son Commit](https://camo.githubusercontent.com/f6c3c3932d81dcc246453d716557eb02557553a3fce34a2829c8b0f1732d7fdc/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f6c6173742d636f6d6d69742f62657263616e6f7a63616e2f656172736976)](https://camo.githubusercontent.com/f6c3c3932d81dcc246453d716557eb02557553a3fce34a2829c8b0f1732d7fdc/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f6c6173742d636f6d6d69742f62657263616e6f7a63616e2f656172736976)[![Açık Konular](https://camo.githubusercontent.com/79b46b09b2a33c1692af085f5c2fc7f329e3c7d988c3c7fb5dd9c86dd6110d31/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f6973737565732f62657263616e6f7a63616e2f656172736976)](https://camo.githubusercontent.com/79b46b09b2a33c1692af085f5c2fc7f329e3c7d988c3c7fb5dd9c86dd6110d31/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f6973737565732f62657263616e6f7a63616e2f656172736976)[![Kapalı Konular](https://camo.githubusercontent.com/a7c34ff5a5619a47b7da0ec358b9b57919b2caa7bb481aacbe4ff6bd94e1c933/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f6973737565732d636c6f7365642f62657263616e6f7a63616e2f656172736976)](https://camo.githubusercontent.com/a7c34ff5a5619a47b7da0ec358b9b57919b2caa7bb481aacbe4ff6bd94e1c933/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f6973737565732d636c6f7365642f62657263616e6f7a63616e2f656172736976)[![Yıldızlar](https://camo.githubusercontent.com/b86c77682f2594c06537ad7bdff016c28b3fbcbefe0e2522cb3cc97f01436011/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f73746172732f62657263616e6f7a63616e2f656172736976)](https://camo.githubusercontent.com/b86c77682f2594c06537ad7bdff016c28b3fbcbefe0e2522cb3cc97f01436011/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f73746172732f62657263616e6f7a63616e2f656172736976)[![Çatallar](https://camo.githubusercontent.com/f4e4d3f7bee8d7fb951d139638f39dc65e2d809ea26146831641713c270d10e5/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f666f726b732f62657263616e6f7a63616e2f656172736976)](https://camo.githubusercontent.com/f4e4d3f7bee8d7fb951d139638f39dc65e2d809ea26146831641713c270d10e5/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f666f726b732f62657263616e6f7a63616e2f656172736976)

🔧 Kurulum
---------

[](#-kurulum)

### 1. Composer ile yükleme

[](#1-composer-ile-yükleme)

```
composer require bercanozcan/earsiv

```

### 2. Yapılandırma dosyasını yayınlayın

[](#2-yapılandırma-dosyasını-yayınlayın)

```
php artisan vendor:publish --tag=config --provider="Bercanozcan\\Earsiv\\EarsivServiceProvider"

```

Bu işlem `config/earsiv.php` dosyasını oluşturur.

---

⚙️ Yapılandırma
---------------

[](#️-yapılandırma)

`config/earsiv.php` dosyası üzerinden indirilecek dosyaların kaydedileceği yolu ayarlayabilirsiniz:

```
return [
    'download_path' => 'faturalar', // storage/app/faturalar
];
```

---

🚀 Kullanım
----------

[](#-kullanım)

### Giriş ve fatura oluşturma

[](#giriş-ve-fatura-oluşturma)

```
use Bercanozcan\Earsiv\Gib;

$gib = app(Gib::class)
    ->setTestCredentials()
    ->login();

$invoice = [
    'faturaTarihi' => now()->format('d/m/Y'),
    'saat' => now()->format('H:i:s'),
    'vknTckn' => '11111111111',
    'aliciUnvan' => 'Demo Müşteri A.Ş.',
    'vergiDairesi' => 'TEST VD',
    'malHizmetTable' => [[
        'malHizmet' => 'Danışmanlık Hizmeti',
        'miktar' => 1,
        'birim' => 'HUR',
        'birimFiyat' => 1000,
        'fiyat' => 1000,
        'kdvOrani' => 20,
        'kdvTutari' => 200,
        'malHizmetTutari' => 1000,
        'iskontoOrani' => 0,
        'iskontoTutari' => 0,
        'iskontoArttm' => 'İskonto'
    ]],
    'matrah' => 1000,
    'hesaplanankdv' => 200,
    'vergilerToplami' => 200,
    'vergilerDahilToplamTutar' => 1200,
    'odenecekTutar' => 1200,
    'tip' => 'İskonto',
    'not' => 'Bu bir demo faturadır.',
];

$ettn = $gib->createDraft($invoice);

echo "Fatura oluşturuldu: $ettn";
```

---

### Fatura önizlemesi alma (HTML)

[](#fatura-önizlemesi-alma-html)

```
$html = $gib->getHtml($ettn);
```

---

### Faturayı diske kaydetme

[](#faturayı-diske-kaydetme)

```
$path = $gib->saveToDisk($ettn);
// storage/app/faturalar/xxxx.zip
```

---

🧪 Test Ortamı
-------------

[](#-test-ortamı)

Test kullanıcıları `setTestCredentials()` metodu ile otomatik alınır.
Tüm işlemler [earsivportaltest.efatura.gov.tr](https://earsivportaltest.efatura.gov.tr) üzerinde gerçekleştirilir.

---

📁 Dosya Sistemi
---------------

[](#-dosya-sistemi)

Faturalar Laravel `Storage` sistemi ile belirtilen diske (örnek: `local`, `public`, `s3`) kaydedilir.
`.env` üzerinden kontrol edilen `FILESYSTEM_DISK` değişkeni aktif olarak kullanılır.

---

✅ Desteklenen İşlemler
----------------------

[](#-desteklenen-i̇şlemler)

- Giriş (login)
- Fatura oluşturma (`createDraft`)
- Fatura önizleme (`getHtml`)
- Fatura indirme (`saveToDisk`)
- Kullanıcı bilgisi sorgulama (`getUserData`)
- Alıcı bilgisi alma (`getRecipientData`)
- İptal ve itiraz talepleri (yakında)
- SMS ile imzalama (yakında)

---

👨‍💻 Geliştirici
---------------

[](#‍-geliştirici)

**Bercan Özcan**
[GitHub - @bercanozcan](https://github.com/bercanozcan)

---

🛡 Uyarı
-------

[](#-uyarı)

Bu paket GİB test ortamında denenmiştir.
Gerçek ortamda kullanmadan önce verilerin doğruluğunu ve teknik dökümana uygunluğunu mutlaka test ediniz.

---

📄 Lisans
--------

[](#-lisans)

Bu proje MIT Lisansı ile lisanslanmıştır.

###  Health Score

25

—

LowBetter than 37% of packages

Maintenance46

Moderate activity, may be stable

Popularity4

Limited adoption so far

Community6

Small or concentrated contributor base

Maturity37

Early-stage or recently created project

 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

Unknown

Total

1

Last Release

406d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/ae4ff82318e0931fbeaa095b2c950272cbd2bfe382571fb18ae5f4bb301054e5?d=identicon)[bercanozcan](/maintainers/bercanozcan)

---

Top Contributors

[![bercanozcan](https://avatars.githubusercontent.com/u/8063250?v=4)](https://github.com/bercanozcan "bercanozcan (6 commits)")

---

Tags

efaturaearsivgibe faturae arşivinternet vergi dairesiearşiv laravelgib laravelefatura laravel

### Embed Badge

![Health badge](/badges/bercanozcan-earsiv/health.svg)

```
[![Health](https://phpackages.com/badges/bercanozcan-earsiv/health.svg)](https://phpackages.com/packages/bercanozcan-earsiv)
```

###  Alternatives

[mlevent/fatura

PHP için GİB eArşiv/eFatura entegrasyonu.

1655.9k](/packages/mlevent-fatura)[twilio/sdk

A PHP wrapper for Twilio's API

1.6k92.9M272](/packages/twilio-sdk)[furkankadioglu/efatura

EFatura

4364.6k1](/packages/furkankadioglu-efatura)[facebook/php-business-sdk

PHP SDK for Facebook Business

90821.9M34](/packages/facebook-php-business-sdk)[google/common-protos

Google API Common Protos for PHP

173103.7M50](/packages/google-common-protos)[hubspot/api-client

Hubspot API client

23914.2M16](/packages/hubspot-api-client)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)
