Trendyol: marketplace guide

About this guide

This is a ChannelEngine guide on the Istanbul-based marketplace Trendyol. Here you can find information on how to request a Trendyol account, how to configure this marketplace on ChannelEngine, what the specific requirements are, and more.

Table of contents

Commercial information

How to request an account

Associated costs

Marketplace features

Settings and configuration

Marketplace-specific requirements and exceptions

• Setup
• Categorization
• Mappings
• Pricing
• Listed products

Additional information

• Order extra data items
• Shipment package logic
• Partial shipments and cancelations
• Fulfilment by Trendyol

FAQs

Commercial information

Founded	2010
Founder	Demet Suzan Mutlu
Headquarters	Istanbul, Turkey
Area served (orders)	Turkey (Turkey) Germany (Global)
Revenue	USD 3,216 million (2021)
Number of monthly visits	1 billion (Turkey) 15 million (Global)
Website	Trendyol
Setup cost	none
Commission	depends on the category and brand
Other costs	none
Payment	once per week (Turkey) once per month (Global)
Product categories	auto/motorcycle parts, bags, cooking, cosmetics, DIY, electronics, fashion, films, food, furniture, games/toys, gardening, household appliances, jewelry, kids, kids/babies, musical instruments, office supplies, shoes, sports equipment (Turkey) bags, cosmetics/perfumes, fashion, home textile/accessories, jewelry, kids/babies, luggage, shoes, sports equipment (Global)
Input language	Turkish (Turkey) English, German (Global)
Input currency	TRY (Turkey) EUR (Global)
Content creation	yes
Minimum number of SKUs	none
Advertisement options	yes
Profile on ChannelEngine	Trendyol

How to request an account

Trendyol Turkey

To start selling on Trendyol, go to their partner portal and fill out the vendor application form. For more information, refer to the Trendyol application form and application steps article.

The following requirements apply:

• You must have a Turkish tax identification number (TID).
• You must have a joint stock, limited liability, or sole proprietorship type of organization.
• Your company must be active according to the records of the Revenue Administration, and you must be able to issue invoices.

Trendyol Global

To start selling on Trendyol Global, register your interest by filling out the seller onboarding form. The following requirements apply:

• Your products must be within the categories supported by Trendyol Global.
• You must have a valid European VAT number.
• You should use one of the following carriers: DHL, DHL Express, DPD, or Hermes.

Associated costs

Trendyol does not charge setup or monthly fees. However, it does charge a commission fee, which depends on the product category.

Marketplace features

Supported	Not supported
Product offers	Repricer
Product content	Returns (marketplace) (Global)
Cancelations (marketplace)
Cancelations (merchant)
Returns (merchant) (Global)*
Returns (marketplace) (Turkey)**
Split shipments
Split orders
HTML formatting
Product variations
Sales channels***
Cargo companies (Turkey)****
Marketplace fulfilment service (Global)

* Handling merchant returns, which are returns recorded on the merchant's side, differs based on the integration. While Trendyol Global fully supports merchant returns, creating a merchant return on Trendyol Turkey requires submitting attachments (PDF, JPEG, etc.) through a form via the marketplace back-end.

** Support for marketplace returns, which are returns recorded on the marketplace, differs based on the integration. Trendyol Turkey fully supports marketplace returns, whereas Trendyol Global does not offer support for marketplace returns.

*** A marketplace that supports sales channels allows merchants to list and sell products across multiple markets (e.g.: countries, regions, and states), all from the same connection.

**** On Trendyol Turkey, you need to work with cargo companies (a.k.a. carriers) to fulfil your orders. You can either use Trendyol contracted cargo prices or work with carriers through your own agreement. Hence, carrier mapping is mandatory on ChannelEngine.

Settings and configuration

Setting up each marketplace on ChannelEngine follows the same flow, once you add the marketplace:

1. Go through the Setup.
2. Create a Product selection.
3. Complete the Categorization.
4. Set up the Mappings: content, offers, and carriers.
5. Configure the Pricing: rules and currency conversion.
6. Finish the Activation.
7. Check the Listed products overview.

Marketplace-specific requirements and exceptions

Setup

On Trendyol

Trendyol Turkey

Once your seller account is active, the information that ChannelEngine needs can be found in your seller dashboard. The steps below are needed for the basic API authentication.

