Ürün Yaratma v2
YENİ SERVİS
İlgili servis geliştirme aşamasında olup, şu an için sadece stage ortamda kullanılmalıdır. Geliştime tarihi ve detayları yakında paylaşılacaktır.
Ürünleriniz Trendyol sistemine yüklenirken bu metod kullanılmaktadır. Tekli ve çoklu ürün gönderimini desteklemektedir.
- Bu method ile ürün aktarımı sağlanmadan önce Trendyol Marka Listesi, Kategori Listesi, Kategori Özellik bilgileri listesi ve Kategori Özellik Değerleri listesi servisleri üzerinden ilgili detaylar alınmalıdır.
- Her bir istek içerisinde gönderilebilecek maksimum item sayısı 1.000'dir.
- fastDeliveryType alanında tanımlama yapabilmek için deliveryDuration alanını 1 olarak girilmesi gerekmektedir.
- Attribute altında bulunan "attributeValueIds" bilgisi, uygun attribute'lar için (Kategori özellik bilgileri listesi servisinden dönen allowMultipleAttributeValues alanı true olduğu durumda) birden fazla değer alabilmektedir.
- "listPrice" alanı, "salePrice" alanından küçük olamaz.
- Ürün aktarma isteğinizin başarılı olması durumunda ürünleriniz ürün onay sürecine girer. Onay süreci devam eden ya da reddedilen ürünler yayına çıkmaz. Ürününüzün yayına çıkmaması durumunda, statüsünü productFilter servisinden kontrol etmeniz önerilmektedir.
TOPLU İŞLEM KONTROLÜ
Ü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 etmeniz gerekmektedir.
POST createProducts (Tekli Örnek)
Parametre Açıklamaları & Kuralları
| Parametre | Zorunluluk | Açıklama | Veri Tipi | Max. Karakter Sayısı |
|---|---|---|---|---|
| barcode | Evet | Ö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 | Evet | Ürün ismi | string | 100 |
| productMainId | Evet | Satıcı tarafından belirlenen, ana ürün kodudur. Ürün varyantlamak için kullanılmaktadır. | string | 40 |
| brandId | Evet | Trendyol Marka ID Bilgisi. | integer | - |
| categoryId | Evet | Trendyol Kategori ID Bilgisi. | integer | - |
| quantity | Evet | Stok miktarı | integer | - |
| stockCode | Evet | Tedarikçi iç sistemindeki unique stok kodu | string | 100 |
| dimensionalWeight | Evet | Desi miktarı | number | - |
| description | Evet | Ürün açıklama bilgileridir. | HTML - string | 30.000 |
| listPrice | Evet | Ürün liste fiyatı(Satış fiyatı düşük olunca üstü çizilen fiyat) PSF | number | - |
| salePrice | Evet | Ürün satış fiyatı TSF | number | - |
| deliveryDuration | Hayır | 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 | - |
| deliveryOption | Hayır | Hızlı teslimat seçeneklerinin girilmesini sağlar. SAME_DAY_SHIPPING veya FAST_DELIVERY değerleri "fastDeliveryType" alanından girilebilir. | string | - |
| images | Evet | Ü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. | List | - |
| vatRate | Evet | Ürün KDV oranı 0,1,10,20 gibi olmalı | integer | - |
| lotNumber | Hayır | İlgili mevzuat kapsamında "Parti/Lot/SKT Bilgisi" alanını kullanarak ürününüze ait ilgili bilgileri sisteme girmeniz gerekmektedir. Ör: Parti No: 011220, Seri No: M00A59153, SKT: 12/12/2012, Lot No: 0301A79 | string(max: 100 karakter, A-Z, a-z, 0-9, ",", "-", ".", ":", "/") / null | 100 |
| shipmentAddressId | Hayır | Ürün Trendyol sistemindeki sevkiyat depo adresi ID bilgisi | integer | - |
| returningAddressId | Hayır | Ürün Trendyol sistemindeki iade depo adresi ID bilgisi | integer | - |
| attributes | Evet | Ürünün, Kategori bilgisi için gönderilebilecek özellik (Spesification/Attribute) bilgileridir. Renk bilgisi 50 karakterden fazla olamaz. | List | - |
Örnek Servis İsteği
{
"items": [
{
"barcode": "TestBarcode",
"title": "string",
"description": "string",
"productMainId": "string",
"brandId": 1,
"categoryId": 1,
"quantity": 0,
"stockCode": "string",
"dimensionalWeight": 0,
"listPrice": 0,
"salePrice": 0,
"vatRate": 0,
"lotNumber": "string",
"shipmentAddressId": 0,
"returningAddressId": 0,
"deliveryOption": {
"deliveryDuration": 0,
"fastDeliveryType": "string"
},
"images": [
{
"url": "trendyol.com/test.jpeg"
}
],
"attributes": [
{
"attributeId": 1,
"attributeValueIds": [
1
],
},
{
"attributeId": 2,
"attributeValue": "String"
}
]
}
]
}
Ürün Varyantlama
ÖNEMLİ
NOT : Bir ürünün birden fazla variant’ı olması durumunda productMainId değeri aynı olacak şekilde (Ürünün XL ve L bedeni gibi) isteğin gönderilmesi beklenmektedir. Ürünün sadece attributes bölümü farklılaştırılmalıdır.
Ürün varyantlama işlemi "productMainId" değerine göre yapılmaktadır. İlgili kategori özelliği üzerinden "slicer" ve "varianter" değeri kontrol edilmelidir.
"slicer" (ürün renk değeri, ürün hafıza değeri vb.)
Ürünü ayrı contentlerde açar, sistem üzerinde en fazla Slicer olarak kullanılan değer renktir, ancak elektronik kategorilerinde ürünün ayrı contentlerde açılabilmesi için (dahili hafıza gibi) slicer değeri olarak kullanılabilir. (kategori özelliği servisi üzerinden slicer=true dönmelidir.)
- Bir kategoride birden fazla slicer değeri olabilir.
- Slicer değer ürünü ayrı contentlerde açtığı için, variant olarak kullanılabilir.
"varianter" (ürün beden değeri vb.)
Aynı content üzerinde yer alan ürünün ayrı bedenleridir. Ürünü farklı contentlerde açmaz. Her kategoride bir tane varianter seçilebilir. Birden fazla seçime izin verilmemektedir.
Servis Cevapları
| 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. |
Updated 10 days ago