Invozon × N11

N11, 2013'te Doğuş Grubu ve SK Group ortaklığıyla kurulmuş ve 2022 sonrasında Türk Hava Yolları leyhine yeniden yapılanan büyük ölçekli Türkiye pazaryeridir. Trendyol ve Hepsiburada'ya kıyasla daha dar bir kullanıcı tabanı olmakla birlikte, özellikle elektronik, küçük ev aletleri ve hobi kategorilerinde güçlü bir konumdadır. N11'in geleneksel SOAP/REST karma API yüzeyi 2024-2025'te modernize edildi; bugün satıcıların büyük çoğunluğu yeni JSON REST uç noktalarını kullanmaktadır.

Invozon'un N11 konektörü, eski SOAP servisleriyle yeni REST uç noktalarını arka planda birleştirir; örneğin tek bir Invozon products POST'u, gerektiğinde N11'in yeni product-service'ine düşer ama hâlâ SOAP üzerinde kalan bazı varyant uçları için legacy WSDL'i çağırır. Bu sayede entegrasyonunuz N11'in geçiş döngüsünden etkilenmez.

Bu rehber N11 mağazanızı Invozon'a bağlamak, ana akışları çalıştırmak ve "N11 Pro Mağaza" gibi N11'e özgü kavramları anlamak içindir.

Bağlantı kurma

N11 entegrasyonu için API Key ve API Secret olmak üzere iki bilgiye ihtiyacınız vardır. Auth modeli HMAC tabanlı imzalamadır.

  1. www.n11.com/satici üzerinden N11 Satıcı Merkezi'ne giriş yapın.
  2. Sağ üstte mağaza adınıza tıklayıp Mağaza Bilgilerim → API Entegrasyonu yolunu izleyin.
  3. API Anahtarı Oluştur butonuna basın.
  4. N11 size bir appKey ve appSecret çifti üretir; appSecret yalnızca bir kez gösterilir.
  5. Hesabınızın API erişimi için Onaylı Satıcı statüsünde olması gerekir. Yeni başlayan satıcıların onay süreci 1-2 iş günü sürer.
  6. N11 Pro Mağaza üyeliğiniz varsa "Pro API Hızlandırma" toggle'ını da açın; bu sizin rate-limit kotanızı 2 katına çıkarır.

Invozon Konsolu'nda Settings → Marketplaces → N11 sekmesinde iki değeri girin.

curl -X POST https://api.invozon.com/v1/marketplaces/n11/ping \
  -H "Authorization: Bearer $INVOZON_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "app_key": "abcd1234efgh5678",
    "app_secret": "zxywvu0987654321"
  }'

{
  "status": "connected",
  "store_name": "Örnek Elektronik",
  "is_pro_store": true,
  "checked_at": "2026-06-02T08:14:22Z"
}

Endpoint referansı

Invozon'un N11 uç noktaları /v1/marketplaces/n11/ öneki altındadır.

Ürün listeleme

N11'de ürün açma akışı productSellerCode (sizin SKU'nuz) ve productCode (N11'in atadığı tekil ürün ID'si) ikilisi üzerinden yürür. Yeni bir ürün kategori öznitelikleriyle birlikte tek istekte gönderilir.

curl -X POST https://api.invozon.com/v1/marketplaces/n11/products \
  -H "Authorization: Bearer $INVOZON_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "items": [
      {
        "product_seller_code": "INV-BTSPK-001",
        "title": "Invozon Mini Bluetooth Hoparlör 5W",
        "subtitle": "10 saat pil ömrü, IPX5 su geçirmez",
        "description": "Taşınabilir bluetooth hoparlör, 5W çıkış gücü, IPX5 sertifikalı.",
        "category_id": 1001234,
        "price": 449.90,
        "currency_type": "TL",
        "image_urls": [
          "https://cdn.example.com/btspk-001-1.jpg",
          "https://cdn.example.com/btspk-001-2.jpg"
        ],
        "approval_status": "Active",
        "preparing_day": 2,
        "shipment_template": "STANDART",
        "stock_items": [
          {
            "gtin": "8690000234567",
            "quantity": 50,
            "seller_stock_code": "INV-BTSPK-001-BLK",
            "attributes": [
              { "name": "Renk", "value": "Siyah" },
              { "name": "Garanti Süresi", "value": "24 Ay" }
            ]
          }
        ],
        "attributes": [
          { "name": "Marka", "value": "Invozon" },
          { "name": "Bağlantı", "value": "Bluetooth 5.3" }
        ]
      }
    ]
  }'

