README

Laravel için N11 Seller Partner API entegrasyonu.

N11 platformu ile entegrasyon sağlayarak, ürün yönetimi, sipariş takibi, kategori listeleme ve daha fazla işlemi programatik olarak gerçekleştirmenize olanak tanıyan bir Laravel paketidir.

Özellikler

N11 API ile kolay entegrasyon
Kategorileri listeleme ve yönetme
Ürünleri sorgulama, ekleme, güncelleme ve silme
Siparişleri listeleme ve yönetme
Şehir ve ilçe bilgilerini sorgulama
Kargo şirketleri ve şablonlarını yönetme
Ürün stok ve satış durumlarını yönetme

Kurulum

Composer aracılığıyla paketi projenize ekleyin:

composer require wiensa/n11-sp-api

Paketi yükledikten sonra, N11 API yapılandırma dosyasını yayınlayın:

php artisan vendor:publish --provider="N11Api\N11SpApi\N11SpApiServiceProvider" --tag="config"

Bu komut, config/n11-sp-api.php yapılandırma dosyasını projenize ekleyecektir.

Yapılandırma

.env dosyanıza N11 API anahtarlarınızı ekleyin:

N11_APP_KEY=your-app-key
N11_APP_SECRET=your-app-secret

Bu anahtarları N11 Seller Partner API panelinden alabilirsiniz.

Kullanım

Facade ile Kullanım

use N11Api\N11SpApi\Facades\N11;

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

// Ürün bilgilerini getir
$product = N11::products()->getProductById(123456);

// Siparişleri listele
$orders = N11::orders()->getOrders([
    'status' => 'New',
    'period' => [
        'startDate' => '01/01/2023',
        'endDate' => '31/12/2023'
    ]
]);

Dependency Injection ile Kullanım

use N11Api\N11SpApi\N11Api;

class ProductController extends Controller
{
    protected N11Api $n11;
    
    public function __construct(N11Api $n11)
    {
        $this->n11 = $n11;
    }
    
    public function getProducts()
    {
        $products = $this->n11->products()->getProducts([
            'currentPage' => 0,
            'pageSize' => 20
        ]);
        
        return $products;
    }
}

Servisler

Paket, N11 API'sine erişmek için aşağıdaki servisleri içerir:

CategoryService: Kategori işlemleri ($n11->categories())
CityService: Şehir ve ilçe işlemleri ($n11->cities())
OrderService: Sipariş işlemleri ($n11->orders())
ProductService: Ürün işlemleri ($n11->products())
ShipmentService: Teslimat şablonu işlemleri ($n11->shipments())
ShipmentCompanyService: Kargo şirketi işlemleri ($n11->shipmentCompanies())
ProductSellingService: Ürün satış durumu işlemleri ($n11->productSellings())
ProductStockService: Ürün stok işlemleri ($n11->productStocks())

Her servis, ilgili N11 API metodlarını içerir ve belgeli metodlarla kolay kullanım sağlar.

Örnek Uygulamalar

Kategori Listeleme

// Tüm kategorileri getir
$categories = N11::categories()->getCategories();

// Kategori detaylarını döngü ile işle
foreach ($categories as $category) {
    echo "Kategori ID: " . $category->id . "\n";
    echo "Kategori Adı: " . $category->name . "\n";
    
    // Alt kategorileri getir
    $subCategories = N11::categories()->getSubCategories($category->id);
    
    // Alt kategorileri işle
    foreach ($subCategories as $subCategory) {
        echo "  Alt Kategori ID: " . $subCategory->id . "\n";
        echo "  Alt Kategori Adı: " . $subCategory->name . "\n";
    }
}

Ürün Ekleme

$product = [
    'productSellerCode' => 'PRD-123456',
    'title' => 'Örnek Ürün',
    'subtitle' => 'Örnek Alt Başlık',
    'description' => 'Ürün açıklama metni',
    'category' => [
        'id' => 1000123
    ],
    'price' => 99.90,
    'currencyType' => 'TL',
    'images' => [
        'image' => [
            [
                'url' => 'https://example.com/image1.jpg',
                'order' => 1
            ],
            [
                'url' => 'https://example.com/image2.jpg',
                'order' => 2
            ]
        ]
    ],
    'stockItems' => [
        'stockItem' => [
            [
                'quantity' => 10,
                'sellerStockCode' => 'STK-123456'
            ]
        ]
    ],
    'shipmentTemplate' => 'Standart Teslimat'
];

$result = N11::products()->createProduct($product);

Siparişleri Listeleme

$orders = N11::orders()->getOrders([
    'status' => 'New', // New, Approved, Rejected, Shipped, Delivered, Completed
    'period' => [
        'startDate' => '01/01/2023',
        'endDate' => '31/12/2023'
    ],
    'pagingData' => [
        'currentPage' => 0,
        'pageSize' => 20
    ]
]);

// Siparişleri işle
foreach ($orders->orderList->order as $order) {
    echo "Sipariş ID: " . $order->id . "\n";
    echo "Sipariş Numarası: " . $order->orderNumber . "\n";
    echo "Alıcı: " . $order->buyer->fullName . "\n";
    
    // Sipariş detayını getir
    $orderDetail = N11::orders()->getOrderDetail($order->id);
    
    // Sipariş kalemlerini işle
    foreach ($orderDetail->orderItems as $item) {
        echo "  Ürün: " . $item->productName . "\n";
        echo "  Adet: " . $item->quantity . "\n";
        echo "  Fiyat: " . $item->price . "\n";
    }
}

Ürün Stok Yönetimi

// Ürün stoğunu sorgula
$stockInfo = N11::productStocks()->getProductStockByProductId(123456);

// Stok güncelle
$stockParams = [
    'items' => [
        [
            'productId' => 123456,
            'quantity' => 100,
            'version' => $stockInfo->version
        ]
    ]
];

$result = N11::productStocks()->updateProductStock($stockParams);

Ürün Satış Durum Yönetimi

// Ürünü satışa kapat
$result = N11::productSellings()->stopSellingProductByProductId(123456);

// Ürünü satışa aç
$result = N11::productSellings()->startSellingProductByProductId(123456);

Sürüm Değişiklikleri

1.x

N11Api sınıfı ve namespace güncellemeleri
Servis metot adları güncellendi (çoğul yapıldı: categories(), cities(), vb.)
Daha tutarlı bir API arayüzü eklendi
PHP 8.3 desteği eklendi

Lisans

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

wiensa / n11-sp-api

Maintainers

Details