06.07.2026

Değerli İş Ortağımız, Ürün Entegrasyonu Servislerimize sistem sağlığı açısından 14 Eylül 2026 tarihi itibari ile satıcı ürün seviyeleri bazında yeni servis limileri uygulanacaktır. İlgili servislerle ilgili yeni limit seviyelerine aşağıdaki linkten ulaşabilirsiniz. https://developers.trendyol.com/docs/1-servis-limitleri Saygılarımızla, Trendyol Entegrasyon Ekibi

26.06.2026

Değerli İş Ortağımız, Stage ortamda ürün sorularını çekme ve cevaplama servislerini test edebilmeniz için, stage test satıcınızın ürünlerine soru ekleyebileceğiniz servisimiz canlıya alınmıştır. bu servisten oluşturacağınız ürün soruları ile testlerinizi ilerletebilirsiniz. [https://developers.trendyol.com/docs/stage-ortamda-m%C3%BC%C5%9Fteri-sorusu-olu%C5%9Fturma](https://developers.trendyol.com/docs/stage-ortamda-m%C3%BC%C5%9Fteri-sorusu-olu%C5%9Fturma) Saygılarımızla, Trendyol Entegrasyon Ekibi

2.06.2026

Değerli İş Ortağımız, Mevcutta kullanılan getShipmentPackage servisinin limitleri 8 Haziran 2026 itibariyle değiştirilecektir. Servise yapmış olduğunuz isteklerinizde yeni limitlere uygun istekle gelmeniz gerekmektedir aksi takdirde servisten 429 hatası alınacaktır. Mevcut getShipmentPackage servisinin maksimum erişilebilir kayıt sayısı: 10.000 olacaktır. Servis Limitleri: [https://developers.trendyol.com/docs/1-servis-limitleri#/versions](https://developers.trendyol.com/docs/1-servis-limitleri#/versions) Büyük veri tarama ihtiyacı için "getShipmentPackagesStream" servisini kullanabilirsiniz. getShipmentPackagesStream uç noktası (endpoint), sipariş paketlerini imleç tabanlı akış (cursor-based streaming) yöntemiyle çekmenize olanak tanır. Bu uç nokta; büyük veri tarama (full scan), periyodik senkronizasyon (polling/cron) ve tüm siparişlerin dışa aktarılması (export) işlemleri için tasarlanmıştır. Yanıt (response) yapısı aynı kalmakla birlikte, imleç tabanlı sayfalama mekanizmasına geçiş yapılması nedeniyle artık totalElements, totalPages, page gibi sayfalama ile ilgili alanlar dönmeyecektir. Bu servisten son 3 aylık siparişlerinizi çekebilirsiniz. Detaylara aşağıdaki link aracılığıyla ulaşabilirsiniz: [https://developers.trendyol.com/docs/sipari%C5%9F-paketlerini-ak%C4%B1%C5%9F-ile-%C3%A7ekme#/versions](https://developers.trendyol.com/docs/sipari%C5%9F-paketlerini-ak%C4%B1%C5%9F-ile-%C3%A7ekme#/versions) Saygılarımızla, Trendyol Entegrasyon Ekibi

13.05.2026

Değerli İş Ortağımız, Trendyol olarak, veri yapılarımızı modernize etmek ve entegrasyon süreçlerinizi daha verimli hale getirmek adına ürün servislerimizde önemli bir güncelleme yapıyoruz. Bugüne kadar ürün servislerimizde "Attribute" (Özellik) altında alınan Menşei bilgisini, artık stockCode veya barcode gibi bağımsız, standart bir alan (field) olarak yöneteceğiz. **Geçiş Süreci Nasıl İşleyecek?** Sizlerin bu değişimden olumsuz etkilenmemesi adına süreci iki aşamalı bir "yumuşak geçiş" (soft transition) modeliyle kurguladık: **1. Hibrit Dönem (Geçiş Dönemi):** Ürün payload'una origin adında yeni bir alan eklenmiştir. Bu dönemde menşei bilgisi hem mevcut attributes altından hem de yeni origin alanı üzerinden gönderilebilecektir. Yeni alan şu an için opsiyonel (optional) statüsündedir. origin alanı 30 Haziran 2026 tarihinde zorunlu olacaktır bu yüzden entegrasyonlarınızı bu yeni alana göre güncellemenizi önemle rica ederiz. Gönderebileceğiniz Menşei Değerleri Listesine entegrasyon dokumanımız üzerinden ulaşabilirsiniz. **2. Tam Geçiş ve Zorunluluk Dönemi:** Belirlenen deadline sonunda origin alanı zorunlu (required) hale gelecektir. Attribute altından menşei bilgisi gönderimi kademeli olarak desteğini yitirecektir. **Veri Taşıma (Migration) Bilgilendirmesi** Geçmişe dönük verileriniz için endişelenmenize gerek yok. Deadline geldiğinde, attributes içerisinde yer alan tüm mevcut menşei bilgileri, Trendyol ekipleri tarafından otomatik olarak yeni origin alanına taşınacaktır. **Entegrasyon dokumanımız üzerinden ilgili servislere eklenen yeni alanı kontrol edebilirsiniz:** Ürün Aktarma V1 (createProducts) Ürün Bilgisi Güncelleme V1 (updateProduct) Toplu İşlem Kontrolü (getBatchRequestResult) Ürün Filtreleme V1 (filterProducts) Ürün Yaratma v2 Ürün Güncelleme - Onaysız Ürün v2 Ürün Güncelleme - Onaylı Ürün v2 (Varyant) Toplu İşlem Kontrolü (getBatchRequestResult) Ürün Filtreleme - Onaysız Ürün v2 Ürün Filtreleme - Onaylı Ürün v2 Saygılarımızla, Trendyol Entegrasyon Ekibi

22.04.2026

Değerli İş Ortağımız, 21 nisan 16:00 - 22 nisan 13:40 aralığında entegrasyondan sipariş paketlerini çekmeye çalışan satıcıların bir kısmı servisten paketleri çekerken hata aldılar. Sorun 22 Nisan 13.41 itibariyle çözülmüştür. Bu aralıktaki siparişlerinizi entegrasyon servisleri üzerinden kontrol etmenizi tavsiye ederiz. Saygılarımızla, Trendyol Entegrasyon Ekibi

20.04.2026

Değerli İş Ortağımız, Değişen ülke gümrük ve vergi politikaları sebebiyle, satıcılarımızın kârlılığını ve satış hacmini koruyarak yurt dışı satış operasyonuna devam edebilmesi adına **Romanya’da Trendyol Yurt Dışı Aracılığı modelini** hayata geçiriyoruz. Yeni iş modelimiz **ilk aşamada sadece Romanya** için geçerli olacaktır. Bu model kapsamında, müşterilerden sipariş geldikçe, sipariş bazında satıcılardan **Trendyol’a fatura kesilmesi beklenecek** ve **siparişlerin gümrük işlemleri ve ihracat süreçleri Trendyol tarafından gerçekleştirilecektir**. Bu modelde Türkiye Pazaryeri ürün listesinde olan **ürünlerin, Trendyol Satıcı Paneli'nden Trendyol Yurt Dışı Aracılığı'na açılması gerekmektedir.** **Entegrasyon servislerindeki değişiklikler aşağıdaki gibi olacaktır:** 1. **Sipariş paketlerini çekme servisi ve webhook modele "is4P" field'ı eklenmiştir**; ""Trendyol Yurt Dışı Aracılığı"" için olan siparişler için **"is4P" alanı true olarak** dönecektir. Bu alanın ilgili servislere eklenmesi ve kontrol edilmesi gerekmektedir. "Trendyol Yurt Dışı Aracılığı" için olan siparişler için **fatura adresi ""DSM Grup Danışmanlık""ın bilgileri** ile dönecektir. **Fatura, "DSM Grup Danışmanlık"ın bilgileri ile oluşturulmalıdır.** 2. **AB Ürün Etiketi & Kargo Etiketi isimli yeni bir servis** kullanılacak olup, Trendyol Yurt Dışı Aracılığı siparişleri için bu servisten AB ürün etiketi alınması gerekmektedir. * **Trendyol öder modeli** ile çalışan satıcıların **TEX veya Aras kargo gönderileri için Kargo Etiketi ve AB Ürün Etiketini beraber dönecektir**. * **Satıcı öder modeli** ile çalışan satıcılar ve **Trendyol öder ile çalışan satıcıların TEX veya Aras harici gönderileri için servisten yalnızca AB Ürün Etiketi dönecektir**. * Yeni servis, stage ortamda kullanıma hazırdır, production ortam geliştirmeleri bu hafta içinde tamamlanacak olup, duyurusu ayrıca yapılacaktır. 3. **İade edilen siparişleri çekme servisinde** **customerFirstName** ve **customerLastName** sabit şekilde **""DSM Grup Danışmanlık""ın bilgileri** ile dönecektir. Bölge gereklilikleri ve kısıtları göz önünde bulundurularak yapılan değerlendirmeler sonucu uygun bulunan satıcılarımıza, **yeni model 12 Mayıs 2026 itibari ile açılmaya başlayacaktır**. Belirtilen tarihe kadar geliştirme süreçlerinizi tamamlayarak yeni servislere geçiş yapmanızı önemle rica ederiz. Trendyol Yurt Dışı Aracılığı İş Modeli ile ilgili detaylar ve etkilenen servisleri aşağıda bulabilirsiniz: 1. [https://developers.trendyol.com/docs/pazaryeri-i%CC%87%C5%9F-modelleri-1](https://developers.trendyol.com/docs/pazaryeri-i%CC%87%C5%9F-modelleri-1) 2. [https://developers.trendyol.com/docs/sipari%C5%9F-paketlerini-%C3%A7ekme-getshipmentpackages](https://developers.trendyol.com/docs/sipari%C5%9F-paketlerini-%C3%A7ekme-getshipmentpackages) 3. [https://developers.trendyol.com/docs/webhook-model](https://developers.trendyol.com/docs/webhook-model) 4. [https://developers.trendyol.com/docs/ab-%C3%BCr%C3%BCn-etiketi-ile-birlikte-ortak-etiket-barkodun-al%C4%B1nmas%C4%B1](https://developers.trendyol.com/docs/ab-%C3%BCr%C3%BCn-etiketi-ile-birlikte-ortak-etiket-barkodun-al%C4%B1nmas%C4%B1) 5. [https://developers.trendyol.com/docs/i%CC%87adesi-olu%C5%9Fturulan-sipari%C5%9Fleri-%C3%A7ekme-getclaims](https://developers.trendyol.com/docs/i%CC%87adesi-olu%C5%9Fturulan-sipari%C5%9Fleri-%C3%A7ekme-getclaims) Saygılarımızla, Trendyol Entegrasyon Ekibi

08.04.2026

Değerli İş Ortağımız, Entegrasyon servislerimize, ürünlerinize video ekleyebileceğiniz yeni bir servis ekledik. Entegrasyon servisleri üzerinden ürünlerinize video içerik ekleyebilirsiniz. * **Video Yükleme Servisi** ile ürünlerinize video ekleyebilirsiniz * **Video Listeleme Servisi** ile yüklenen videoların onay durumlarını takip edebilir ve listeleybilirsiniz [https://developers.trendyol.com/docs/seller-integration-video-api](https://developers.trendyol.com/docs/seller-integration-video-api) Saygılarımızla, Trendyol Entegrasyon Ekibi

06.04.2026

Değerli İş Ortağımız, Altyapı geçişi nedeniyle yeni ürün yaratma, onaysız ürün güncelleme, onaysız ürün silme akışlarındaki tüm işlemler gecikmeli olarak yansıtılacaktır. Bir veri kaybı olması beklenmiyor fakat işlemler geç yansıyacağından ekranda ve response'larda işlem tamamlanmamış gibi görünecek. Operasyonun başlangıç tarihi: 7 Nisan 23:00 Operasyonunun bitiş tarihi: 8 Nisan 03.00 Saygılarımızla, Trendyol Entegrasyon Ekibi

02.04.2026

Değerli İş Ortağımız Sipariş paketlerini çekme servisi ve webhook modelinin response'larına yeni alanlar ve var olan bazı alanların yeni isimlendirilmiş halleri geçtiğimiz aylarda eklenmişti. Ek olarak bazı alanlar kaldırılmıştı. İsimlendirme değişikliği yapılan alanların eski halleri 2 Nisan 2026'da stage ortamdan 6 Nisan 2026'da da production ortamın response'undan kaldırılacaktır. Herhangi bir problemle karşılaşmamak için gerekli düzenlemeleri yapmanızı ivedilikle rica ederiz. **Yeni eklenen alanlar:** * “cancelledBy”: * “cancelReason”: * “cancelReasonCode”: * "lineTotalDiscount" ("lineSellerDiscount"+ "lineTyDiscount") * "packageTotalDiscount": ("packageSellerDiscount"+ "packageTyDiscount") **İsimlendirme değişikliği yapılan alanlar / 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" **Kaldıralacak alanlar:** * "sku": * "scheduledDeliveryStoreId": * "agreedDeliveryDateExtendible": * "extendedAgreedDeliveryDate": * "agreedDeliveryExtensionEndDate": * "agreedDeliveryExtensionStartDate": * "groupDeal": **Entegrasyon servisimize aşağıdan ulaşabilirsiniz;** [https://developers.trendyol.com/docs/sipari%C5%9F-paketlerini-%C3%A7ekme-getshipmentpackages#/versions](https://developers.trendyol.com/docs/sipari%C5%9F-paketlerini-%C3%A7ekme-getshipmentpackages#/versions) [https://developers.trendyol.com/update/docs/webhook-model#/versions](https://developers.trendyol.com/update/docs/webhook-model#/versions) Saygılarımızla, Trendyol Ekibi

18.03.2026

Değerli İş Ortağımız, Stok-fiyat servisine yapılan güncelleme isteklerinde geçici bir gecikme yaşanmaktadır. Teknik ekibimiz durumun en kısa sürede normale dönmesi için çalışmalarını sürdürmektedir. Bu durumun geçici bir süreç olduğunu belirtir, anlayışınız için teşekkür ederiz. Sorunun başlandığı tarih 19 Mart 21:15 Sorunun çözüldüğü tarih 19 Mart 23:42 Saygılarımızla, Trendyol Entegrasyon Ekibi

18.03.2026

Değerli İş Ortağımız, **Cari Hesap Ekstresi Entegrasyonu Servislerimizde** otherfinancials servisinde Platform Hizmet Bedeli faturalarının filtrelenebilmesi için "transactionSubType" olarak yeni bir filtre parametresi eklenmiştir. Platform hizmet bedeli kayıtlarını filtrelemek için "PlatformServiceFee" değeri kullanılabilir. Bu parametreyi kullanmak için transactionType=DeductionInvoices ya da transactionTypes içinde DeductionInvoices olacak şekilde istek yapılmalıdır. İlgili servis ve parametre detaylarına aşağıdan ulaşabilirsiniz: [https://developers.trendyol.com/docs/cari-hesap-ekstresi-entegrasyonu](https://developers.trendyol.com/docs/cari-hesap-ekstresi-entegrasyonu) Saygılarımızla, Trendyol Entegrasyon Ekibi

17.03.2026

Değerli İş Ortağımız, **Soru & Cevap Entegrasyonu Servislerimize** sistem sağlığı açısından **27 Mart 2026** tarihi itibari ile **servis limiti eklenecektir.** Aşağıdaki servis limitlerini dikkate alarak istek yapabilirsiniz: * **Müşteri Sorularını Çekme Servisi:** 1000 req/min * **Müşteri Sorularını Cevaplama Servisi:** 500 req/min Saygılarımızla, Trendyol Entegrasyon Ekibi

16.03.2026

Değerli İş Ortağımız, Sipariş paketlerini çekme servisimizde ve Webhook modelimizde, lines objesi altına "businessUnit" isimli yeni bir alan eklenmiştir. Bu alanda "Digital Goods" değerini alan siparişleriniz için entegrasyon süreçlerinizde aşağıdaki maddeleri dikkate almanızı rica ederiz: **Müşteri Bilgileri:** businessUnit alanı "Digital Goods" olan siparişlerde, müşteri telefon numarası bilgisi "null" olarak dönecektir. **Dijital Kod Gönderimi:** Alternatif Teslimat ile Gönderim servisi üzerinden ilettiğiniz dijital kod, Trendyol tarafından doğrudan müşteriye ulaştırılacaktır. **Dijital Ürün Olmayan Gönderilerde Hata Mesajı**: businessUnit alanı "Digital Goods" olmayan bir sipariş paketi için Alternatif Teslimat le Gönderim servisi üzerinden dijital kod gönderimi yapılmak istendiği durumda; sistem tarafından "digital.good.business.unit.not.valid" hatası dönecektir. **Etkilenen servisler:** * Sipariş Paketlerini Çekme Servisi * Webhook Model * Alternatif Teslimat İle Dijital Ürün Gönderimi Süreçlerinizde aksama yaşanmaması adına gerekli güncellemeleri yapmanızı önemle rica ederiz. Saygılarımızla, Trendyol Entegrasyon Ekibi

09.03.2026

Değerli İş Ortağımız, Sipariş paketlerinin statü güncellemelerinde geçici bir gecikme yaşanmaktadır. Teknik ekibimiz durumun en kısa sürede normale dönmesi için çalışmalarını sürdürmektedir. Bu durumun geçici bir süreç olduğunu belirtir, anlayışınız için teşekkür ederiz. \*\*Sorun 10 Mart 11:30 itibariyle çözülmüştür Saygılarımızla, Trendyol Entegrasyon Ekibi

05.03.2026

Değerli İş Ortağımız, Sizlere daha hızlı, stabil ve kesintisiz bir altyapı sunabilmek adına sistem performansımızı sürekli olarak iyileştiriyoruz. Bu kapsamda, Sipariş Paketlerini Çekme servisimizde önemli bir güncelleme yapacağımızı bildirmek isteriz. Sistem kaynaklarımızı daha verimli kullanarak API yanıt sürelerimizi hızlandırmak amacıyla, geçmişe dönük sipariş verisi sorgulama limitlerimizi güncelliyoruz. Daha önce 3 aylık geçmiş sipariş verilerini çekmenize olanak tanıyan servisimiz, **5 Mart 2026** itibarıyla **maksimum 1 aylık (30 gün)** veriyi kapsayacak şekilde optimize edilecektir. **Bu değişiklik sizin için ne anlama geliyor?** **5 Mart 2026** gününden itibaren servis üzerinden yalnızca son 1 aya ait sipariş paketlerinizi çekebileceksiniz. Eğer 1 aydan daha eski (son 3 aya ait) sipariş verilerinize ihtiyacınız varsa, Trendyol Satıcı Paneli üzerinden siparişlerinize ulaşabilirsiniz Entegrasyonlarınızda, otomatik görevlerinizde veya raporlama süreçlerinizde hata almamak adına sistemlerinizi maksimum 1 aylık sorgu yapacak şekilde güncellemenizi rica ederiz. Bu sürecin işleyişinize olan etkisini en aza indirmek için gereken düzenlemeleri zamanında yapmanızı önemle rica ederiz. Anlayışınız ve iş birliğiniz için teşekkür ederiz. Herhangi bir sorunuz veya teknik desteğe ihtiyacınız olursa, bizimle her zaman iletişime geçebilirsiniz. Saygılarımızla, Trendyol Entegrasyon Ekibi

25.02.2026

Değerli İş Ortağımız, Sipariş paketlerini çekme servisi ve webhook modelinin response'larına Teslimat Numarası alanı eklenmiştir. Yeni eklenen alan: shipmentNumber Entegrasyon servisimize aşağıdan ulaşabilirsiniz; [https://developers.trendyol.com/docs/sipari%C5%9F-paketlerini-%C3%A7ekme-getshipmentpackages](https://developers.trendyol.com/docs/sipari%C5%9F-paketlerini-%C3%A7ekme-getshipmentpackages) İş birliğiniz için teşekkür eder, iyi çalışmalar dileriz. Saygılarımızla, Trendyol Ekibi

10.02.2026

Değerli İş Ortağımız, Sizlere daha verimli ve optimize edilmiş bir operasyonel deneyim sunmak amacıyla, ürün entegrasyon servislerimizde önemli bir yapısal güncellemeye gidiyoruz. **Yapılan Değişikliğin Kapsamı:** Mevcut barkod bazlı yapıdan, daha esnek ve kapsayıcı olan içerik (content) bazlı yapıya geçiş yapıyoruz. Bu değişiklikle birlikte, Seller Center ile entegrasyon servislerimiz arasındaki veri modeli uyumunu tam hale getirerek süreçlerinizi standardize etmeyi hedefliyoruz. **Geçiş Süreci ve Takvim:** **Yeni Servislerin Erişimi:** Yeni nesil servislerimiz (v2) bugünden itibaren kullanıma açılmıştır. **Eski Servislerin Kapatılması:** Mevcut (eski) servislerimiz 10 Ağustos 2026 tarihine kadar desteklenmeye devam edecektir. **Aksiyon Beklentisi:** Entegrasyonlarınızda herhangi bir kesinti yaşamamanız adına, belirtilen tarihe kadar geliştirme süreçlerinizi tamamlayarak yeni servislere geçiş yapmanızı önemle rica ederiz. **Yeni Eklenen Servis Listesi (v2:)** Aşağıdaki servislerin güncel versiyonlarını dokümantasyonlarımız üzerinden inceleyebilirsiniz: * Ürün Yaratma v2 * Ürün Filtreleme - Temel Bilgiler v2 * Ürün Filtreleme - Onaysız Ürün v2 * Ürün Filtreleme - Onaylı Ürün v2 * Ürün Güncelleme - Onaysız Ürün v2 * Ürün Güncelleme - Onaylı Ürün Content Güncelleme v2 * Ürün Güncelleme - Onaylı Ürün Varyant Güncelleme v2 * Ürün Güncelleme - Onaylı Ürün Teslimat Bilgisi Güncelleme v2 * Kategori Özellik Listesi v2 * Kategori Özellik Değerleri Listesi v2 İş birliğiniz için teşekkür eder, iyi çalışmalar dileriz. Saygılarımızla, Trendyol Ekibi

30.12.2025

Cari hesap ekstresi entegrasyonu kapsamındaki settlements ve otherfinancials servislerimize iki yeni filtre parametresi eklenmiştir: 1. transactionTypes: Tek bir istekte birden fazla işlem türüne ait muhasebe kayıtlarını listeleyebilirsiniz. 2. paymentDate: Muhasebe kayıtlarını, "ödemeye girebileceği en erken tarih" filtresiyle sorgulayabilirsiniz. Entegrasyon servisimize aşağıdan ulaşabilirsiniz: [https://developers.trendyol.com/docs/cari-hesap-ekstresi-entegrasyonu](https://developers.trendyol.com/docs/cari-hesap-ekstresi-entegrasyonu)

08.12.2025

Sipariş paketlerini çekme servisi ve webhook modelinin response'larına yeni alanlar ve var olan bazı alanların yeni isimlendirilmiş halleri eklenmiştir. Ek olarak bazı alanlar kaldırılmıştır. İsimlendirme değişikliği yapılan alanların eski halleri 1 ay sonra response'dan kaldırılacaktır. Herhangi bir problemle karşılaşmamak için gerekli düzenlemeleri yapmanızı ivedilikle rica ederiz. 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

İade paketlerini çekme servisine var olan bazı alanların yeni isimlendirilmiş halleri eklenmiştir. İsimlendirme değişikliği yapılan alanların eski halleri 2 ay sonra response'dan kaldırılacaktır. Herhangi bir problemle karşılaşmamak için gerekli düzenlemeleri yapmanızı ivedilikle rica ederiz. Fields where naming changes were made: * content/"id": > "claimId" * "vatBaseAmount": > "vatRate"

29.08.2025

Sipariş paketlerini çekme servisimiz üzerinde yaşanan bir incident sebebi ile, servisi birden fazla parametre ve "Cancelled" statusu ile birlikte kullanıyorsanız, (örneğin Cancelled ve Created statulerini aynı anda çekmeye çalışıyorsanız) "shipmentPackageStatus" alanı servis responsunda yer almamıştır. Buradaki sorun 28 Ağustos 2025 tarihinde başlamış olup, 29 Ağustos 2025 Saat 13.00 itibari ile çözülmüştür. Bu doğrultuda ilgili aralıktaki siparişlerinizi kontrol etmenizi rica ederiz.

31.07.2025

Değerli geri bildirimlerinize doğrudan yanıt olarak geliştirilen yeni bir özelliğin lansmanını duyurmaktan mutluluk duyuyoruz. Ürün Arşivleme API hizmeti artık yayında ve kullanılabilir. Bu hizmet, Trendyol sisteminde ürünlerinizi arşivlemek veya arşivden çıkarmak için kullanılır. Hem tekli hem de çoklu ürün arşivleme işlemlerini destekler.

24.06.2025

Trendyol OMS modeline (getShipmentPackages ve Webhook servislerine) yeni "createdBy" ve "originPackageIds" alanları eklenmiştir. "createdBy" alanı paketin nasıl oluştuğunu belirtiyor: * order-creation: gelen siparişte direkt paketin yaratıldığı, * cancel: kısmi iptal sonrası paketin yaratıldığı, * split: paket bölmeye istinaden paketin yaratıldığı, * transfer: paketin muadil ürün süreci sonrasında yaratıldığı "originPackageIds" alanı cancel veya split sonrası dolu geliyor, bu işlemler sonrası ilk paketin packageid'sini veriyor.

26.05.2025

Değerli İş Ortağımız, Servis standartlarımızı sağlamak ve servislerimizin performansını arttırmak amacı ile entegrasyon servislerimizde base url değişikliği gerçekleştirilmiştir. Eski servisler 26 Mayıs sonu itibari ile kapatılmaya başlanmıştır. Eğer servis URL'lerinde düzenleme yapmadıysanız isteklerinizde hata ile karşılaşacaksınız. Süreçlerinizin aksamaması için en kısa süre içerisinde yeni servis endpointlerimizi servis bazlı kontrol etmenizi rica ederiz. [https://developers.trendyol.com](https://developers.trendyol.com)

22.05.2025

Trendyol OMS modeline (getShipmentPackages ve Webhook servislerine) yeni "latitude", "longitude" ve "cargoDeci" alanları 22.05.2025 tarihinde eklenmiştir. Detaylar için dökümanımızı kontrol edebilirsiniz.

09.05.2025

Stock\&Price Güncelleme Servisinin BatchRequestResult Response'unda güncelleme olmuştur. Yeni Response modeline Toplu İşlem Kontrolü sayfası üzerinden ulaşabilirsiniz.

08.05.2025

12 Mayıs Pazartesi tarihi itibariyle Aras Kargo ile olan satıcı öder entegrasyonunda değişikliğe gitmekteyiz. Bu değişiklik ile birlikte, Kargo Takip Kodu Bildirme (updateTrackingNumber) servisimiz kullanıma kapatılacak olup, paketlerinizi sipariş paketlerini çekme servisimiz (getShipmentPackages) üzerinden dönen “cargoTrackingNumber” ile kargo firmasına teslim etmeniz gerekmektedir. 30 Haziran 2025 itibarıyla entegrasyon yapılarınızda değişikliğe gitmeniz gerekmektedir.

08.05.2025

Web color 348 attribute'u 5 Mayıs Pazartesi günü zorunlu hale getirilmişti. Kampanya döneminde sorun yaşanmaması adına bu attribute kampanya sonuna kadar optional olacak şekilde değiştirilmiştir. Kampanya sonrasında yeniden zorunlu hale getirilecektir. Ürün yükleme süreçlerinde sorun yaşamamanız adına kategori ağacını güncellemenizi rica ederiz.

11.04.2025

Sipariş paketlerini çekme servisimize ve webhook modelimize "productCategoryId" ve "laborCost" alanı eklenmiştir. Bu alanlar sipariş paketlerini çekme servisi içerisine "lines" alanı altına eklenecektir. Entegrasyon servisimize döküman üzerinden ulaşabilirsiniz.

09.04.2025

Entegrasyon servislerimizin durumunu gerçek zamanlı takip edebileceğiniz API Health Check sayfamızı kullanıma sunduk. Servislerin çalışma durumunu ve genel sağlık durumunu takip edebilirsiniz. Adres: [https://developers.trendyol.com/api-status](https://developers.trendyol.com/api-status)

04.04.2025

Teslimat Entegrasyonu başlığı altına Tazmin Entegrasyon Servisi eklenmiştir. Bu servis ile kargo firması TEX olan sipariş paketleriniz için tazmin işlemlerinizi takip edebilirsiniz.

28.03.2025

1 Nisan 2025 tarihinde yürürlüğe girecek olan yönetmelik kapsamında satışa sunduğunuz ürünlerin ilanlarında üretici bilgisi, ithalatçı bilgisi, kullanım talimatı ve CE uygunluk sembolü gibi bilgilerin eksiksiz olması gerekmektedir. İlgili özelliklere aşağıdaki attributeId değerleri ile erişilebilir: * attributeID: 1198 -> "Üretici Bilgisi" * attributeID: 1216 -> "İthalatçı/ Yetkili Temsilci" * attributeID: 1116 -> "Kullanım Talimatı/Uyarıları" * attributeID: 1210 -> "CE Uygunluk Sembolu"

21.03.2025

Cari Hesap Ekstresi Entegrasyonu settlements ve otherFinancials servislerimize shipmentPackageId alanı eklenmiştir. Entegrasyon dökümanımız üzerinden kontrol edebilirsiniz.

18.03.2025

Sipariş paketlerini çekme servisimize ve webhook modelimize "identityNumber" alanı eklenecektir. İlgili alan “string” data tipinde olup, 21 Mart tarihinde eklenmesi planlanmaktadır. Bu alanın eklenmesi ile birlikte, "tcIdentityNumber" alanı 5 Mayıs itibari ile kaldırılacaktır.

17.03.2025

Sipariş faturalarının HTML formatında yüklenmesi sorunlara yol açabilmektedir. Faturalarınızı HTML harici formatlarda (PDF, JPEG, PNG, link) yüklemenizi öneririz. Güvenlik ve erişilebilirlik adına ilgili geliştirmeleri en kısa sürede yapmanızı beklemekteyiz.

14.03.2025

7 Nisan 2025 tarihi itibari ile, İade paketlerini çekme servisimize “WaitingFraudCheck” statusü eklenecektir. Fraud kontrolüne giren iadeler maksimum 9 saat içerisinde çözümlenecek olup, başarılı olanlar “Accepted”, sorunlu olanlar “Rejected” statusune geçecektir.

05.03.2025

1 Nisan 2025 tarihinde yürürlüğe girecek yönetmelik hatırlatmasıdır. Güvenli ürün kapsamında ürün özelliklerinin eksiksiz doldurulması kritik önem taşımaktadır. Yönetmelik kapsamındaki yaptırımlar arasında satışın durdurulması ve para cezaları bulunmaktadır.

03.03.2025

Entegrasyon servislerimizde 03.03.2025 ile 17.03.2025 tarihleri arasında Trendyol içi testler yapılacağı için servislerimize atacağınız isteklerinizde hata alabilirsiniz.

27.02.2025

Ramazan ayı büyük indirim dönemi öncesinde ürünlerinizin fiyat ve stok durumunu kontrol etmeniz, satış performansınızı ve satıcı puanınızı korumanız açısından önem arz etmektedir.

27.02.2025

Entegrasyon servislerimizde uyguladığımız limitler, listeleme limitleri baz alınarak güncellenecektir. İlk fazda sipariş servislerimiz ile uygulama başlamıştır. Limit detaylarına entegrasyon dokümanımızdan ulaşabilirsiniz.

26.02.2025

Servis performansını arttırmak amacı ile base url değişikliği gerçekleştirilmektedir. Eski servisler 26 Mayıs itibari ile kapatılacak olup, yeni endpointler için entegrasyon dökümanımızı kontrol etmenizi rica ederiz.

25.02.2025

Eski servisler Nisan ayı itibari ile kapatılacaktır. Ürün, Sipariş, Ortak Etiket, İade, Soru Cevap, Muhasebe ve Webhook servislerinin tamamı yeni base url üzerinde canlıya alınmıştır.

11.02.2025

Trendyol OMS modeline yeni adres alanları eklenmiştir. CEE bölgesi için "countyId" ve "countyName", GULF bölgesi için "shortAddress" ve "stateName" alanları dolu gelecektir.

31.01.2025

OMS modelimize yeni adres alanları (countyId, countyName, shortAddress, stateName) eklenmiştir. "shipmentAddress" ve "invoiceAddress" altından kontrol edilebilir.

07.01.2025

08.01.2025 05.00-05.30 arasında claim servisleri üzerinde teknik çalışma yapılacaktır. Bu sürede iade işlemleri yapılamayacaktır.

02.01.2025

Yeni katalog yapısına geçiş süreci nedeniyle anlık hatalar ve yansıma gecikmeleri yaşanabilir.

02.01.2025

02.01.2025 tarihinde yaşanan geçici sistem hatası nedeniyle 500 hataları alınmış olabilir. Sorun üzerinde çalışılmaktadır.

27.12.2024

Test Siparişi Oluşturma servisimizin endpoint'i değişmiştir. Yeni endpoint: [https://stageapi.trendyol.com/integration/order/orders/core](https://stageapi.trendyol.com/integration/order/orders/core)

27.12.2024

30 Aralık itibariyle Sendeo yerine Kolay Gelsin kargo firmasının kullanılması gerekmektedir.

27.12.2024

otherfinancials endpoint'i için yeni "transactionType=Stoppage" eklenmiştir. Bu tip ile E-ticaret Stopaj kalemleri listelenebilecektir.

25.12.2024

1 Ocak 2025 itibarıyla yapılacak ödemelerden %1 stopaj yapılacaktır. Bu kapsamda ürün bedeli ile işçilik bedelinin ayrıştırılması gerekmektedir. İşçilik bedelleri line bazlı bildirilmelidir.

23.12.2024

Bazı kategorilerde aynı özelliğin birden fazla görünmesi sorunu üzerinde çalışılmaktadır.

23.12.2024

"lines" altına "discountPercentage" alanı eklenmiştir. Bu alan ile ürün bazlı indirimler simule edilebilecektir.

18.12.2024

17-18 Aralık tarihlerinde yaşanan geçici 500 hatası sorunu çözülmüştür. Bu tarihler arasındaki siparişlerinizi kontrol etmeniz rica olunur.

13.12.2024

Webhook Retry Modeli, Statu Modeli (subscribedStatuses), Authorization Model (API\_KEY) ve Aktif/Pasif servisleri eklenmiştir.

09.12.2024

15 Ocak'tan sonra Web Color (348) attribute'u zorunlu olacaktır. Bu alan gönderilmezse sistem ürün yaratma hatası verecektir.

08.03.2024

Azerbaycan ve GULF ülkeleri için fatura üzerindeki numara ile sistemdeki numara aynı olmalıdır. Kontroller 1 Nisan 2024'ten itibaren geçerli olacaktır.

20.12.2023

Bahreyn, Umman ve Kuveyt ülkeleri eklendi. Adres alanı id değerleri için dökümanı kontrol ediniz.

21.11.2023

Suudi Arabistan ve BAE'den sonra Katar da ülke listesine eklendi.

19.10.2023

Mikro ihracat siparişleri için "productOrigin" datası üzerinden menşei bilgisi iletilmelidir.

25.08.2023

Hatalı beslenen faturalar bu servis üzerinden silinip tekrar beslenebilir.

21.08.2023

Stage ortamında iade statüsünü waitinginaction'a çekmek için ilgili servis kullanılabilir.

11.08.2023

Trendyol tarafından kesilen kargo faturalarının detaylarına DeductionInvoices responsundan ulaşabilirsiniz.

27.07.2023

4 Ağustos 2023 itibarıyla Mikro ihracat paketleri için “invoiceNumber” ve “invoiceDateTime” alanları zorunlu hale gelmiştir.

12.07.2023

14.07.2023'ten itibaren Azerbaycan siparişlerinde countryCode "AZ" olarak dönecektir. "micro" alanı True ise sipariş mikro ihracat siparişidir.

11.07.2023

12.07.2023 itibarıyla mikro ihracat faturaları panelden veya link servisi ile yüklenmelidir. “invoiceNumber” ve “invoiceDateTime” alanları zorunludur.

07.07.2023

10 Temmuz 2023 itibarıyla KDV oranları %10 ve %20 olarak güncellenmiştir. Eski oranlarla yapılan istekler hata alacaktır.

03.07.2023

Azerbaycan siparişleri için son geçiş tarihi uzatılmıştır. Yeni tarih netleştiğinde bilgi verilecektir.

15.06.2023

sendInvoiceLink servisine eklenen “invoiceNumber” ve “invoiceDateTime” alanlarının mikro ihracat için zorunlu olduğu hatırlatılır.

15.06.2023

03.07.2023'ten itibaren Azerbaycan adresleri için countryCode "AZ" olarak dönecektir.

12.06.2023

Stage ortamında sipariş statülerini Shipped, Delivered vb. olarak güncellemek için ilgili servis kullanılabilir.

29.05.2023

Güncel liste Trendyol Kargo Şirketleri Listesi dökümanı üzerinden indirilebilir.

16.05.2023

Azerbaycan İhracat projesi ile yeni alanlar eklenmiştir. Örnek JSON isteği dökümanda mevcuttur.

06.07.2026

Dear Business Partner, To ensure system health, new rate limits based on seller product listing limits will be applied to our Product Integration Services, starting from September 14, 2026. You can access the new limit details for the relevant services via the link below: https://developers.trendyol.com/v2.0/docs/1-service-limitations Best regards, Trendyol Integration Team

26.06.2026

Dear Business Partner, Creating Customer Questions Service was developed in stage environment. You can create your own product questions in order to progress your tests for Question\&Answer Services. [https://developers.trendyol.com/v2.0/docs/creating-customer-questions-in-stage-environment](https://developers.trendyol.com/v2.0/docs/creating-customer-questions-in-stage-environment) Best regards, Trendyol Integration Team

02.06.2026

Dear Business Partner, The limits for the current getShipmentPackage service will be updated as of June 8 , 2026. Your requests to this service must comply with the new limits; otherwise, you will receive a 429 error. Current getShipmentPackages will be limited to 10,000 total records. Service Limitations: [https://developers.trendyol.com/v2.0/docs/1-service-limitations#/versions](https://developers.trendyol.com/v2.0/docs/1-service-limitations#/versions) In order to provide large data scanning ability yu can use the "getShipmentPackagesStream" service. The getShipmentPackagesStream endpoint allows you to fetch order packages using cursor-based streaming. This endpoint is designed for large-scale data scanning (full scan), periodic synchronization (polling/cron), and exporting all orders; while the response structure remains the same, pagination-related fields such as totalElements, totalPages, page will no longer be returned due to the switch to a cursor-based pagination mechanism. Data from the last 3 months is accessible through this endpoint. You can reach the details below the link: [https://developers.trendyol.com/v2.0/docs/marketplace-business-models#/versions](https://developers.trendyol.com/v2.0/docs/marketplace-business-models#/versions) Best regards, Trendyol Integration Team

13.05.2026

Dear Business Partner, At Trendyol, we are implementing a significant update to our product services to modernize our data structures and enhance the efficiency of your integration processes. Moving forward, the "Origin" (Country of Origin) information—which was previously managed under the "Attribute" section—will now be handled as an independent, standard field, similar to stockCode or barcode. **How Will the Transition Process Work?** To ensure a seamless experience, we have designed a two-phase ""soft transition"" model: **1. Hybrid Period (Transition Phase):** A new field named origin has been added to the product payload. During this period, origin information can be sent via both the existing attributes section and the new origin field. Currently, the new field is optional. However, the origin field will become mandatory on June 30, 2026. Therefore, we strongly recommend updating your integrations to support this new field as soon as possible. You can access the List of Origin Values through our integration documentation. **2. Full Transition and Mandatory Period:** Following the deadline, the origin field will become required. Support for sending origin information via the attributes section will be gradually phased out. **Data Migration Information** There is no need for concern regarding your historical data. Once the deadline is reached, all existing origin information within the attributes section will be automatically migrated to the new origin field by the Trendyol team. **You can review the newly added field in the relevant services via our integration documentation:** Product Creation V1 (createProducts) Update Product V1 (updateProduct) Batch Request Status (getBatchRequestResult) Product Filtering V1 (filterProducts) Product Creation V2 Update Product - Unapproved V2 Update Product - Approved V2 (Variant) Product Filtering - Unapproved V2 Product Filtering - Approved V2 Sincerely, Trendyol Integration Team

22.04.2026

Dear Business Partner, Between April 21st, 16:00 and April 22nd, 13:40, some sellers attempting to retrieve order packages from the integration service encountered errors. This issue was resolved as of April 22nd, 13:41. We recommend checking your orders from this period through the integration services. Sincerely, Trendyol Integration Team

08.04.2026

Dear Business Partner, We have added a new integration service that allows you to add video content to your products. You can now manage your product videos directly through our integration services. * **Video Upload Service**: Used to add video content to your products. * **Video Listing Service**: Used to list the approval status and list your uploaded videos [https://developers.trendyol.com/v2.0/update/docs/video](https://developers.trendyol.com/v2.0/update/docs/video) Best regards, Trendyol Integration Team

06.04.2026

Dear Business Partner, Due to an infrastructure migration, all operations in the flows for creating new products, updating unapproved products, and deleting unapproved products will be reflected with a delay. No data loss is expected; however, since the processing will be delayed, operations may appear incomplete on the dashboard and in API responses. Operation Start Date: April 7, 23:00 Operation End Date: April 8, 03:00 Best regards, Trendyol Integration Team

02.04.2026

Dear Business Partner 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 at 2 April 2026 in the stage environment response and 6 April 2026 in the production environment response. 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": **You can access our integration service below;** [https://developers.trendyol.com/v2.0/docs/get-order-packages-getshipmentpackages#/versions](https://developers.trendyol.com/v2.0/docs/get-order-packages-getshipmentpackages#/versions) [https://developers.trendyol.com/v2.0/update/docs/webhook-model#/versions](https://developers.trendyol.com/v2.0/update/docs/webhook-model#/versions) Best regards, Trendyol Team

18.03.2026

Dear Business Partner, There is a temporary delay in updating requests to the stock-price service. Our technical team is working to resolve the issue as soon as possible. Please note that this is a temporary situation and thank you for your understanding. Date the problem started: March 19th, 21:15 Date the problem was solved: March 19 Mart 23:42 Sincerely, Trendyol Integration Team

18.03.2026

Dear Business Partner, A new filter parameter, "transactionSubType", has been added to the otherfinancials service to enable filtering of Platform Service Fee invoices. "PlatformServiceFee" can be used as value. To utilize this parameter, the request must include transactionType=DeductionInvoices or have DeductionInvoices within the transactionTypes. Please find detailed endpoint and parameter information in below link: [https://developers.trendyol.com/v2.0/docs/current-account-statement-integration](https://developers.trendyol.com/v2.0/docs/current-account-statement-integration) Best Regards, Trendyol Team

17.03.2026

Dear Business Partner, To ensure system stability and maintain high service quality, **rate limits** will be added **starting from 27th March 2026** for our **Question & Answer Integration Services.** Please ensure your requests are made within the following limits: * **Getting Customer Questions:** 1000 req/min * **Answering Customer Questions Service:** 500 req/min We kindly ask you to adjust your integration logic to comply with these limits to avoid any service interruptions. Best Regards, Trendyol Team

16.03.2026

Dear Business Partner, We have added a new field named "businessUnit" under the lines object in our Get Shipment Packages Service and Webhook model. For orders where this field is set to "Digital Goods", please take the following updates into account for your integration processes: **Customer Information**: For orders with the businessUnit set as "Digital Goods," the customer phone number will be returned as "null". **Digital Code:** Digital code sent via the "Shipping with Alternative Delivery" service will be delivered directly to the customer by Trendyol. **Error Message for Non-Digital Good Shipments:** If an attempt is made to send a digital code via the "Shipping with Alternative Delivery" service for orders where the businessUnit is not "Digital Goods," the system will return a "digital.good.business.unit.not.valid" error. **Related services:** * Get Shipment Packages * Webhook Model * Digital Product Delivery with Alternative Delivery Thank you for your cooperation. Best Regards, Trendyol Team

09.03.2026

Dear Business Partner, We are currently experiencing a temporary delay in order package status updates. Our technical team is working to resolve the issue as quickly as possible. Please be advised that this is a temporary situation. Thank you for your patience and understanding. \*\*The issue was resolved as of March 10th, 11:30 AM. Best Regards, Trendyol Team

05.03.2026

Dear Business Partner, In our continuous effort to provide you with a faster, more stable, and seamless platform experience, we are consistently optimizing our system performance. As part of these improvements, we would like to inform you of an upcoming update to our getShipmentPackages Service. To optimize system resources and significantly improve API response times, we are updating the time limit for historical order data retrieval. The service, which previously allowed you to fetch orders from the past 3 months, will be updated to support a maximum retrieval **period of 1 month (30 days)**, effective **5 March 2026**. **What does this mean for you?** Starting **5 March 2026**, you will only be able to fetch order packages from the last 1 month via this service. If you require order data older than 1 month (up to the previous 3-month limit), we strongly advise you to check Trendyol Seller Center. Please ensure that you update your integrations, automated tasks, and reporting processes to query a maximum of 1 month's data to avoid any errors. We kindly ask you to make the necessary adjustments in a timely manner to minimize any disruption to your operations. We appreciate your understanding and cooperation as we work to enhance our infrastructure. If you have any questions or require technical support, please do not hesitate to reach out to our team. Best regards, Trendyol Integration Team

25.02.2026

Dear Business Partner, Shipment Number field has been added to the response for the get shipment packages service and webhook model. Newly added field: shipmentNumber You can access our integration service below; [https://developers.trendyol.com/v2.0/docs/get-order-packages-getshipmentpackages](https://developers.trendyol.com/v2.0/docs/get-order-packages-getshipmentpackages) Best regards, Trendyol Team

10.02.2026

Dear Business Partner, We are reaching out to inform you about a significant structural update to our product integration services aimed at providing a more efficient and optimized operational experience. **Scope of the Update:** We are transitioning from our current barcode-based structure to a content-based structure. This update ensures that our integration services are fully aligned with the Seller Center data model, providing a more standardized and seamless workflow for your operations. **Migration Timeline:** **Availability of New Services:** Our next-generation services (v2) are available for use as of today. **Deprecation of Legacy Services:** Existing legacy services will remain active until August 10, 2026. **Action Required:** To avoid any service interruptions, we kindly request that you complete your development and migrate to the new v2 services before the specified deadline. **Newly Released Services (v2):** You can access and review the updated versions of the following services via our API documentation for Turkey Marketplace below: * Product Create v2 * Product Filter Base Information v2 * Product Filtering - Unapproved Products v2 * Product Filtering - Approved Products v2 * Product Update - Unapproved Product v2 * Product Update - Approved Product v2 * Category Attribute List v2 * Category Attribute Values List v2 Thank you for your cooperation. Best Regards, Trendyol Team

30.12.2025

We have added two new filter parameters to our settlements and otherfinancials services under the Current Account Statement integration: transactionTypes: You can now list accounting records for multiple transaction types in a single request. paymentDate: You can filter accounting records based on the earliest possible payment date. You can access our integration service below: [https://developers.trendyol.com/v2.0/docs/current-account-statement-integration](https://developers.trendyol.com/v2.0/docs/current-account-statement-integration)

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

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.

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.

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.

26.05.2025

Dear Business Partner, In order to provide our service standards and increase the performance of our services, a base URL change has been made in our integration services. Old services have started to be closed as of the end of May 26. If you have not made any changes to the service URLs, you will encounter errors in your requests. In order to prevent any disruptions to your processes, we kindly ask you to check our new service endpoints as soon as possible, based on our service, through our integration document. [https://developers.trendyol.com/en/docs/category/5-trendyol-marketplace-integration](https://developers.trendyol.com/en/docs/category/5-trendyol-marketplace-integration) Best regards, Trendyol Team

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.

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.

08.05.2025

As Trendyol, in order to provide a better service to our sellers, we are making changes to the seller-pays integration with Aras Cargo as of Monday, May 12. With this change, our Cargo Tracking Code Notification (updateTrackingNumber) service will be closed and you must deliver your packages to the cargo company with the “cargoTrackingNumber” returned via our order packages picking service (getShipmentPackages). As of June 30, 2025; In order for sellers to switch to the new integration model, you must make changes to your integration structures and not report cargo tracking codes via the Cargo Tracking Number service.

08.05.2025

The web color 348 attribute was made mandatory on Monday, May 5. In order to avoid problems during the campaign period, this attribute has been changed to be optional until the end of the campaign. It will be made mandatory again after the campaign. We kindly ask you to update the category tree so that you do not experience problems during the product upload process.

11.04.2025

Dear Business Partner, The "productCategoryId" and "laborCost" fields 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/en/docs/trendyol-marketplace/order-integration/get-order-packages](https://developers.trendyol.com/en/docs/trendyol-marketplace/order-integration/get-order-packages) Best regards, Trendyol Team

09.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. * You can reach our API Health Check page at [https://developers.trendyol.com/api-status](https://developers.trendyol.com/api-status).

04.04.2025

The Compensation Integration has been added under the Delivery Integration heading. With this service, you can track your Compensation transactions for your order packages whose cargo company is TEX. Document link: [https://developers.trendyol.com/en/docs/trendyol-marketplace/delivery-integration/compensation-integration](https://developers.trendyol.com/en/docs/trendyol-marketplace/delivery-integration/compensation-integration)

28.03.2025

According to legal regulations in Türkiye, new attributes has been added to our categories. You can check the attributes below; The relevant features are accessible from our category feature pull service with the following attributeId values: * attributeID: 1198 -> "Manufacturer Information" * attributeID: 1216 -> "Importer/Authorized Representative/Performance Service Provider" * attributeID: 1116 -> "Usage Instructions/Warnings" * attributeID: 1210 -> "CE Conformity Symbol" The property values that must include visuals (Visuals activated as of March 13): * attributeID: 134 -> Energy Class * attributeID: 1148 -> Product Information Form * attributeID: 1244 -> Package Image (front) * attributeID: 1245 -> Package Image (back) * attributeID: 1214 -> Energy and Nutritional Values

21.03.2025

The shipmentPackageId field has been added to our Current Account Statement Integration settlements and otherFinancials services. You can check it through our integration document below: [https://developers.trendyol.com/docs/category/4-muhasebe-ve-finans-entegrasyonu](https://developers.trendyol.com/docs/category/4-muhasebe-ve-finans-entegrasyonu)

18.03.2025

The "identityNumber" field will be added to our get shipment package service and webhook model under the "content" field on March 21. With the addition of the relevant field, the "tcIdentityNumber" field will be removed as of May 5. **NOTE:** For orders Romania to Romania (March 21 - April 9), this field will be set as 0. Starting April 9, the real CNP value will be returned in the identityNumber field. [https://developers.trendyol.com/int/docs/international-marketplace/international-order-v2/int-getShipmentPackages](https://developers.trendyol.com/int/docs/international-marketplace/international-order-v2/int-getShipmentPackages)

14.03.2025

As of April 7, 2025, the “WaitingFraudCheck” status will be added to our Getting Returned Orders service. Returns that enter fraud control will be resolved within a maximum of 9 hours. Returns whose fraud control is successful will move to “Accepted”, otherwise “Rejected”. [https://developers.trendyol.com/en/docs/trendyol-marketplace/returned-orders-integration/getting-returned-orders](https://developers.trendyol.com/en/docs/trendyol-marketplace/returned-orders-integration/getting-returned-orders)

05.03.2025

According to legal regulations in Türkiye, new attributes has been added to our categories (Manufacturer Info, Importer Info, Usage Instructions, CE Symbol, etc.). Visual links must be added to properties such as Energy Class and Product Information Form.

27.02.2025

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

27.02.2025

The limits applied in our integration services will be updated based on listing limits (50k, 75k, 150k, 350k, or Unlimited). [https://developers.trendyol.com/en/docs/service-limitations](https://developers.trendyol.com/en/docs/service-limitations)

26.02.2025

In order to ensure our service standards, the base URL is being changed. The old services will be closed as of May 26. Please check new service endpoints: [https://developers.trendyol.com/en](https://developers.trendyol.com/en)

25.02.2025

Base URL change is ongoing. Status of live services: * Product, Order, Common Label, Return (with sellerId), Q\&A, Accounting, and Webhook services are all live.

11.02.2025

New address fields added (countyId, countyName, shortAddress, stateName). For TR Marketplace, "countyId" is 0, others are empty.

04.02.2025

Base URL change details and live dates for specific services (Invoice Link, Barcode Request, Q\&A services) were announced for February and March 2025.

31.01.2025

New address fields added under "shipmentAddress" and "invoiceAddress" for CEE and Gulf regions.

27.12.2024

New endpoint: [https://stageapi.trendyol.com/integration/order/orders/core](https://stageapi.trendyol.com/integration/order/orders/core)

27.12.2024

Sendeo cargo company will not be used as of December 30. Kolay Gelsin cargo company should be used instead.

27.12.2024

New transactionType=Stoppage added for GET otherfinancials endpoint to list E-commerce Withholding items.

25.12.2024

**NOTE: Türkiye Marketplace Only.** As of Jan 1, 2025, product price and labor cost must be separated in specific categories due to tax law changes. [https://developers.trendyol.com/en/docs/trendyol-marketplace/order-integration/update-labor-cost](https://developers.trendyol.com/en/docs/trendyol-marketplace/order-integration/update-labor-cost)

24.12.2024

A temporary system error (500) occurred between 10:56 and 11:01 on 24.12.2024. The issue is resolved.

23.12.2024

Issue detected with duplicate attributes appearing in some categories during product creation. Teams are working on a resolution.

23.12.2024

"DiscountPercentage" field has been added under "lines" in the test order creation service.

18.12.2024

A temporary 500 error issue occurred between 17.12.2024 and 18.12.2024. The problem is resolved.

13.12.2024

New features: Webhook Retry Model, Webhook Status Model, Webhook Authorization (API\_KEY), and Webhook Active/Passive Model.

09.12.2024

Web Color (348) attribute will be mandatory for product creation for Turkey after January 15th.

19.10.2023

Origin information ("productOrigin") added under "lines" field for micro export order invoices.

25.08.2023

Incorrect invoices can be deleted and re-sent. [https://developers.trendyol.com/en/docs/trendyol-marketplace/order-integration/delete-invoice-link](https://developers.trendyol.com/en/docs/trendyol-marketplace/order-integration/delete-invoice-link)

21.08.2023

New service for notifying return status in stage environment. [https://developers.trendyol.com/en/docs/trendyol-marketplace/order-integration/test-order-statu-updates](https://developers.trendyol.com/en/docs/trendyol-marketplace/order-integration/test-order-statu-updates)

10.08.2023

Access details of cargo invoices issued by Trendyol. [https://developers.trendyol.com/en/docs/trendyol-accounting-integration/cargo-invoice-details](https://developers.trendyol.com/en/docs/trendyol-accounting-integration/cargo-invoice-details)

27.07.2023

“invoiceNumber” and “invoiceDateTime” fields required for microexport as of 4 August 2023.

12.07.2023

Azerbaijan countryCode "AZ" implementation details and micro export order identification ("micro": True).

11.07.2023

Micro export invoices must be sent via seller panel or invoice link service instead of encrypted email.

07.07.2023

VAT rates changed from 8%/18% to 10%/20% as of July 10, 2023.

15.06.2023

Reminder for “invoiceNumber” and “invoiceDateTime” mandatory fields in SendInvoiceLink service.

15.06.2023

Timeline for Azerbaijan billing address and countryCode ("AZ") changes.

12.06.2023

Testing statuses: "Shipped", "AtCollectionPoint", "Delivered", "UnDelivered" and "Returned".

16.05.2023

New fields added for Azerbaijan Export project. Sample JSON included in documentation.

06.07.2026

Dear Business Partner, To ensure system health, new rate limits based on seller product listing limits will be applied to our Product Integration Services, starting from September 14, 2026. You can access the new limit details for the relevant services via the link below: https://developers.trendyol.com/v3.0/docs/6-service-limitations Best regards, Trendyol Integration Team

30.06.2026

Dear Business Partner, We are adding a new cargo provider code for Saudi Arabia orders. Please ensure you have taken the necessary actions: New Carrier Code: A new cargo company code, Joy Express, will be added to both "TY Pays" and "Seller Pays" model within the first week of July. You must add JoyExpress to your platform as a valid cargo company code. Document link: [https://developers.trendyol.com/v3.0/docs/8-carrier-companies](https://developers.trendyol.com/v3.0/docs/8-carrier-companies) Best regards, Trendyol Integration Team

29.06.2026

Dear Business Partner, We have added a new optional field, "countryCodes" to our Webhook Create and Webhook Filter services. This field allows you to manage orders by specific countries. If this field is not added in the request body, you will continue to receive orders from all active countries. Your existing webhooks will not be affected by this change. However, if you wish to separate your webhooks by country, you can create new ones using this field. Service details are provided below: * Webhook Create * Webhook Filter Best regards, Trendyol Integration Team

02.06.2026

Dear Business Partner, The limits for the current getShipmentPackage service will be updated as of June 8 , 2026. Your requests to this service must comply with the new limits; otherwise, you will receive a 429 error. Current getShipmentPackages will be limited to 10,000 total records. Service Limitations: [https://developers.trendyol.com/v3.0/docs/6-service-limitations#/versions](https://developers.trendyol.com/v3.0/docs/6-service-limitations#/versions) In order to provide large data scanning ability yu can use the "getShipmentPackagesStream" service. The getShipmentPackagesStream endpoint allows you to fetch order packages using cursor-based streaming. This endpoint is designed for large-scale data scanning (full scan), periodic synchronization (polling/cron), and exporting all orders; while the response structure remains the same, pagination-related fields such as totalElements, totalPages, page will no longer be returned due to the switch to a cursor-based pagination mechanism. Data from the last 3 months is accessible through this endpoint. You can reach the details below the link: [https://developers.trendyol.com/v3.0/docs/get-shipment-packages-stream#/versions](https://developers.trendyol.com/v3.0/docs/get-shipment-packages-stream#/versions) Best regards, Trendyol Integration Team

13.05.2026

Dear Business Partner, We are implementing a significant update to our product services to modernize our data structures and enhance the efficiency of your integration processes. Moving forward, the "Origin" (Country of Origin) information—which was previously managed under the "Attribute" section—will now be handled as an independent, standard field, similar to stockCode or barcode. **How Will the Transition Process Work?** To ensure a seamless experience, we have designed a two-phase ""soft transition"" model. **1. Hybrid Period (Transition Phase):** A new field named origin has been added to the product payload. During this period, origin information can be sent via both the existing attributes section and the new origin field. Currently, the new field is optional. You can access the List of Origin Values through our integration documentation. **2. Full Transition:** Support for sending origin information via the attributes section will be gradually phased out starting from 30th of June 2026. Only new field will be remaining for country of origin information of the product. **Data Migration Information** There is no need for concern regarding your historical data. Once the full transition deadline is reached, all existing origin information within the attributes section will be automatically migrated to the new origin field by the Trendyol team. **You can review the newly added field in the relevant services via our integration documentation:** Product Creation V1 (createProducts) Update Product V1 (updateProduct) Batch Request Status (getBatchRequestResult) Product Filtering V1 (filterProducts) Product Creation V2 Update Product - Unapproved V2 Update Product - Approved V2 (Variant) Product Filtering - Unapproved V2 Product Filtering - Approved V2 Best regards, Trendyol Integration Team

29.04.2026

Dear Business Partner, To improve the product listing processes on our platform and ensure full compliance with legal regulations, it is needed to fill **"SGR Price"** field for the **related categories starting from 11th of May 2026 for Romania.** SGR (Deposit-Return System) amounts must be calculated and entered based on the unit count of the product you are offering. You can find the **calculation method** and **related categories** for SGR price as in below link: [https://developers.trendyol.com/v3.0/docs/list-of-categories-requiring-sgr-definition](https://developers.trendyol.com/v3.0/docs/list-of-categories-requiring-sgr-definition) **New fields** have been added to the **product, order and returned order services**: * "sgrPrice" field is added to the Product Create, Product Filter, Product Update, Check Batch Request Result Services * "lineSgrFee" and "totalSgrFee" are added to the get shipmentPackages service and webhook model * "totalSgrFee" is added to the get Returned Order Service **Please review our service-based integration documentation for new fields:** **Product V1 Services (will be closed mid August 2026):** * [https://developers.trendyol.com/v3.0/docs/2-product-create](https://developers.trendyol.com/v3.0/docs/2-product-create) * [https://developers.trendyol.com/v3.0/docs/3-product-update](https://developers.trendyol.com/v3.0/docs/3-product-update) * [https://developers.trendyol.com/v3.0/docs/4-product-filter](https://developers.trendyol.com/v3.0/docs/4-product-filter) * [https://developers.trendyol.com/v3.0/docs/8-check-batchrequest-result](https://developers.trendyol.com/v3.0/docs/8-check-batchrequest-result) **Product V2 Services:** * [https://developers.trendyol.com/v3.0/docs/product-create-v2](https://developers.trendyol.com/v3.0/docs/product-create-v2) * [https://developers.trendyol.com/v3.0/docs/product-update-unapproved-product-v2](https://developers.trendyol.com/v3.0/docs/product-update-unapproved-product-v2) * [https://developers.trendyol.com/v3.0/docs/product-update-approved-product-v2](https://developers.trendyol.com/v3.0/docs/product-update-approved-product-v2) * [https://developers.trendyol.com/v3.0/docs/product-filter-unapproved-product-v2](https://developers.trendyol.com/v3.0/docs/product-filter-unapproved-product-v2) * [https://developers.trendyol.com/v3.0/docs/product-filter-approved-product-v2](https://developers.trendyol.com/v3.0/docs/product-filter-approved-product-v2) * [https://developers.trendyol.com/v3.0/docs/check-batchrequest-result](https://developers.trendyol.com/v3.0/docs/check-batchrequest-result) **Get Shipment Packages Service:** * [https://developers.trendyol.com/v3.0/docs/2-get-shipment-packages](https://developers.trendyol.com/v3.0/docs/2-get-shipment-packages) * [https://developers.trendyol.com/v3.0/docs/get-shipment-packages-stream](https://developers.trendyol.com/v3.0/docs/get-shipment-packages-stream) **Webhook Model:** * [https://developers.trendyol.com/v3.0/docs/1-webhook-model](https://developers.trendyol.com/v3.0/docs/1-webhook-model) **Get Returned Order Service:** * [https://developers.trendyol.com/v3.0/docs/2-getting-returned-orders](https://developers.trendyol.com/v3.0/docs/2-getting-returned-orders) Sincerely, Trendyol Integration Team

22.04.2026

Dear Business Partner, Between April 21st, 16:00 and April 22nd, 13:40, some sellers attempting to retrieve order packages from the integration service encountered errors. This issue was resolved as of April 22nd, 13:41. We recommend checking your orders from this period through the integration services. Sincerely, Trendyol Integration Team

08.04.2026

Dear Business Partner, We have added a new integration service that allows you to add video content to your products. You can now manage your product videos directly through our integration services. * **Video Upload Service**: Used to add video content to your products. * **Video Listing Service**: Used to list the approval status and list your uploaded videos [https://developers.trendyol.com/v3.0/update/docs/video-upload-filtering-services](https://developers.trendyol.com/v3.0/update/docs/video-upload-filtering-services) Best regards, Trendyol Integration Team

06.04.2026

Dear Business Partner, Due to an infrastructure migration, all operations in the flows for creating new products, updating unapproved products, and deleting unapproved products will be reflected with a delay. No data loss is expected; however, since the processing will be delayed, operations may appear incomplete on the dashboard and in API responses. Operation Start Date: April 7, 23:00 Operation End Date: April 8, 03:00 Best regards, Trendyol Integration Team

06.04.2026

Dear Business Partner, We are introducing a new field, **"dontShipBack"**, to the **Getting Returned Orders service** response starting **from April 13, 2026**. This field indicates whether a returned package needs to be sent back to the customer. Please follow the logic below: If **"dontShipBack": true**: You do not need to ship the package back to the customer. If **"dontShipBack": false**: You must ship the package back to the customer only if your rejection request has been approved by Trendyol. You can continue to track the status of your rejection requests via the Get Returned Order service on "claimItemStatus" status. Please ensure your integration is updated by April 13, 2026 to align with this new return flow. CEE Region Returned Order Service: [https://developers.trendyol.com/v3.0/docs/2-getting-returned-orders](https://developers.trendyol.com/v3.0/docs/2-getting-returned-orders) Gulf Region Retrned Order Service: [https://developers.trendyol.com/v3.0/docs/2-getting-returned-orders-1](https://developers.trendyol.com/v3.0/docs/2-getting-returned-orders-1) Thank you for your cooperation. Best Regards, Trendyol Team

02.04.2026

Dear Business Partner 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 at 2 April 2026 in the stage environment response and 6 April 2026 in the production environment response. 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": **You can access our integration service below;** [https://developers.trendyol.com/v3.0/docs/2-get-shipment-packages#/versions](https://developers.trendyol.com/v3.0/docs/2-get-shipment-packages#/versions) [https://developers.trendyol.com/v3.0/update/docs/1-webhook-model#/versions](https://developers.trendyol.com/v3.0/update/docs/1-webhook-model#/versions) Best regards, Trendyol Team

27.03.2026

Dear Business Partner, Order status updates may be delayed due to the system error for Trendyol Pays model in CEE region. Our technical team is working on it and will take action as soon as possible. If you believe an exemption is necessary, you can contact us via Seller Support in Seller Panel. Best Regards, Trendyol Team

16.03.2026

Dear Business Partner, We have added a new field named "businessUnit" under the lines object in our Get Shipment Packages Service and Webhook model. This field is provided for informational purposes, allowing you to track which business unit your products belong to. If you wish to monitor the business unit classification of your orders, you may now utilize this field in your integrations. **Related services:** * Get Shipment Packages * Webhook Model Thank you for your cooperation. Best Regards, Trendyol Team

12.03.2026

Dear Business Partner, We are adding a new cargo provider code for Romania to Romania (RO to RO) orders. Please ensure you have taken the necessary actions: New Carrier Code: A new cargo company code, FANEX, has been added to "TY Pays" model. You must add FANEX to your platform as a valid cargo company code. Document link: [https://developers.trendyol.com/v3.0/docs/8-carrier-companies](https://developers.trendyol.com/v3.0/docs/8-carrier-companies) Best Regards, Trendyol Team

09.03.2026

Dear Business Partner, We are currently experiencing a temporary delay in order package status updates. Our technical team is working to resolve the issue as quickly as possible. Please be advised that this is a temporary situation. Thank you for your patience and understanding. \*\*The issue was resolved as of March 10th, 11:30 AM. Best Regards, Trendyol Team

05.03.2026

Dear Business Partner, In our continuous effort to provide you with a faster, more stable, and seamless platform experience, we are consistently optimizing our system performance. As part of these improvements, we would like to inform you of an upcoming update to our getShipmentPackages Service. To optimize system resources and significantly improve API response times, we are updating the time limit for historical order data retrieval. The service, which previously allowed you to fetch orders from the past 3 months, will be updated to support a maximum retrieval **period of 1 month (30 days)**, effective **5 March 2026**. **What does this mean for you?** Starting **5 March 2026**, you will only be able to fetch order packages from the last 1 month via this service. If you require order data older than 1 month (up to the previous 3-month limit), we strongly advise you to check Trendyol Seller Center. Please ensure that you update your integrations, automated tasks, and reporting processes to query a maximum of 1 month's data to avoid any errors. We kindly ask you to make the necessary adjustments in a timely manner to minimize any disruption to your operations. We appreciate your understanding and cooperation as we work to enhance our infrastructure. If you have any questions or require technical support, please do not hesitate to reach out to our team. Best regards, Trendyol Team

27.02.2026

Dear Business Partner, We are reaching out to inform you about Romanian and Arabic language support has been added to our Product V2 services. You can add the "Accept-Language" as Header Parameter in order to specify your preferred language as below: * RO is used for listing in the Romanian language on the RO storefront * AR is used for listing in the Arabic language on the SA and AE storefronts * EN is used for listing in the English language on all International storefronts Related Services (v2) You can access and review the updated versions of the following services via our API documentation for International Marketplace below: * Product Create v2 * Product Filtering - Approved Products v2 * Product Update - Unapproved Product v2 * Product Update - Approved Product - Content Update v2 * Category List * Category Attribute List v2 * Category Attribute Values List v2 Best regards, Trendyol Team

25.02.2026

Dear Business Partner, Shipment Number field has been added to the response for the get shipment packages service and webhook model. Newly added field: shipmentNumber You can access our integration service below; [https://developers.trendyol.com/v3.0/docs/2-get-shipment-packages](https://developers.trendyol.com/v3.0/docs/2-get-shipment-packages) Best regards, Trendyol Team

17.02.2026

Dear Business Partner, We will add new delivery company to ""TY Pays"" model for Greece to Greece orders. ACS (Carrier Company) to our TY Pays model in GR to GR. You need to add this carrier companies to your platform as well. Tests in production environment will start **on 11th March 2026** and **go live date is 6th of April.** Document link: [https://developers.trendyol.com/v3.0/docs/8-carrier-companies](https://developers.trendyol.com/v3.0/docs/8-carrier-companies) Best Regards, Trendyol Team

10.02.2026

Dear Business Partner, We are reaching out to inform you about a significant structural update to our product integration services aimed at providing a more efficient and optimized operational experience. **Scope of the Update:** We are transitioning from our current barcode-based structure to a content-based structure. This update ensures that our integration services are fully aligned with the Seller Center data model, providing a more standardized and seamless workflow for your operations. **Migration Timeline:** **Availability of New Services:** Our next-generation services (v2) are available for use as of today. **Deprecation of Legacy Services:** Existing legacy services will remain active until August 10, 2026. **Action Required:** To avoid any service interruptions, we kindly request that you complete your development and migrate to the new v2 services before the specified deadline. **Newly Released Services (v2):** You can access and review the updated versions of the following services via our API documentation for International Marketplace below: * Product Create v2 * Product Filter Base Information v2 * Product Filtering - Unapproved Products v2 * Product Filtering - Approved Products v2 * Product Update - Unapproved Product v2 * Product Update - Approved Product v2 * Category Attribute List v2 * Category Attribute Values List v2 Thank you for your cooperation. Best Regards, Trendyol Team

10.02.2025

If you are working with an integrator company, please ensure they are fully informed about the countries where you perform product transfers. 1. Storefront Code Usage: You must provide the related storeFrontCode as Header parameter for the target country in your integration requests. 2. Price Synchronization Logic: Your price updates via API will behave differently based on the “Price Sync” setting selected during the transfer in the seller panel: * Sync Enabled: Price update requests for the target country will be ignored (invalid). Prices will be automatically updated based on the source country. * Sync Disabled: Price information in the target country may appear as null. To go live, you must manually send a price update request specifically for that target country. 3. Stock Synchronization Logic: Your stock updates via API will behave differently based on the “Stock Sync” setting selected during the transfer in the seller panel: * Sync Enabled: Stock update requests for the target country will be ignored (invalid). Stock levels will be directly reflected from the source country and stocks will be synchronized between countries. * Sync Disabled: You must manually send a stock update request for the target country to ensure correct availability. 4. When Product Synchronization is Disabled: When product sync is disabled in the seller panel, the stock and price sync features are automatically disabled as well, which closes cross-border operations.

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](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](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](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](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](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](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](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](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](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](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](https://stageapi.trendyol.com/integration/order/orders/local-gulf) For Europe: [https://stageapi.trendyol.com/integration/orders/eu](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](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.

Changelog

Changelog