RestAPI Ürün Yükleme
Ürün Yükleme (CreateProduct)
POST https://api.n11.com/ms/product/tasks/product-create
Bu servis kullanılarak ürünlerini yükleyebilirsiniz.
- Authorization no auth seçiniz.
- Headers alanına appkey ve appsecret bilgisini eklemeniz gerekir.
- Tek seferde maximum 1000 sku gönderebilirsiniz.
- İsteğinizi json formatında body de raw olarak ve aşağıdaki örnek desende iletiniz.
- HTTP isteğinizi 'POST' methoduyla ilgili endpoint'e gönderin.
- Servise yapılan her başarılı istek için response’ta ID (taskId) değeri dönmektedir. TaskDetail servisi ile yapılan işlemin kontrolü sağlanabilir.
Dikkat Edilmesi Gerekenler;
- Ürün yüklemeye başlanmadan mapping alanında zorunlu özellikler doldurulmalı ve özelliklerin gönderimi yapılırken customValue alanı kontrol edilmelidir.
- GetCategoryAttributesList servisinden mandatory>true dönen ürün özellik değeri zorunludur.
- 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 ister customValue alanına ister n11 değerlerini gönderebilir veya free değer iletebilirsiniz.
- GetCategoryAttributesList servisinden Variant>true döner ise ürünlere aynı productMainId eklenirse aynı sayfada ürün seçeneği şeklinde gözükür.
- Ürün görsel boyutu maksimum 10 MB ( 10.240 KB ) olmalıdır.
- Buybox ürün yükleme için CreateProduct servisinde gönderilen barcode alanı N11 kataloğundaki bir barkod ile eşleşir ise attribute özelliklerine bakılmaksızın ürün satıcı onayı bekliyor statüsünde açılacaktır.
- Ürün yükleme adımında ürün bazlı shipmentTemplate (kargo şablon adı ) gönderilmelidir.
| Parametre | Parametre Değer | Açıklama | Tip |
| integrator | Evet | API Kullanıcı/Entegratör Firma ismini yazınız.Tüm gönderimlerinizde aynı ismi iletiniz. | string |
| title | Evet | Ürün ismi, Marka-cinsiyet renk veye ürün bilgisini eklerek yazabilirsiniz. | string |
| description | Evet | Ürüne ait açıklamaları ekleyiniz. | HTML-string |
| categoryId | Evet | GetCategories servisinden aldığınız kategorinin en alt kırılım id değerini yazınız | long |
| currencyType | Evet | Fiyatlandırmanızı TL, USD, EUR para birimlerini kullanabilirsiniz.USD ve EUR para birimi Merkez Bankası kur oranına göre güncellenir. | string |
| productMainId | Evet | Ürüne ait tüm modelleri için aynı id yazınız.Varyantlı ürün açmak için Renk ve Beden tüm değeri için aynı değer eklenmelidir. Bu renkleri aynı sayfada toplarken bedenleri varyantlı açılmasını sağlar. | string |
| preparingDay | Evet | Ürünün kargoya verilmesi için gereken süre anlamına gelmektedir. | integer |
| shipmentTemplate | Evet | Hesabım>Teslimat Bilgilerimden oluşturduğunuz kargo şablon ismini yazınız. | string |
| maxPurchaseQuantity | Hayır | Maksimum tekil alıcı başına eklenen satın alım adetidir. | integer |
| stockCode | Evet | Ürüne ait belirlediğiniz uniq değerlerdir.Stok-fiyat güncellemeleriniz stokcode'a göre yapmanız gerekmektedir. Maksimum değeri 255 | string |
| catalogId | Hayır | n11'in katalogundaki id değeridir. | long |
| barcode | Hayır | Gönderim yapılan değeri hata vermeden sadece ulusal barkodları kaydedilir.n11 katalogundaki barkod eşleştirebilmesi için yazılır. | string |
| quantity | Evet | Stok miktarı.Maksimum değer 999.999 | integer |
| images/url/order | Evet | Ürün görsellerine ait URL adresi listesidir.Parametresi ile Görsel url adresleri SSL sertifikalı "https" formatında adresler olmalıdır. Order parametresi ile görsel sırasını yazınız | string |
| attributes | Evet | Ürünün kategori özellik bilgilerini yazınız. Kategori özellik servisindeki Mandatory>true olan değerini yazmak zorunludur. | string |
| attributes.id | Evet | Kategori özellik servisindeki özellik id değerini ekleyiniz. | long |
| valueId | Evet | Kategori özellik servisindeki CustomValue>false ise valueId yazılmalıdır. | long |
| customValue | Evet | Kategori özellik servisindeki CustomValue>true ise free değer yazabilirsiniz. | string |
| salePrice | Evet | Ürün satış fiyatı | amount |
| listPrice | Evet | Ürün liste fiyatı(Satış fiyatı düşük olunca üstü çizilen fiyat) PSF | amount |
| vatRate | Evet | Ürün KDV oranı 0,1,10,20 değerlerini alabilir | integer |
| Parametre (Cevap) | Açıklama | Tip |
| id | Taskdetail'de bu idye göre sorulanmalıdır. | long |
| type | Güncelleme (SKU_UPDATE) veya Yükleme(PRODUCT_CREATE) tasklı olduğu anlaşılır | string |
| status | IN_QUEUE (Task İşleniyor, Taskdetail'den sorgulayınız.) ve REJECT (Task İşlenmemiştir . Reasons alanını kontrol ediniz.) | string |
| reasons | Status bilgisine göre nedenler yazmaktadır. | list of string |
Tekil Ürün Yükleme (Varyantsız)
Örnek Request:
{ "payload": { "integrator": "Entegratör isminizi yazınız", "skus": [ { "title": "Realme C55 8 GB 256 GB (Realme Türkiye Garantili) md0123278", "description": "BB test test", "categoryId": 1000476, "currencyType": "TL", "productMainId": "test1", "preparingDay": 3, "shipmentTemplate": "1", "maxPurchaseQuantity": 5, "stockCode": "md01g4141", "catalogId": null, "barcode": 8806094924862, "quantity": 10, "images": [ { "url": "https://n11scdn.akamaized.net/a1/602_857/15/94/31/26/IMG-4582034240738960980.jpg", "order": 1 }, { "url": "https://images.secretlab.co/theme/common/collab_pokemon_catalog_charizard-min.png", "order": 0 } ], "attributes": [ { "id": 1, "valueId": null, "customValue": "Realme" }, { "id": 911, "valueId":444058, "customValue": "null" }, { "id": 1302, "valueId": 587473, "customValue": "null" }, { "id": 429, "valueId": null, "customValue": "Beyaz" } ], "salePrice": 2000, "listPrice": 2200, "vatRate": 10 } ] } }
Örnek Response:
{ "id": 1092, "type": "PRODUCT_CREATE", "status": "IN_QUEUE", "reasons": [ "1 sku işlenmeye alındı." ] }
Create Product Varyantlı ve Aynı Modele Ait Ürün Yükleme
- GetCategoryAttributesList Servisinden variant true değerli ürünlerde aynı productMainId değeri yüklediğinizde ürün varyantlı açılacaktır
- GetCategoryAttributesList Servisinden slicer true değerli için productMainId değeri yüklediğinizde ürün varyantlı açılacaktır
Örnek Request
{
"payload": {
"integrator": "Entegratör İsmini yazınız ",
"skus": [
{
"title": "Bisiklet Yaka Çicek Desenli Elbise Mavi A11-2",
"description": "B5555544",
"categoryId": 1209218,
"currencyType": "TL",
"productMainId": "1122",
"preparingDay": 3,
"shipmentTemplate": "1",
"maxPurchaseQuantity": 5,
"stockCode": "22211112S",
"catalogId": null,
"barcode": null,
"quantity": 10,
"images": [
{
"url": "https://n11scdn.akamaized.net/a1/602_857/15/94/31/26/IMG-4582034240738960980.jpg",
"order": 0
},
{
"url": "https://images.secretlab.co/theme/common/collab_pokemon_catalog_charizard-min.png",
"order": 1
}
],
"attributes": [
{
"id": 1,
"valueId": null,
"customValue": "Mağaza7"
},
{
"id": 429,
"valueId": null,
"customValue": "Mavi"
},
{
"id": 220,
"valueId": 6397019,
"customValue": "null"
},
{
"id": 1493,
"valueId": 6179186,
"customValue": "null"
},
{
"id": 1272,
"valueId": 6179186,
"customValue": "null"
},
{
"id": 1236,
"valueId": 9619686,
"customValue": "null"
},
{
"id": 6791,
"valueId": 6753182,
"customValue": "null"
},
{
"id": 394,
"valueId": 6753182,
"customValue": "null"
},
{
"id": 5368,
"valueId": 4094199,
"customValue": "null"
},
{
"id": 22,
"valueId": 4093865,
"customValue": "null"
},
{
"id": 1494,
"valueId": 4093868,
"customValue": "null"
}
],
"salePrice": 2000,
"listPrice": 2200,
"vatRate": 10
},
{
"title": "Bisiklet Yaka Çicek Desenli Elbise Mavi A11-2",
"description": "B5555544",
"categoryId": 1209218,
"currencyType": "TL",
"productMainId": "1122",
"preparingDay": 3,
"shipmentTemplate": "1",
"maxPurchaseQuantity": 5,
"stockCode": "22211112M",
"catalogId": null,
"barcode": null,
"quantity": 10,
"images": [
{
"url": "https://n11scdn.akamaized.net/a1/602_857/15/94/31/26/IMG-4582034240738960980.jpg",
"order": 0
},
{
"url": "https://images.secretlab.co/theme/common/collab_pokemon_catalog_charizard-min.png",
"order": 1
}
],
"attributes": [
{
"id": 1,
"valueId": null,
"customValue": "Mağaza7"
},
{
"id": 429,
"valueId": null,
"customValue": "Mavi"
},
{
"id": 220,
"valueId": 6397019,
"customValue": "null"
},
{
"id": 1493,
"valueId": 6179186,
"customValue": "null"
},
{
"id": 1272,
"valueId": 6179186,
"customValue": "null"
},
{
"id": 1236,
"valueId": 9619686,
"customValue": "null"
},
{
"id": 6791,
"valueId": 6753182,
"customValue": "null"
},
{
"id": 394,
"valueId": 6753182,
"customValue": "null"
},
{
"id": 5368,
"valueId": 4094199,
"customValue": "null"
},
{
"id": 22,
"valueId": 4093865,
"customValue": "null"
},
{
"id": 1494,
"valueId": 4093852,
"customValue": "null"
}
],
"salePrice": 2000,
"listPrice": 2200,
"vatRate": 10
},
{
"title": "Bisiklet Yaka Çicek Desenli Elbise Yeşil A11-2",
"description": "B5555544",
"categoryId": 1209218,
"currencyType": "TL",
"productMainId": "1122",
"preparingDay": 3,
"shipmentTemplate": "1",
"maxPurchaseQuantity": 5,
"stockCode": "222111121S",
"catalogId": null,
"barcode": "null",
"quantity": 10,
"images": [
{
"url": "https://n11scdn.akamaized.net/a1/602_857/15/94/31/26/IMG-4582034240738960980.jpg",
"order": 0
},
{
"url": "https://images.secretlab.co/theme/common/collab_pokemon_catalog_charizard-min.png",
"order": 1
}
],
"attributes": [
{
"id": 1,
"valueId": null,
"customValue": "Mağaza7"
},
{
"id": 429,
"valueId": null,
"customValue": "Yeşil"
},
{
"id": 220,
"valueId": 6397019,
"customValue": "null"
},
{
"id": 1493,
"valueId": 6179186,
"customValue": "null"
},
{
"id": 1272,
"valueId": 6179186,
"customValue": "null"
},
{
"id": 1236,
"valueId": 9619686,
"customValue": "null"
},
{
"id": 6791,
"valueId": 6753182,
"customValue": "null"
},
{
"id": 394,
"valueId": 6753182,
"customValue": "null"
},
{
"id": 5368,
"valueId": 4094199,
"customValue": "null"
},
{
"id": 22,
"valueId": 4093865,
"customValue": "null"
},
{
"id": 1494,
"valueId": 4093868,
"customValue": "null"
}
],
"salePrice": 2000,
"listPrice": 2200,
"vatRate": 10
},
{
"title": "Bisiklet Yaka Çicek Desenli Elbise Mavi A11-2",
"description": "B5555544",
"categoryId": 1209218,
"currencyType": "TL",
"productMainId": "1122",
"preparingDay": 3,
"shipmentTemplate": "1",
"maxPurchaseQuantity": 5,
"stockCode": "222111121M",
"catalogId": null,
"barcode": null,
"quantity": 10,
"images": [
{
"url": "https://n11scdn.akamaized.net/a1/602_857/15/94/31/26/IMG-4582034240738960980.jpg",
"order": 0
},
{
"url": "https://images.secretlab.co/theme/common/collab_pokemon_catalog_charizard-min.png",
"order": 1
}
],
"attributes": [
{
"id": 1,
"valueId": null,
"customValue": "Mağaza7"
},
{
"id": 429,
"valueId": null,
"customValue": "Yeşil"
},
{
"id": 220,
"valueId": 6397019,
"customValue": "null"
},
{
"id": 1493,
"valueId": 6179186,
"customValue": "null"
},
{
"id": 1272,
"valueId": 6179186,
"customValue": "null"
},
{
"id": 1236,
"valueId": 9619686,
"customValue": "null"
},
{
"id": 6791,
"valueId": 6753182,
"customValue": "null"
},
{
"id": 394,
"valueId": 6753182,
"customValue": "null"
},
{
"id": 5368,
"valueId": 4094199,
"customValue": "null"
},
{
"id": 22,
"valueId": 4093865,
"customValue": "null"
},
{
"id": 1494,
"valueId": 4093852,
"customValue": "null"
}
],
"salePrice": 2000,
"listPrice": 2200,
"vatRate": 10
}
]
}
}