Ürün Aktarma (v2/createProducts)

Ürün Aktarımı v2

Ü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 Liste ve Kategori/Kategori Özellik bilgileri 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.
Product yaratma servisinde bulunan "stockCode" alanı, sipariş paketlerini çekme servisinden dönen "merchantSku" alanına gelmektedir. getShipmentPackages servisi üzerinden kontrol edilebilir.
Ü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)

PROD

https://apigw.trendyol.com/integration/product/sellers/{sellerId}/products

STAGE

https://stageapigw.trendyol.com/integration/product/sellers/{sellerId}/products

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. Marka bilgilerini çekeceğiniz servise buradan ulaşabilirsiniz.	integer	-
categoryId	Evet	Trendyol Kategori ID Bilgisi. Kategori bilgilerini çekeceğiniz servise buradan ulaşabilirsiniz.	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
currencyType	Evet	Ürün liste fiyatı para birimidir.	string	-
listPrice	Evet	Ürün liste fiyatı(Satış fiyatı düşük olunca üstü çizilen fiyat) PSF	number	-
salePrice	Evet	Ürün satış fiyatı TSF	number	-
cargoCompanyId	Evet	Trendyol Kargo Firması Bilgisi. Kargo bilgilerini çekeceğiniz servise buradan ulaşabilirsiniz.	integer	-
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. Özellik bilgilerini çekeceğiniz servise buradan ulaşabilirsiniz. Renk bilgisi 50 karakterden fazla olamaz.	List	-

Örnek Servis İsteği

{
  "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,
      "lotNumber": "string",
      "deliveryOption": {
        "deliveryDuration": 1,
        "fastDeliveryType": "SAME_DAY_SHIPPING|FAST_DELIVERY"
      }
      "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,
      "lotNumber": "string",
      "shipmentAddressId": 0,
      "returningAddressId": 0,
      "deliveryOption": {
        "deliveryDuration": 1,
        "fastDeliveryType": "SAME_DAY_SHIPPING|FAST_DELIVERY"
      }
      "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)

PROD

[https://apigw.trendyol.com/integration/product/sellers/{sellerId}/products]

STAGE

[https://stageapigw.trendyol.com/integration/product/sellers/{sellerId}/products]

Örnek Servis İsteği

{
  "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,
      "lotNumber": "string",
      "shipmentAddressId": 0,
      "returningAddressId": 0,
      "deliveryOption": {
        "deliveryDuration": 1,
        "fastDeliveryType": "SAME_DAY_SHIPPING|FAST_DELIVERY"
      }
      "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,
      "deliveryOption": {
        "deliveryDuration": 1,
        "fastDeliveryType": "SAME_DAY_SHIPPING|FAST_DELIVERY"
      }
      "images": [
        {
          "url": "https://www.sampleadress/path/folder/image_2.jpg"
        }
      ],
      "attributes": [
        {
          "attributeId": 338,
          "attributeValueId": 6981
        },
        {
          "attributeId": 343,
          "attributeValueId": 4294
        },
        {
          "attributeId": 346,
          "attributeValueId": 4290
        }
      ]
    }
  ]
}

🚧
Ö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) çoklu örnekte olduğu şekliyle isteğin gönderilmesi beklenmektedir. Ürünün sadece attributes bölümü farklılaştırılmalıdır.

Ürün Varyantlama

Ü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.