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 |