PHPackages                             wiensa/trendyol-sp-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. wiensa/trendyol-sp-api

ActiveLibrary[API Development](/categories/api)

wiensa/trendyol-sp-api
======================

Trendyol Marketplace API entegrasyonu için Laravel paketi

v1.0.2(1y ago)417↓100%1[1 issues](https://github.com/wiensa/trendyol-sp-api/issues)MITPHPPHP ^8.2CI failing

Since Apr 18Pushed 1y ago1 watchersCompare

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

READMEChangelog (3)Dependencies (7)Versions (3)Used By (0)

Trendyol Marketplace API Laravel Paketi
=======================================

[](#trendyol-marketplace-api-laravel-paketi)

Bu paket, Trendyol Marketplace API'si ile entegrasyon sağlamak için Laravel uygulamalarında kullanılabilecek bir istemci sağlar.

Kurulum
-------

[](#kurulum)

### Packagist Üzerinden Kurulum (Tavsiye Edilen)

[](#packagist-üzerinden-kurulum-tavsiye-edilen)

Paketi Composer aracılığıyla yükleyin:

```
composer require wiensa/trendyol-sp-api
```

### GitHub Üzerinden Kurulum

[](#github-üzerinden-kurulum)

Eğer paket henüz Packagist'e yüklenmemişse, GitHub üzerinden doğrudan kurulum yapabilirsiniz. Bu yöntem için `composer.json` dosyanıza aşağıdaki kod bloğunu ekleyin:

```
"repositories": [
    {
        "type": "vcs",
        "url": "https://github.com/wiensa/trendyol-sp-api"
    }
],
"require": {
    "wiensa/trendyol-sp-api": "dev-main"
}
```

Sonra Composer'ı güncellemeyi unutmayın:

```
composer update
```

### Lokal Geliştirme İçin Kurulum

[](#lokal-geliştirme-i̇çin-kurulum)

Geliştirme sürecinde lokal olarak kullanmak için `composer.json` dosyanıza path repository ekleyebilirsiniz:

```
"repositories": [
    {
        "type": "path",
        "url": "../trendyol-sp-api"
    }
],
"require": {
    "wiensa/trendyol-sp-api": "*"
}
```

Laravel 5.5 ve üstü için, paket otomatik olarak kaydedilecektir.

Yapılandırma dosyasını yayınlamak için:

```
php artisan vendor:publish --provider="TrendyolApi\TrendyolSpApi\Providers\TrendyolServiceProvider" --tag="config"
```

Yapılandırma
------------

[](#yapılandırma)

Paket yapılandırması, yayınlanan `config/trendyol.php` dosyasında veya `.env` dosyasında aşağıdaki şekilde ayarlanabilir:

```
TRENDYOL_SUPPLIER_ID=your-supplier-id
TRENDYOL_API_KEY=your-api-key
TRENDYOL_API_SECRET=your-api-secret
TRENDYOL_API_URL=https://api.trendyol.com/sapigw
TRENDYOL_CACHE_ENABLED=true
TRENDYOL_CACHE_TTL=3600
TRENDYOL_DEBUG=false
```

Kullanım
--------

[](#kullanım)

### Facade Kullanımı

[](#facade-kullanımı)

```
use TrendyolApi\TrendyolSpApi\Facades\Trendyol;

// Ürünleri listeleme
$products = Trendyol::products()->list(['page' => 0, 'size' => 50]);

// Sipariş bilgilerini alma
$orders = Trendyol::orders()->list(['status' => 'Created', 'startDate' => '2023-01-01', 'endDate' => '2023-12-31']);

// Kategorileri listeleme
$categories = Trendyol::categories()->list();

// Markaları arama
$brands = Trendyol::brands()->search('Apple');

// İadeleri listeleme
$returns = Trendyol::returns()->list(['startDate' => '2023-01-01', 'endDate' => '2023-12-31']);

// Müşteri sorularını listeleme
$questions = Trendyol::customerQuestions()->list(['status' => 'WAITING_FOR_ANSWER']);

// Şikayetleri/talepleri listeleme
$claims = Trendyol::claims()->list(['status' => 'OPEN']);

// Kargo firmalarını listeleme
$shipmentProviders = Trendyol::shipmentProviders()->list();
```

### Helper Fonksiyonu Kullanımı

[](#helper-fonksiyonu-kullanımı)

```
// Ürünleri listeleme
$products = trendyol()->products()->list(['page' => 0, 'size' => 50]);

// Sipariş bilgilerini alma
$orders = trendyol()->orders()->list();

// İadeleri listeleme
$returns = trendyol()->returns()->list();

// Müşteri sorusuna yanıt verme
$answer = trendyol()->customerQuestions()->answer(12345, 'Ürünümüz 2 yıl garantilidir.');
```

### Dependency Injection Kullanımı

[](#dependency-injection-kullanımı)

```
use TrendyolApi\TrendyolSpApi\Trendyol;

class ProductController extends Controller
{
    protected Trendyol $trendyol;

    public function __construct(Trendyol $trendyol)
    {
        $this->trendyol = $trendyol;
    }

    public function index()
    {
        return $this->trendyol->products()->list();
    }
}
```

Özellikler
----------

[](#özellikler)

- **Ürün Yönetimi**:

    - Ürün listeleme, detay görüntüleme
    - Ürün oluşturma (tekli ve toplu)
    - Ürün güncelleme (tekli ve toplu)
    - Ürün silme
    - Stok ve fiyat güncelleme
- **Sipariş Yönetimi**:

    - Siparişleri listeleme ve detay görüntüleme
    - Sipariş paketini onaylama veya iptal etme
    - Kargo takip numarası güncelleme
    - Fatura bilgisi/dosyası gönderme
- **İade Yönetimi**:

    - İadeleri listeleme ve detay görüntüleme
    - İade durumunu güncelleme (onaylama/reddetme)
    - İade kargo takip numarasını güncelleme
- **Müşteri Soruları Yönetimi**:

    - Soruları listeleme ve detay görüntüleme
    - Soruları yanıtlama
    - Soruları eskalasyon yapma/üst kademeye iletme
- **Talep/Şikayet Yönetimi**:

    - Talepleri listeleme ve detay görüntüleme
    - Talep durumunu güncelleme
    - Talebe not ekleme
    - Talebe döküman/delil yükleme
- **Kargo ve Sevkiyat Yönetimi**:

    - Kargo firmalarını listeleme
    - Tedarikçi kargo hesaplarını görüntüleme
    - Sevkiyat çıkışlarını listeleme ve detay görüntüleme
    - Kargo etiketi indirme (tekli ve toplu)
    - Sevkiyat çıkışı oluşturma
    - Teslimat seçeneklerini görüntüleme
- **Kategori ve Marka Yönetimi**:

    - Kategori ve markaları listeleme ve arama
- **Tedarikçi Adresi Yönetimi**:

    - Tedarikçi adreslerini yönetme
- **Genel Özellikler**:

    - API İstek Rate Limiting: API istek sınırlamalarına otomatik uyum sağlama
    - Önbellek Desteği: API yanıtlarını önbelleğe alma özelliği
    - Debug Modu: API isteklerini ve yanıtlarını günlüğe kaydetme özelliği

Hata Yönetimi
-------------

[](#hata-yönetimi)

```
use TrendyolApi\TrendyolSpApi\Exceptions\TrendyolApiException;

try {
    $products = Trendyol::products()->list();
} catch (TrendyolApiException $e) {
    // API hatası işlemleri
    $error_code = $e->getCode();
    $error_message = $e->getMessage();
} catch (\Exception $e) {
    // Diğer hatalar
}
```

Detaylı Kullanım Örnekleri
--------------------------

[](#detaylı-kullanım-örnekleri)

### İade İşlemleri

[](#i̇ade-i̇şlemleri)

```
// İadeleri listeleme
$returns = Trendyol::returns()->list([
    'startDate' => '2023-01-01',
    'endDate' => '2023-12-31',
    'status' => 'PENDING'
]);

// İade detayını görüntüleme
$returnDetail = Trendyol::returns()->get(12345);

// İade durumunu güncelleme (onaylama)
$updateStatus = Trendyol::returns()->updateStatus(12345, 'APPROVED');

// İade durumunu güncelleme (reddetme)
$updateStatus = Trendyol::returns()->updateStatus(12345, 'REJECTED', 'Ürün hasarlı geldi');

// İade kargo takip numarasını güncelleme
$updateTracking = Trendyol::returns()->updateTrackingNumber(12345, '1234567890');
```

### Müşteri Soruları

[](#müşteri-soruları)

```
// Müşteri sorularını listeleme
$questions = Trendyol::customerQuestions()->list([
    'status' => 'WAITING_FOR_ANSWER',
    'startDate' => '2023-01-01',
    'endDate' => '2023-12-31'
]);

// Soru detayını görüntüleme
$questionDetail = Trendyol::customerQuestions()->get(12345);

// Soruyu yanıtlama
$answer = Trendyol::customerQuestions()->answer(12345, 'Ürünümüz 2 yıl garantilidir.');

// Soruyu eskalasyon yapma/üst kademeye iletme
$escalate = Trendyol::customerQuestions()->escalate(12345, 'Teknik bilgi gerektiren bir soru');
```

### Talep/Şikayet İşlemleri

[](#talepşikayet-i̇şlemleri)

```
// Talepleri listeleme
$claims = Trendyol::claims()->list([
    'status' => 'OPEN',
    'startDate' => '2023-01-01',
    'endDate' => '2023-12-31'
]);

// Talep detayını görüntüleme
$claimDetail = Trendyol::claims()->get(12345);

// Talebe not ekleme
$addNote = Trendyol::claims()->addNote(12345, 'Müşteri ile görüşüldü, çözüm sağlandı.');

// Talep durumunu güncelleme
$updateStatus = Trendyol::claims()->updateStatus(12345, 'SOLVED', 'Müşteriye yeni ürün gönderildi');

// Talebe döküman/delil yükleme (Base64 formatında dosya içeriği)
$uploadDocument = Trendyol::claims()->uploadDocument(
    12345,
    base64_encode(file_get_contents('kargo_fisi.pdf')),
    'kargo_fisi.pdf'
);
```

### Kargo ve Sevkiyat İşlemleri

[](#kargo-ve-sevkiyat-i̇şlemleri)

```
// Kargo firmalarını listeleme
$shipmentProviders = Trendyol::shipmentProviders()->list();

// Tedarikçi kargo hesaplarını görüntüleme
$supplierAccounts = Trendyol::shipmentProviders()->getSupplierAccounts();

// Sevkiyat çıkışlarını listeleme
$shipmentOutbounds = Trendyol::shipmentProviders()->getShipmentOutbounds([
    'startDate' => '2023-01-01',
    'endDate' => '2023-12-31'
]);

// Sevkiyat çıkışı detayını görüntüleme
$shipmentOutbound = Trendyol::shipmentProviders()->getShipmentOutbound(12345);

// Teslimat seçeneklerini görüntüleme
$deliveryOptions = Trendyol::shipmentProviders()->getDeliveryOptions();

// Kargo etiketi indirme
$shippingLabel = Trendyol::shipmentProviders()->downloadShippingLabel(12345);

// Toplu kargo etiketi indirme
$bulkShippingLabels = Trendyol::shipmentProviders()->downloadBulkShippingLabel([12345, 67890]);

// Sevkiyat çıkışı oluşturma
$createOutbound = Trendyol::shipmentProviders()->createShipmentOutbound([
    'shipmentProvider' => 'Aras',
    'packageDetails' => [
        // ...
    ]
]);
```

Testler
-------

[](#testler)

Testleri çalıştırmak için:

```
composer test
```

Lisans
------

[](#lisans)

Bu paket MIT lisansı altında lisanslanmıştır.

###  Health Score

31

—

LowBetter than 68% of packages

Maintenance45

Moderate activity, may be stable

Popularity11

Limited adoption so far

Community8

Small or concentrated contributor base

Maturity50

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

Total

2

Last Release

384d ago

### Community

Maintainers

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

---

Top Contributors

[![wiensa](https://avatars.githubusercontent.com/u/155260864?v=4)](https://github.com/wiensa "wiensa (5 commits)")

---

Tags

apilaravelpackagee-commercemarketplaceentegrasyontrendyol

###  Code Quality

TestsPest

Static AnalysisPHPStan, Rector

Code StyleLaravel Pint

Type Coverage Yes

### Embed Badge

![Health badge](/badges/wiensa-trendyol-sp-api/health.svg)

```
[![Health](https://phpackages.com/badges/wiensa-trendyol-sp-api/health.svg)](https://phpackages.com/packages/wiensa-trendyol-sp-api)
```

###  Alternatives

[aimeos/aimeos-laravel

Cloud native, API first Laravel eCommerce package with integrated AI for ultra-fast online shops, marketplaces and complex B2B projects

8.6k214.7k3](/packages/aimeos-aimeos-laravel)[joisarjignesh/bigbluebutton

BigBlueButton Server API Library for Laravel

162145.5k1](/packages/joisarjignesh-bigbluebutton)[bmatovu/laravel-mtn-momo

Laravel MTN MOMO integration.

14310.9k](/packages/bmatovu-laravel-mtn-momo)

PHPackages © 2026

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