Trendyol Satıcı API kimlik bilgilerini tanımlar. Bilgileri Trendyol Satıcı Paneli > Hesap Bilgileri > Entegrasyon Bilgileri sayfasından alabilirsiniz. Ortam değişkenleri (TRENDYOL_SELLER_ID, TRENDYOL_API_KEY, TRENDYOL_API_SECRET) tanımlıysa bu araca gerek yoktur.

Tanımlı Trendyol API kimlik bilgilerinin durumunu gösterir (secret maskelenir).

Satıcının Trendyol ürünlerini sayfalı olarak listeler. Barkod, stok kodu, onay/satış durumu ve tarih filtreleri uygulanabilir.

Satıcının kayıtlı adreslerini döndürür. Ürün oluştururken (trendyol_create_products) gönderilen shipmentAddressId ve returningAddressId değerleri buradan alınır: supplierAddresses[] içinde shipmentAddress=true olan kayıtların id değeri shipmentAddressId, returningAddress=true olanlarınki returningAddressId için kullanılır (addressType: Shipment, Invoice, Returning). Yanıt ayrıca defaultShipmentAddress, defaultInvoiceAddress ve defaultReturningAddress alanlarını içerir; default=true olan kayıt o tür için varsayılandır. UYARI: "SATICI BAŞVURU SÜRECİ" tamamlanmadan bu servis kullanılmamalıdır.

Trendyol marka listesini sayfalı olarak döndürür; brandId değeri ürün oluştururken kullanılır. Bir sayfada en az 1000 marka dönebilir — belirli bir markayı ararken sayfalama yerine trendyol_get_brand_by_name tercih edin.

Marka adına göre arama yapar. DİKKAT: Marka adları büyük/küçük harfe duyarlıdır (ör. "TRENDYOLMİLLA").

Trendyol marka listesinde bulunmayan bir markayı oluşturur. Marka adı ve 1-3 adet marka görseli (diskteki dosya yolları) gönderilir.

Trendyol kategori ağacını döndürür. Ürün oluştururken YALNIZCA en alt seviye kategori (subCategories: []) kullanılabilir; alt kategorisi olan bir kategori ile ürün aktarılamaz. Kategori ağacı düzenli olarak güncellenir — güncel olmayan ağaç eksik/yanlış veri girişine yol açar; haftalık yenilemeniz önerilir. name parametresi, anahtar kelimenin geçtiği tüm seviyelerdeki kategorileri döndürür.

Bir kategoriye ait özellikleri (attributes) döndürür; ürün oluştururken gönderilecek attributeId değerleri buradan alınır. Alan anlamları: required=true ise attributes içinde gönderilmesi zorunlu; allowCustom=true ise ID yerine serbest metin (customAttributeValue) gönderilir; slicer=true ise trendyol.com’da ayrı ürün kartı açılır (ör. renk); varianter=true ise aynı içerik altında varyant olur (ör. beden); allowMultipleAttributeValues=true ise özellik birden çok değer alabilir.

Bir kategori özelliğinin alabileceği değerleri (attributeValueId) sayfalı olarak döndürür. Yeni değerler eklenebildiği için listeyi haftalık yenilemeniz önerilir.

Trendyol sistemine tekli/toplu ürün yükler (istek başına en fazla 1000 kalem). Önce trendyol_get_brands, trendyol_get_category_tree, trendyol_get_category_attributes ve trendyol_get_category_attribute_values ile gerekli ID değerlerini alın. Varyantlı ürünlerde (ör. aynı ürünün L ve XL bedeni) her varyant ayrı kalem olarak, YALNIZCA attributes farklı olacak şekilde ve aynı productMainId ile gönderilir. İstek sonucunda dönen batchRequestId ile trendyol_get_batch_request_result çağrılarak sonuç KONTROL EDİLMELİDİR; başarılı istekten sonra onay süreci başlar, onaydaki/reddedilen ürünler yayına alınmaz.

