Changelog

  Değerli İş Ortağımız,

  Lüks segmentteki ürünleri daha güçlü ve özelleştirilmiş bir alışveriş deneyimiyle müşterilerle buluşturacak olan Trendyol Luxe Platformu çok yakında yayına giriyor!
  
  Satıcılarımızın bu yeni platformda ürünlerini sorunsuz bir şekilde listeleyebilmeleri ve sipariş/iade süreçlerini yönetebilmeleri için API servislerimizde bazı teknik geliştirmeler yapılmıştır. Entegrasyon sistemlerinizi bu değişikliklere uygun şekilde güncellemeniz önem taşımaktadır.

  **1. Ürün Servisleri Geliştirmeleri (Product API)**

  **Varsayılan Davranış:** İstekte channels alanı gönderilmezse ürün yayında olduğu kanal(lar)daki kayıtlar için isteği kabul eder. Ürün hem CORE hem LUXE kanalda yayında ise ve herhangi bir kanaldaki ürün yayına kapatılmak istenirse, istek sadece yayında olması istenen kanalın değeri ile yapılmalıdır.

  **Kısıtlama:** Bir üründe LUXE kanalının kullanılabilmesi için ilgili markanın Luxe Marka statüsünde olması  ve satıcının da LUXE kategorisi için tanımlanmış olması gerekmektedir.

  **Kapsam:** Bu güncellemeler yalnızca onaylı ürün akışlarını (TR storefront) kapsamaktadır. Onaysız ürün oluşturma/güncelleme endpoint'lerinde channels kapsam dışıdır.

  **Değişen Endpoint'ler ve Kullanım Detayları:**

  **Marka Listesi:** 
  https://developers.trendyol.com/docs/trendyol-marka-listesi-getbrands-1
  Yanıta LUXE (boolean) alanı eklenmiştir. Markanın lüks kanal kullanımına uygun olup olmadığını bu alandan kontrol edebilirsiniz ("LUXE": true).

  **Onaylı Ürün Filtreleme v2:**
  https://developers.trendyol.com/docs/%C3%BCr%C3%BCn-filtreleme-onayl%C4%B1-%C3%BCr%C3%BCn-v2
  Yanıt içerisindeki variants[] dizisine channels alanı eklenmiştir (Örn: "channels": ["CORE", "LUXE"]).

  **Ürün Filtreleme v1:**
  https://developers.trendyol.com/docs/%C3%BCr%C3%BCn-filtreleme-filterproducts
  Yanıt içerisindeki content[] alanına "channels": ["CORE", "LUXURY"] eklenmiştir.

  **Ürün Güncelleme v1:**
  https://developers.trendyol.com/docs/%C3%BCr%C3%BCn-bilgisi-g%C3%BCncelleme-updateproduct
  İstek body'sinde items[] altına "channels": ["CORE", "LUXURY"] alanı eklenmiştir.

  **Onaylı Ürün Varyant Güncelleme v2:**   
  https://developers.trendyol.com/docs/%C3%BCr%C3%BCn-g%C3%BCncelleme-onayl%C4%B1-%C3%BCr%C3%BCn-v2
  İstek body'sinde items[] altına "channels": ["CORE", "LUXURY"] alanı eklenmiştir.

  **channels Alanı Kuralları:**
  ["CORE"]: Sadece standart platform
  ["LUXE"]: Sadece Trendyol Luxe (Luxe marka kontrolü yapılır)
  ["CORE", "LUXE"]: Her iki kanal
  [] (Boş array): Geçersizdir, sistem hata döner.
  Alan gönderilmezse mevcut kanal bilgisi değiştirilmez.


  **2. Sipariş ve İade Servisleri Geliştirmeleri (Order-Return API)**
  LUXE kanaldan gelen sipariş ve iadeleri ayırt edebilmeniz için sipariş paketlerini çekme ve iadeleri çekme servisleri ve webhook modele channelId alanı eklenmiştir.
  channelId değeri 25 olan sipariş ve iadeler Trendyol Luxe platformuna aittir. channelId değeri 1 olan sipariş ve iadeler standart CORE kanalına aittir.

  **Sipariş servisleri:**
  https://developers.trendyol.com/docs/sipari%C5%9F-paketlerini-%C3%A7ekme-getshipmentpackages
  https://developers.trendyol.com/docs/sipari%C5%9F-paketlerini-ak%C4%B1%C5%9F-ile-%C3%A7ekme

  **Webhook model:**
  https://developers.trendyol.com/docs/webhook-model

  **İade servisi:**
  https://developers.trendyol.com/docs/i%CC%87adesi-olu%C5%9Fturulan-sipari%C5%9Fleri-%C3%A7ekme-getclaims

  Saygılarımızla,

  Trendyol Entegrasyon Ekibi

