❗️

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ı

ParametreZorunlulukAçıklamaVeri TipiMax. Karakter Sayısı
barcodeEvetÖ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.string40
titleEvetÜrün ismistring100
productMainIdEvetSatıcı tarafından belirlenen, ana ürün kodudur. Ürün varyantlamak için kullanılmaktadır.string40
brandIdEvetTrendyol Marka ID Bilgisi.integer-
categoryIdEvetTrendyol Kategori ID Bilgisi.integer-
quantityEvetStok miktarıinteger-
stockCodeEvetTedarikçi iç sistemindeki unique stok kodustring100
dimensionalWeightEvetDesi miktarınumber-
descriptionEvetÜrün açıklama bilgileridir.HTML - string30.000
listPriceEvetÜrün liste fiyatı(Satış fiyatı düşük olunca üstü çizilen fiyat) PSFnumber-
salePriceEvetÜrün satış fiyatı TSFnumber-
deliveryDurationHayırSevkiyat 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-
deliveryOptionHayırHızlı teslimat seçeneklerinin girilmesini sağlar. SAME_DAY_SHIPPING veya FAST_DELIVERY değerleri "fastDeliveryType" alanından girilebilir.string-
imagesEvetÜ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-
vatRateEvetÜrün KDV oranı 0,1,10,20 gibi olmalıinteger-
lotNumberHayı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: 0301A79string(max: 100 karakter, A-Z, a-z, 0-9, ",", "-", ".", ":", "/") / null100
shipmentAddressIdHayırÜrün Trendyol sistemindeki sevkiyat depo adresi ID bilgisiinteger-
returningAddressIdHayırÜrün Trendyol sistemindeki iade depo adresi ID bilgisiinteger-
attributesEvetÜ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 CodeAçıklama
200Gönderilen istek başarılı olmuştur. Tarafınıza dönen batchRequestId ile Toplu İşlem Kontrolü Servisine giderek işlem sonucunu görebilirsiniz.
400URL 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.
500Anlı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.