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 için güncelleme atabilirsiniz.
- İ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;
- 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.
- GetCategoryAttributesList servisinden customValue>true döner ise ister valueId ister customValue değerini free text yazabilirsiniz.
- GetCategoryAttributesList servisinden Slicer>true döner ise ürünlere aynı productMainId eklenirse aynı sayfada ürün görseliyle seçenekli şeklinde gözükür. Bu değeri bilgi amaçlı kullanabilirsiniz.
- 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.
| Parametre(İstek) | Zorunlu | Açıklama | Veri Tipi |
| 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. | |
| 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 |
| attributesid | 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 |
| Parametre(Cevap) | Açıklama | Veri Tipi |
| id | Taskdetail'de bu idye göre sorulanmalıdır. | long |
| type | Güncelleme (SKU_UPDATE) veye 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": null,
"customValue": "256 GB"
},
{
"id": 1302,
"valueId": null,
"customValue": "Test"
},
{
"id": 429,
"valueId": null,
"customValue": "Beyaz"
}
],
"salePrice": 2000,
"listPrice": 2200
}
]
}
}
Örnek Response:
{
"id": 1092,
"type": "SKU_UPDATE",
"status": "IN_QUEUE",
"reasons": [
"1 sku işlenmeye alındı."
]
}
Create Product Varyantlı ve Aynı Modele Ait Ürün Yükleme
- GetCategoryAttributes Servisinden variant true değerli ürünlerde aynı productMainId değeri yüklediğinizde ürün varyantlı açılacaktır
- GetCategoryAttributes 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
},
{
"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
},
{
"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
},
{
"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
}
]
}
}