<Accordion title="Yeni Ürün Entegrasyon Servisleri Hakkında" icon="fa-undo">
  <h6 align="right"> 21.07.2026 </h6>
  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) Şubat ayından itibaren kullanıma açılmıştır.

  Eski Servislerin Kapatılması: Mevcut (eski) servislerimiz 15 Eylül 2026 tarihine kadar desteklenmeye devam edecektir.

  15 Eylül 2026 tarihine kadar eski servislere yapılan istekler için gün içinde 3 kez 15 dakika boyunca aşağıdaki hata mesajı dönecektir:

  "This endpoint is temporarily unavailable due to a scheduled brownout. Please refer to the current integration documentation to migrate your service to Product v2."

  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:

  https://developers.trendyol.com/docs/%C3%BCr%C3%BCn-v2-api-endpoint

  Saygılarımızla,

  Trendyol Entegrasyon Ekibi
</Accordion>


<Accordion title="Sipariş Paketlerini Çekme Servisinde Servis Limiti Güncellemesi" icon="fa-undo">
  <h6 align="right"> 2.06.2026 </h6>
  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
</Accordion>

<Accordion title="Menşei (Origin) Bilgisi Tanımlama Süreçlerindeki Değişiklik Hakkında" icon="fa-undo">
  <h6 align="right"> 13.05.2026 </h6>

  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
</Accordion>

<Accordion title="Sipariş Paketlerini Çekme Servisinde Yaşanan Geçici Gecikme Hakkında" icon="fa-undo">
  <h6 align="right"> 22.04.2026 </h6>
  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
</Accordion>

<Accordion title="Trendyol Yurt Dışı Aracılığı Modeli Hakkında" icon="fa-undo">
  <h6 align="right"> 20.04.2026 </h6>
  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
</Accordion>

<Accordion title="Yeni Ürün Video Ekleme Servisi Hakkında" icon="fa-undo">
  <h6 align="right"> 08.04.2026 </h6>
  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
</Accordion>

<Accordion title="Ürün Süreçleri Altyapı Çalışması" icon="fa-undo">
  <h6 align="right"> 06.04.2026 </h6>
  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
</Accordion>

<Accordion title="Trendyol Sipariş Paketlerini Çekme Entegrasyon Servisi Hakkında" icon="fa-undo">
  <h6 align="right"> 02.04.2026 </h6>
  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
</Accordion>

<Accordion title="Stok Fiyat Servisi Güncellemelerinde Yaşanan Geçici Gecikme Hakkında " icon="fa-undo">
  <h6 align="right"> 18.03.2026 </h6>
  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
</Accordion>

<Accordion title="Finans Servislerinde Platform Hizmet Bedeli Kayıtlarının Filtrelenebilmesi" icon="fa-undo">
  <h6 align="right"> 18.03.2026 </h6>
  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
</Accordion>

<Accordion title="Soru & Cevap Entegrasyonu Servis Limitleri" icon="fa-undo">
  <h6 align="right"> 17.03.2026 </h6>
  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
</Accordion>

<Accordion title="Sipariş Paketleri Servislerine Yeni Alan Eklenmesi ve Dijital Ürün Gönderimi Hakkında" icon="fa-undo">
  <h6 align="right"> 16.03.2026 </h6>
  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
</Accordion>

<Accordion title="Sipariş Paketleri Statü Güncellemelerinde Yaşanan Geçici Gecikme Hakkında" icon="fa-undo">
  <h6 align="right"> 09.03.2026 </h6>
  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
</Accordion>

<Accordion title="Sipariş Paketlerini Çekme Servisi Hakkında" icon="fa-undo">
  <h6 align="right"> 05.03.2026 </h6>
  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
</Accordion>

<Accordion title="Sipariş Paketlerini Çekme Servisi Hakkında" icon="fa-undo">
  <h6 align="right"> 25.02.2026 </h6>
  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
</Accordion>

<Accordion title="Yeni Ürün Entegrasyon Servisleri Hakkında" icon="fa-undo">
  <h6 align="right"> 10.02.2026 </h6>
  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
</Accordion>

<Accordion title="Muhasebe ve Finans Entegrasyon Servisleri Hakkında" icon="fa-undo">
  <h6 align="right"> 30.12.2025 </h6>
  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)
</Accordion>

<Accordion title="Trendyol Sipariş Paketlerini Çekme Servisi Hakkında" icon="fa-info-circle">
  <h6 align="right"> 08.12.2025 </h6>
  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":
</Accordion>

<Accordion title="Trendyol İade Paketlerini Çekme Servisi Hakkında" icon="fa-undo">
  <h6 align="right"> 08.12.2025 </h6>
  İ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"
</Accordion>

<Accordion title="Trendyol Sipariş Paketlerini Çekme Servisi Hakkında" icon="fa-exclamation-triangle">
  <h6 align="right"> 29.08.2025 </h6>
  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.
</Accordion>

