2. Announcement

08.12.2025

New fields and renamed versions of existing fields have been added to the response for the order package pull service and webhook model. Additionally, some fields have been removed. The old versions of the renamed fields will be removed from the response after one months. We kindly request that you make the necessary adjustments immediately to avoid any further issues.

Newly added fields:

• “cancelledBy”:
• “cancelReason”:
• “cancelReasonCode”:
• "lineTotalDiscount" ("lineSellerDiscount"+ "lineTyDiscount")
• "packageTotalDiscount": ("packageSellerDiscount"+ "packageTyDiscount")

Fields where naming changes were made:

• "merchantSku": > "stockCode"
• "merchantId": > "sellerId"
• root/"id": > "shipmentPackageId"
• line/"id": > "lineId"
• line/"amount": > "lineGrossAmount"
• line/"discount": > "lineSellerDiscount":
• line/"tyDiscount": > "lineTyDiscount"
• line/ "lineItemDiscount": > "lineItemSellerDiscount"
• line/"price": > "lineUnitPrice"
• root/"grossAmount": > "packageGrossAmount"
• "totalDiscount": > "packageSellerDiscount"
• "totalTyDiscount": > "packageTyDiscount"
• "totalPrice": > "packageTotalPrice"
• "productCode": > "contentId"
• "vatBaseAmount": > "vatRate"

Fields to remove:

• "sku":
• "scheduledDeliveryStoreId":
• "agreedDeliveryDateExtendible":
• "extendedAgreedDeliveryDate":
• "agreedDeliveryExtensionEndDate":
• "agreedDeliveryExtensionStartDate":
• "groupDeal":

08.12.2025

Some existing fields in the getclaims package service have been renamed. The old versions of the renamed fields will be removed from the response after two months. We kindly request that you make the necessary adjustments immediately to avoid any further issues.

Fields where naming changes were made:

• content/"id": > "claimId"
• "vatBaseAmount": > "vatRate"

29.08.2025

As part of our ongoing improvements to financial operations, based on your feedback, we will be switching payouts for Romania-based sellers from EUR to RON (Romanian Leu) effective September 4th, 2025. Accordingly, the Current Account Statement API will also return values in RON instead of EUR.

All financial APIs will return monetary values in RON instead of EUR starting from September 1th, 2025.

Historical Data: Past records (before September 1st) will still be available in the system, but will be displayed in RON using the ECB conversion rate of the corresponding date.

29.08.2025

Due to an incident with our getShipmentPackage service, if you are using the service with multiple parameters and a "Cancelled" status (for example, if you are trying to get both Cancelled and Created statuses), the "shipmentPackageStatus" field is not included in the service response. This issue began on August 28, 2025, and was resolved as of 1:00 PM on August 29, 2025. We kindly ask you to check your orders within the relevant timeframe.

19.08.2025

We have added a new service to our Alternative Delivery model. From now on, you'll be able to use the Alternative Delivery model with the cargo link. You can find details in our document.

31.07.2025

We are excited to announce the launch of a new feature developed directly in response to your valuable feedback. The Product Archive API service is now live and available. This service is used to archive or unarchive your products in the Trendyol system. It supports both single and multiple product archiving operations.

31.07.2025

According to legal rules in Romania, VAT rates will change as of August 1 as follows.

Standard VAT rate will increase from 19% to 21% Reduced VAT rates will increase from 5% and 9% to 11%

07.07.2025

"shipmentAddressId" and "returningAddressId" fields have been added to the Trendyol Product Create Service.

24.06.2025

New "createdBy" and "originPackageIds" fields have been added to the Trendyol OMS model (getShipmentPackages and Webhook services).

The "createdBy" field indicates how the package was created:

• order-creation: the package was created directly in the incoming order,
• cancel: the package was created after partial cancellation,
• split: the package was created based on the package split,
• transfer: orders that are directed to another seller by Trendyol because the seller who received the order does not have the product.

The "originPackageIds" field is filled after cancellation or split, after these operations it gives the packageid of the first package.

19.06.2025

We are excited to announce the launch of a new feature developed directly in response to your valuable feedback. The Accounting and Finance Integration Service is now live and available International marketplace sellers.

19.06.2025

We're excited to announce that as of today, provider change development for our Gulf 3P local sellers has gone live! The development will only permit TY Pays to TY Pays changes. The available partners will vary depending on the package's country and whether it's prepaid or COD. You can check the cargo companies that you can change according to the region.

22.05.2025

New "latitude","longitude" and "cargoDeci" fields were added to the Trendyol OMS model (getShipmentPackages and Webhook services) on 22.05.2025.You can access the details from the getShipmentpackages service document.

