PHPackages                             ismail0234/n11-php-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. ismail0234/n11-php-api

ActiveLibrary

ismail0234/n11-php-api
======================

N11 PHP API

v1.1.4(5y ago)672.3k↓16.7%32[5 issues](https://github.com/ismail0234/n11-php-api/issues)[1 PRs](https://github.com/ismail0234/n11-php-api/pulls)MITPHP

Since Jun 28Pushed 1y ago6 watchersCompare

[ Source](https://github.com/ismail0234/n11-php-api)[ Packagist](https://packagist.org/packages/ismail0234/n11-php-api)[ Patreon](https://www.patreon.com/botbenson)[ RSS](/packages/ismail0234-n11-php-api/feed)WikiDiscussions master Synced 1mo ago

READMEChangelog (10)DependenciesVersions (14)Used By (0)

[![Latest Stable Version](https://camo.githubusercontent.com/b2de3686a921fdff318bc0565bf6d314e21ebba1f516a701fdf2d7293515bc61/68747470733a2f2f706f7365722e707567782e6f72672f69736d61696c303233342f6e31312d7068702d6170692f762f737461626c65)](https://packagist.org/packages/ismail0234/n11-php-api)[![Total Downloads](https://camo.githubusercontent.com/5d5288ef0d1cfece63024eb1ccb37fcbfe2a7ca81dfa1f56751501446b00eed3/68747470733a2f2f706f7365722e707567782e6f72672f69736d61696c303233342f6e31312d7068702d6170692f646f776e6c6f616473)](https://packagist.org/packages/ismail0234/n11-php-api)[![License](https://camo.githubusercontent.com/67534c7c606884556e579e3287013997a58e02c178ec2622e7fe0a6d9d9aa89e/68747470733a2f2f706f7365722e707567782e6f72672f69736d61696c303233342f6e31312d7068702d6170692f6c6963656e7365)](https://packagist.org/packages/ismail0234/n11-php-api)

N11 PHP API
===========

[](#n11-php-api)

Bu API n11 için yazılmıştır. N11 için yazılmış olan gelişmiş bir php entegrasyon API'si. Ekstra olarak n11 üzerinde mağazanıza gelen siparişleri websitenize aktaracak bir fonksiyonda mevcuttur.

Bağış Yapın
-----------

[](#bağış-yapın)

Yaptığım işlerden memnun iseniz, daha iyi ve daha çok iş çıkartmam için beni destekleyebilirsiniz;

Katkı Çağrısı (Katkıda Bulunanlar)
----------------------------------

[](#katkı-çağrısı-katkıda-bulunanlar)

Çok fazla vaktim olmadığından N11'in bütün API fonksiyonları tamamlanmamıştır. Eksik fonksiyonları isterseniz tamamlayarak **pull request** gönderebilirsiniz veya istediğiniz fonksiyonun eklenmesi için **issue** açabilirsiniz.

### Change Log

[](#change-log)

- See [ChangeLog](https://github.com/ismail0234/n11-php-api/blob/master/CHANGELOG.md)

### License

[](#license)

- See [ChangeLog](https://github.com/ismail0234/n11-php-api/blob/master/LICENSE)

Hızlı Bakış
-----------

[](#hızlı-bakış)

- [Kurulum](#kurulum)
- [Kullanım](#kullan%C4%B1m)
- [Şehir Servisleri (CityService)](#%C5%9Fehir-servisleri-cityservice)
- [Kargo Şirketi Servisleri (ShipmentCompanyService)](#kargo-%C5%9Firketi-servisleri-shipmentcompanyservice)
- [Kategori Servisi (CategoryService)](#kategori-servisi-categoryservice)
- [Ürün Servisi (ProductService)](#%C3%BCr%C3%BCn-servisi-productservice)
- [Ürün Satış Durumu Servisi (ProductSellingService)](#%C3%BCr%C3%BCn-sat%C4%B1%C5%9F-durumu-servisi-productsellingservice)
- [Ürün Stok Servisi (ProductStockService)](#%C3%BCr%C3%BCn-stok-servisi-productstockservice)
- [Sipariş Servisi (Order Service)](#sipari%C5%9F-servisi-order-service)
- [N11 Sipariş Bildirimi WebHook (N11 Order WebHook Beta)](#n11-sipari%C5%9F-bildirimi-webhook-n11-order-webhook-beta)

Kurulum
-------

[](#kurulum)

Kurulum için composer kullanmanız gerekmektedir. Composer'a sahip değilseniz windows için [Buradan](https://getcomposer.org/) indirebilirsiniz.

```
composer require ismail0234/n11-php-api
```

Kullanım
--------

[](#kullanım)

```
use IS\PazarYeri\N11\N11Client;

include "vendor/autoload.php";

$client = new N11Client();
$client->setApiKey('xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx');
$client->setApiPassword('xxxxxxxxxxxxxxxx');
```

### Şehir Servisleri (CityService)

[](#şehir-servisleri-cityservice)

```
/**
 *
 * @description N11 Üzerindeki bütün şehirlerin listesini döndürür.
 *
 */
$client->city->getCities();

/**
 *
 * @description Şehir hakkında birkaç bilgi döndürür.
 * @param int Şehir Id - Zorunlu
 *
 */
$client->city->getCity(34);

/**
 *
 * @description Plaka kodu verilen şehre ait ilçelerinin listelenmesi için kullanılır.
 * @param int Şehir Id - Zorunlu
 *
 */
$client->city->getDistrict(34);

/**
 *
 * @description İlçe kodu verilen semt/mahallelerin listelenmesi için kullanılır.
 * @param int İlçe Id - Zorunlu
 *
 */
$client->city->getNeighborhoods(22569);
```

### Kargo Şirketi Servisleri (ShipmentCompanyService)

[](#kargo-şirketi-servisleri-shipmentcompanyservice)

```
/**
 *
 * @description N11 Üzerinde tanımlı olan tüm kargo şirketlerini listeler
 *
 */
$client->shipmentcompany->getShipmentCompanies();
```

### Teslimat Şablonu Servisi (ShipmentService)

[](#teslimat-şablonu-servisi-shipmentservice)

```
/**
 *
 * @description Oluşturulan teslimat şablonu bilgilerini listelemek için kullanılan metoddur.
 *
 */
$client->shipment->getShipmentTemplateList();

/**
 *
 * @description Teslimat şablon ismi ile aratılan şablonun bilgilerini döndürür.
 * @param string Şablon Adı - Zorunlu
 *
 */
$client->shipment->getShipmentTemplate('Ücretsiz Kargo');
```

### Kategori Servisi (CategoryService)

[](#kategori-servisi-categoryservice)

```
/**
 *
 * @description N11 üzerinde tanımlanmış tüm üst seviye kategorileri döndürür.
 *
 */
$client->category->getTopLevelCategories();

/**
 *
 * @description İstenilen kategori, üst seviye kategori veya diğer seviye kategorilerden olabilir, bu kategorilere ait olan özelliklerin
 *				ve bu özelliklere ait değerlerin listelenmesi için kullanılan metottur.
 * @param int Kategori Id - Zorunlu
 * @param array Sayfalama - İsteğe Bağlı
 *
 */
$client->category->getCategoryAttributes(1002841, array('currentPage' => 1, 'pageSize' => 20));

/**
 *
 * @description İstenilen kategori, üst seviye kategori veya diğer seviye kategorilerden olabilir,
 * 				bu kategorilere ait olan özelliklerin listelenmesi için kullanılan metoddur.
 * @param int Kategori Id - Zorunlu
 *
 */
$client->category->getCategoryAttributesId(1002841);

/**
 *
 * @description Özelliğe sistemimizde verilen id bilgisini (category.attributeList.attribute.id) girdi vererek,
 *				o özelliğe ait değerleri listeler.
 * @param int Kategori Id - Zorunlu
 * @param array Sayfalama - İsteğe Bağlı
 *
 */
$client->category->getCategoryAttributeValue(354080997, array('currentPage' => 0, 'pageSize' => 20));

/**
 *
 * @description Kodu verilen kategorinin birinci seviye üst kategorilerine ulaşmak için bu metot kullanılmalıdır. İkinci seviye üst
 *				kategorilere ulaşmak için (Örn. “Deri ayakkabı -> Ayakkabı -> Giysi” kategori ağacında “Giysi “ bilgisi)
 *				birinci seviye üst kategorinin (Örn. Ayakkabı) kodu verilerek tekrar servis çağırılmalıdır.
 *
 */
$client->category->getParentCategory(1000717);

/**
 *
 * @description Kodu verilen kategorinin birinci seviye alt kategorilerine ulaşmak için bu metot kullanılmalıdır. İkinci seviye alt
 *				kategorilere ulaşmak için (Örn. “Giysi -> Ayakkabı -> Deri ayakkabı” kategori ağacında “Deri ayakkabı” bilgisi)
 *				birinci Seviye alt kategorinin (Örn. Ayakkabı) kodu verilerek tekrar servis çağırılmalıdır.
 *
 */
$client->category->getSubCategories(1002841);
```

### Ürün Servisi (ProductService)

[](#ürün-servisi-productservice)

```
/**
 *
 * @description N11 ürün ID sini kullanarak sistemde kayıtlı olan ürünün bilgilerini getirir.
 *
 */
$client->product->getProductByProductId(359620750);

/**
 *
 * @description Mağaza ürün kodunu kullanarak sistemde kayıtlı olan ürünün bilgilerini getirir.
 *
 */
$client->product->getProductBySellerCode('IS-20014');

/**
 *
 * @description N11 Üzerindeki ürünleri listelemek için kullanılır.
 * @param array Sayfalama - İsteğe Bağlı
 *
 */
$client->product->getProductList(array('currentPage' => 0, 'pageSize' => 20));

/**
 *
 * @description Mağazaya yeni ürün eklemek için kullanılır.
 * @param array eklenecek ürün bilgileri - Zorunlu
 *
 */
$client->product->SaveProduct(
					array(
						'productSellerCode' => 'TF23094823',
						'title' => 'Mavi Toparlayıcı Efekt Skinny Pantolon',
						'subtitle' => 'Curabitur blandit consequat libero, ac suscipit leo luctusrfggfgf',
						'description' => 'Curabitur blandit consequat libero, ac suscipit leo luctus eget. Etiam condimentum augue at quam sagittis bibendum. Quisque vitae malesuada urna. Proi',
						'domestic' => 'false',
						'category' => array(
							'id' => '1002201'
						),
						'specialProductInfoList' => array(
							'specialProductInfo' => array(
								'key' => '?',
								'value' => '?',
							)
						),
						'price' => '185.00',
						'currencyType' => '1',
						'images' => array(
							'image' => array(
								array(
									'url' => 'https://contents.mediadecathlon.com/p1058366/k20d731c11ef86aad6039daa20fb66dc3/1058366_default.jpg',
									'order' => '1',
								),
								array(
									'url' => 'https://contents.mediadecathlon.com/p1058366/k20d731c11ef86aad6039daa20fb66dc3/1058366_default.jpg',
									'order' => '2',
								),
								array(
									'url' => 'https://contents.mediadecathlon.com/p1058366/k20d731c11ef86aad6039daa20fb66dc3/1058366_default.jpg',
									'order' => '3',
								),
								array(
									'url' => 'https://contents.mediadecathlon.com/p1058366/k20d731c11ef86aad6039daa20fb66dc3/1058366_default.jpg',
									'order' => '4',
								),
								array(
									'url' => 'https://contents.mediadecathlon.com/p1058366/k20d731c11ef86aad6039daa20fb66dc3/1058366_default.jpg',
									'order' => '5',
								),
								array(
									'url' => 'https://contents.mediadecathlon.com/p1058366/k20d731c11ef86aad6039daa20fb66dc3/1058366_default.jpg',
									'order' => '6',
								)
							)
						),
						'approvalStatus' => '1',
						'attribute' => array(),
						'saleStartDate' => '',
						'saleEndDate' => '',
						'productionDate' => '',
						'expirationDate' => '',
						'productCondition' => 1,
						'preparingDay' => 3,
						'discount' => array(
							'startDate' => '',
							'endDate' => '',
							'type' => '',
							'value' => '',
						),
						'shipmentTemplate' => 'termos',
						'stockItems' => array(
							'stockItem' => array(
								array(
									'bundle' => 'false',
									'mpn' => '112',
									'gtin' => '0190198066473',
									'oem' => '',
									'quantity' => '855',
									'n11CatalogId' => '',
									'sellerStockCode' => '112',
									'optionPrice' => '185.00',
									'attributes' => array(
										'attribute' => array(
											array(
												'name' => 'Sezon',
												'value' => '2013 Sonbahar-Kış'
											),
											array(
												'name' => 'Cinsiyet',
												'value' => 'Erkek',
											),
											array(
												'name' => 'Beden',
												'value' => '145',
											),
											array(
												'name' => 'Desen',
												'value' => 'Nakışlı',
											),
											array(
												'name' => 'Ürün_Detayı',
												'value' => 'Kapüşonlu',
											),
											array(
												'name' => 'İçerik',
												'value' => 'Brode,Brokar,İnterlok',
											),
											array(
												'name' => 'Marka',
												'value' => 'Esteem',
											),
											array(
												'name' => 'Renk',
												'value' => 'Gri',
											)
										)
									)
								)
							)
						),
						'unitInfo' => array(
							'unitType' => '',
							'unitWeight' => ''
						),
						'maxPurchaseQuantity' => '122',
						'groupAttribute' => '',
						'groupItemCode' => '',
						'itemName' => ''
					)
				);

/**
 *
 * @description Kayıtlı olan bir ürünü N11 Id si kullanarak silmek için kullanılır.
 * @param int N11 Ürün Id - Zorunlu
 *
 */
$client->product->deleteProductById(1234567890);

/**
 *
 * @description Kayıtlı olan bir ürünü mağaza ürün kodu kullanılarak silmek için kullanılır.
 * @param string N11 Ürünün Mağazadaki Ürün Kodu - Zorunlu
 *
 */
$client->product->deleteProductBySellerCode(1234567890);
```

### Ürün Satış Durumu Servisi (ProductSellingService)

[](#ürün-satış-durumu-servisi-productsellingservice)

```
/**
 *
 * @description Satışta olan ürünün n11 ürün ID si kullanılarak satışa kapatılması için kullanılır.
 * @param int N11 Ürün Id - Zorunlu
 *
 */
$client->selling->stopSellingProductByProductId(1234567890);

/**
 *
 * @description Satışta olmayan bir ürünün N11 ürün ID si kullanılarak satışa başlanması için kullanılır.
 * @param string N11 Ürün Mağaza Id - Zorunlu
 *
 */
$client->selling->startSellingProductBySellerCode('IS-20014');

/**
 *
 * @description Satışta olmayan bir ürünün N11 ürün ID si kullanılarak satışa başlanması için kullanılır.
 * @param int N11 Ürün Id - Zorunlu
 *
 */
$client->selling->startSellingProductByProductId(1234567890);

/**
 *
 * @description Satışta olan ürünün mağaza ürün kodu kullanılarak satışının durdurulması için kullanılır.
 * @param string N11 Ürün Mağaza Id - Zorunlu
 *
 */
$client->selling->stopSellingProductBySellerCode('IS-20014');
```

### Ürün Stok Servisi (ProductStockService)

[](#ürün-stok-servisi-productstockservice)

```
/**
 *
 * @description Sistemde kayıtlı olan ürünün N11 ürün ID si ile ürün stok bilgilerini getiren metottur.
 * 				Cevap içinde stok durumunun “version” bilgisi de vardır, ürün stoklarında değişme olduysa
 *				bu versiyon bilgisi artacaktır, çağrı yapan taraf versiyon bilgisini kontrol ederek N11 e
 *				verilen stok bilgilerinde değişim olup olmadığını anlayabilir.
 * @param int N11 Ürün Id - Zorunlu
 *
 */
$client->stock->getProductStockByProductId(1234567890);
```

### Sipariş Servisi (Order Service)

[](#sipariş-servisi-order-service)

```
/**
 *
 * @description Bu metot sipariş ile ilgili özet bilgileri listelemek için kullanılır.
 * @note İsteğe bağlı olarak dizideki alanların istenilen bölümleri eklenmeyebilir veya dizi hiç gönderilmeyebilir.
 * @param array Arama Sorgusu - İsteğe Bağlı
 *
 */
$client->order->orderList(
	array(
		// Ürün ID Numarası
		'productId'         => 1234567890,
		// Sipariş Durumu   => New, Approved, Rejected, Shipped, Delivered, Completed, Claimed, LATE_SHIPMENT
		'status'            => 'New',
		// Alıcı Adı
		'buyerName'         => 'ismail',
		// Sipariş Numarası
		'orderNumber'       => 1234567890,
		// Ürün Mağaza Kodu
		'productSellerCode' => 'IS-20014',
		// Teslim alacak kişinin adı
		'recipient'         => 'ismail',
		// Sipariş oluşturma tarihi başlangıç
		'period'            => array(
			// Başlangıç Tarihi => d/m/Y H:i:s
			'startDate' => '28/06/2019',
			// Bitiş Tarihi => d/m/Y H:i:s
			'endDate'   => '01/07/2019'
		),
		// Güncellenen Siparişleri Listeler
		'sortForUpdateDate' => false,
		// Sayfalama
		'pagingData' => array(
			// Şuanki Sayfa
			'currentPage' => 0,
			// Gösterilecek nesne
			'pageSize'    => 20
		)

	)
);

/**
 *
 * @description Sipariş N11 ID bilgisi kullanarak sipariş detaylarını almak için kullanılır,
 *				sipariş N11 ID bilgisine orderList metotlarıyla ulaşılabilir.
 * @param int Sipariş ID Numarası - Zorunlu
 *
 */
$client->order->orderDetail(123456789);
```

### N11 Sipariş Bildirimi WebHook (N11 Order WebHook) BETA

[](#n11-sipariş-bildirimi-webhook-n11-order-webhook-beta)

N11 Tarafından sipariş bildirimleri için bir webhook verilmediği için bu işlemi yapmak isteyenler kişiler için yazılmış olan bir webhook dur. Webhook'u kullanabilmeniz için sunucunuzda **sqlite** pdo driver kurulu olması gerekmektedir.

**Not:** Oluşturacağınız bu dosyayı linux tarafında arkaplanda sürekli çalışır halde kalması gerekmektedir. Bunu yapmak için **tmux** veya **servis yazarak** kullanabilirsiniz. **Cronjob ile kullanmayınız!**

***Bu Webhook'un henüz beta aşamasında olduğunu unutmayın!***

```
include "vendor/autoload.php";

use IS\PazarYeri\N11\N11Client;

$client = new N11Client();
$client->setApiKey('xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx');
$client->setApiPassword('xxxxxxxxxxxxxxxx');

/**
 *
 * @description Webhook istek hızı
 * @param string
 * 	  'slow'   => 300 saniye,
 *	  'medium' => 180 saniye (default/taviye edilen),
 * 	  'fast'   => 60 saniye
 * 	  'vfast'  => 30 saniye
 *
 */
$client->webhook->setRequestMode('medium');

/**
 *
 * @description N11 sonuçlarında kaç siparişin getirileceği
 * @param string
 * 	  'vmax'     => 100 adet,
 *	  'max'      => 75 adet,
 * 	  'medium'   => 50 adet (default/taviye edilen),
 * 	  'min'      => 30 adet
 *
 */
$client->webhook->setResultMode('medium');

/**
 *
 * @description Sipariş bildirimlerinde geçmiş siparişler kontrol edilsinmi?
 * @param bool
 * 	  true     => Evet (default/Tavsiye edilen),
 *	  false    => Hayır,
 *
 */
// Uyarı! Bu fonksiyon versiyon 1.1.0'dan itibaren kaldırılmıştır.
// $client->webhook->setOldConsumeMode(true);

/* Anonymous function ile siparişleri almak */
$client->webhook->orderConsume(function($order){

	echo "Sipariş Bilgileri";
	echo "";
	print_r($order);
	echo "";

});

/* Class ile siparişleri almak */

Class N11Orders
{

	public function consume($order)
	{

		echo "Sipariş Bilgileri";
		echo "";
		print_r($order);
		echo "";

	}

}

$client->webhook->orderConsume(array(new N11Orders(), 'consume'));
```

###  Health Score

40

—

FairBetter than 88% of packages

Maintenance26

Infrequent updates — may be unmaintained

Popularity37

Limited adoption so far

Community19

Small or concentrated contributor base

Maturity66

Established project with proven stability

 Bus Factor1

Top contributor holds 71.8% 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 ~53 days

Recently: every ~141 days

Total

12

Last Release

1926d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/51d3e225a57d3d068169049be18ed07aacbc4646cdd58aa70a81b336b09ad503?d=identicon)[ismail02](/maintainers/ismail02)

---

Top Contributors

[![ismail0234](https://avatars.githubusercontent.com/u/20711301?v=4)](https://github.com/ismail0234 "ismail0234 (61 commits)")[![allcontributors[bot]](https://avatars.githubusercontent.com/in/23186?v=4)](https://github.com/allcontributors[bot] "allcontributors[bot] (12 commits)")[![eminks](https://avatars.githubusercontent.com/u/1908412?v=4)](https://github.com/eminks "eminks (11 commits)")[![AygnYldz](https://avatars.githubusercontent.com/u/34922286?v=4)](https://github.com/AygnYldz "AygnYldz (1 commits)")

---

Tags

entegrasyonn11n11-php-apin11-soappazaryeriphp-apiPHP-APIpazaryeriN11eticaretn11 php api

### Embed Badge

![Health badge](/badges/ismail0234-n11-php-api/health.svg)

```
[![Health](https://phpackages.com/badges/ismail0234-n11-php-api/health.svg)](https://phpackages.com/packages/ismail0234-n11-php-api)
```

###  Alternatives

[mevdschee/php-crud-api

Single file PHP script that adds a REST API to a SQL database.

3.7k63.8k9](/packages/mevdschee-php-crud-api)[ismail0234/trendyol-php-api

Trendyol PHP API

1023.2k](/packages/ismail0234-trendyol-php-api)[airmoi/filemaker

Rewritten FileMaker PHP-API

83123.5k3](/packages/airmoi-filemaker)[matatirosoln/filemaker-api

FileMaker PHP API

107.3k1](/packages/matatirosoln-filemaker-api)

PHPackages © 2026

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