<Accordion title="Yeni Servis Geliştirmesi" icon="fa-plus-circle">
  <h6 align="right"> 31.07.2025 </h6>
  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.
</Accordion>

<Accordion title="Sipariş Paketlerini Çekme ve Webhook Servisleri Response'ına Eklenen Yeni Alanlar Hk." icon="fa-code-branch">
  <h6 align="right"> 24.06.2025 </h6>
  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.
</Accordion>

<Accordion title="Base URL Değişikliği Hakkında" icon="fa-network-wired">
  <h6 align="right"> 26.05.2025 </h6>
  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)
</Accordion>

<Accordion title="Sipariş Paketlerini Çekme ve Webhook Servisleri Response'ına Eklenen Yeni Alanlar Hk." icon="fa-map-marker-alt">
  <h6 align="right"> 22.05.2025 </h6>
  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.
</Accordion>

<Accordion title="Stock&Price Güncelleme Servisinin BatchRequestResult Response'u" icon="fa-sync-alt">
  <h6 align="right"> 09.05.2025 </h6>
  Stock\&Price Güncelleme Servisinin BatchRequestResult Response'unda güncelleme olmuştur. Yeni Response modeline Toplu İşlem Kontrolü sayfası üzerinden ulaşabilirsiniz.
</Accordion>

<Accordion title="Trendyol Aras Kargo Tedarikçi Öder Modeli Hakkında" icon="fa-shipping-fast">
  <h6 align="right"> 08.05.2025 </h6>
  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.
</Accordion>

<Accordion title="Trendyol Web Color Attribute Hakkında" icon="fa-palette">
  <h6 align="right"> 08.05.2025 </h6>
  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.
</Accordion>

<Accordion title="Trendyol Entegrasyon Servisleri 'productCategoryId' ve 'laborCost' Alanları Hakkında" icon="fa-tag">
  <h6 align="right"> 11.04.2025 </h6>
  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.
</Accordion>

<Accordion title="Trendyol - API Health Check Hakkında" icon="fa-heartbeat">
  <h6 align="right"> 09.04.2025 </h6>
  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)
</Accordion>

<Accordion title="Trendyol - Tazmin Entegrasyon Servisi Hakkında" icon="fa-file-invoice-dollar">
  <h6 align="right"> 04.04.2025 </h6>
  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.
</Accordion>

<Accordion title="Trendyol - Ürün Denetim Yönetmeliği Yeni Eklenen Ürün Özellikleri Hakkında" icon="fa-gavel">
  <h6 align="right"> 28.03.2025 </h6>
  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"
</Accordion>

<Accordion title="Trendyol Muhasebe Ve Finans Entegrasyonu Hakkında" icon="fa-calculator">
  <h6 align="right"> 21.03.2025 </h6>
  Cari Hesap Ekstresi Entegrasyonu settlements ve otherFinancials servislerimize shipmentPackageId alanı eklenmiştir. Entegrasyon dökümanımız üzerinden kontrol edebilirsiniz.
</Accordion>

<Accordion title="Trendyol - 'identityNumber' Alanı Hakkında" icon="fa-id-card">
  <h6 align="right"> 18.03.2025 </h6>
  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.
</Accordion>

<Accordion title="Trendyol - Sipariş Faturaları Hakkında" icon="fa-file-pdf">
  <h6 align="right"> 17.03.2025 </h6>
  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.
</Accordion>

<Accordion title="Trendyol - İade Servisine Eklenen Statu Hk." icon="fa-shield-alt">
  <h6 align="right"> 14.03.2025 </h6>
  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.
</Accordion>

<Accordion title="Ürün Denetim Yönetmeliği Yeni Eklenen Ürün Özellikleri Hakkında" icon="fa-balance-scale">
  <h6 align="right"> 05.03.2025 </h6>
  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.
</Accordion>

<Accordion title="Trendyol Stage Ortam Entegrasyon Servisleri Hakkında" icon="fa-vial">
  <h6 align="right"> 03.03.2025 </h6>
  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.
</Accordion>

<Accordion title="Trendyol - Ramazan Kampanyası İçin Ürün Stok ve Fiyatlarınızı Kontrol Ediniz" icon="fa-calendar-check">
  <h6 align="right"> 27.02.2025 </h6>
  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.
</Accordion>

<Accordion title="Trendyol - Listeleme Limitleri Bazlı Servis Limitleri Hakkında" icon="fa-list-ol">
  <h6 align="right"> 27.02.2025 </h6>
  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.
</Accordion>

<Accordion title="Base URL Değişikliği Hakkında" icon="fa-link">
  <h6 align="right"> 26.02.2025 </h6>
  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.
</Accordion>

<Accordion title="Base URL Değişikliği Hakkında" icon="fa-server">
  <h6 align="right"> 25.02.2025 </h6>
  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.
</Accordion>

