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