1. Go to the Trendyol back-end.
2. Log in to your account and click Hesap bilgilerim (Account details).
3. Go to the Entegrasyon bilgileri (Integration details) tab on the right.
4. Locate the Satıcı ID (Seller ID), API key, and API secret and copy the values.

Trendyol Global

Once your seller account is active, contact Trendyol to request the API authentication details that ChannelEngine needs to establish the connection.

Trendyol	ChannelEngine
Seller ID	Supplier ID
Developer ID	API key
Secret key	API secret key

On ChannelEngine

1. Go to the Setup page of your Trendyol marketplace.
2. Enter your Supplier ID, API key, and API secret key  in the Connection section.
3. Click Save.

Categorization

Categorization on Trendyol is straightforward. All categories are listed in Turkish for the Turkish integration and in English for the Trendyol Global integration.

Mappings

Content

All products (required)

Your products must first go through the verification process carried out by Trendyol. For that, set your stock and price attributes to zero. Once your products are accepted, you can assign stock and price to them.

Bear in mind that after products are accepted by Trendyol, color information can no longer be updated. To update the product's color, you need to first delete the product and then recreate it.

Consider language differences when mapping the attributes. Trendyol Turkey requires attribute values to be submitted in Turkish, whereas Trendyol Global requires values to be in English or German.

For the Turkish integration, you can apply Turkish characters (i.e.: ğ, Ğ, Ş, ş, İ, Ü, etc.) in the attributes, such as Brand, Product description, and Product name.

• Desi miktarı (Weight)* - the volumetric weight of the package. The formula to calculate the volumetric weight is as follows: [Package width in cm]×[Package length in cm]×[Package height in cm]÷3,000. E.g.: for the package with the dimensions: W=20 cm, L=50 cm, H=100 cm, the volumetric weight is calculated as follows: 20×50×100÷3,000 = 33.3.
• Kargo firması (Shipping company)* - the name of the courier company (a.k.a carrier). Select from the options in the dropdown menu. E.g.: MNG Kargo, Aras Kargo.
• KDV oranı (VAT rate) - the product's sales tax rate. Select from the options in the dropdown menu.
• Marka (Brand) - the product's brand or manufacturer.
• SKU - the product's stock keeping unit, which is the Merchant product number on ChannelEngine. The maximum number of characters is 100.
• Teslimat süresi (Delivery time)* - the estimated delivery time measured in days. E.g.: 2. If you want to make use of the Express delivery attribute, the Delivery time attribute should be set to 1.
• Ürün açıklaması (Product description) - the product's description. The maximum number of characters is 30,000. HTML tags are supported. The following requirements apply:
  • Should include - terms of use, materials, warranty status.
  • Should not include - carrier name, delivery time, your company contact information, external links, advertisement campaigns, personalized information. 
• Ürün adı (Product name) - the product's title. The maximum number of characters is 100. The product's title should clearly identify the product and be easily searched for (i.e.: contain keywords). The following requirements apply: 
  • Should include - size, color, weight (or other applicable dimensions), product details.
• Ürün görsel URL 1 (Product image URL 1) - the URL to the main image of the product. The following requirements apply:
  • URL format - 'https'. E.g.: https://imagenoll.org/image1.jpeg.
  • Minimum resolution - 600x800 px at 72 dpi.
  • Desired resolution - 1200x1800 px at 96 dpi.
  • Maximum file size - 10 MB.

All products (optional)

• Hızlı teslimat tipi (Express delivery)* - indicate if the product can be subject to express delivery. This results in an 'Express delivery' label on your product on Trendyol. The options are: Ayni gün sevkiyat (Same day shipping) and Hizle gönderim (Fast shipping).
• Ürün görsel URL 2-8 (Product image URL 2-8) - the link to the additional images of the product. The following requirements apply:
  • URL format - 'https'.
  • Minimum resolution - 600x800 px at 72 dpi.
  • Desired resolution - 1200x1800 px at 96 dpi.
  • Maximum file size - 10 MB.

* Attributes with an asterisk are only present in the Trendyol Turkey integration.

Offer

All products (required)

• Satış fiyatı (Sales price) - the desired price for the product, without its currency. Decimals are separated by a period. E.g.: 370.95. The price should include the sales tax (e.g.: VAT).

Carrier

Carrier mapping is required on Trendyol, and they have a specific list of carriers to select from. To learn more about supported shipment models, refer to Working models with cargo (Trendyol Turkey) and Carrier Companies (Trendyol Global).

