POST https://api.n11.com/ms/product/tasks/price-stock-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;
- Fiyat güncellemelerinde listPrice ve salePrice parametreleri birlikte gönderilmelidir.
- listPrice ve salePrice değerlerinde küsurat bilgisi nokta ile ayrılmalıdır. Virgül kullanımı hata alınmasına sebebiyet verecektir.
- listPrice ve salePrice değerlerinde küsurat noktadan sonra 2 hane iletilmelidir. Aksi takdirde isteğiniz FAIL olacaktır.
- Sadece fiyat veya sadece stok güncellemesi yapılacak ise istekte güncellemek istemediğiniz alanları göndermeyebilirsiniz. İstekte mevcut olmayan alanlar için herhangi bir update yapılmayacaktır. Burada dikkat edilmesi gereken nokta fiyat güncellemelerinde listPrice ve salePrice’ın birlikte gönderilmelidir.
- listPrice ve salePrice değerini aynı değer gönderebilirsiniz. listPrice, salePrice’dan yüksek olmalıdır. Aksi takdirde isteğiniz FAIL olacaktır.
| 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 |
| listPrice | Hayır* | Ürün liste fiyatı (Satış fiyatı düşük olunca üstü çizilen fiyat) PSF. | number |
| salePrice | Hayır* | Ürün satış fiyatı TSF. | number |
| quantity | Hayır | Stok miktarı. | integer |
| currencyType | Hayır | Ürün liste fiyatı para birimi. Alınan değerler TL, USD ve EUR olabilir. | text |
| 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 |
Örnek Request
{
"payload": {
"integrator": "Entegratör İsmini yazabilirsiniz",
"skus": [
{
"stockCode": "test_variant_ea1_1",
"listPrice": 2000,
"salePrice": 1600,
"quantity": 2,
"currencyType": "TL"
},
{
"stockCode": "test_variant_ea1_2",
"listPrice": 2200,
"salePrice": 1800,
"quantity": 1,
"currencyType": "TL"
}
]
}
}Örnek Response
{
"id": 1092,
"type": "SKU_UPDATE",
"status": "IN_QUEUE",
"reasons": [
"1 sku işlenmeye alındı."
]
}