Changelog

29.01.2026

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

29.01.2026

Sizlere daha hızlı ve verimli bir entegrasyon deneyimi sunabilmek adına, entegrasyon servisleri dokümantasyonumuzun altyapısını tamamen yeniledik.

İhtiyaçlarınızı daha kapsamlı karşılamak üzere tasarladığımız yeni sistemimizde, mevcut tüm bilgileri korurken süreci kolaylaştıracak yeni teknik özellikler ve geliştirilmiş bir rehber akışı ekledik.

Kapsamlı Veri Aktarımı: Eski dokümantasyondaki tüm veriler, eksiksiz bir şekilde yeni yapıya aktarıldı.

Yeni Teknik İçerikler: Geliştirme süreçlerinizi hızlandıracak ek rehberler ve teknik detaylar eklendi.

Yeni dokümantasyonumuza aşağıdaki bağlantıdan ulaşabilirsiniz:

👉 https://developers.trendyol.com/

Entegrasyon süreçlerinizi bu güncel kaynak üzerinden takip etmenizi önemle rica ederiz.

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.

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

• "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"

• "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.

• 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 edmenizi rica ederiz. 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

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 edmenizi 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

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.