Onay bekleyen (taslak) ürünlerin bilgilerini günceller; yalnızca ürün bilgisi güncellenir (istek başına en fazla 1000 kalem). Güncelleme öncesi kategori/özellik bilgilerinizin güncel olduğunu doğrulayın. Sonucu batchRequestId ile trendyol_get_batch_request_result üzerinden kontrol edin.

Onaylı ürünlerin içeriğini (başlık, açıklama, görsel, özellik) günceller; contentId ile çalışır (istek başına en fazla 1000 kalem). Onaylı üründe barcode, productMainId, brandId, categoryId ve slicer/varianter özellik değerleri GÜNCELLENMEZ. Kısmi güncelleme desteklenir (ör. yalnızca contentId + description göndermek yeterlidir) — ANCAK özelliklerden herhangi biri güncellenecekse ürünün TÜM özellikleri ve değerleri istekte gönderilmelidir. Sonucu trendyol_get_batch_request_result, QC sonucunu trendyol_get_product_update_audits ile kontrol edin.

Onaylı ürünlerin varyant bilgilerini günceller (istek başına en fazla 1000 kalem). barcode dışındaki tüm alanlar güncellenebilir; kısmi güncelleme desteklenir (barkod + değiştirmek istediğiniz alanı göndermek yeterlidir). Sonucu trendyol_get_batch_request_result ile kontrol edin.

Onaylı ürünlerin teslimat bilgilerini günceller (istek başına en fazla 1000 kalem). barcode dışındaki tüm alanlar güncellenebilir. fastDeliveryType kullanmak için deliveryDuration=1 olmalıdır. Sonucu trendyol_get_batch_request_result ile kontrol edin.

Onaylı ürünlerin stok ve fiyatını günceller (istek başına en fazla 1000 sku). quantity = satılabilir stok. DİKKAT: Aynı isteği değişiklik yapmadan tekrar gönderirseniz "15 dakika boyunca aynı isteği tekrarlı olarak atamazsınız!" hatası döner — yalnızca değişen stok/fiyatları gönderin. Sonucu trendyol_get_batch_request_result ile kontrol edin (stok-fiyat güncellemesinde batch status alanı dönmez; kalem bazlı status alanlarına bakın).

Ürünleri arşivler veya arşivden çıkarır (istek başına en fazla 1000 kalem). Arşivlenen ürünler Trendyol’da görünmez olur ancak silinmez; arşivden çıkarılan ürünler yeniden aktifleşir. Sonucu trendyol_get_batch_request_result ile kontrol edin.

Düşük/yüksek fiyatlama, kritik fiyat hatası veya ürünü tedarik edememe nedeniyle satışa kapatılan (kilitlenen) ürünlerin kilidini açar. Kilit durumu trendyol_filter_approved_products yanıtındaki locked/lockReason alanlarından görülebilir. Sonucu trendyol_get_batch_request_result ile kontrol edin.

☢️ DİKKAT: Ürün silme geri alınamaz. Ürünleri Trendyol sisteminden siler. Yalnızca onay bekleyen ürünler ile BİR GÜNDEN UZUN SÜREDİR ARŞİVDE olan ve Trendyol tarafından satışa kapatılmamış onaylı ürünler silinebilir. Geçici olarak yayından kaldırmak için silmek yerine trendyol_archive_products kullanın. Sonucu trendyol_get_batch_request_result ile kontrol edin.

createProducts, updateProducts, updatePriceAndInventory, arşivleme, silme ve kilit açma işlemlerinden dönen batchRequestId ile işlem sonucunu sorgular. status alanı (IN_PROGRESS | COMPLETED) batch’in tamamlanıp tamamlanmadığını, kalem bazlı failureReasons alanı hata nedenlerini gösterir. Sonuçlar en fazla 4 saat boyunca sorgulanabilir. Not: Stok-fiyat güncellemelerinde batch status alanı dönmez; kalem bazlı status alanlarını kontrol edin.

Tek bir barkodun temel durum bilgisini (approved, archived, listingId, contentId, approvedDate) döndürür.

