Ürün Aktarma (v2/createProducts)

Ürün Aktarımı v2

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.

  • POST createProducts (Tekli Örnek)

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
        }
      ]
    }
  ]
}
  • POST createProducts (Tek Ürün 2 Variant Örnek)

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.