<Accordion title="Sipariş Paketlerini Çekme ve Webhook Response Modelimiz Hk." icon="fa-map-marked-alt">
  <h6 align="right"> 11.02.2025 </h6>
  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.
</Accordion>

<Accordion title="Sipariş Paketlerini Çekme ve Webhook Response Modelimiz Hk." icon="fa-globe">
  <h6 align="right"> 31.01.2025 </h6>
  OMS modelimize yeni adres alanları (countyId, countyName, shortAddress, stateName) eklenmiştir. "shipmentAddress" ve "invoiceAddress" altından kontrol edilebilir.
</Accordion>

<Accordion title="Trendyol İade İşlemlerinde Teknik Çalışma" icon="fa-tools">
  <h6 align="right"> 07.01.2025 </h6>
  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.
</Accordion>

<Accordion title="Ürün Oluşturma - Güncelleme Sorunları" icon="fa-exclamation-circle">
  <h6 align="right"> 02.01.2025 </h6>
  Yeni katalog yapısına geçiş süreci nedeniyle anlık hatalar ve yansıma gecikmeleri yaşanabilir.
</Accordion>

<Accordion title="Trendyol Kategori Listesi ve Kategori - Özellik Listesi Servisleri Hakkında" icon="fa-stream">
  <h6 align="right"> 02.01.2025 </h6>
  02.01.2025 tarihinde yaşanan geçici sistem hatası nedeniyle 500 hataları alınmış olabilir. Sorun üzerinde çalışılmaktadır.
</Accordion>

<Accordion title="Test Siparişi Endpoint'i Hakkında" icon="fa-vials">
  <h6 align="right"> 27.12.2024 </h6>
  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)
</Accordion>

<Accordion title="Sendeo Kargo Firması Değişikliği Hakkında" icon="fa-truck-loading">
  <h6 align="right"> 27.12.2024 </h6>
  30 Aralık itibariyle Sendeo yerine Kolay Gelsin kargo firmasının kullanılması gerekmektedir.
</Accordion>

<Accordion title="Cari Hesap Ekstresi Entegrasyonu Hakkında" icon="fa-file-invoice">
  <h6 align="right"> 27.12.2024 </h6>
  otherfinancials endpoint'i için yeni "transactionType=Stoppage" eklenmiştir. Bu tip ile E-ticaret Stopaj kalemleri listelenebilecektir.
</Accordion>

<Accordion title="Trendyol İşçilik Bedeli Bildirimi Servisi Hakkında" icon="fa-cut">
  <h6 align="right"> 25.12.2024 </h6>
  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.
</Accordion>

<Accordion title="Ürün Yükleme Hatası Hakkında" icon="fa-bug">
  <h6 align="right"> 23.12.2024 </h6>
  Bazı kategorilerde aynı özelliğin birden fazla görünmesi sorunu üzerinde çalışılmaktadır.
</Accordion>

<Accordion title="Test Siparişi Servisi Hakkında" icon="fa-flask">
  <h6 align="right"> 23.12.2024 </h6>
  "lines" altına "discountPercentage" alanı eklenmiştir. Bu alan ile ürün bazlı indirimler simule edilebilecektir.
</Accordion>

<Accordion title="Sipariş Paketlerini Çekme Servisi Hakkında" icon="fa-history">
  <h6 align="right"> 18.12.2024 </h6>
  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.
</Accordion>

<Accordion title="Trendyol - Webhook Servisleri Güncellemesi Hakkında" icon="fa-project-diagram">
  <h6 align="right"> 13.12.2024 </h6>
  Webhook Retry Modeli, Statu Modeli (subscribedStatuses), Authorization Model (API\_KEY) ve Aktif/Pasif servisleri eklenmiştir.
</Accordion>

<Accordion title="Trendyol - WebColor Attribute Hk." icon="fa-paint-brush">
  <h6 align="right"> 09.12.2024 </h6>
  15 Ocak'tan sonra Web Color (348) attribute'u zorunlu olacaktır. Bu alan gönderilmezse sistem ürün yaratma hatası verecektir.
</Accordion>

<Accordion title="Mikro İhracat Siparişlerinizin Fatura Numaraları Hakkında" icon="fa-file-signature">
  <h6 align="right"> 08.03.2024 </h6>
  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.
</Accordion>

<Accordion title="MENA Bölgesi Siparişleri İçin Yeni Ülkeler" icon="fa-globe-asia">
  <h6 align="right"> 20.12.2023 </h6>
  Bahreyn, Umman ve Kuveyt ülkeleri eklendi. Adres alanı id değerleri için dökümanı kontrol ediniz.
</Accordion>

<Accordion title="MENA Bölgesi Siparişleri Hakkında" icon="fa-map">
  <h6 align="right"> 21.11.2023 </h6>
  Suudi Arabistan ve BAE'den sonra Katar da ülke listesine eklendi.
</Accordion>