20.05.2025

We would like to inform you new integration services which is called Return and Shipping Address Information (getSuppliersAddresses). You can get your address information from using this service. You can reach the details in the documentation.

09.05.2025

There has been an update in the BatchRequestResult Response of the Stock&Price Update Service. You can access the new Response model via the Check Batchrequest Result page.

15.04.2025

For Romania, (storeFrontCode RO), we are updating our returns integration services. With our new return services, we are developing structures where our sellers can approve or reject the returns that customers placed. We aim to put these developments live during the week of May 15. We kindly request you to make the necessary developments in this direction.

Note: Once the return is delivered to the seller's warehouse, the seller will have 2 business days to approve or reject the return. During this time, return status will be in "waitingInAction”. If no action is taken within 2 business days, the return will be automatically approved by the system.

If this development is not implemented, sellers will not be able to approve or reject returns, and all returns will be automatically approved after the 2 business days have passed. That is why it is critical to follow the deadlines.

15.04.2025

In order to ensure the uninterrupted and smooth operation of our integration services, we are pleased to announce that we have launched our API Health Check page. With this page, you can follow the status of our integration services in real time and be informed immediately in case of any problems or errors. What Can You Do with the API Health Check Page? You can check the operating status of the services (working/not working). You can follow the general health status of the services.

14.04.2025

Dear Business Partner, For the return reason "Undelivered International Shipment" there are two ID could be set. You can check it below; Id: 2015 Description: Undelivered International Shipment Id: 2019 Description: Undelivered International Shipment

11.04.2025

Dear Business Partner, There is a situation where the "status": "COMPLETED" field is not returned in the service response in the Check Batchrequest Result service. Our teams are investigating and we will resolve the issue within the day. Best regards, Trendyol Team

11.04.2025

Dear Business Partner, The "productCategoryId" field has been added to our getShipmentpackages and webhook service. These fields will be added under the "lines" field in the order packages pull service. You can reach our integration service below; https://developers.trendyol.com/int/docs/international-marketplace/international-order-v2/int-getShipmentPackages Best regards, Trendyol Team

03.04.2025

District Information for GULF Countries service for Gulf region cities has been added under our Address Information service. You can access district information through this service.

https://developers.trendyol.com/en/docs/trendyol-marketplace/order-integration/address-information

25.03.2025

“cargoSenderNumber” field is going to be added to our getClaims service as of 28 March. With this development, if the tracking number that cargo companies generate, involves not only numeric characters, cargo tracking numbers will be shared in this field.

18.03.2025

The "identityNumber" field will be added to our get shipment package service and webhook model.

The “identityNumber” field is in the "string" data type and is planned to be added on March 21. The "identityNumber" field will be added under the "content" field on get shipment package service. With the addition of the relevant field, the "tcIdentityNumber" field will be removed as of May 5.

NOTE: For the orders Romania to Romania, From March 21, 2025 to April 9, 2025 this field will be set as 0 for 13 characters. Starting from April 9, a new field called CNP will be added to the address page on Trendyol.com and the real CNP value will be returned in the identityNumber field.

You can reach our integration service below; https://developers.trendyol.com/int/docs/international-marketplace/international-order-v2/int-getShipmentPackages

14.03.2025

We have added customer phone number and shipmentAddress information for rejected packages to the response of Getting Returned Orders service.

https://developers.trendyol.com/int/docs/international-marketplace/international-return-flow-gulf/int-getClaims

It can be seen as shipmentAddress under rejectedPackageInfo field where rejected return information is located. The phone number will be available in the response for 4 days after the return is rejected. The shipmentAddress will always be in the response.

11.03.2025

As of April, we will be allowing our customers to make any cancellation operations (partial and fully cancellation)

With this change until the package is shipped, customers will be allowed to make cancellation after the payment. (order placed)

You can check the status as “Cancelled” in getShipmentPackages. You can check our integration documentation here.