Onaysız (taslak) ürünleri listeler: onay sürecinde olanlar (pendingApproval) ve inceleme sonrası reddedilenler (rejected). Reddedilen ürünlerin nedenleri rejectReasonDetails alanında döner; gerekli düzeltmeler yapılınca ürün yeniden onay sürecine girer. page × size en fazla 10.000 olabilir; 10.000’den fazla barkod için nextPageToken kullanın (size + nextPageToken göndererek sonraki sayfayı alırsınız).

Onaylı ürünleri içerik (content) ve varyant detaylarıyla listeler: fiyat, stok, komisyon, kilit/arşiv durumu, teslimat seçenekleri ve ürün URL’i. page × size en fazla 10.000 olabilir; 10.000’den fazla içerik için nextPageToken kullanın.

Onaylı ürünlerin yalnızca stok ve fiyat bilgisini listeler (tam içerik detayı olmadan). stockLastModifiedDate yalnızca üründe stok güncellemesi olduysa dolu döner, aksi halde null’dır. page × size en fazla 10.000 olabilir; sonrası için nextPageToken kullanın.

Ürünlerin buybox bilgisini döndürür: buybox sıralaması (buyboxOrder), buybox fiyatı, birden fazla satıcı olup olmadığı ve ikinci/üçüncü buybox fiyatları. Tek istekte en fazla 10 barkod sorgulanabilir (servis limiti: 1000 istek/dk).

Ürün bilgi güncelleme isteklerinin kalite kontrol (QC) sonuçlarını contentId bazında döndürür. Her güncelleme tipi (TITLE, DESCRIPTION, MEDIA, ATTRIBUTE) için status (SUCCESS | FAIL), reddedilenlerde rejectReasons ve değişen/mevcut değerler döner.

Ürün içeriği için video oluşturur; video verilen URL’den indirilip arka planda işlenir (limit: 200 istek/dk). Dosya koşulları: .mp4 veya .mov, en fazla 500 MB, 8-120 saniye. Bir productContentId için yalnızca 1 aktif video olabilir; bir video en fazla 100 farklı içerik ID’sine bağlanabilir. Video, isApproved=true olana kadar son kullanıcıya gösterilmez — durumu trendyol_get_videos ile takip edin. Başarılı indirme sonrası aynı productContentId’ye sahip eski videoların ürün bağlantısı otomatik kaldırılır.

Satıcının entegrasyon videolarını listeler (limit: 1000 istek/dk). status: IN_PROGRESS (indiriliyor/işleniyor), SUCCESS (indirildi), FAILED (başarısız — errorCode alanına bakın). Video yalnızca status=SUCCESS ve isApproved=true iken yayındadır; optimizedVideoUrl yalnızca işlem tamamlandığında dolar.

Satıcının siparişlerini (sipariş paketlerini) sayfalı olarak listeler. Belirli bir siparişi getirmek için orderNumber verin. Durum filtreleri: Created, Picking, Invoiced, Shipped, Cancelled, Delivered, UnDelivered, Returned, Repack, UnSupplied, Awaiting, AtCollectionPoint, UnPacked.

Müşterilerin sorduğu soruları sayfalı olarak listeler. Tarih verilmezse Trendyol son bir haftanın sorularını döndürür. startDate/endDate aralığı en fazla 2 hafta olabilir — Trendyol daha uzun aralıklarda HATA VERMEZ, endDate’i sessizce startDate + 2 hafta yapar; bu araç veri kaybını önlemek için 2 haftadan uzun aralığı baştan reddeder, daha geniş tarama için aralığı 2 haftalık parçalara bölüp ayrı çağrılar yapın. Yanıtlanacak soruları bulmak için status=WAITING_FOR_ANSWER kullanın (yalnızca bu durumdaki sorular trendyol_create_answer ile yanıtlanabilir). Durum açıklamaları: trendyol_get_reference_data kind=soru_durumlari. Yanıttaki id değeri trendyol_create_answer ve trendyol_get_question_by_id için kullanılır; userName yalnızca showUserName=true ise dolar; tarihler epoch milisaniyedir.

