POST https://api.n11.com/ms/product/tasks/product-create
- 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 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 özellik değeri zorunludur.
- GetCategoryAttributesList servisinden customValue>false dönen özellik için yine aynı servisten dönen valueId değeri ile gönderilmelidir. Bu değerler sadece n11 değerleri kullanılır anlamına gelir. customValue>true döner ise customValue alanına n11 değerlerini gönderebilir veya free değer iletebilirsiniz.
- GetCategoryAttributesList servisinden variant>true döner ise ürünlere aynı productMainId eklendiğinde 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 Bilgilerim alanından 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 |
| attributes.valueId | Evet | Kategori özellik servisindeki CustomValue>false ise valueId yazılmalıdır. | long |
| attributes.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 | 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 |
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ı."
]
}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
}
]
}
}Örnek Response
{
"id": 1900,
"type": "PRODUCT_CREATE",
"status": "IN_QUEUE",
"reasons": [
"4 sku işlenmeye alındı."
]
}