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

ActiveLibrary[API Development](/categories/api)

wiensa/hepsiburada-sp-api
=========================

Hepsiburada Marketplace Satıcı Paneli API entegrasyonu için Laravel paketi

v1.0.3(1y ago)241[1 issues](https://github.com/wiensa/hepsiburada-sp-api/issues)MITPHPPHP ^8.3CI failing

Since Apr 18Pushed 1y ago1 watchersCompare

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

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

Hepsiburada Marketplace API
===========================

[](#hepsiburada-marketplace-api)

Bu Laravel paketi, [Hepsiburada Marketplace API](https://developers.hepsiburada.com/) ile entegrasyon sağlamak için geliştirilmiştir. Paket, Hepsiburada'nın satıcı paneli üzerinden erişilebilen API'leri Laravel uygulamalarınızda kolayca kullanmanızı sağlar.

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

[](#özellikler)

- Kategori bilgilerini sorgulama ve kategori özelliklerini alma
- Ürün bilgilerini gönderme ve sorgulama
- Listing (ürün listeleme) işlemleri
- Sipariş yönetimi
- Talep ve iade yönetimi (Claims)
- Finans ve muhasebe işlemleri
- Raporlama
- Taşıma ve lojistik işlemleri
- Kolay entegrasyon ve kullanım
- Laravel 10+ ve PHP 8.3+ desteği

Kurulum
-------

[](#kurulum)

Composer ile paketi projenize ekleyin:

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

Laravel 10.x ve üzeri için otomatik olarak servis sağlayıcı kaydedilecektir. Laravel 10'dan önceki sürümleri kullanıyorsanız, `config/app.php` dosyasına aşağıdaki servis sağlayıcıyı manuel olarak ekleyin:

```
'providers' => [
    // ...
    HepsiburadaApi\HepsiburadaSpApi\Providers\HepsiburadaApiServiceProvider::class,
],

'aliases' => [
    // ...
    'HepsiburadaApi' => HepsiburadaApi\HepsiburadaSpApi\Facades\HepsiburadaApi::class,
],
```

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

[](#yapılandırma)

Öncelikle yapılandırma dosyasını yayınlayın:

```
php artisan vendor:publish --tag=hepsiburada-api-config
```

Bu komutu çalıştırdıktan sonra, `config/hepsiburada-api.php` dosyası oluşturulacaktır. Burada API için gereken ayarları yapabilirsiniz.

Alternatif olarak, `.env` dosyanıza aşağıdaki değişkenleri ekleyebilirsiniz:

```
HEPSIBURADA_API_BASE_URL=https://marketplace-api.hepsiburada.com
HEPSIBURADA_API_USERNAME=kullanici_adiniz
HEPSIBURADA_API_PASSWORD=sifreniz
HEPSIBURADA_MERCHANT_ID=satici_id

```

Kullanım
--------

[](#kullanım)

### Facade ile Kullanım

[](#facade-ile-kullanım)

```
use HepsiburadaApi;

// Kategorileri listele
$categories = HepsiburadaApi::categories()->getCategories();

// Ürün bilgilerini gönder
$response = HepsiburadaApi::products()->createProduct([
    // Ürün verileri
]);

// Listing bilgilerini al
$listings = HepsiburadaApi::listings()->getListings();

// Sipariş bilgilerini al
$orders = HepsiburadaApi::orders()->getCompletedOrders();
```

### DI Container ile Kullanım

[](#di-container-ile-kullanım)

```
use HepsiburadaApi\HepsiburadaSpApi\HepsiburadaApi;

class ProductController extends Controller
{
    protected $api;

    public function __construct(HepsiburadaApi $api)
    {
        $this->api = $api;
    }

    public function index()
    {
        $products = $this->api->products()->getProductsByStatus('APPROVED');

        return view('products.index', compact('products'));
    }
}
```

Örnekler
--------

[](#örnekler)

### Kategori İşlemleri

[](#kategori-i̇şlemleri)

```
// Tüm kategorileri listele
$categories = HepsiburadaApi::categories()->getCategories();

// Belirli bir kategorinin özelliklerini al
$attributes = HepsiburadaApi::categories()->getCategoryAttributes('category_id');

// Özellik değerlerini al
$attributeValues = HepsiburadaApi::categories()->getAttributeValues('attribute_id');
```

### Ürün İşlemleri

[](#ürün-i̇şlemleri)

```
// Ürün bilgisi gönder
$response = HepsiburadaApi::products()->createProduct([
    'categoryId' => 'kategori_id',
    'merchant' => 'satici_id',
    'attributes' => [
        // Ürün özellikleri
    ],
    'images' => [
        // Ürün görselleri
    ],
    // Diğer ürün bilgileri
]);

// Hızlı ürün yükleme
$response = HepsiburadaApi::products()->quickUpload([
    // Ürün verileri
]);

// Ürün durumunu sorgula
$status = HepsiburadaApi::products()->getProductStatus('barkod');

// Ürün statüsüne göre listele
$products = HepsiburadaApi::products()->getProductsByStatus('APPROVED');
```

### Listing İşlemleri

[](#listing-i̇şlemleri)

```
// Listing bilgilerini sorgula
$listings = HepsiburadaApi::listings()->getListings([
    'page' => 0,
    'size' => 50
]);

// Fiyat güncelle
$response = HepsiburadaApi::listings()->updatePrice([
    'listings' => [
        [
            'listingId' => 'listing_id',
            'price' => 99.99,
            'availableStock' => 10
        ]
    ]
]);

// Stok güncelle
$response = HepsiburadaApi::listings()->updateStock([
    'listings' => [
        [
            'listingId' => 'listing_id',
            'quantity' => 50
        ]
    ]
]);
```

### Sipariş İşlemleri

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

```
// Tamamlanan siparişleri listele
$orders = HepsiburadaApi::orders()->getCompletedOrders([
    'beginDate' => '2023-01-01',
    'endDate' => '2023-12-31'
]);

// İptal edilen siparişleri listele
$cancelledOrders = HepsiburadaApi::orders()->getCancelledOrders();

// Bekleyen siparişleri listele
$pendingOrders = HepsiburadaApi::orders()->getPendingOrders();

// Sipariş detaylarını al
$orderDetails = HepsiburadaApi::orders()->getOrderDetail('siparis_numarasi');

// Siparişi kargoya ver
$response = HepsiburadaApi::orders()->shipOrderItems([
    'merchantId' => 'satici_id',
    'packageNumber' => 'paket_numarasi',
    'shippingCompany' => 'kargo_firmasi',
    'trackingNumber' => 'takip_numarasi'
]);

// Paket içeriklerini hazırlama
$response = HepsiburadaApi::orders()->packageItems([
    'merchantId' => 'satici_id',
    'packageNumber' => 'paket_numarasi',
    'items' => [
        // Paketlenecek ürün kalemleri
    ]
]);
```

### Talep ve İade İşlemleri

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

```
// Tüm talepleri listele
$claims = HepsiburadaApi::claims()->getClaims();

// Talep detayını görüntüle
$claimDetails = HepsiburadaApi::claims()->getClaimDetails('claim_id');

// Talebe yanıt gönder
$response = HepsiburadaApi::claims()->respondToClaim([
    'claimNumber' => 'claim_number',
    'merchantId' => 'merchant_id',
    'responseType' => 'ACCEPT',
    'notes' => 'Talebiniz onaylandı'
]);

// İade taleplerini listele
$returnRequests = HepsiburadaApi::claims()->getReturnRequests();

// İade talebini onayla
$returnApproval = HepsiburadaApi::claims()->approveReturnRequest([
    'returnId' => 'return_id',
    'merchantId' => 'merchant_id'
]);
```

### Finans ve Muhasebe İşlemleri

[](#finans-ve-muhasebe-i̇şlemleri)

```
// İşlem geçmişini listele
$transactions = HepsiburadaApi::finances()->getTransactions([
    'startDate' => '2023-01-01',
    'endDate' => '2023-12-31'
]);

// Ödeme özeti al
$paymentSummary = HepsiburadaApi::finances()->getPaymentSummary();

// Ödeme detayını görüntüle
$paymentDetails = HepsiburadaApi::finances()->getPaymentDetails('payment_id');

// Fatura bilgilerini listele
$invoices = HepsiburadaApi::finances()->getInvoices();

// Komisyon bilgilerini al
$commissions = HepsiburadaApi::finances()->getCommissions();
```

### Raporlama İşlemleri

[](#raporlama-i̇şlemleri)

```
// Satış performans raporu al
$salesReport = HepsiburadaApi::reports()->getSalesPerformance();

// Sipariş raporu al
$orderReport = HepsiburadaApi::reports()->getOrderReport([
    'beginDate' => '2023-01-01',
    'endDate' => '2023-12-31'
]);

// Ürün performans raporu al
$productReport = HepsiburadaApi::reports()->getProductPerformance();

// Stok durumu raporu al
$inventoryReport = HepsiburadaApi::reports()->getInventoryReport();

// Özel rapor oluştur
$customReport = HepsiburadaApi::reports()->createCustomReport([
    'merchantId' => 'merchant_id',
    'reportType' => 'SALES',
    'startDate' => '2023-01-01',
    'endDate' => '2023-12-31',
    'format' => 'CSV'
]);

// Rapor durumunu sorgula
$reportStatus = HepsiburadaApi::reports()->getReportStatus('report_id');

// Rapor indirme bağlantısı al
$downloadLink = HepsiburadaApi::reports()->getReportDownloadLink('report_id');
```

### Taşıma ve Lojistik İşlemleri

[](#taşıma-ve-lojistik-i̇şlemleri)

```
// Kargo şirketlerini listele
$carriers = HepsiburadaApi::logistics()->getCarriers();

// Kargo ücretlerini sorgula
$shippingRates = HepsiburadaApi::logistics()->getShippingRates([
    'shippingCompanyId' => '1'
]);

// Kargo takip bilgilerini güncelle
$trackingUpdate = HepsiburadaApi::logistics()->updateTrackingInfo([
    'packageNumber' => 'package_number',
    'trackingNumber' => 'tracking_number',
    'carrierId' => '1'
]);

// Kargo etiketi oluştur
$shippingLabel = HepsiburadaApi::logistics()->createShippingLabel([
    'merchantId' => 'merchant_id',
    'orderId' => 'order_id',
    'packageNumber' => 'package_number',
    'shippingCompanyId' => 1
]);

// Teslimat bölgesi bilgilerini sorgula
$deliveryZones = HepsiburadaApi::logistics()->getDeliveryZones();
```

Lisans
------

[](#lisans)

Bu paket MIT lisansı altında lisanslanmıştır. Daha fazla bilgi için [LICENSE](LICENSE) dosyasına bakın.

###  Health Score

29

—

LowBetter than 59% of packages

Maintenance37

Infrequent updates — may be unmaintained

Popularity7

Limited adoption so far

Community8

Small or concentrated contributor base

Maturity54

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

Total

3

Last Release

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

---

Tags

apilaravele-commercemarketplaceentegrasyonHepsiburadasatıcı paneli

###  Code Quality

TestsPest

Static AnalysisPHPStan, Rector

Code StyleLaravel Pint

Type Coverage Yes

### Embed Badge

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

```
[![Health](https://phpackages.com/badges/wiensa-hepsiburada-sp-api/health.svg)](https://phpackages.com/packages/wiensa-hepsiburada-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)[smodav/mpesa

M-Pesa API implementation

16363.7k1](/packages/smodav-mpesa)[ardakilic/mutlucell

Mutlucell SMS API wrapper for sending sms text messages for Laravel

457.3k](/packages/ardakilic-mutlucell)[dariusiii/tmdb-laravel

Laravel Package for TMDB ( The Movie Database ) API. Provides easy access to the wtfzdotnet/php-tmdb-api library.

1821.1k](/packages/dariusiii-tmdb-laravel)

PHPackages © 2026

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