Tek bir müşteri sorusunu ID ile getirir. id değerini trendyol_get_questions yanıtındaki content[].id alanından alabilirsiniz. Yanıt: soru metni, durum, müşteri bilgisi, ürün bilgisi (productName, productMainId = model kodu, imageUrl, webUrl), aktif yanıt (answer) ve son reddedilen yanıt (rejectedAnswer; reason alanı red gerekçesini verir).

Müşteri sorusuna yanıt gönderir. YALNIZCA WAITING_FOR_ANSWER durumundaki sorular yanıtlanabilir (durumlar için trendyol_get_reference_data kind=soru_durumlari). Yanıt 10-2000 karakter olmalıdır. Yanıtlar yasaklı kelime kontrolünden geçer: yasaklı kelime tespit edilirse yanıt reddedilir ve soru WAITING_FOR_ANSWER durumuna geri döner; belirli sayıda yasaklı kelime denemesinden sonra soru UNANSWERED durumuna geçer ve bir daha yanıtlanamaz. Sorular 3 iş günü içinde yanıtlanmazsa kapanır. Olası hatalar: soru zaten yanıtlanmış, süre limiti aşıldı, yasaklı kelime limiti aşıldı.

Siparişin e-arşiv fatura bağlantısını Trendyol’a iletir; Trendyol bu bağlantıyı içeren e-Fatura e-postasını müşteriye gönderir. Siparişteki şifreli e-posta adresine PDF ekleyerek fatura gönderemiyorsanız bu servisi kullanın (şifreli adresler müşteri bazında sabit değildir, her sipariş için ayrı üretilir). ☢️ YASAL YÜKÜMLÜLÜK: bu servisle iletilen fatura bağlantısı 8 yıl boyunca erişilebilir kalmalıdır. invoiceNumber ve invoiceDateTime Mikro İhracat ve Trendyol Cross-Border Fulfillment paketlerinde ZORUNLU, diğer paket tiplerinde opsiyoneldir. HTTP 409 iki durumda döner: (1) bu shipmentPackageId için zaten fatura iletilmiş, (2) bu bağlantı daha önce başka bir shipmentPackageId için kullanılmış. Yanlış iletilen bağlantı trendyol_delete_invoice_link ile silinip yeniden gönderilebilir.

☢️ Hatalı iletilmiş bir fatura bağlantısını siler; ardından trendyol_send_invoice_link ile doğru bağlantı yeniden iletilebilir. serviceSourceId = shipmentPackageId, customerId değerini trendyol_get_orders yanıtındaki paket bilgisinden alabilirsiniz. channelId her zaman 1 gönderilir.

Siparişin fatura dosyasını (pdf, jpeg, png) yükler. Dosya 10 MB’ı aşamaz ve ileri tarihli fatura eklenemez. Mikro İhracat ve Trendyol Cross-Border Fulfillment siparişlerinde invoiceNumber ve invoiceDateTime ZORUNLUDUR (eksikse "Invoice information is required for Micro export types" hatası döner). Sık hatalar: paket başka satıcıya aitse "The shipment package does not belong to the specified seller", paketin faturası zaten yüklüyse "The invoice for the package number has already been sent", paket bulunamazsa "The shipment package with the ID could not be found".

Satış, iade, indirim, kupon ve provizyon işlemlerinin detaylarını getirir. Finansal kayıtlar sipariş TESLİM EDİLDİKTEN sonra oluşur. transactionType (tek tür) veya transactionTypes (çok tür) verilmelidir; ikisi birden verilirse Trendyol transactionTypes’ı geçerli sayar. Trendyol bu uçta en fazla 15 günlük aralık kabul eder; verilen aralık otomatik olarak 15 günlük parçalara bölünüp tüm sayfalar birleştirilir. paymentOrderId sipariş–ödeme eşleştirmesi için kullanılır ve sipariş ödendikten sonra oluşur (istisnalar dışında vadesi gelen siparişler için her Çarşamba bir ödeme emri üretilir). Düzeltme kayıtları çiftler hâlinde değerlendirilmelidir: SellerRevenuePositive↔CommissionNegative, SellerRevenueNegative↔CommissionPositive, SellerRevenuePositiveCancel↔CommissionNegativeCancel, SellerRevenueNegativeCancel↔CommissionPositiveCancel. Her türün açıklaması, cari hesaba etkisi ve commissionAmount/sellerRevenue işaretleri için trendyol_get_reference_data kind=settlement_islem_turleri. Yanıttaki store* alanları yalnızca Market satıcılarında dolar (Marketplace’te null); affiliate TRENDYOLTR veya TRENDYOLAZJV döner.

