Product Create (createProducts)
Product Create
This method is used when uploading your products to the Trendyol system. It supports single and multiple product shipment.
- You must determine the prices of your products in Turkish Lira. Exchange rate information is not supported.
- Before transferring the product with this method, relevant details should be obtained from Trendyol Brand List and Category/Category Attribute Information services.
- The maximum number of items that can be sent in each request is 1000.
- In order to be able to define in the fastDeliveryType field, the deliveryDuration field must be entered as 1.
- "stockCode" in product data, equals to "merchantSku" in order data. It can be checked in getShipmentPackages service.
- Following a successful product create request, product approval process starts. Products that are under approval or rejected will not go live. In this case you need to check product status through the productFilter service.
Check Batchrequest Result
After the product create process, you need to check the status of your products and the transfer process via the getBatchRequestResult service with the batchRequestId in the response.
POST createProducts (Single)
Sample Service Request
{
"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,
"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": 343,
"attributeValueId": 4294
},
{
"attributeId": 346,
"attributeValueId": 4290
},
{
"attributeId": 47,
"customAttributeValue": "COLOUR"
}
]
}
]
}POST createProducts (Single Product with 2 variants)
PROD
https://apigw.trendyol.com/integration/product/sellers/{sellerId}/products
STAGE
https://stageapigw.trendyol.com/integration/product/sellers/{sellerId}/products
Sample Service Request
{
"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, // It will be removed from the body as of October 17
"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
},
{
"attributeId": 47,
"customAttributeValue": "COLOUR"
}
]
},
{
"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,
"deliveryDuration": 10, // It will be removed from the body as of October 17
"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
},
{
"attributeId": 47,
"customAttributeValue": "COLOUR"
}
]
}
]
}IMPORTANT NOT : If a product has more than one variant (such as XL and L size of the product), the request is expected to be sent in multiple instances. Only the attributes section of the product must be differentiated.
"attributes": [
{
"attributeId": 338,
"attributeValueId": 6981
},
{
"attributeId": 343,
"attributeValueId": 4294
},
{
"attributeId": 346,
"attributeValueId": 4290
},
{
"attributeId": 47,
"customAttributeValue": "COLOUR"
}
]Parameters Description and Rules
| Parameter | Required | Explanation | Data Type | Max. Number of Characters |
|---|---|---|---|---|
| barcode | Yes | As a special character "." , "-" , "_" can be use. You may use Turkish characters (ğ, Ğ, Ş, ş, İ, Ü etc.). If there is a space in the middle of your barcode, it will be combined and imported. You should also make your stock-price updates according to the imported barcode. | string | 40 |
| title | Yes | Product Name | string | 100 |
| productMainId | Yes | Main Product Code | string | 40 |
| brandId | Yes | Trendyol Brand ID Information. | integer | - |
| categoryId | Yes | Trendyol Category ID Information | integer | - |
| quantity | Yes | Stok Amount | integer | - |
| stockCode | Yes | Unique stock code in supplier internal system | string | 100 |
| dimensionalWeight | Yes | Desi Amount | number | - |
| description | Yes | Product description information. | HTML - string | 30.000 |
| currencyType | Yes | It should be sent in TRY. You need to determine the prices of your products in Turkish Lira. Exchange rate information is not supported. | string | - |
| listPrice | Yes | Product list price (the price crossed out when the selling price is low) PSF | number | - |
| salePrice | Yes | Product sales price TSF | number | - |
| cargoCompanyId | Yes | Trendyol Cargo Company Information | integer | - |
| deliveryDuration | No | Shipment Duration | integer | - |
| deliveryOption | No | Allows entry of express delivery options. SAME_DAY_SHIPPING or FAST_DELIVERY values can be entered in the "fastDeliveryType" field. | string | - |
| images | Yes | It is the URL address list of product images. Visual URL addresses must be SSL certified addresses in "https" format. Maximum 8 images can be added for a barcode. The dimensions of the images of the products must be 1200x1800 and 96dpi. | List | - |
| vatRate | Yes | Product VAT rate (like 0,1,10,20) | integer | - |
| shipmentAddressId | No | Product Shipment warehouse address ID information in Trendyol system | integer | - |
| returningAddressId | No | Product Return warehouse address ID information in Trendyol system | integer | - |
| attributes | Yes | It is the property (Specification/Attribute) information of the product that can be sent for Category information. | List | - |
Service Responses
| Status Code | Definition |
|---|---|
| 200 | The request was successful. you need to check the status of your products and the transfer process via the getBatchRequestResult service with the batchRequestId in the response. |
| 400 | Missing or incorrect parameter is used in the URL. Review the document again. |
| 401 | One of the supplierID, API Key, API Secure Key information you used while sending the request is missing or incorrect. You can find the right information for your store on Trendyol Seller Panel. |
| 404 | The request url information is incorrect. Review the document again. |
| 500 | There may have been a momentary error. In case the situation does not improve by waiting a few minutes, create a request under the heading "API Integration Support Request" with the endpoint used, the sent request and the response. |
Updated 10 days ago