Ü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ünler Trendyol sistemine ilk olarak bu method yardımıyla iletilecektir. Tekli ve çoklu ürün gönderimini desteklemektedir.

Ürün fiyatlarınızı döviz kuru bilgisi girerek gönderemezsiniz. Türk Lirası üzerinden ürünlerinize ait fiyatları belirlemeniz gerekmektedir.

Bu method kullanarak yaptığınız işlemlerin durumunu getBatchRequestResult ü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ı

*Koyu renkli belirtilmiş alanlar zorunlu alan olarak istekte gönderilmelidir

Parametre Açıklama Veri Tipi
barcode Ürün Barkodu 40 karakter üzerinde olmamalıdır. Barkodunuzda "? / & % + ^ ' * _" boşluk gibi özel karakterler kullanılamaz. Barkodunuzun ortasındaa 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
title Ürün başlığı 100 karakterden uzun olamaz. string
productMainId Ana Ürün Kodu string
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 100 karakterden fazla olamaz. string
dimensionalWeight Desi miktarı number
description Ürün açıklama bilgileridir. 30.000 karakterden fazla olamaz. HTML - string
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 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 resmi URL adresi Listesi/adresler 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,
      "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
        }
      ]
    }
  ]
}

Birden fazla depo ile çalışmı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,
      "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
        }
      ]