Sipariş dışı finansal kayıtları getirir: satıcı finansmanı, virmanlar, ödemeler (hakedişler), Trendyol’un satıcıya kestiği faturalar, satıcının Trendyol’a kestiği faturalar, gelen virmanlar ve komisyon mutabakat faturaları. transactionType (tek tür) veya transactionTypes (çok tür) verilmelidir; ikisi birden verilirse Trendyol transactionTypes’ı geçerli sayar. Aralık otomatik olarak 15 günlük parçalara bölünür. transactionSubType=PlatformServiceFee yalnızca DeductionInvoices ile birlikte kullanılabilir ve platform hizmet bedeli kayıtlarını süzer. Kargo faturası seri numarası için: transactionType=DeductionInvoices sonuçlarında transactionType değeri "Kargo Faturası"/"Kargo Fatura" olan kayıtların "id" alanı, trendyol_get_cargo_invoice_items’in invoiceSerialNumber değeridir. Türlerin açıklamaları için trendyol_get_reference_data kind=diger_finansal_islem_turleri.

Trendyol’un satıcıya kestiği kargo faturasının kalemlerini getirir. invoiceSerialNumber: trendyol_get_other_financials (transactionType=DeductionInvoices) yanıtında transactionType değeri "Kargo Faturası" veya "Kargo Fatura" olan kayıtların "id" alanıdır.

İade (claim) paketlerini sayfalı olarak listeler; sonuçlar lastModifiedDate sırasına göre döner. Yeni iadeler için claimItemStatus=Created kullanın. claimIds verilirse diğer tüm filtreler yok sayılır ve yalnızca o claim döner. Yanıttaki orderShipmentPackageId, iade paketinin ID değeridir (trendyol_update_test_claim_to_waiting_in_action bu değeri bekler). Tarihler (claimDate, orderDate, lastModifiedDate) GMT epoch milisaniyedir; satıcı paneliyle eşleştirmek için GMT+3 olarak yorumlayın. Durumlar: Created, WaitingInAction, WaitingFraudCheck, Accepted, Unresolved, Rejected, Cancelled, InAnalysis.

İade kodu olmadan gelen sipariş paketleri için iade (claim) talebi oluşturur. Talep "Created" durumunda açılır; bu servis yalnızca ONAYLAYACAĞINIZ iadeler için kullanılmalıdır. customerId değerini trendyol_get_orders yanıtındaki siparişten alabilirsiniz. Oluşan iade paketini trendyol_get_claims ile görüntüleyebilirsiniz. stageMode açıksa stage ortamında çalışır.

☢️ DİKKAT: İade onayı geri alınamaz ve müşteriye para iadesi sürecini başlatır. Deponuza ulaşan iade kalemlerini onaylar. Yalnızca WaitingInAction durumundaki iadeler onaylanabilir. claimId ve claimLineItemIdList değerlerini trendyol_get_claims yanıtından alın (claimLineItemIdList = items[].claimItems[].id). Onaylanan iade, kurallara göre fraud kontrolüne tabi olursa Accepted yerine önce WaitingFraudCheck durumunda görünür.