{
  "task_id": "n11-task-9c1e4c4e",
  "queued_count": 1,
  "status_url": "/v1/marketplaces/n11/tasks/n11-task-9c1e4c4e"
}

N11'de yeni ürün, içerik moderasyonundan geçmek için 1-12 saat bekler; onay sonrası productCode atanır ve vitrinde görünür.

Stok güncelleme

Stok ve fiyat güncellemesi productSellerCode üzerinden tek istekte yapılır.

curl -X POST https://api.invozon.com/v1/marketplaces/n11/inventory \
  -H "Authorization: Bearer $INVOZON_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "items": [
      {
        "product_seller_code": "INV-BTSPK-001",
        "stock_items": [
          { "seller_stock_code": "INV-BTSPK-001-BLK", "quantity": 38, "price": 419.90 }
        ]
      }
    ]
  }'

{
  "task_id": "n11-inv-3f1a4c4e",
  "accepted": 1
}

Stok güncellemesi vitrine 30 saniye - 2 dakika içinde yansır.

Sipariş alma

N11 siparişleri durum filtresine göre listelenir.

curl "https://api.invozon.com/v1/marketplaces/n11/orders?status=New&start=2026-06-01T00:00:00Z&end=2026-06-02T00:00:00Z&page=1&size=50" \
  -H "Authorization: Bearer $INVOZON_TOKEN"

{
  "page": 1,
  "size": 50,
  "total_pages": 1,
  "orders": [
    {
      "order_number": "402583912",
      "status": "New",
      "created_at": "2026-06-01T18:42:11Z",
      "buyer": {
        "first_name": "Mehmet",
        "last_name": "S.",
        "tax_id": null
      },
      "shipping_address": {
        "city": "Ankara",
        "district": "Çankaya",
        "address": "Kızılay Mah. ... No: 5 D: 10",
        "postal_code": "06420"
      },
      "items": [
        {
          "order_item_id": "OI-1029384",
          "product_seller_code": "INV-BTSPK-001",
          "product_code": "P-734829",
          "quantity": 1,
          "price": 449.90,
          "commission_rate": 12.5,
          "due_amount": 393.66
        }
      ],
      "cargo_company": "Aras Kargo",
      "cargo_tracking_number": null,
      "payment_type": "CreditCard",
      "total_amount": 449.90
    }
  ]
}

Sipariş statüsü güncelleme

N11'in durum makinesi: New → Approved → Shipped → Delivered. İptal için New → Rejected geçişi vardır.

curl -X PATCH https://api.invozon.com/v1/marketplaces/n11/orders/402583912/items/OI-1029384/status \
  -H "Authorization: Bearer $INVOZON_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "status": "Shipped",
    "cargo_tracking_number": "ARS123456789",
    "cargo_company": "Aras Kargo"
  }'

Sipariş kalemini Shipped durumuna geçirmek için kargo takip numarası zorunludur.

Kargo etiketi üretme

N11'in kendi kargo şirketi olmadığı için etiket üretimi anlaşmalı kargonun (Aras, Yurtiçi, MNG, PTT) paneline bağlıdır. Invozon'a bu kargolarla doğrudan entegrasyon kurabilir ve etiketleri tek noktadan alabilirsiniz.

