Ürün Ekleme (create)
Bu API isteği, bir tedarikçinin yeni bir ürünü tek tek oluşturmasını sağlar. Her istekle yalnızca bir ürün oluşturulur. İsteğin gövdesinde belirli ürün özellikleri ve detayları bulunur.
POST createProducts (Tekli Örnek)
https://api.pempati.com/api/{vendorId}/product/create
Parametre Açıklamaları
| Parametre | Açıklama | Veri Tipi |
|---|---|---|
| categoryId | categoryId bilgisinin Kategori bilgilerini çekeceğiniz servise Kategori Listesi'nden ulaşabilirsiniz | int |
| subCategoryId | subCategoryId bilgisinin Kategori bilgilerini çekeceğiniz servise Kategori Listesi'nden ulaşabilirsiniz | int |
| brandId | brandId bilgisinin Marka bilgilerini çekeceğiniz servise Marka Listesi'nden ulaşabilirsiniz. | string |
| brand | brand bilgisinin Marka bilgilerini çekeceğiniz servise Marka Listesi'nden ulaşabilirsiniz. | string |
| name | Ürünün adı. | string |
| shortDescription | Ürünün kısa açıklaması. | string |
| longDescription | Ürünün uzun açıklaması. | string |
| stockCode | Ürünün stok kodu. | string |
| barcode | Özel karakter olarak yalnızca "." nokta , "-" tire , "_" alt tire kullanılabilir. Barkodunuzun ortasında boşluk varsa birleştirilerek içeri alınır. | string |
| model | Ürünün modeli. | string |
| dimensionalWeight | Desi miktarı | number |
| cargoCompany | Ürünün kargo firması. | string |
| kdv | Ürün KDV oranı 0, 1, 10, 20 gibi olmalı | number |
| mrpPrice | Ürün liste fiyatı (Satış fiyatı düşük olunca üstü çizilen fiyat) PSF | number |
| price | Ürünün fiyatı. | number |
| quanity | Ürünün stok miktarı. | int |
| hasVarient | Ürünün varyantı olup olmadığını belirtir. | boolean |
| size | size bilgisinin Boyut bilgilerini çekeceğiniz servise Boyut Listesi'nden ulaşabilirsiniz. | string |
| color | Renk bilgisinin Renk bilgilerini çekeceğiniz servise Renk Listesi'nden ulaşabilirsiniz. | string |
| varientId | Ürün grup kodu. Varyatlı ürünlerde aynı varyantId kullanmak gerekir | string |
| images | Ürün görsellerine ait URL adresi listesidir. Görsel url adresleri SSL sertifikalı "https" formatında adresler olmalıdır. Bir barkod için maksimum 8 adet görsel eklenebilir. Ürünlere ait görsellerin boyutlarının 1200x1800 ve 96dpi olması gerekmektedir. | array |
Örnek Servis İsteği
{
"categoryId": 12,
"subCategoryId": 69,
"brandId": null,
"name": "Salcano Hector 24 V Dağ Bisikleti (140 Cm Üstü Boy) 24429",
"shortDescription": "Salcano Hector 24 V Dağ Bisikleti (140 Cm Üstü Boy) 24429\r\n",
"longDescription": "Ürün adresinize orjinal kapalı kutusu ile yarı kurulu şekilde gönderilmektedir.",
"stockCode": null,
"barcode": "",
"model": null,
"dimensionalWeight": 0,
"kdv": 0,
"mrpPrice": 0,
"price": 3830,
"quanity": 0,
"statusType": 1,
"createdDateLong": 1691560335,
"updatedDateLong": 1691560335,
"hasVarient": false,
"size": null,
"color": null,
"varientId": null,
"images": [
"https://pempatifiles.blob.core.windows.net/photo-images/8215f9be-1acf-4bb9-b8e1-9abc0d6796bc.png"
]
}
POST createProduct
https://api.pempati.com/api/{vendorId}/product/create
Filtre Parametreleri
| Parametre | Zorunluluk | Açıklama |
|---|---|---|
| vendorId (Path) | Var | İstenilen tedarikçinin benzersiz kimliğini belirtir. API'nin çalıştırılacağı URL içinde bu tedarikçi kimliği bulunmalıdır. |
Örnek Servis Cevabı
{
"success": true,
"response": null,
"data": {
"id": "p8hl0rzoytsg",
"categoryId": 12,
"subCategoryId": 69,
"brandId": null,
"name": "Salcano Hector 24 V Dağ Bisikleti (140 Cm Üstü Boy) 24429",
"shortDescription": "Salcano Hector 24 V Dağ Bisikleti (140 Cm Üstü Boy) 24429\r\n",
"longDescription": "Ürün adresinize orjinal kapalı kutusu ile yarı kurulu şekilde gönderilmektedir.",
"stockCode": null,
"barcode": "",
"model": null,
"dimensionalWeight": 0,
"kdv": 0,
"mrpPrice": 0,
"price": 3830,
"quanity": 0,
"statusType": 1,
"createdDateLong": 1691560335,
"updatedDateLong": 1691560335,
"hasVarient": false,
"size": null,
"color": null,
"varientId": null,
"images": [
"https://pempatifiles.blob.core.windows.net/photo-images/8215f9be-1acf-4bb9-b8e1-9abc0d6796bc.png"
]
},
"errors": []
}
Parametre Açıklamaları & Kuralları
| Status Code | Açıklama |
|---|---|
| 200 | Gönderilen istek başarılı olmuştur. |
| 400 | URL içerisinde eksik veya hatalı parametre kullanılmaktadır. Dokümanı tekrar inceleyiniz. |
| 401 | İstek gönderirken kullandığınız supplierID, API Key, API Secure Key bilgilerinden birisi eksik ya da yanlıştır. Mağazanız için doğru bilgilere Pempati Satıcı Paneli üzerinden ulaşabilirsiniz. |
| 404 | İstek gönderilen URL bilgisi hatalıdır. Dokümanı tekrar inceleyiniz. |
| 500 | Anlık bir hata yaşanmış olabilir. Birkaç dakika bekleyerek durumun düzelmemesi durumunda kullanılan endpoint, gönderilen istek ve cevap ile beraber "API Entegrasyon Destek Talebi" başlığından talep oluşturunuz. |