• Change Log
  • API Dokümantasyonu
  • Mağaza Destek Merkezi
  • Satıcı Paneli
  • Change Log
  • API Dokümantasyonu
  • Mağaza Destek Merkezi
  • Satıcı Paneli
  • Change Log
    • n11 Ürün Entegrasyonu
      • Kategori Ağacı Listeleme
      • Kategori Özellikleri Listeleme
      • Ürün Yükleme
      • Ürün Bilgisi Güncelleme
      • Ürün Fiyat-Stok Güncelleme
      • Ürün Soru-Cevap Servisi
      • Ürün Silme
      • Task Detail Sorgulama
      • Satıcı Ürün Sorgulama
      • Katalog Servisi ve Hızlı Ürün Yükleme
    • n11 Sipariş Entegrasyonu
      • Sipariş Listeleme Servisi
      • Sipariş Kalemlerini Güncelleme
      • Toplama Talebi Oluşturma
      • Sipariş Paket Bölme
      • Miktar Bazlı Paket Bölme & Sipariş Ürün İptali
      • Fatura Linki Gönderme
      • Sipariş Kalemine İşçilik Bedeli Gönderme
    • İade/İptal Entegrasyonu
      • İade Talepleri Servisi
      • Parçalı İptal Talebi
    • Bilgilendirmeler
      • API Hata Mesajları ve Açıklamaları
      • SOAP-Rest API Sipariş Listeleme Servisi Karşılaştırması
    • n11faturam
      • n11faturam E-Fatura Link Oluşturma
    • Mikro İhracat
      • Micro İhracat

    Ürün Bilgisi Güncelleme

    728 görünüm 4

    Yazar n11 Developer
    24 Aralık 2015
    POST https://api.n11.com/ms/product/tasks/product-update
    • Authorization no auth seçiniz.
    • Headers alanına appKey ve appSecret bilgisini eklemeniz gerekir.
    • HTTP isteğinizi POST methoduyla ilgili endpoint’e gönderin.
    • İsteğinizi JSON formatında body de raw olarak aşağıdaki örnek desende iletiniz.
    • Tek seferde maximum 1000 sku gönderebilirsiniz.
    • Servise yapılan her başarılı istek için response’ta ID (taskId) değeri dönmektedir. TaskDetails servisi ile yapılan işlemin kontrolü sağlanabilir.

    Dikkat Edilmesi Gerekenler;

    • Ürün gruplaması yapmak için productMainId değeri iletilmelidir, bu parametreden gönderilen değer ile güncelleme sağlayabilirsiniz.
    • productMainId değeri silinmek isteniyorsa deleteProductMainId değeri True aktarılmalıdır, False gönderildiği durumda silinmeyecektir.
    • Ürün maximum satış adedi maxPurchaseQuantity parametresi ile iletilmelidir, bu parametreden gönderilen değer ile güncelleme sağlayabilirsiniz.
    • Ürün maximum satış adedi değerinin silinmesi için deleteMaxPurchaseQuantity parametresi True aktarılmalıdır, False gönderildiği durumda silinmeyecektir. True gönderildiği durumda satın alım adet sınırı olmadığı kabul edilecektir.
    • Stok kodu bazında attributes alanında güncellenecek ürün güvenliği attribute değerlerini göndermeniz gerekir, ürün temel özellikleri (Marka, Renk, Beden vb.) yalnızca n11 tarafından güncellenebilmektedir.
      Güncelleme yapılacak attribute bilgilerine CategoryAttributesList servisimizden ve aşağıda yer alan “Ürün Güvenliği Bilgileri ve Besin Değerleri” tablosundan ulaşabilirsiniz.
    • GetCategoryAttributesList servisinden customValue>false dönen ürün özelliği için yine aynı servisten dönen valueId değeri ile yazılmalıdır. Bu değerler sadece n11 değerleri kullanılır anlamına gelir. customValue>true döner ise free değer iletebilirsiniz.
    Request Parametre Zorunluluk Açıklama Veri Tipi
    integrator Evet Entegratör ve API kullanıcısının verilebilecek özel ismi. Tüm gönderimlerinizde aynı değer kullanmanızı rica ederiz. string
    stockCode Evet Tedarikçinin ürüne belirlediği uniq kod. Ürünler (SKU) ile ilgili güncellemeleri bu değeri zorunlu olarak göndermelisiniz. string
    status Hayır Ürünün satışta olup olmadığını belirtir. Satışta olması isteniyorsa “Active” yazılır, ürünü satıştan çekmek için “Suspended” yazılır. string
    preparingDay Hayır Ürün bazlı kargoya gönderim süresini belirtir. 0’dan büyük bir değer girilmelidir. integer
    shipmentTemplate Hayır Satıcı Panelinde Hesabım > Teslimat Bilgileri alanından oluşturulan “Şablon Adı” başlığında belirtilen değeri yazabilirsiniz. string
    deleteProductMainId Hayır Ana ürün kodunu (productMainId ) silmek isterseniz “True” değerini ekleyiniz. Alabildiği değerler: True, False boolean
    productMainId Hayır Ana ürün kodudur. Aynı modele ait ürün özelliklerini birleştirir. string
    deleteMaxPurchaseQuantity Hayır Maksimum satın alım değerini (maxPurchaseQuantity) silmek isterseniz “True” değerini ekleyiniz. Alabildiği değerler: True, False boolean
    maxPurchaseQuantity Hayır Ürüne toplu alışveriş yapılmaması isteniyorsa, ürün bazlı maksimum kaç adet satın alınabileceğini belirtir. integer
    description Hayır Ürün açıklaması string
    vatRate Hayır Ürün KDV oranı 0,1,10,20 değerlerini alabilir integer
    attributes Hayır Ürünün kategori özellik bilgilerini yazınız. Kategori özellik servisindeki Mandatory>true olan değerini yazmak zorunludur. string
    id *Hayır Kategori özellik servisindeki özellik id değerini ekleyiniz. string
    valueId *Hayır Kategori özellik servisindeki CustomValue>false ise valueId yazılmalıdır. string
    customValue *Hayır Kategori özellik servisindeki CustomValue>true ise free değer yazabilirsiniz. string

    *attributes alanı gönderildiği durumda id, valueId ve customValue alanları zorunludur.

    Parametre (Cevap) Açıklama Tip
    id TaskDetails‘de bu idye göre sorulanmalıdır. long
    type SKU_UPDATE (Stok Fiyat Güncelleme)
    PRODUCT_UPDATE (Ürün Güncelleme)
    PRODUCT_CREATE (Ürün Yükleme)
    PRODUCT_DELETE (Ürün Silme)
    string
    status IN_QUEUE (Task İşleniyor, TaskDetails’den sorgulayınız.)
    REJECT (Task İşlenmemiştir, reasons alanını kontrol ediniz.)
    string
    reasons Status bilgisine göre nedenler yazmaktadır. Task işleme alındığında “X sku işlenmeye alındı.” dönecektir (X=Task ürün sayısı). list of string

    *attributes alanı gönderildiği durumda id, valueId ve customValue alanları zorunludur.

    Örnek Request
    {
        "payload": {
            "integrator": "Entegratör İsmini yazabilirsiniz",
            "skus": [
                {
                    "stockCode": "xyz-1",
                    "status": "Active",
                    "preparingDay": 3,
                    "shipmentTemplate": "STANDART",
                    "deleteProductMainId": true,
                    "productMainId": "ea_v_xyz",
                    "deleteMaxPurchaseQuantity": false,
                    "maxPurchaseQuantity": 3,
                    "description": "Test Ürün Açıklaması",
                    "vatRate": 10,
                    "attributes": [
                        {
                            "id": 1000000,
                            "valueId": null,
                            "customValue": "Test Mağazacılık A.Ş."
                        },
                        {
                            "id": 1000004,
                            "valueId": 2000001,
                            "customValue": null
                        }
                    ]
                }
            ]
        }
    }
    Örnek Response
    {
      "id": 2017,
      "type": "PRODUCT_UPDATE",
      "status": "IN_QUEUE",
      "reasons": [
        "1 sku işlenmeye alındı."
      ]
    }
    Ürün Güvenliği Bilgileri ve Besin Değerleri
    attributeId attributeName
    1000000 Kayıtlı Ticari Unvan
    1000002 İletişim Adresi
    1000003 E-posta
    1000004 Menşei
    1000005 Sağlayıcı Tipi
    1000006 Ürün Güvenliği Görseli 1
    1000007 Ürün Güvenliği Görseli 2
    1000008 Ürün Güvenliği Görseli 3
    1000009 Ürün Güvenliği Görseli 4
    1000010 Ürün Güvenliği Görseli 5
    1000011 Ürün Güvenliği Görseli 6
    1000012 Ürün Güvenliği Görseli 7
    1000013 Ürün Güvenliği Görseli 8
    1000014 Ürün Güvenliği Dökümanı 1
    1000015 Ürün Güvenliği Dökümanı 2
    1000016 Ürün Güvenliği Dökümanı 3
    1000017 Kullanım Talimatı
    1000018 Materyal Bileşeni
    1000019 Bakım Talimatı
    1000020 CE Uygunluk Sembolü
    1000021 Yıkama Talimatı
    1000022 Ürün Uyarı Sembolleri
    1000023 Ürün Güvenliği Uyarıları
    1000024 Alerjen Uyarısı
    1000025 Muhafaza Koşulları
    1000026 Kullanım Önerileri
    1000027 İçindekiler
    1000028 Son Tüketim Tarihi
    1000029 Tavsiye Edilen Tüketim Tarihi
    1000030 Tamir Edilebilirlik
    1000031 İçerik Listesi
    1000001 Marka (Ürün Güvenliği)
    2000202 Enerji (kcal)
    2000203 Enerji (kJ)
    2000204 Yağ (g)
    2000205 Doymuş yağ (g)
    2000206 Trans yağ (g)
    2000207 Tekli doymamış yağ (g)
    2000208 Çoklu doymamış yağ (g)
    2000209 Kolesterol (mg)
    2000210 Karbonhidrat (g)
    2000211 Şeker (g)
    2000212 Şeker Alkolü (g)
    2000213 Nişasta (g)
    2000214 Lif (g)
    2000215 Protein (g)
    2000216 Tuz (g)
    2000217 Sodyum (g)
    2000218 Vitamin A (µg)
    2000219 Vitamin D (µg)
    2000220 Vitamin E (mg)
    2000221 Vitamin K (µg)
    2000222 Vitamin C (mg)
    2000223 Tiamin (mg)
    2000224 Riboflavin (mg)
    2000225 Niacin (mg)
    2000226 Vitamin B6 (mg)
    2000227 Folik asit (µg)
    2000228 Vitamin B12 (µg)
    2000229 Biotin (µg)
    2000230 Pantotenik Asit (mg)
    2000231 Potasyum (mg)
    2000232 Klorur (mg)
    2000233 Kalsiyum (mg)
    2000234 Fosfor (mg)
    2000235 Magnezyum (mg)
    2000236 Demir (mg)
    2000237 Çinko (mg)
    2000238 Bakır (mg)
    2000239 Manganez (mg)
    2000240 Florur (mg)
    2000241 Selenyum (µg)
    2000242 Krom (µg)
    2000243 Molibden (µg)
    2000244 İyot (µg)
    2000245 Alkol Derecesi

    Bu yararlı oldu mu?

    4 Evet  1 Hayır
    Related Articles
    • Micro İhracat
    • Mikro İhracat
    • n11faturam E-Fatura Link Oluşturma
    • n11faturam
    • Katalog Servisi ve Hızlı Ürün Yükleme
    • Toplama Talebi Oluşturma
    Geri
    Ürün Yükleme
    İleri
    Ürün Fiyat-Stok Güncelleme
    © Telif Hakkı 2026 n11.com. Tüm Hakları Saklıdır.