❗️

NEW SERVICE

The service is currently under development and should only be used in a stage environment. Development dates and details will be shared soon.

-This method is used to upload your products to the Trendyol system. It supports both single and bulk product submissions.

-Before transferring products using this method, relevant details must be retrieved via the Trendyol Brand List, Category List, Category Attribute Information, and Category Attribute Values services.

-The maximum number of items that can be sent in a single request is 1,000.

-To define a value in the "fastDeliveryType" field, the "deliveryDuration" field must be set to 1.

-The attributeValueIds field located under Attribute can accept multiple values for eligible attributes (specifically when the "allowMultipleAttributeValues" field returned from the Category Attribute Information service is true).

-The listPrice field cannot be lower than the salePrice field.

-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 BATCH REQUEST 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)

Parameters Description and Rules

ParametreRequiredExplanationData TypeMax. Number of Characters
barcodeYesOnly the period ".", the hyphen "-", and the underscore "_" can be used as special characters. Turkish characters (ğ, Ğ, Ş, ş, İ, Ü, etc.) are acceptable. If your barcode has a space in the middle, it should be combined and enclosed. You must also update your stock and prices according to the enclosed barcode.string40
titleYesProduct namestring100
productMainIdYesThis is the main product code determined by the seller. It is used for product variation.string40
brandIdYesTrendyol Brand ID Information.integer-
categoryIdYesTrendyol Category ID Information.integer-
quantityYesStock quantityinteger-
stockCodeYesUnique stock code in the supplier's internal systemstring100
dimensionalWeightYesDecimal quantitynumber-
descriptionYesThis is product description information.HTML - string30.000
listPriceYesProduct list price (price crossed out when the selling price is lower) - PSFnumber-
salePriceYesProduct selling price - TSFnumber-
deliveryDurationNoShipping Time (You can enter barcode-based shipping times within the ranges specified by our operations teams. If you do not enter this information, your default delivery time will be applied to the barcode.)integer-
deliveryOptionNoThis allows you to enter fast delivery options. The values ​​SAME_DAY_SHIPPING or FAST_DELIVERY can be entered in the "fastDeliveryType" field.string-
imagesYesThis is a list of URL addresses for product images. Image URLs must be SSL-certified "https" formatted addresses. A maximum of 8 images can be added to one barcode. The image dimensions must be 1200x1800 pixels and 96dpi.List-
vatRateYesThe product VAT rate should be something like 0, 1, 10, 20.integer-
lotNumberNoIn accordance with the relevant legislation, you are required to enter the relevant information about your product into the system using the "Batch/Lot/Expiration Date Information" field. For example: Batch No: 011220, Serial No: M00A59153, Expiration Date: 12/12/2012, Lot No: 0301A79string(max: 100 character, A-Z, a-z, 0-9, ",", "-", ".", ":", "/") / null100
shipmentAddressIdNoProduct shipping warehouse address ID information in the Trendyol system.integer-
returningAddressIdNoProduct return warehouse address ID information in the Trendyol system.integer-
attributesYesThe product information that can be submitted for category purposes includes specifications/attributes. Color information cannot exceed 50 characters.List-

Sample Service Request*

{
    "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"
                }
            ]
        }
    ]
}

Product Varient

📘

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.

Product varianting is done based on the "productMainId" value. The "slicer" and "varianter" values ​​should be checked via the relevant category attribute. "slicer" ((product color value, product memory value, etc.)

The product opens in separate contents. The most commonly used slicer value on the system is color, but in electronics categories, it can be used as a slicer value (like for internal memory) to allow the product to open in separate contents. (The category feature service must return slicer=true.)

  • A category can have more than one slicer value. - Since the slicer value opens the product in separate contents, it can be used as a variant.

"varianter" (product size, etc.)

These are different sizes of the same product within the same content. The product will not open in different content sections. Only one variant can be selected per category. Multiple selections are not allowed.

Service Responses

Status CodeDefinition
200The 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.
400Missing or incorrect parameter is used in the URL. Review the document again.
401One 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.
404The request url information is incorrect. Review the document again.
500There 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.