<Accordion title="Sipariş Paketlerini Çekme Servisine MENSEI Bilgisi Eklenmesi" icon="fa-flag">
  <h6 align="right"> 19.10.2023 </h6>
  Mikro ihracat siparişleri için "productOrigin" datası üzerinden menşei bilgisi iletilmelidir.
</Accordion>

<Accordion title="Fatura Linki Silme" icon="fa-trash-alt">
  <h6 align="right"> 25.08.2023 </h6>
  Hatalı beslenen faturalar bu servis üzerinden silinip tekrar beslenebilir.
</Accordion>

<Accordion title="İade Test Siparişlerini WaitingInAction Statüsüne Çekme" icon="fa-step-forward">
  <h6 align="right"> 21.08.2023 </h6>
  Stage ortamında iade statüsünü waitinginaction'a çekmek için ilgili servis kullanılabilir.
</Accordion>

<Accordion title="Kargo Faturası Detayları Servis Geliştirmesi Hk." icon="fa-file-invoice-dollar">
  <h6 align="right"> 11.08.2023 </h6>
  Trendyol tarafından kesilen kargo faturalarının detaylarına DeductionInvoices responsundan ulaşabilirsiniz.
</Accordion>

<Accordion title="Mikro İhracat Paketleri İçin Fatura Gönderimi Güncellemesi" icon="fa-file-export">
  <h6 align="right"> 27.07.2023 </h6>
  4 Ağustos 2023 itibarıyla Mikro ihracat paketleri için “invoiceNumber” ve “invoiceDateTime” alanları zorunlu hale gelmiştir.
</Accordion>

<Accordion title="Mikro İhracat Siparişleri İçin Geçiş Tarihi Hk." icon="fa-exchange-alt">
  <h6 align="right"> 12.07.2023 </h6>
  14.07.2023'ten itibaren Azerbaycan siparişlerinde countryCode "AZ" olarak dönecektir. "micro" alanı True ise sipariş mikro ihracat siparişidir.
</Accordion>

<Accordion title="Mikro İhracat Siparişleri İçin Fatura Gönderimleri Hk." icon="fa-upload">
  <h6 align="right"> 11.07.2023 </h6>
  12.07.2023 itibarıyla mikro ihracat faturaları panelden veya link servisi ile yüklenmelidir. “invoiceNumber” ve “invoiceDateTime” alanları zorunludur.
</Accordion>

<Accordion title="KDV Oranları Hakkında" icon="fa-percent">
  <h6 align="right"> 07.07.2023 </h6>
  10 Temmuz 2023 itibarıyla KDV oranları %10 ve %20 olarak güncellenmiştir. Eski oranlarla yapılan istekler hata alacaktır.
</Accordion>

<Accordion title="Azerbaycan Siparişleri İçin Geçiş Tarihi Hk." icon="fa-clock">
  <h6 align="right"> 03.07.2023 </h6>
  Azerbaycan siparişleri için son geçiş tarihi uzatılmıştır. Yeni tarih netleştiğinde bilgi verilecektir.
</Accordion>

<Accordion title="Mikro İhracat Paketleri İçin Fatura Linki Gönderme Hatırlatması" icon="fa-envelope-open-text">
  <h6 align="right"> 15.06.2023 </h6>
  sendInvoiceLink servisine eklenen “invoiceNumber” ve “invoiceDateTime” alanlarının mikro ihracat için zorunlu olduğu hatırlatılır.
</Accordion>

<Accordion title="Azerbaycan Siparişleri Hk." icon="fa-map-pin">
  <h6 align="right"> 15.06.2023 </h6>
  03.07.2023'ten itibaren Azerbaycan adresleri için countryCode "AZ" olarak dönecektir.
</Accordion>

<Accordion title="Test Siparişlerinde Statü Güncelleme" icon="fa-check-double">
  <h6 align="right"> 12.06.2023 </h6>
  Stage ortamında sipariş statülerini Shipped, Delivered vb. olarak güncellemek için ilgili servis kullanılabilir.
</Accordion>

<Accordion title="Güncel Kargo Fiyatları Listesi" icon="fa-truck">
  <h6 align="right"> 29.05.2023 </h6>
  Güncel liste Trendyol Kargo Şirketleri Listesi dökümanı üzerinden indirilebilir.
</Accordion>

<Accordion title="Fatura Linki Gönderme (sendInvoiceLink) Servis Geliştirmesi Hk." icon="fa-link">
  <h6 align="right"> 16.05.2023 </h6>
  Azerbaycan İhracat projesi ile yeni alanlar eklenmiştir. Örnek JSON isteği dökümanda mevcuttur.
</Accordion>

  Dear Business Partner,

  We will add new delivery company as BoxNow to “TY Pays” model for below for Greece to Greece orders.

  Best Regards,

  Trendyol Team

