PHPackages                             theposeidonas/laravel-kolaybi-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. [Payment Processing](/categories/payments)
4. /
5. theposeidonas/laravel-kolaybi-api

ActiveLibrary[Payment Processing](/categories/payments)

theposeidonas/laravel-kolaybi-api
=================================

KolayBi API for Laravel Projects

V1.0.2(3mo ago)044MITPHPPHP ^8.1CI passing

Since Jan 28Pushed 3mo agoCompare

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

READMEChangelog (3)Dependencies (6)Versions (4)Used By (0)

[![Contributors](https://camo.githubusercontent.com/f8736e03bf47a73b4659962ff572865d28c630abb41a555808a819b2f9fb16ef/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f636f6e7472696275746f72732f746865706f736569646f6e61732f6c61726176656c2d6b6f6c617962692d6170692e7376673f7374796c653d666f722d7468652d6261646765)](https://github.com/theposeidonas/laravel-kolaybi-api/graphs/contributors)[![Forks](https://camo.githubusercontent.com/b0462dd7a7dcb843d20801d5c256fb9212e54df4c5038450660c7bd5240f3e1b/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f666f726b732f746865706f736569646f6e61732f6c61726176656c2d6b6f6c617962692d6170692e7376673f7374796c653d666f722d7468652d6261646765)](https://github.com/theposeidonas/laravel-kolaybi-api/network/members)[![Stargazers](https://camo.githubusercontent.com/43102fda911284aa6a377c68187031050a134677405297ba60247259878fa4de/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f73746172732f746865706f736569646f6e61732f6c61726176656c2d6b6f6c617962692d6170692e7376673f7374796c653d666f722d7468652d6261646765)](https://github.com/theposeidonas/laravel-kolaybi-api/stargazers)[![Issues](https://camo.githubusercontent.com/0470e30e31ab2b2007012bdb9bc346ce1e1b909329bd6736533be8be5b2d8aad/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f6973737565732f746865706f736569646f6e61732f6c61726176656c2d6b6f6c617962692d6170692e7376673f7374796c653d666f722d7468652d6261646765)](https://github.com/theposeidonas/laravel-kolaybi-api/issues)[![MIT License](https://camo.githubusercontent.com/a44a91776ae85e15e78fc62e0b8fe1da39fd1320d7f453a479a57c9e5dcaa43f/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f6c6963656e73652f746865706f736569646f6e61732f6c61726176656c2d6b6f6c617962692d6170692e7376673f7374796c653d666f722d7468652d6261646765)](https://github.com/theposeidonas/laravel-kolaybi-api/blob/master/LICENSE.txt)[![LinkedIn](https://camo.githubusercontent.com/d52963778220cbec61d6ed72270f9735024ffceeb551e5c3933d4e03b4694cf1/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f2d4c696e6b6564496e2d626c61636b2e7376673f7374796c653d666f722d7468652d6261646765266c6f676f3d6c696e6b6564696e26636f6c6f72423d353535)](https://www.linkedin.com/in/theposeidonas/)

 [ ![Webremium](https://camo.githubusercontent.com/b296a4bcddaa46f01bf242a8844ca03888e3d0b341dee41de0aa9bd51a4cd28c/68747470733a2f2f697374616e62756c7765627461736172696d2e70726f2f696d616765732f697374616e62756c2d7765622d7461736172696d2d6c6f676f2e77656270) ](https://webremium.com)### KolayBi API Laravel Package

[](#kolaybi-api-laravel-package)

[![Laravel](https://camo.githubusercontent.com/5a580364ff3bd338370177402c5c050ff81a1933927e1e475c920c90850b38a3/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f4c61726176656c2d4646324432303f7374796c653d666f722d7468652d6261646765266c6f676f3d6c61726176656c266c6f676f436f6c6f723d7768697465)](https://laravel.com)[![Packagist Downloads](https://camo.githubusercontent.com/ae71854cf489314b367413e949e9cc9de8e1e56f637bbb3d432a56843c559975/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f746865706f736569646f6e61732f6c61726176656c2d6b6f6c617962692d6170693f7374796c653d666f722d7468652d626164676526636f6c6f723d3030376563362663616368655365636f6e64733d33363030)](https://camo.githubusercontent.com/ae71854cf489314b367413e949e9cc9de8e1e56f637bbb3d432a56843c559975/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f746865706f736569646f6e61732f6c61726176656c2d6b6f6c617962692d6170693f7374796c653d666f722d7468652d626164676526636f6c6f723d3030376563362663616368655365636f6e64733d33363030)[![Tests](https://camo.githubusercontent.com/616c49527770b6276bbc8609cb49541a30b04dff91b7b888ba71a7ca9b3aca9b/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f616374696f6e732f776f726b666c6f772f7374617475732f746865706f736569646f6e61732f6c61726176656c2d6b6f6c617962692d6170692f706870756e69742e796d6c3f7374796c653d666f722d7468652d6261646765266c6f676f3d676974687562)](https://camo.githubusercontent.com/616c49527770b6276bbc8609cb49541a30b04dff91b7b888ba71a7ca9b3aca9b/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f616374696f6e732f776f726b666c6f772f7374617475732f746865706f736569646f6e61732f6c61726176656c2d6b6f6c617962692d6170692f706870756e69742e796d6c3f7374796c653d666f722d7468652d6261646765266c6f676f3d676974687562)

 Laravel için geliştirilmiş güncel KolayBi API paketi.
 [**Dökümantasyon »**](https://github.com/theposeidonas/laravel-kolaybi-api)

 [Hata Bildir](https://github.com/theposeidonas/laravel-kolaybi-api/issues) · [Özellik İste](https://github.com/theposeidonas/laravel-kolaybi-api/issues)

---

Laravel KolayBi API
===================

[](#laravel-kolaybi-api)

Bu paket, KolayBi API servisleri ile Laravel projeniz arasında hızlı ve güvenli bir köprü kurar. Otomatik bearer alarak arka planda otomatik yöneterek geliştirme sürecinizi hızlandırır.

### Neden ihtiyaç var?

[](#neden-ihtiyaç-var)

KolayBi API entegrasyonu yaparken tekrar eden kimlik doğrulama işlemleri, dinamik token yönetimi ve karmaşık JSON yapılarıyla uğraşmak yerine; Laravel standartlarına uygun Facade yapısını kullanan, her Resource için hazır validasyonları olan sade bir çözüme ihtiyaç duyulmaktadır.

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

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

[](#başlarken)

Paketi kullanabilmek için KolayBi üzerinden API Key ve Channel ID bilgilerine sahip olmanız gerekmektedir.

### Kurulum

[](#kurulum)

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

Config dosyasını yayınlamak için:

```
php artisan vendor:publish --tag=kolaybi-config --force
```

### Konfigürasyon

[](#konfigürasyon)

`.env` dosyanıza aşağıdaki bilgileri ekleyin:

```
KOLAYBI_API_KEY="your-api-key"
KOLAYBI_CHANNEL_ID="your-channel-id"
KOLAYBI_SANDBOX=true
KOLAYBI_BASE_URL="https://ofis-sandbox-api.kolaybi.com"
```

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

Kullanım
--------

[](#kullanım)

Kullanacağınız Controller içerisine paketi dahil edin:

```
use Theposeidonas\Kolaybi\Facades\Kolaybi;
```

#### Sınıflar (Resources)

[](#sınıflar-resources)

Tüm modüllere Facade üzerinden erişebilirsiniz:

```
Kolaybi::bank(); // Kasa ve Banka Hesapları
Kolaybi::company(); // Şirket Yönetimi
Kolaybi::associate(); // Cari (Müşteri ve Tedarikçi) Yönetimi
Kolaybi::invoice(); // Satış ve Alış Faturası İşlemleri
Kolaybi::product(); // Ürün, Hizmet ve Stok Yönetimi
Kolaybi::order(); // Sipariş Yönetimi
Kolaybi::proforma(); // Proforma Fatura İşlemleri
Kolaybi::tag(); // Etiket Yönetimi
Kolaybi::user(); // Kullanıcı ve Yetki Yönetimi
```

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

##### Yanıt Yapısı

[](#yanıt-yapısı)

Tüm istekler `KolaybiResponse` sınıfı döner. Başarı kontrolü ve veriye erişim şu şekildedir:

```
$response = Kolaybi::bank()->list();

if ($response->isSuccess()) {
$data = $response->getData();
$status = $response->getStatus();
}
```

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

Tüm Fonksiyonlar ve Parametreleri
---------------------------------

[](#tüm-fonksiyonlar-ve-parametreleri)

Aşağıda paket içerisindeki kullanabileceğiniz tüm fonksiyonlar bulunuyor. Parametre detayları için döküman linklerini inceleyebilirsiniz. Eğer tek bir parametre bekleniyorsa, direk bu parametreyi, eğer birden fazla parametre bekleniyorsa da array şeklinde göndermelisiniz.

#### Kasa ve Banka (BankResource)

[](#kasa-ve-banka-bankresource)

```
Kolaybi::bank()->list($query); // Kasa ve banka hesaplarını listeleme -> https://developer.kolaybi.com/docs/vaults/list/
Kolaybi::bank()->find($vaultId); // Belirli bir kasa/banka detayını görüntüleme -> https://developer.kolaybi.com/docs/vaults/detail
Kolaybi::bank()->transactions($vaultId); // Kasa/banka hesap hareketlerini listeleme -> https://developer.kolaybi.com/docs/vaults/transactions]
```

#### Şirket (CompanyResource)

[](#şirket-companyresource)

```
Kolaybi::company()->list(); // Yetkili olunan şirketleri listeleme -> https://developer.kolaybi.com/docs/companies/list/
```

### Cari Hesap (AssociatesResource)

[](#cari-hesap-associatesresource)

```
Kolaybi::associate()->list(); // Cari hesapları (müşteri ve tedarikçi) listeleme -> https://developer.kolaybi.com/docs/associates/list/
Kolaybi::associate()->create($data); // Yeni cari hesap (müşteri/tedarikçi) oluşturma -> https://developer.kolaybi.com/docs/associates/create/
Kolaybi::associate()->addressCreate($data); // Mevcut bir cari hesaba yeni adres ekleme -> https://developer.kolaybi.com/docs/associates/addresses/
Kolaybi::associate()->transactions($associateId); // Cari hesaba ait tüm hareketleri listeleme -> https://developer.kolaybi.com/docs/associates/transactions/
Kolaybi::associate()->payment($id, $data); // Cari hesaptan tahsilat yapma (Ödeme Girişi) -> https://developer.kolaybi.com/docs/associates/payment/
Kolaybi::associate()->proceed($id, $data); // Cari hesaba ödeme yapma (Ödeme Çıkışı) -> https://developer.kolaybi.com/docs/associates/proceed/
```

### Fatura (InvoiceResource)

[](#fatura-invoiceresource)

```
Kolaybi::invoice()->list($query); // Satış ve alış faturalarını listeleme -> https://developer.kolaybi.com/docs/invoices/list/
Kolaybi::invoice()->create($data); // Yeni fatura (satış/alış) oluşturma -> https://developer.kolaybi.com/docs/invoices/create/
Kolaybi::invoice()->find($documentId); // Belirli bir faturanın detaylarını görüntüleme -> https://developer.kolaybi.com/docs/invoices/detail/
Kolaybi::invoice()->formalize($documentId); // E-Fatura Gönderimi (Taslak Faturayı Resmileştirme) -> https://developer.kolaybi.com/docs/invoices/e-document/
Kolaybi::invoice()->collect($data); // Fatura Tahsilat -> https://developer.kolaybi.com/docs/invoices/proceed/
Kolaybi::invoice()->delete($documentId); // Mevcut bir faturayı silme -> https://developer.kolaybi.com/docs/invoices/delete/
Kolaybi::invoice()->deleteCollection($documentId); // Fatura üzerindeki tahsilat/ödeme kaydını silme -> https://developer.kolaybi.com/docs/invoices/proceed-delete/
Kolaybi::invoice()->cancelEDocument($documentId); // Resmileşmiş bir e-belgeyi iptal etme -> https://developer.kolaybi.com/docs/invoices/e-document-cancel/
Kolaybi::invoice()->viewEDocument($uuid); // E-Belgenin görüntüsünü (HTML/PDF) alma -> https://developer.kolaybi.com/docs/invoices/e-document-view/
Kolaybi::invoice()->resendEDocument($documentId); // E-Belgeyi alıcıya tekrar e-posta ile gönderme -> https://developer.kolaybi.com/docs/invoices/resend/
Kolaybi::invoice()->listEInvoices($query); // Gelen kutusuna düşen e-faturaları listeleme -> https://developer.kolaybi.com/docs/e-documents/list
```

### Sipariş (OrderResource)

[](#sipariş-orderresource)

```
Kolaybi::order()->create($data); // Yeni sipariş oluşturma -> https://developer.kolaybi.com/docs/orders/create/
Kolaybi::order()->find($documentId); // Belirli bir siparişin detaylarını görüntüleme -> https://developer.kolaybi.com/docs/orders/detail/
```

### Ürün ve Stok (ProductResource)

[](#ürün-ve-stok-productresource)

```
Kolaybi::product()->list($query); // Ürün ve hizmetleri listeleme -> https://developer.kolaybi.com/docs/products/list/
Kolaybi::product()->create($data); // Yeni ürün veya hizmet oluşturma -> https://developer.kolaybi.com/docs/products/create/
Kolaybi::product()->find($productId); // Belirli bir ürünün detaylarını görüntüleme -> https://developer.kolaybi.com/docs/products/detail/
Kolaybi::product()->update($productId, $data); // Mevcut ürün bilgilerini güncelleme -> https://developer.kolaybi.com/docs/products/update/
Kolaybi::product()->stock($data); // Ürün için stok girişi veya çıkışı yapma (Stok Hareketleri) -> https://developer.kolaybi.com/docs/products/stock/
```

### Proforma Fatura (ProformaResource)

[](#proforma-fatura-proformaresource)

```
Kolaybi::proforma()->create($data); // Yeni proforma fatura oluşturma -> https://developer.kolaybi.com/docs/proformas/create/
Kolaybi::proforma()->find($documentId); // Belirli bir proforma faturanın detaylarını görüntüleme -> https://developer.kolaybi.com/docs/proformas/detail/
```

### Etiket (TagResource)

[](#etiket-tagresource)

```
Kolaybi::tag()->list($query); // Etiketleri listeleme -> https://developer.kolaybi.com/docs/tags/list/
Kolaybi::tag()->find($tagId); // Belirli bir etiketin detaylarını görüntüleme -> https://developer.kolaybi.com/docs/tags/detail
```

### Kullanıcı (UserResource)

[](#kullanıcı-userresource)

```
Kolaybi::user()->list(); // Şirketteki kullanıcıları listeleme -> https://developer.kolaybi.com/docs/users/list/
```

TODO
----

[](#todo)

- Temel Resource yapıları tamamlandı.
- Unit testler eklendi.

Lisanslama
----------

[](#lisanslama)

MIT Lisansı ile dağıtılmaktadır. Detaylar için `LICENSE` dosyasına bakabilirsiniz.

([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

38

—

LowBetter than 85% of packages

Maintenance80

Actively maintained with recent releases

Popularity11

Limited adoption so far

Community6

Small or concentrated contributor base

Maturity45

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 ~0 days

Total

3

Last Release

104d 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 (10 commits)")

---

Tags

laravelbillinginvoicekolaybi

###  Code Quality

TestsPHPUnit

Code StyleLaravel Pint

### Embed Badge

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

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

###  Alternatives

[laraveldaily/laravel-invoices

Missing invoices for Laravel

1.5k1.3M4](/packages/laraveldaily-laravel-invoices)

PHPackages © 2026

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