☢️ DİKKAT: İade reddi müşteriyi doğrudan etkileyen, geri alınamaz bir işlemdir. Deponuza ulaşan iade kalemleri için red talebi oluşturur. Yalnızca WaitingInAction durumundaki iadeler reddedilebilir. claimIssueReasonId için trendyol_get_claim_issue_reasons kullanın. Dosya eki, 451, 1651 ve 2101 dışındaki TÜM nedenler için zorunludur (pdf, jpeg vb.). Not: 2101 ("Sipariş sorusundan gelen değişim talebi") ile reddedilirse değişim onaylanır; müşterinin talebi yoksa kullanılmamalıdır. Red sonrası iade reddi paketi oluşursa bilgileri trendyol_get_claims yanıtındaki rejectedpackageinfo alanından izlenebilir.

trendyol_create_claim_issue için geçerli red nedenlerini (claimIssueReasonId) listeler. Not: 1651 ("İade paketi elime ulaşmadı") nedeni, iade WaitingInAction durumuna geçtikten sonraki ilk 24 saat içinde seçilemez.

Bir iade kaleminin durum geçmişini getirir: önceki/yeni durum, güncelleme tarihi ve işlemi yapan. executorApp="SellerIntegrationApi" entegrasyon üzerinden, "Seller Center Orders BFF" satıcı paneli üzerinden yapılan işlemi gösterir; bunlar dışındaki kayıtlar sizin tarafınızdan yapılmayan işlemlerdir.

Sabit listeleri döndürür: iade nedenleri (getClaims yanıtındaki customerClaimItemReason/trendyolClaimItemReason id karşılıkları), iade durumları, dosya eki gerektirmeyen red nedenleri, kargo firmaları (ürün oluştururken kullanılan cargoCompanyId), menşei ülke kodları, video içerik türleri ve finans işlem türleri. settlement_islem_turleri her tür için açıklama, cari hesaba etkisi (Alacak/Borç) ve commissionAmount/sellerRevenue işaretlerini verir. Red nedenlerinin güncel tam listesi için trendyol_get_claim_issue_reasons kullanın.

STAGE ortamında test siparişi oluşturur (üretim ortamını etkilemez). Barkodlar stage ortamındaki ürünlere ait olmalıdır. Adres/müşteri alanları verilmezse test varsayılanları kullanılır. Kurumsal fatura için commercial=true ile birlikte address.company, invoiceTaxNumber ve invoiceTaxOffice zorunludur.

STAGE ortamındaki test siparişi paketinin durumunu günceller. Durumlar sırayla ilerler: Shipped (kargoya verildi) → AtCollectionPoint (dağıtım noktasında) → Delivered (teslim edildi) / UnDelivered (teslim edilemedi) → Returned (iade edildi). packageId ve lineId değerlerini trendyol_get_orders (stageMode=true) sonuçlarından alabilirsiniz.

STAGE ortamında oluşturulmuş bir iade (claim) talebini WaitingInAction durumuna çeker; iade onay/red test senaryoları için kullanılır. shipmentPackageId değerini trendyol_get_claims yanıtındaki orderShipmentPackageId alanından alabilirsiniz.

STAGE ortamında bir ürün için müşteri sorusu oluşturur; trendyol_create_answer test senaryoları için kullanılır. Bu servisin yalnızca stage ortamı vardır — çağrı her zaman stageapigw’ye gider. Soru metni boş olamaz. Oluşturulan soru Trendyol’da yayınlanmadan önce değerlendirmeye girer. userId için dokümandaki örnek değer (4147346) kullanılabilir; channelId verilmezse 1 gönderilir.

Sipariş durum değişiklikleri için webhook kaydeder. Abone olunabilecek durumlar: CREATED, PICKING, INVOICED, SHIPPED, CANCELLED, DELIVERED, UNDELIVERED, RETURNED, UNSUPPLIED, AWAITING, UNPACKED, AT_COLLECTION_POINT, VERIFIED. Kimlik doğrulama BASIC_AUTHENTICATION olarak yapılır; username/password verilmezse API key/secret kullanılır.

Satıcıya ait kayıtlı webhookları listeler.

Kayıtlı bir webhooku ID ile siler. ID değerini trendyol_get_webhooks ile bulabilirsiniz.