Trendyol Turkey

On Trendyol Turkey, depending on whether you use your own shipping prices or rely on Trendyol's contracted cargo prices, the process of providing the tracking code is different. Normally, ChannelEngine automatically updates the shipment with the tracking code provided by Trendyol.

However, if you choose to handle the shipment yourself and submit your own tracking code, you can only use UPS Kargo or Aras Kargo as your carrier.

Note that if you use Aras Kargo according to the Trendyol contracted cargo prices model, you must indicate 'Aras Kargo-TrendyolContracted' as Your shipping method.

I work with my own shipping prices	I work with my own shipping prices	I work with Trendyol contracted cargo prices
Trendyol tracking code	My own tracking code	Trendyol tracking code
MNG Kargo	UPS Kargo	Aras Kargo
Sürat Krago	Aras Kargo	Horoz Lojistik
Horoz Lojistik	-	MNG Kargo
PTT Kargo	-	Sürat Krago
Yurtiçi Kargo	-	Yurtiçi Kargo
-	-	PTT Kargo

Trendyol Global

On Trendyol Global, the list of supported carriers includes DHL, DHL Express, DPD, and Hermes. Unlike the Turkish integration, you need to provide the shipment tracking code yourself for every shipment.

Pricing

Trendyol requires the prices to be submitted in TRY for the Turkish integration and in EUR for the Trendyol Global integration. If you do not have pricing attributes in the respective currency, you need to set a currency conversion.

Listed products

If you have problems with products not appearing on Trendyol (especially if you are trying to add products that do not exist yet), check the Listed products page for more information.

You can either filter on Channel status (Invalid for all products that ChannelEngine has not exported, such as products with an empty EAN or products that currently do not exist on Trendyol) or use the Validation and feedback tab to see all known validation/feedback errors for specific products.

Additional information

Order extra data items

When an order is imported to ChannelEngine, ChannelEngine also fetches extra data items related to the order itself – or to order lines. This extra data is specific to this marketplace. An explanation of each can be found below: 

Order extra data

Key	Conditional*	Description
TCKN number	Yes	The identity number for gold, fertilizer, or orders over 5000₺.
Order number	No	The main order number on Trendyol.
Cargo provider name	No	The name of the cargo company assigned to transport the order.
Cargo tracking number	No	The tracking number of the order.
Commercial company	Yes**	The name of the invoiced company.
Commercial company tax number	Yes**	The tax number of the invoiced company.
Commercial company tax office	Yes**	The tax office of the invoiced company.
E-invoice available	Yes**	To indicate whether the buyer is to pay via e-invoice.

* Conditional fields only display if the marketplace provided a value. 

** Present if the invoice for the order is commercial, not individual. 

Shipment package logic

Trendyol applies a shipment package logic when handling orders, shipments, and returns. Trendyol decides which way to fulfill an order best – splitting it into several shipment packages based on stock, mapped carrier, shipment region, and other factors. This means that each order on ChannelEngine corresponds to several shipment packages on Trendyol.

When retrieving orders from Trendyol, ChannelEngine combines the Order number and the Shipment package ID on Trendyol into the Channel order number. E.g.: if the Order number is '1735032345' and the Shipment package ID is '44564419', the Channel order number on ChannelEngine is '1735032345_44564419'.

Partial shipments and cancelations

Partial shipments and cancelations follow a specific procedure on Trendyol. If only part of a shipment package is either canceled or shipped, Trendyol changes the status of the original order to Unpacked and creates new suborders (i.e.: new shipment packages). The new package IDs are communicated to ChannelEngine in the order extra data, and can be retrieved by the merchant via the Merchant API.

Fulfilment by Trendyol

Marketplace fulfilment service is currently only available on Trendyol Global. To enable the fulfillment by Trendyol feature, reach out to ChannelEngine's Support team to activate the Fulfillment by Trendyol setting.

Orders fulfilled by Trendyol get imported into ChannelEngine with the status Shipped and the order extra data, which contains additional information about the order. 

FAQs

How often does each task run on Trendyol?

Trendyol follows the schedule below:

Task	Frequency
Export product data to channel	every 60 minutes
Export product offers to channel	every 15 minutes
Import offers from channel	every 20 minutes
Import orders from channel	every 20 minutes
Export order shipments to channel	every 60 minutes
Import returns from channel	every 60 minutes
Export returns to channel	every 60 minutes