curl https://api.invozon.com/v1/marketplaces/n11/orders/402583912/label \
  -H "Authorization: Bearer $INVOZON_TOKEN" \
  -H "Accept: application/pdf" \
  -o n11-etiket-402583912.pdf

Bu uç nokta, Invozon'a kayıtlı kargo entegrasyonunuzu kullanarak etiketi üretir. Kargo entegrasyonu yoksa 404 döner ve kargonuzun panelinden etiket almanız gerekir.

İade akışı

N11 iadeleri claim olarak adlandırılır.

curl "https://api.invozon.com/v1/marketplaces/n11/claims?status=Open&start=2026-05-25T00:00:00Z&end=2026-06-02T00:00:00Z" \
  -H "Authorization: Bearer $INVOZON_TOKEN"

{
  "claims": [
    {
      "claim_id": "CL-77231",
      "order_number": "402583912",
      "order_item_id": "OI-1029384",
      "reason": "URUN_ARIZALI",
      "status": "Open",
      "customer_note": "Açıldığında çalışmadı.",
      "request_date": "2026-06-02T06:12:55Z"
    }
  ]
}

İadeyi onaylamak/reddetmek:

curl -X PATCH https://api.invozon.com/v1/marketplaces/n11/claims/CL-77231 \
  -H "Authorization: Bearer $INVOZON_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "decision": "approve",
    "refund_amount": 449.90,
    "note": "Müşteri haklı, iade kabul edildi."
  }'

Kategori öznitelik şeması

N11'de bir kategorinin zorunlu/opsiyonel özniteliklerini listelemek için:

curl https://api.invozon.com/v1/marketplaces/n11/categories/1001234/attributes \
  -H "Authorization: Bearer $INVOZON_TOKEN"

{
  "category_id": 1001234,
  "category_name": "Bluetooth Hoparlör",
  "attributes": [
    { "name": "Marka",          "mandatory": true,  "multivalue": false, "values": ["Invozon", "JBL", "Sony", "Anker", "..."] },
    { "name": "Renk",           "mandatory": true,  "multivalue": false, "values": ["Siyah", "Beyaz", "Mavi", "Kırmızı"] },
    { "name": "Bağlantı",       "mandatory": false, "multivalue": true,  "values": ["Bluetooth 5.0", "Bluetooth 5.3", "AUX", "USB-C"] },
    { "name": "Garanti Süresi", "mandatory": true,  "multivalue": false, "values": ["12 Ay", "24 Ay", "36 Ay"] }
  ]
}

Pazaryeri-spesifik notlar

N11 Pro Mağaza farkı. N11 Pro Mağazaları, performans skoru yüksek satıcılara verilen bir statüdür. Pro Mağazalar Vitrin Önceliği, kampanyalara otomatik dahil olma ve API rate-limit tavanının iki katına çıkması gibi avantajlardan faydalanır. Invozon is_pro_store: true döndüğünde batch boyutlarını ve poll sıklığını otomatik olarak iki katına yükseltir.

GTIN doğrulama. N11, marka tescili olan kategorilerde (elektronik, kozmetik, gıda) GTIN/barkod zorunlu tutar ve GS1 veritabanı üzerinden doğrular. Geçersiz GTIN ile gönderilen ürünler INVALID_GTIN hatasıyla reddedilir. Kendi markanız için GS1 Türkiye'den barkod almanız gerekir; rastgele EAN-13 üretmeyin.

Kategori değişikliği. N11 kategori değişikliğine API üzerinden izin verir ama "geri dönüşü olmayan" bir işlemdir: ürün eski kategorinin yorumlarını korur, ama eski satış geçmişi yeni kategorinin "Çok Satanlar" sıralamasına yansımaz. Bu yüzden Invozon PATCH /v1/marketplaces/n11/products/{seller_code}/category çağrısı confirm: true parametresi olmadan reddedilir.

