RestAPI Ürün Bilgileri Güncelleme Servisi

Ürün Güncelleme

Bu sayfada temel ürün bilgileri, ürün güvenliği bilgileri ve besin değerleri özelliklerinin güncelleme bilgilerine ulaşabilirsiniz. 

Servise yapılan her başarılı istek için response’ta ID (taskId) değeri dönmektedir. TaskDetails servisi üzerinden yapılan işlemin kontrolü sağlanabilir.


Ürün Bilgisi Güncelleme (UpdateProduct)

POST https://api.n11.com/ms/product/tasks/product-update

Bu servisi kullanarak ürün bilgilerinizi güncelleyebilirsiniz.

  • Authorization no auth seçiniz.
  • Headers alanına appkey ve appsecret bilgisini eklemeniz gerekir.
  • Tek seferde maximum 1000 sku için güncelleme atabilirsiniz.
  • İsteğinizi json formatında body de raw olarak iletmeniz gerekir.
  • HTTP isteğinizi 'POST' methoduyla ilgili endpoint'e gönderin.
  • JSON dosyanızı iletilen örnek desen formatında hazırlayın.
     

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.) 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.

 

Ö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
                    }
                ]
            }
        ]
    }
}
    

Parametre Zorunluluk Açıklama Tip
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. long
     valueId *Hayır Kategori özellik servisindeki CustomValue>false ise valueId yazılmalıdır. long
     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.

Ü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