Bu method daha önce Ürün Aktarma (createProducts) adresinde detayları anlatılmış methodun yeni versiyonudur. Bu method yardımı ile gönderilecek ürün bilgileri Trendyol Marka, Kategori ve Özellik bilgilerine göre eşlenerek gönderilecektir.
Bu servis kullanılarak gönderilen ürünler Trendyol.com'da daha hızlı yayına alınmaktadır.
Ürünleriniz Trendyol sistemine yüklenirken bu metod kullanılmaktadır .
Tekli ve çoklu ürün gönderimini desteklemektedir.
Ürünlerinize ait fiyatları Türk Lirası üzerinden belirlemeniz gerekmektedir. Döviz kuru bilgisi desteklenmemektedir.
Ürün aktarım işlemi sonrasında response içerisinde yer alan batchRequestId ile ürünlerinizin ve aktarım işleminin durumunu getBatchRequestResult servisi üzerinden kontrol etmelisiniz.
NOT: Ürünlere ait görsellerin boyutlarının 1200x1800 ve 96dpi olması gerekmektedir.
https://api.trendyol.com/sapigw/suppliers/{supplierid}/v2/products
Parametre Açıklamaları & Kuralları
Koyu renkli belirtilmiş alanlar zorunlu alan olarak istekte gönderilmelidir.
| Parametre | Açıklama | Veri Tipi | Max. Karakter Sayısı |
|---|---|---|---|
| barcode | Özel karakter olarak yalnızca "." nokta , "-" tire , "_" alt tire kullanılabilir. Türkçe karakterlerin(ğ, Ğ, Ş, ş, İ, Ü vb) kullanılması uygundur. Barkodunuzun ortasında boşluk varsa birleştirilerek içeri alınır. Stok-fiyat güncellemelerinizi de içeri alınan barkoda göre yapmanız gerekmektedir. | string | 40 |
| title | Ürün ismi. | string | 100 |
| productMainId | Ana Ürün Kodu | string | 40 |
| brandId | Trendyol Marka ID Bilgisi. Marka bilgilerini çekeceğiniz servise buradan ulaşabilirsiniz. | integer | - |
| categoryId | Trendyol Kategori ID Bilgisi. Kategori bilgilerini çekeceğiniz servise buradan ulaşabilirsiniz. | integer | - |
| quantity | Stok miktarı | integer | - |
| stockCode | Tedarikçi iç sistemindeki unique stok kodu | string | 100 |
| dimensionalWeight | Desi miktarı | number | - |
| description | Ürün açıklama bilgileridir. | HTML - string | 30.000 |
| currencyType | Ürün liste fiyatı para birimidir. | string | - |
| listPrice | Ürün liste fiyatı(Satış fiyatı düşük olunca üstü çizilen fiyat) PSF | number | - |
| salePrice | Ürün satış fiyatı TSF | number | - |
| cargoCompanyId | Trendyol Kargo Firması Bilgisi. Kargo bilgilerini çekeceğiniz servise buradan ulaşabilirsiniz. | integer | - |
| deliveryDuration | Sevkiyat Süresi (Operasyon ekiplerimiz tarafından belirtilen aralıklarda barkod bazlı sevkiyat süresi girebilirsiniz. Göndermediğiniz taktirde varsayılan termin süreniz barkod üzerinde işletilecektir.) | integer | - |
| 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 | List | - |
| vatRate | Ürün KDV oranı 0,1,8,18 gibi olmalı | integer | - |
| shipmentAddressId | Ürün Trendyol sistemindeki sevkiyat depo adresi ID bilgisi | integer | - |
| returningAddressId | Ürün Trendyol sistemindeki iade depo adresi ID bilgisi | integer | - |
| attributes | Ürünün, Kategori bilgisi için gönderilebilecek özellik (Spesification/Attribute) bilgileridir. Özellik bilgilerini çekeceğiniz servise buradan ulaşabilirsiniz. Renk bilgisi 50 karakterden fazla olamaz. | List | - |
{
"items": [
{
"barcode": "barkod-1234",
"title": "Bebek Takımı Pamuk",
"productMainId": "1234BT",
"brandId": 1791,
"categoryId": 411,
"quantity": 100,
"stockCode": "STK-345",
"dimensionalWeight": 2,
"description": "Ürün açıklama bilgisi",
"currencyType": "TRY",
"listPrice": 250.99,
"salePrice": 120.99,
"vatRate": 18,
"cargoCompanyId": 10,
"images": [
{
"url": "https://www.sampleadress/path/folder/image_1.jpg"
}
],
"attributes": [
{
"attributeId": 338,
"attributeValueId": 6980
},
{
"attributeId": 47,
"customAttributeValue": "PUDRA"
},
{
"attributeId": 346,
"attributeValueId": 4290
}
]
}
]
}
Birden fazla depo ile çalışıyorsanız aşağıdaki json'ı kullanmanızı rica ederiz.
{
"items": [
{
"barcode": "barkod-1234",
"title": "Bebek Takımı Pamuk",
"productMainId": "1234BT",
"brandId": 1791,
"categoryId": 411,
"quantity": 100,
"stockCode": "STK-345",
"dimensionalWeight": 2,
"description": "Ürün açıklama bilgisi",
"currencyType": "TRY",
"listPrice": 250.99,
"salePrice": 120.99,
"vatRate": 18,
"cargoCompanyId": 10,
"shipmentAddressId": 0,
"returningAddressId": 0,
"deliveryDuration": 10,
"images": [
{
"url": "https://www.sampleadress/path/folder/image_1.jpg"
}
],
"attributes": [
{
"attributeId": 338,
"attributeValueId": 6980
},
{
"attributeId": 47,
"customAttributeValue": "PUDRA"
},
{
"attributeId": 346,
"attributeValueId": 4290
}
]
}
]
}
https://api.trendyol.com/sapigw/suppliers/{supplierid}/v2/products
{
"items": [
{
"barcode": "barkod-1234",
"title": "Bebek Takımı Pamuk",
"productMainId": "1234BT",
"brandId": 1791,
"categoryId": 411,
"quantity": 100,
"stockCode": "STK-345",
"dimensionalWeight": 2,
"description": "Ürün açıklama bilgisi",
"currencyType": "TRY",
"listPrice": 250.99,
"salePrice": 120.99,
"vatRate": 18,
"cargoCompanyId": 10,
"shipmentAddressId": 0,
"returningAddressId": 0,
"images": [
{
"url": "https://www.sampleadress/path/folder/image_1.jpg"
}
],
"attributes": [
{
"attributeId": 338,
"attributeValueId": 6980
},
{
"attributeId": 343,
"attributeValueId": 4294
},
{
"attributeId": 346,
"attributeValueId": 4290
}
]
},
{
"barcode": "barkod-12345",
"title": "Bebek Takımı Pamuk",
"productMainId": "1234BT",
"brandId": 1791,
"categoryId": 411,
"quantity": 100,
"stockCode": "STK-3454",
"dimensionalWeight": 2,
"description": "Ürün açıklama bilgisi",
"currencyType": "TRY",
"listPrice": 250.99,
"salePrice": 120.99,
"vatRate": 18,
"cargoCompanyId": 10,
"shipmentAddressId": 0,
"returningAddressId": 0,
"images": [
{
"url": "https://www.sampleadress/path/folder/image_2.jpg"
}
],
"attributes": [
{
"attributeId": 338,
"attributeValueId": 6981
},
{
"attributeId": 343,
"attributeValueId": 4294
},
{
"attributeId": 346,
"attributeValueId": 4290
}
]
}
]
}
NOT : Bir ürünün birden fazla variant’ı olması durumunda productMainId değeri aynı olacak şekilde (Ürünün XL ve L bedeni gibi) çoklu örnek’te olduğu şekliyle isteğin gönderilmesi beklenmektedir. Ürünün sadece attributes bölümü farklılaştırılmalıdır.
"attributes": [
{
"attributeId": 338,
"attributeValueId": 6981
},
{
"attributeId": 343,
"attributeValueId": 4294
},
{
"attributeId": 346,
"attributeValueId": 4290
}
]
| Status Code | Açıklama |
|---|---|
| 200 | Gönderilen istek başarılı olmuştur. Tarafınıza dönen batchRequestId ile Toplu İşlem Kontrolü Servisine giderek işlem sonucunu görebilirsiniz. |
| 400 | URL içerisinde eksik veya hatalı paremetre 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 Trendyol 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.. Bir kaç 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. |