<Accordion title="About New Order Integration Endpoint" icon="fa-undo">
  <h6 align="right"> 30.07.2026 </h6>
  Dear Business Partner,

  The following endpoint services will be deprecated as of October 15, 2026. Until October 15, 2026, requests to the following services will return error code 426 three times a day for 10 minutes each time.

  https://apigw.trendyol.com/integration/order/sellers/{sellerId}/orders

  You must migrate to below Order V2 endpoint services by this date. With V2 order endpoint services maximum accessible record count will be limited to 10,000 (maxQueryWindowResult).

  https://apigw.trendyol.com/integration/order/sellers/{sellerId}/v2/orders

  Document link:

  https://developers.trendyol.com/v3.0/docs/2-get-shipment-packages

  Best Regards,

  Trendyol Team
  
</Accordion>

<Accordion title="About Current Account Statement (CHE) Integration Service Changes" icon="fa-undo">
  <h6 align="right"> 06.07.2026 </h6> 
    Hello,

    The id and paymentOrderId values returned by the Current Account Statement (CHE        
    services will be updated.

    We will complete this change by 3 August 2026. After that date, the new id and     
    paymentOrderId values will be valid.

    Matching or filtering with previously stored id / paymentOrderId values will no 
    longer work.

    For this reason, we kindly ask you to re-fetch your settlements and 
    otherfinancials data by date range after 3 August 2026.

    There will be no change to the endpoints. You can continue using the following     
    addresses:

    The startDate, endDate, transactionType, page, and size parameters will continue        
    to work the same way.

    The storeFrontCode header will also remain mandatory.
    The date range rule is unchanged: a maximum of 15 days per request.

    What we kindly ask from you after 3 August 2026:
    1) Not using old id / paymentOrderId values as keys
    2) Re-fetching otherfinancials and settlements reports for the relevant period by    date range
    3) Updating your own records with the new id and paymentOrderId values returned in  
    the response
    4) Cleaning up old id / paymentOrderId records

    Please note: re-fetching with an old paymentOrderId is not recommended.
    The correct approach is to re-fetch the reports using startDate, endDate, and 
    transactionType.

    If you have any questions, please reach out to us through the Integration support     
    channels.
    Sharing a sample sellerId and an old/new paymentOrderId would also be helpful if     
    needed.

    Thank you,
    Trendyol Integration
</Accordion>

<Accordion title="About Product Services Rate Limit Changes" icon="fa-undo">
  <h6 align="right"> 06.07.2026 </h6>
  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
</Accordion>

<Accordion title="About Saudi Arabia New Cargo Company" icon="fa-undo">
  <h6 align="right"> 30.06.2026 </h6>
  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
</Accordion>

<Accordion title="About Country Based Webhook Creation and Filtering" icon="fa-undo">
  <h6 align="right"> 29.06.2026 </h6>
  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
</Accordion>

<Accordion title="About Get Shipment Packages Service New Rate Limits" icon="fa-undo">
  <h6 align="right"> 02.06.2026 </h6>
  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
</Accordion>

<Accordion title="About Update on Country of Origin (Origin) Field Definition Processes" icon="fa-undo">
  <h6 align="right"> 13.05.2026 </h6>
  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
</Accordion>

<Accordion title="About SGR Price Definitions in Product Listings for Romania" icon="fa-undo">
  <h6 align="right">29.04.2026 </h6>
  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
</Accordion>

<Accordion title="Regarding the Temporary Delay in the getShipment Package Service" icon="fa-undo">
  <h6 align="right">22.04.2026 </h6>
  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
</Accordion>

<Accordion title="About New Video Upload Service" icon="fa-undo">
  <h6 align="right"> 08.04.2026 </h6>
  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
</Accordion>

<Accordion title="Infrastructure Maintenance for Product Processes" icon="fa-undo">
  <h6 align="right"> 06.04.2026 </h6>
  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
</Accordion>

<Accordion title="About New Field in Getting Returned Order Service" icon="fa-undo">
  <h6 align="right"> 06.04.2026 </h6>
  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
</Accordion>

<Accordion title="About Trendyol getShipmentPackage / Webhook Model" icon="fa-info-circle">
  <h6 align="right"> 02.04.2026 </h6>
  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
</Accordion>

<Accordion title="About Order Status Delay for Trendyol Pays Model in CEE" icon="fa-info-circle">
  <h6 align="right"> 27.03.2026 </h6>
  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
</Accordion>

<Accordion title="About New Field in Order Services" icon="fa-undo">
  <h6 align="right"> 16.03.2026 </h6>
  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
</Accordion>

<Accordion title="About New RO to RO TY Pays Cargo Company Code" icon="fa-undo">
  <h6 align="right"> 12.03.2026 </h6>
  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
</Accordion>

<Accordion title="About Temporary Delay in Get Shipment Packages Service" icon="fa-undo">
  <h6 align="right"> 09.03.2026 </h6>
  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