Subtitle alanı. N11'in az bilinen ama önemli alanlarından biri subtitle'dır — ürün başlığının altında SEO ve dönüşüm için kullanılan ikincil bir metin satırı. Bu alan Trendyol ve HB'de yoktur. Boş bırakmak yerine ürünün ana faydasını yazmanız önerilir.

Kampanya yapısı. N11'in Süper Fırsat Cuması, Vitrin Kampanyaları, Marka Vitrin ve Pro Vitrin olmak üzere birkaç kampanya tipi vardır. Pro Vitrin yalnızca Pro Mağazalara açıktır.

Komisyon yapısı. N11 komisyonu kategoriye göre %5-18 arasında değişir. Pro Mağazalar için kategoriye bağlı 0.5-2 puanlık komisyon indirimi mevcuttur. İşlem başına ek hizmet bedeli yoktur (HB'nin aksine).

Sınırlamalar

  • N11 API'si appKey başına dakikada ~200 istek tavanı uygular; Pro Mağazada bu tavan ~400'e çıkar.
  • Ürün başlığı en fazla 80 karakter, açıklama en fazla 20.000 karakter (HTML kabul edilir, sınırlı tag set'i).
  • Görsel sayısı en fazla 8, minimum 600×600 piksel.
  • Tek istekte en fazla 100 SKU stok/fiyat güncellenebilir; Invozon büyük güncellemeleri otomatik böler.
  • N11'in eski SOAP servislerinde varyantsız ürün güncellemesi hâlâ yavaştır (5-15 sn yanıt süresi); Invozon bu çağrıları async kuyruğa alır.
  • N11 sandbox sunmuyor; testler production'da küçük SKU'larla yapılır.
  • Satıcı paneli üzerinden yapılan manuel kampanya katılımları API'ye anlık yansımayabilir, 10-15 dakika gecikme olabilir.

Sık Sorulan Sorular

Pro Mağaza olmak için ne gerekiyor? N11 Pro Mağaza için son 3 ayda en az 50 sipariş, %95+ olumlu satıcı puanı ve %2'nin altında iade oranı şartı vardır. Bu kriterleri sağlayan satıcılar otomatik olarak Pro statüsüne yükseltilir.

GTIN bulamıyorum, ne yapmalıyım? Kendi markanızı satıyorsanız GS1 Türkiye'den (gs1tr.org) barkod alıp tüm ürünlerinize atayabilirsiniz. Bir GS1 üyeliği yıllık ~3.000 TL'dir ve 1000 ürüne kadar barkod hakkı verir. Distribütör iseniz markanın yetkili distribütör belgesini sunarak üreticinin GTIN'lerini kullanabilirsiniz.

Ürün açıklamasında hangi HTML etiketlerine izin var? p, br, ul, ol, li, strong, em, h2, h3, table, tr, td, th etiketlerine izin verilir. img, script, iframe, style yasaktır.

N11'de sipariş aldıktan sonra kaç gün içinde kargoya vermeliyim? Varsayılan olarak preparing_day alanında bildirdiğiniz süre (1-5 gün) içinde kargolama yapmalısınız. Bu süreyi aşan kalemler LATE_SHIPMENT olarak işaretlenir ve satıcı puanınızı düşürür.

Aynı barkodu iki kez yüklersem ne olur? N11 GTIN tekilliğini katı uygular: aynı gtin zaten başka bir satıcıda varsa, sizin ürününüz aynı vitrin sayfasına bağlanır (çoklu satıcı modu). Aynı satıcıda zaten varsa hata döner.

Sandbox yok, test nasıl yaparım? Pratikte satıcılar 1-2 düşük fiyatlı, stoğu az tutulan "test SKU" ile production'da uçtan uca akış denerler. Invozon Konsolu'nda dry_run: true modu, gerçek N11 çağrısı yapmadan istek payload'unu görmenize izin verir.

Resmî dokümantasyon: https://api.n11.com/ws