PHPackages                             theposeidonas/laravel-parasut-api - 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. theposeidonas/laravel-parasut-api

ActiveLibrary[API Development](/categories/api)

theposeidonas/laravel-parasut-api
=================================

Paraşüt v4 API for Laravel Projects

v1.2.3(1y ago)124.6k↓18.2%4MITPHPCI passing

Since Jan 20Pushed 1y ago1 watchersCompare

[ Source](https://github.com/theposeidonas/laravel-parasut-api)[ Packagist](https://packagist.org/packages/theposeidonas/laravel-parasut-api)[ GitHub Sponsors](https://github.com/theposeidonas)[ RSS](/packages/theposeidonas-laravel-parasut-api/feed)WikiDiscussions main Synced 1mo ago

READMEChangelog (9)Dependencies (5)Versions (10)Used By (0)

[![Contributors](https://camo.githubusercontent.com/67cf2977c72c180c90256ca0bf47c7d027f683bce700975355df7c572be542d2/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f636f6e7472696275746f72732f746865706f736569646f6e61732f6c61726176656c2d706172617375742d6170692e7376673f7374796c653d666f722d7468652d6261646765)](https://github.com/theposeidonas/laravel-parasut-api/graphs/contributors)[![Forks](https://camo.githubusercontent.com/c6805f2836e63e94267b16ed39b319d2cd70fbd5b27f0b2583b177fdf3d91659/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f666f726b732f746865706f736569646f6e61732f6c61726176656c2d706172617375742d6170692e7376673f7374796c653d666f722d7468652d6261646765)](https://github.com/theposeidonas/laravel-parasut-api/network/members)[![Stargazers](https://camo.githubusercontent.com/2914f41592ece626635b7f8c6df4da7a819e9ba2e1e3c7d5e75891c3d03abd7c/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f73746172732f746865706f736569646f6e61732f6c61726176656c2d706172617375742d6170692e7376673f7374796c653d666f722d7468652d6261646765)](https://github.com/theposeidonas/laravel-parasut-api/stargazers)[![Issues](https://camo.githubusercontent.com/c38bd14d4bb7f365e56b8e0032388ab0f98feab221e4c8d6e3711affa75add9a/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f6973737565732f746865706f736569646f6e61732f6c61726176656c2d706172617375742d6170692e7376673f7374796c653d666f722d7468652d6261646765)](https://github.com/theposeidonas/laravel-parasut-api/issues)[![MIT License](https://camo.githubusercontent.com/2474f37f6559420dd734c913d2507836651dc364e88f3c65ca53c1cb701a8aa1/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f6c6963656e73652f746865706f736569646f6e61732f6c61726176656c2d706172617375742d6170692e7376673f7374796c653d666f722d7468652d6261646765)](https://github.com/theposeidonas/laravel-parasut-api/blob/master/LICENSE.txt)[![LinkedIn](https://camo.githubusercontent.com/d52963778220cbec61d6ed72270f9735024ffceeb551e5c3933d4e03b4694cf1/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f2d4c696e6b6564496e2d626c61636b2e7376673f7374796c653d666f722d7468652d6261646765266c6f676f3d6c696e6b6564696e26636f6c6f72423d353535)](https://www.linkedin.com/in/theposeidonas/)

 [ ![İstanbul Web Tasarım](https://camo.githubusercontent.com/b296a4bcddaa46f01bf242a8844ca03888e3d0b341dee41de0aa9bd51a4cd28c/68747470733a2f2f697374616e62756c7765627461736172696d2e70726f2f696d616765732f697374616e62756c2d7765622d7461736172696d2d6c6f676f2e77656270) ](https://istanbulwebtasarim.pro)### Paraşüt API Laravel Package

[](#paraşüt-api-laravel-package)

[![Laravel](https://camo.githubusercontent.com/5a580364ff3bd338370177402c5c050ff81a1933927e1e475c920c90850b38a3/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f4c61726176656c2d4646324432303f7374796c653d666f722d7468652d6261646765266c6f676f3d6c61726176656c266c6f676f436f6c6f723d7768697465)](https://laravel.com)[![Packagist Downloads (custom server)](https://camo.githubusercontent.com/a3c5c9b042912aceded5772bd5f88ebf0e54e30d61b6b2c0c7637f3ae93f3ec4/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f746865706f736569646f6e61732f6c61726176656c2d706172617375742d6170693f7374796c653d666f722d7468652d626164676526636f6c6f723d3030376563362663616368655365636f6e64733d33363030)](https://camo.githubusercontent.com/a3c5c9b042912aceded5772bd5f88ebf0e54e30d61b6b2c0c7637f3ae93f3ec4/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f746865706f736569646f6e61732f6c61726176656c2d706172617375742d6170693f7374796c653d666f722d7468652d626164676526636f6c6f723d3030376563362663616368655365636f6e64733d33363030)[![Tests](https://camo.githubusercontent.com/ad178f507e13bca06d6f44863ad2293ea37700fd9a4415b55ea6f3afc2efbbf2/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f616374696f6e732f776f726b666c6f772f7374617475732f746865706f736569646f6e61732f6c61726176656c2d706172617375742d6170692f706870756e69742e796d6c3f7374796c653d666f722d7468652d6261646765266c6f676f3d676974687562)](https://camo.githubusercontent.com/ad178f507e13bca06d6f44863ad2293ea37700fd9a4415b55ea6f3afc2efbbf2/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f616374696f6e732f776f726b666c6f772f7374617475732f746865706f736569646f6e61732f6c61726176656c2d706172617375742d6170692f706870756e69742e796d6c3f7374796c653d666f722d7468652d6261646765266c6f676f3d676974687562)

 Laravel için yazılmış Paraşüt V4 API paketi.
 [**Dökümantasyon »**](https://github.com/theposeidonas/laravel-parasut-api)

 [Demo](https://github.com/theposeidonas/laravel-parasut-api) · [Buglar](https://github.com/theposeidonas/laravel-parasut-api/issues) · [İstekler](https://github.com/theposeidonas/laravel-parasut-api/issues)

Laravel Paraşüt API
===================

[](#laravel-paraşüt-api)

Bu proje, Laravel için oluşturulmuş kolayca Paraşüt V4 API ile bağlantı kurmanızı sağlayacak bir paket. Paraşüt API bilgilerinizi .env dosyasına girdikten sonra tekrar tekrar Auth işlemleri ile uğraşmadan kolayca istediğiniz fonksiyonu istediğiniz yerde çalıştırabilirsiniz.

Please go to the README.en.md file to read the English documentation.

### Neden ihtiyaç var?

[](#neden-ihtiyaç-var)

Laravel için yazılmış hızlı ve basit bir Paraşüt API paketi neredeyse hiç bulunmuyor. OAuth2 işlemlerini otomatik olarak yapan, token süresi dolmuşsa otomatik olarak yeni token alan ve Controller içerisine sadece yapacağınız işlemi yazdıran sade bir pakete ihtiyaç duyuyorduk.

Bug ve Hataları lütfen Issues kısmından bildirin.

([Başa dön](#readme-top))

Başlarken
---------

[](#başlarken)

Paraşüt ile mutlaka iletişime geçip gerekli bilgilerinizi alın. Bu hem deneme hesabı hem de normal hesap için geçerlidir.

### Projenize ekleme

[](#projenize-ekleme)

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

```
composer require theposeidonas/laravel-parasut-api
```

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

```
php artisan vendor:publish --tag=parasut-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;

```
'Parasut' => Theposeidonas\LaravelParasutApi\Facades\Parasut::class,
```

### Konfigürasyon

[](#konfigürasyon)

Kullanım için projenize eklemeyi yaptıktan sonra, .env dosyası içerisinde şu satırları ekleyip düzeltmelisiniz;

```
PARASUT_USERNAME="demo@parasut.com"  // Username
PARASUT_PASSWORD="XXXXXXXXX"  // Password
PARASUT_COMPANY_ID="123123" // Company ID
PARASUT_CLIENT_ID="XXXXXXXXXXXXXXXXX" // Paraşüt Client ID
PARASUT_CLIENT_SECRET="XXXXXXXXXXXXXXXXX" // Paraşüt Client Secret
PARASUT_REDIRECT_URI="urn:ietf:wg:oauth:2.0:oob" // Paraşüt Redirect URI, değiştirmenize gerek yok
```

([Başa dön](#readme-top))

Kullanım
--------

[](#kullanım)

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

```
use Theposeidonas\LaravelParasutApi\Facades\Parasut;
```

#### Sınıflar

[](#sınıflar)

Tüm ayarlamaları ve konfigürasyonlarınızı yaptıktan sonra kullanacağınız Controller içerisinde belirli sınıfları çağırabilirsiniz. Bu sınıflar şu şekilde;

```
/* Satışlar */
Parasut::Bill();            // Satış faturası           https://apidocs.parasut.com/#tag/SalesInvoices
Parasut::Customer();        // Müşteri                  https://apidocs.parasut.com/#tag/Contacts

/* Giderler */
Parasut::Receipt();         // Fiş - Fatura             https://apidocs.parasut.com/#tag/PurchaseBills
Parasut::Bank();            // Banka giderleri          https://apidocs.parasut.com/#tag/BankFees
Parasut::Salary();          // Maaş giderleri           https://apidocs.parasut.com/#tag/Salaries
Parasut::Tax();             // Vergi giderleri          https://apidocs.parasut.com/#tag/Taxes
Parasut::Supplier();        // Tedarikçi                https://apidocs.parasut.com/#tag/Contacts
Parasut::Employee();        // Çalışan                  https://apidocs.parasut.com/#tag/Employees

/* Resmileştirme */
Parasut::Inbox();           // E-Fatura Gelen Kutusu    https://apidocs.parasut.com/#tag/EInvoiceInboxes
Parasut::EArchive();        // E-Arşiv                  https://apidocs.parasut.com/#tag/EArchives
Parasut::EBill();           // E-Fatura                 https://apidocs.parasut.com/#tag/EInvoices
Parasut::ESmm();            // E SMM                    https://apidocs.parasut.com/#tag/ESmms

/* Nakit */
Parasut::Account();         // Kasa ve Banka            https://apidocs.parasut.com/#tag/Accounts
Parasut::Transaction();     // İşlem                    https://apidocs.parasut.com/#tag/Transactions

/* Stok */
Parasut::Product();         // Ürün                     https://apidocs.parasut.com/#tag/Products
Parasut::Warehouse();       // Depo                     https://apidocs.parasut.com/#tag/Warehouses
Parasut::Waybill();         // İrsaliye                 https://apidocs.parasut.com/#tag/ShipmentDocuments
Parasut::StockMovement();   // Stok Hareketi            https://apidocs.parasut.com/#tag/StockMovements

/* Ayarlar */
Parasut::Category();        // Kategori                 https://apidocs.parasut.com/#tag/ItemCategories
Parasut::Tag();             // Etiket                   https://apidocs.parasut.com/#tag/Tags

/* Other */
Parasut::ApiHome();         // Api Home                 https://apidocs.parasut.com/#tag/ApiHome
Parasut::TrackableJob();    // Trackable Job            https://apidocs.parasut.com/#tag/TrackableJobs
Parasut::Webhook();         // Webhooks                 https://apidocs.parasut.com/#tag/Webhooks
```

*Bunlar dışında kalan, ürünlerin stok seviyesini kontrol etmek için `Parasut::Product()->inventory($id); ` kullanmanız gerekir.*

#### Fonksiyonlar

[](#fonksiyonlar)

Paraşüt içindeki sınıfları kullanırken,  sayfasında yer alan fonksiyonları kullanabilirsiniz.

Örneğin;
Müşteri index fonksiyonu için: `Parasut::Customer()->index(); `
Müşteri create fonksiyonu için: `Parasut::Customer()->create($data); `
Müşteri show fonksiyonu için: `Parasut::Customer()->show($id); `
Müşteri edit fonksiyonu için: `Parasut::Customer()->edit($id, $data); `

şeklinde kullanabilirsiniz. Dökümanlarda gösterilen tüm fonksiyonlar mevcuttur.

##### Veri Yapılandırması

[](#veri-yapılandırması)

Bir sınıfta create fonksiyonu için veri gönderirken,  tarafında bahsedilen şekilde veri göndermelisiniz. Eğer gerekli parametreleri göndermezseniz hata alırsınız.

Ayrıca veriyi JSON olarak değil, Array olarak göndermeniz gereklidir. Paket kendisi JSON'a çevirerek gönderim yapacaktır.

Örnek Müşteri oluşturma;

```
$customer = [
            'data'=>[
                'type'=>'contacts',
                'attributes'=>[
                    'email'=>'demo@parasut.com',
                    'name'=>'İsim Soyisim',
                    'contact_type'=>'person',
                    'tax_number'=>'11111111111',
                    'account_type'=>'customer'
                ]
            ]
        ];
$response = Parasut::Customer()->create($customer);
```

Eğer işlemleriniz başarılıysa size şöyle bir Array geri dönecektir;

```
Array
(
    [success] => true // İşlem başarılı ise true
    [error] => false // İşlem başarısız ise true
    [body] => stdClass Object // Paraşüt dökümanlarında yazan response -> stdClass Object olarak
    [status] => 200 // Response Status
)
```

##### Query Parameters ()

[](#query-parameters-)

Filtreleme ve query parametrelerini gönderme v1.2.0-beta ile dahil edilmiştir. Artık dökümanlarda yazan **Query Parameters** yani URL sonuna eklenen parametreleri gönderebilirsiniz. Parametreler zorunlu değildir fakat gönderdiğiniz endpoint'e göre değişiklik gösterilir ve doğrulanır. Gerekenden farklı bir parametre gönderemezsiniz.

UYARI: v1.2.0'dan önce Inbox içerisinde vkn ile gelen parametre kodu değiştirildi. Yani eğer projenizde `Parasut::Inbox->index($vkn)` şeklinde bir kullanım yapıyorsanız, bunu uygun şekilde aşağıdaki gibi bir array olarak göndermeniz gerekiyor.

```
$parameters = [
    'filter' => [
        // Sadece integer kabul edilir.
        'vkn' => 1234567890
    ],
    // Bu kısım zorunlu değil.
    'page' => [
        'number' => 1,
        'size'=> 15
    ]
];

Parasut::Inbox->index($parameters);
```

Örnek Parametre Gönderimi

```
$parameters = [
            'filter' => [
                'name' => 'isim',
                'currency' => 'TRY',
                'bank_name' => 'Banka ismi',
                'bank_branch' => 'Banka Şubesi',
                'account_type' => 'Hesap Tipi',
                'iban' => 'TR00 0000 0000 0000 0000 0000 00'
            ],
            'sort' => 'balance',
            'page' => [
                'number' => 1,
                'size' => 15
            ]
        ];
$response = Parasut::Account()->index($id, $parameters);
```

([Başa dön](#readme-top))

### TODO

[](#todo)

Eksikleri ve hataları Issues kısmından yazabilirsiniz.

- Fonksiyonlar dahil edildi
- Eksik diğer kısımlar eklendi. (Others)
- Staging fonksiyonları çıkartıldı.
- Fonksiyonların ekstra filtreleri dahil edilecek (Query Parameters)

Lisanslama
----------

[](#lisanslama)

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

([Başa dön](#readme-top))

İletişim
--------

[](#i̇letişim)

Baran Arda - [@theposeidonas](https://twitter.com/theposeidonas) -

Proje Linki:

([Başa dön](#readme-top))

###  Health Score

36

—

LowBetter than 82% of packages

Maintenance44

Moderate activity, may be stable

Popularity31

Limited adoption so far

Community11

Small or concentrated contributor base

Maturity47

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 92.3% 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 ~51 days

Recently: every ~60 days

Total

9

Last Release

437d ago

### Community

Maintainers

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

---

Top Contributors

[![theposeidonas](https://avatars.githubusercontent.com/u/29899853?v=4)](https://github.com/theposeidonas "theposeidonas (24 commits)")[![safakocamanoglu](https://avatars.githubusercontent.com/u/68944910?v=4)](https://github.com/safakocamanoglu "safakocamanoglu (2 commits)")

---

Tags

laravelparasutphplaravelparasut

###  Code Quality

TestsPHPUnit

### Embed Badge

![Health badge](/badges/theposeidonas-laravel-parasut-api/health.svg)

```
[![Health](https://phpackages.com/badges/theposeidonas-laravel-parasut-api/health.svg)](https://phpackages.com/packages/theposeidonas-laravel-parasut-api)
```

###  Alternatives

[irazasyed/telegram-bot-sdk

The Unofficial Telegram Bot API PHP SDK

3.3k4.5M84](/packages/irazasyed-telegram-bot-sdk)[dcblogdev/laravel-microsoft-graph

A Laravel Microsoft Graph API (Office365) package

168285.5k1](/packages/dcblogdev-laravel-microsoft-graph)[vluzrmos/slack-api

Wrapper for Slack.com WEB API.

102589.1k3](/packages/vluzrmos-slack-api)[smodav/mpesa

M-Pesa API implementation

16363.7k1](/packages/smodav-mpesa)[dcblogdev/laravel-xero

A Laravel Xero package

53129.1k1](/packages/dcblogdev-laravel-xero)[simplestats-io/laravel-client

Client for SimpleStats!

4515.5k](/packages/simplestats-io-laravel-client)

PHPackages © 2026

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