</Accordion>

<Accordion title="About Get Shipment Packages Service" icon="fa-undo">
  <h6 align="right"> 05.03.2026 </h6>
  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
</Accordion>

<Accordion title="About Local Language Support in Product V2 Services" icon="fa-undo">
  <h6 align="right"> 27.02.2026 </h6>
  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
</Accordion>

<Accordion title="About Get Shipment Packages Service" icon="fa-undo">
  <h6 align="right"> 25.02.2026 </h6>
  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
</Accordion>

<Accordion title="About Greece New Cargo Company" icon="fa-undo">
  <h6 align="right"> 17.02.2026 </h6>
  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
</Accordion>

<Accordion title="About New Product Integration Service" icon="fa-undo">
  <h6 align="right"> 10.02.2026 </h6>
  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
</Accordion>

<Accordion title="About EU Cross Country Product Transfer" icon="fa-info-circle">
  <h6 align="right"> 10.02.2025 </h6>
  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.
</Accordion>

<Accordion title="About getShipmentPackage Service" icon="fa-info-circle">
  <h6 align="right"> 08.12.2025 </h6>
  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":
</Accordion>

<Accordion title="About getClaim Service" icon="fa-info-circle">
  <h6 align="right"> 08.12.2025 </h6>
  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"
</Accordion>

<Accordion title="Current Account Statement Integration – Transition to RON Currency" icon="fa-info-circle">
  <h6 align="right"> 29.08.2025 </h6>
  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.
</Accordion>

<Accordion title="About Trendyol Problem on getShipmentPackage Service" icon="fa-info-circle">
  <h6 align="right"> 29.08.2025 </h6>
  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.
</Accordion>

<Accordion title="Alternative Delivery For GULF region New Service" icon="fa-info-circle">
  <h6 align="right"> 19.08.2025 </h6>
  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.
</Accordion>

<Accordion title="New Service Announcement" icon="fa-info-circle">
  <h6 align="right"> 31.07.2025 </h6>
  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.
</Accordion>

<Accordion title="vatRate changes on Romania" icon="fa-info-circle">
  <h6 align="right"> 31.07.2025 </h6>
  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%
</Accordion>

<Accordion title="New Optional Fields Added to Product Create Service" icon="fa-info-circle">
  <h6 align="right"> 07.07.2025 </h6>
  "shipmentAddressId" and "returningAddressId" fields have been added to the Trendyol Product Create Service.
</Accordion>

<Accordion title="New Fields Added to Webhook Services Response and GetShipmentPackages Service Response." icon="fa-info-circle">
  <h6 align="right"> 24.06.2025 </h6>
  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.
</Accordion>

<Accordion title="Trendyol Accounting and Finance Integration API Service" icon="fa-info-circle">
  <h6 align="right"> 19.06.2025 </h6>
  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.
</Accordion>

<Accordion title="Trendyol Cargo Provider Change API Service" icon="fa-info-circle">
  <h6 align="right"> 19.06.2025 </h6>
  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.
</Accordion>

<Accordion title="New Fields Added to Webhook Services Response and GetShipmentPackages Service Response." icon="fa-info-circle">
  <h6 align="right"> 22.05.2025 </h6>
  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.
</Accordion>

<Accordion title="About Return and Shipping Address Information Service" icon="fa-info-circle">
  <h6 align="right"> 20.05.2025 </h6>
  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.
</Accordion>

<Accordion title="About BatchRequestResult Response" icon="fa-info-circle">
  <h6 align="right"> 09.05.2025 </h6>
  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.
</Accordion>

<Accordion title="Trendyol- Romania Return Model Updates" icon="fa-info-circle">
  <h6 align="right"> 15.04.2025 </h6>
  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.
</Accordion>

<Accordion title="Trendyol -About Apı Health Check" icon="fa-info-circle">
  <h6 align="right"> 15.04.2025 </h6>
  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.
</Accordion>

<Accordion title="Trendyol - About Return Reasons" icon="fa-info-circle">
  <h6 align="right"> 14.04.2025 </h6>
  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
</Accordion>

<Accordion title="Error in Check Batchrequest Result status field" icon="fa-info-circle">
  <h6 align="right"> 11.04.2025 </h6>
  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
</Accordion>

<Accordion title="Adding &#x22;productCategoryId&#x22; Line to the Trendyol Integration Service" icon="fa-info-circle">
  <h6 align="right"> 11.04.2025 </h6>
  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
</Accordion>

<Accordion title="District Information for GULF Countries Service" icon="fa-info-circle">
  <h6 align="right"> 03.04.2025 </h6>
  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)
</Accordion>

<Accordion title="About ​​data type for “cargoTrackingNumber” Field on getClaim service." icon="fa-info-circle">
  <h6 align="right"> 25.03.2025 </h6>
  “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.
</Accordion>