If customers prefer to make a partial cancellation (let's say there are 2 items in a package and after payment, the customer decided to cancel one of them), in this case the whole package will be in “Cancelled” status and under the same orderNumber there will be a new package generated accordingly.

NOTE1: All the operations such as updating packages as “Picking” and “Invoiced” should be managed for the new package.

NOTE2: If the seller works with the Seller Pays Cargo Model, a new cargo sender number should be sent to Trendyol for the new package generated by Trendyol, with Update Tracking Number service. (Documentation) If the seller works with TY Pays Cargo Model, a new cargoTrackingNumber from getShipmentPackage service for the new package generated by Trendyol should be used to deliver the package to the customer. (Documentation)

03.03.2025

Since Trendyol internal tests will be conducted in our integration services between 03.03.2025 and 17.03.2025, you may receive errors in your requests to our services. We plan to complete the tests as soon as possible.

27.02.2025

Ramadan is approaching and as we prepare for the big discount period, it is even more important to check the price and stock status of your products. These checks will allow you to deliver complete and correct products to our customers at the right prices.

Managing your stock and prices correctly during this period when you will receive high orders, such as the Ramadan Campaign, will increase your sales and seller ratings and help you avoid possible penalty processes due to errors.

Therefore, we recommend that you make the necessary checks now to be fully prepared for the campaign period in order to maximize your sales performance and increase the satisfaction of your customers.

27.02.2025

We will add new delivery model called "TY Pays" to our platform for Romania on 3rd week of March.

Please note that, if you are working in CEE region you are required to make this additional development for Trendyol Pays Model. FanCourier (Carrier Company) to our TY Pays model in Romania. You need to add this carrier company to your platform as well.

Note: All shipments from Romania to Romania will only be returned via the Ty Pays model. When the package delivered to the seller's warehouse, return will be automatically approved by the system.

If you are using Trendyol Pays Model: "cargoTrackingNumber" which Trendyol provides on getShipmentPackage service, should be used to deliver the package.

Label can be obtained by using Getting Common Label (getCommonLabel) service.

A Package cannot be updated as "Shipped" or "Delivered" by the Seller. Trendyol follows the package status directly from cargo carrier company. If seller wants to follow it, getShipmentPackage service can be used.

Additional Pre-Notification, In April, we will be adding the dispute process to our return flow where the sellers can accept or reject to start a dispute process for the returns. You can check our GULF model for details. It will be same in the CEE region as well.

27.02.2025

There was an incident that occurred on update stock and price services, starting from Feb 26, 2025, 11:06 am GMT and ends with Feb 27, 2025, 06:40 am GMT.

Please check your stocks and prices in order not to having any issue if you had used stock and price update service on that time period.

26.02.2025

We will add new delivery model called "TY Pays" to our platform for Romania on 3rd week of March.

FanCourier (Carrier Company) to our TY Pays model in Romania. You need to add this carrier companies to your platform as well.

Note: All shipments from Romania to Romania will only be returned via the Ty Pays model.

If you are using Trendyol Pays Model:

"cargoTrackingNumber" which Trendyol provides on getShipmentPackage service, should be used to deliver the package. Label can be obtained by using Getting Common Label (getCommonLabel) service. A Package cannot be updated as "Shipped" or "Delivered" by the Seller. Trendyol follows the package status directly from cargo carrier company. If seller wants to follow it, getShipmentPackage service can be used.

26.02.2025

We added a new service called "Delete Invoice Link" to our integration services. With this service, Invoices that were updated incorrectly before, can be deleted through this service and send again through the send invoice link service.

You can reach the details below the link https://developers.trendyol.com/int/docs/international-marketplace/international-order-v2/int-delete-invoice-link

25.02.2025

In order to ensure our service standards and increase the performance of our services, the base URL is being changed in our integration services. The old services will be closed end of May 26. We kindly ask you to provide the necessary updates as soon as possible.

We kindly ask you to check our service-based integration document for our new service endpoints. NOTE: Below you can see the information about whether the new service endpoints are active or not, based on service.

https://developers.trendyol.com/int/docs/category/8-international-marketplace

Product Integration All services have been live.

Order Integration All services have been live.

Common Label Integration All services have been live.

Return Integration All services have been live. The sellerId value has been added to our return approve and rejection service endpoints.

Webhook All services have been live.

20.02.2025

We added new carrier companies to our platform. You need to add these carrier companies to your platform as well.

GLS to our seller pays model in Romania. ZID LOGISTICS to our seller pays model in KSA. SWFTBOX to our seller pays model in AE.

You can find the updated Carrier Companies from the documentation below. https://developers.trendyol.com/int/docs/international-marketplace/international-order-v2/int-carrier-companies

17.02.2025

According to the legal regulations, in Slovakia the vatRates has been changed. You can find the updated vatRates below;

Slovakia -> 0,19 and 23

You can check the integration documentation here. https://developers.trendyol.com/int/docs/storeFrontCode

14.02.2025

Dear Business Partner,

New address fields will be added to the Trendyol OMS model (getShipmentPackages and Webhook services) on 20.02.2025. You can check the new fields under the "shipmentAddress" and "invoiceAddress" fields.

These two fields have been added as an option for our sellers who have problems with address characters. "addressLine1": "xxx", "addressLine2": "xxx" Best regards Trendyol Team

12.02.2025

Alternative delivery options enable sellers to deliver the orders created by the customer to the customer with their own courier options and update the package status as "Delivered" or "Returned" to Trendyol via the related services.

You can deliver your packages with an Alternative Delivery (ADEL) option as of Today. Our integration services are ready. For details please check our integration services here: https://developers.trendyol.com/int/docs/international-marketplace/international-order-v2/int-alternative-delivery

NOTE: You must apply Trendyol Team to be able to use this service, as alternative delivery works with ADEL permissions based on the seller.

11.02.2025

New address fields were added to the Trendyol OMS model on 07.02.2025 (getShipmentPackages and Webhook services). You can check the new fields under the "shipmentAddress" and "invoiceAddress" fields.

For TR Marketplace, "countyId" is 0, other fields are empty. -"countyId" -> eligible for the CEE region -"countyName" -> eligible for the CEE region -"shortAddress" -> eligible for the Gulf region -"stateName" -> eligible for the Gulf region

Best regards, Trendyol Team

04.02.2025

In order to ensure our service standards and increase the performance of our services, the base URL is being changed in our integration services. The old services will be closed as of April, and the exact date will be shared as soon as possible. We kindly ask you to provide the necessary updates as soon as possible.

We kindly ask you to check our service-based integration document for our new service endpoints. NOTE: Below you can see the information about whether the new service endpoints are active or not, based on service.

Product Integration All other services under Product Integration have been live.

Order Integration The new endpoints for the "Send Customer Invoice Link" Service will be live on February 21, 2025. All other services under Order Integration have been live.

Common Label Integration New endpoints for the "Getting Common Label" Service will be live on February 10, 2025.

Return Integration All services have been live. The sellerId value has been added to our return approve and rejection service endpoints.

Webhook All services have been live.

31.01.2025

There are new address fields added to our OMS model. (Get Shipment Packages and Webhook) You can check the new fields under "shipmentAddress" and "invoiceAddress"

Added fields as follows;

• "countyId" -> eligible for the cee region
• "countyName" -> eligible for the cee region
• "shortAddress" -> eligible for the gulf region
• "stateName" -> eligible for the gulf region

27.12.2024

The endpoint of our Create a Test Order services has changed. You can access our current endpoint via our integration document.

https://developers.trendyol.com/int/docs/international-marketplace/international-order-v2/int-create-test-order

New endpoint:

For Gulf: https://stageapi.trendyol.com/integration/order/orders/local-gulf

For Europe: https://stageapi.trendyol.com/integration/orders/eu

24.12.2024

There was a temporary system error in our order packages pulling service (getShipmentPackages) that started on 24.12.2024 at 10:56 and was resolved on 24.12.2024 at 11:01. You may have received a 500 error in the requests you sent to our service between these dates. The problem has been resolved and we do not expect it to happen again, we kindly ask you to check your orders between these dates.

23.12.2024

During the product create process, we noticed that the same attribute appeared more than once in some categories. Our teams are working hard to resolve this issue as soon as possible. Thank you for your understanding.

23.12.2024

"DiscountPercentage" field has been added under "lines" in our test order creation service. With this field, you will be able to simulate the discounts you have created based on the product. You can check the details in our integration document:

https://developers.trendyol.com/en/docs/trendyol-marketplace/order-integration/creating-test-order

13.12.2024

You can access the changes made to our webhook services and our new features below.

Webhook Retry Model:

In case of an error in webhook services, the system will automatically take action and deactivate the relevant webhook request. In this context, we will be sending two e-mails to our sellers.

Webhook Status Model:

In the requests made to our webhook services, we were collecting applications from you without receiving any status and sending you the Created, Cancelled, Unpacked, Shipped and Delivered statuses as a result of successful requests.

Webhook Authorization Model:

We have added not only "Basic Authentication" to our webhook services, but also the "API_KEY" method. In this context, the "authenticationType" field has been added to our webhook creation service.

Webhook Active/Passive Model:

Two new services have been added to our webhook services. With these services, you can make your webhook applications passive or active. (Applications that are automatically passive due to an error should be activated by correcting the error through this service.)

08.09.2023

There has been a request body chance on create claim services. Please check our documentation for details.

04.09.2023

Product Integration and Order Integration Services has been deprecated. Starting from September 4 you should use Product Integration v2 and Order Integration v2 services.

09.06.2023

Product Integration v2 services will be live in August.

05.06.2023

Order Integration v2 and Returned Order Integration v2 services will be live in August.

10.05.2023

There will be changes in our integration services in August. Change details and date information will be added soon. Most of the service changes will be on the order integration side.