<Accordion title="Trendyol - About ​​”identityNumber” Field." icon="fa-info-circle">
  <h6 align="right"> 18.03.2025 </h6>
  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)
</Accordion>

<Accordion title="Adding New Fields for Getting Returned Orders Service" icon="fa-info-circle">
  <h6 align="right"> 14.03.2025 </h6>
  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.
</Accordion>

<Accordion title="About Customer Cancellation (GULF Region)" icon="fa-info-circle">
  <h6 align="right"> 11.03.2025 </h6>
  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)
</Accordion>

<Accordion title="About Trendyol Stage Environment Integration Services" icon="fa-info-circle">
  <h6 align="right"> 03.03.2025 </h6>
  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.
</Accordion>

<Accordion title="Trendyol - GULF Region Ramadan Campaign" icon="fa-info-circle">
  <h6 align="right"> 27.02.2025 </h6>
  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.
</Accordion>

<Accordion title="Romania Trendyol Pays Cargo Model" icon="fa-info-circle">
  <h6 align="right"> 27.02.2025 </h6>
  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.
</Accordion>

<Accordion title="Trendyol - Incident on Stock and Price Service" icon="fa-info-circle">
  <h6 align="right"> 27.02.2025 </h6>
  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.
</Accordion>

<Accordion title="TY Pays Model in CEE Region" icon="fa-info-circle">
  <h6 align="right"> 26.02.2025 </h6>
  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.
</Accordion>

<Accordion title="About Delete Invoice Link Service" icon="fa-info-circle">
  <h6 align="right"> 26.02.2025 </h6>
  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)
</Accordion>

<Accordion title="APIGW Base Url Changing" icon="fa-info-circle">
  <h6 align="right"> 25.02.2025 </h6>
  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.
</Accordion>

<Accordion title="Adding New Carrier Companies to Trendyol" icon="fa-info-circle">
  <h6 align="right"> 20.02.2025 </h6>
  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)
</Accordion>

<Accordion title="About Slovakia vatRates Change" icon="fa-info-circle">
  <h6 align="right"> 17.02.2025 </h6>
  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)
</Accordion>

<Accordion title="Adding new Line for getShipment Package and Webhook Service Response" icon="fa-info-circle">
  <h6 align="right"> 14.02.2025 </h6>
  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
</Accordion>

<Accordion title="Trendyol - Alternative Delivery For GULF region" icon="fa-info-circle">
  <h6 align="right"> 12.02.2025 </h6>
  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.
</Accordion>

<Accordion title="getShipmentPackages & Webhook Response Model" icon="fa-info-circle">
  <h6 align="right"> 11.02.2025 </h6>
  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
</Accordion>

<Accordion title="APIGW Base Url Changing" icon="fa-info-circle">
  <h6 align="right"> 04.02.2025 </h6>
  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.
</Accordion>

<Accordion title="About getShipmentPackages and webhook responses" icon="fa-info-circle">
  <h6 align="right"> 31.01.2025 </h6>
  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
</Accordion>

<Accordion title="Create a Test Order Service Update" icon="fa-info-circle">
  <h6 align="right"> 27.12.2024 </h6>
  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)
</Accordion>

<Accordion title="getShipmentPackages Service Error" icon="fa-info-circle">
  <h6 align="right"> 24.12.2024 </h6>
  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.
</Accordion>

<Accordion title="Product Create Error" icon="fa-info-circle">
  <h6 align="right"> 23.12.2024 </h6>
  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.
</Accordion>

<Accordion title="Create a Test Order Service Update" icon="fa-info-circle">
  <h6 align="right"> 23.12.2024 </h6>
  "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)
</Accordion>

<Accordion title="Trendyol - Webhook Services Updates" icon="fa-info-circle">
  <h6 align="right"> 13.12.2024 </h6>
  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.)
</Accordion>

<Accordion title="About Create Claim Services" icon="fa-info-circle">
  <h6 align="right"> 08.09.2023 </h6>
  There has been a request body chance on create claim services. Please check our documentation for details.
</Accordion>

<Accordion title="About Product Integration and Order Integration Services" icon="fa-info-circle">
  <h6 align="right"> 04.09.2023 </h6>
  Product Integration and Order Integration Services has been deprecated. Starting from September 4 you should use Product Integration v2 and Order Integration v2 services.
</Accordion>

<Accordion title="About Product Integration v2" icon="fa-info-circle">
  <h6 align="right"> 09.06.2023 </h6>
  Product Integration v2 services will be live in August.
</Accordion>

<Accordion title="About Order Integration v2 and Returned Order Integration v2" icon="fa-info-circle">
  <h6 align="right"> 05.06.2023 </h6>
  Order Integration v2 and Returned Order Integration v2 services will be live in August.
</Accordion>

<Accordion title="About Service Changes" icon="fa-info-circle">
  <h6 align="right"> 10.05.2023 </h6>
  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.
</Accordion>