Trendyol entegrasyonu, ürün, stok, fiyat ve sipariş bilgisini Trendyol ile kendi sisteminiz arasında elle taşımadan akıtan bağlantıdır. Trendyol bunu herkese açık bir API ve sipariş bildirimleriyle sağlıyor. Tek kanalda satan küçük bir mağazaya hazır bir entegratör yeter. Kendi siteniz, depo programınız ya da ERP’niz varsa bağlantıyı onların etrafında kurmak gerekir.
Trendyol API’si neleri bağlamanıza izin verir?
API, iki yazılımın birbirine veri göndermek için kullandığı kapıdır. Trendyol’un geliştirici dokümanı bu kapıyı üç ana akışa ayırıyor:
| Akış | Ne taşır | Bilmeniz gereken kural |
|---|---|---|
| Ürün | Ürün aktarma, bilgi güncelleme, kategori özellikleri | Özellikler Trendyol’un kategori listesine göre doldurulur |
| Stok ve fiyat | Satılabilir stok, satış fiyatı, liste fiyatı | İstek başına en fazla 1.000 barkod gönderilir |
| Sipariş | Sipariş paketleri, statü güncellemesi, iptal, iade | Siparişler webhook ile anında bildirilebilir |
Webhook, Trendyol’un bir olay olduğunda sizin sisteminize kendiliğinden haber göndermesidir. Siparişi sizin sormanızı beklemez.
Stok ve fiyat güncellemesi nasıl çalışır?
Stok ve fiyat tek bir servisle gönderilir. Trendyol’un stok ve fiyat güncelleme dokümanındaki kurallar şunlar:
- Bir istekte en fazla 1.000 barkod güncellenir.
- Gönderdiğiniz stok satılabilir stoktur. Sipariş geldiğinde Trendyol bu sayıyı kendisi düşürür.
- İstek kuyruğa alınır. Sonucu, dönen toplu işlem numarasıyla ayrıca sorgulamanız gerekir.
- Hiç değişmemiş bir isteği 15 dakika içinde tekrar gönderirseniz hata alırsınız. Yalnızca değişen barkodlar gönderilmelidir.
- 14 Eylül 2026’dan itibaren stok ve fiyat istekleri ortak bir dakika limitine giriyor. Servis limitleri sayfasına göre bu limit, satıcının limit grubuna bağlı olarak dakikada 350 ile 2.000 istek arası. Aynı barkod için dakikada 30’dan fazla fiyat güncellemesi hata döner.
Bu kurallar yüzünden her dakika tüm kataloğu baştan göndermek hem gereksiz hem de hataya açık. Doğru kurgu, stoğu değişen ürünü yakalayıp yalnızca onu göndermektir.
Stoğun asıl kaynağı tek olmalıdır: depo programı, ERP ya da kendi siteniz. Trendyol o kaynağa bakan bir kopya olur.
Siparişler sisteminize nasıl düşer?
Siparişleri almanın iki yolu var. Ya belirli aralıklarla sipariş paketlerini sorgularsınız, ya da webhook ile Trendyol’un size haber vermesini beklersiniz. Webhook modeli siparişin oluşmasından teslimine, iptalinden iadesine kadar 13 statüde bildirim gönderiyor. Sorgulama yolunda Trendyol, sayfa numarasıyla sorgulamaya göre daha verimli ve güvenilir dediği bir akış servisi de sunuyor.
Sipariş sisteminize düştükten sonra statüyü geri beslemek de entegrasyonun işidir. Toplamaya başlandığında Picking, faturalandığında Invoiced statüsü gönderilir. Stok çıkmazsa tedarik edememe bildirimi de API’den yapılır.
Bu akışın hızı mağaza puanına yansır. Siparişin depoya ne kadar çabuk ulaştığı kargoya teslim süresini, stoğun doğruluğu da tedarik edememe oranını belirler. Puanı oluşturan metriklerin tamamını Trendyol mağaza puanı yazımızda anlattık.
Hazır entegratör mü, özel entegrasyon mu?
Trendyol’u başka pazaryerleri ve e-ticaret altyapılarıyla bağlayan hazır entegrasyon yazılımları var. Çoğu mağaza için doğru başlangıç onlardır.
| Durum | Hazır entegratör | Özel entegrasyon |
|---|---|---|
| Tek depo, birkaç pazaryeri, hazır e-ticaret altyapısı | Yeter | Gereksiz maliyet |
| Stok ERP’de ya da depo programında | ERP’nizi destekliyorsa yeter | ERP desteklenmiyorsa gerekir |
| Fiyat bir kurala göre hesaplanıyor (kur, maliyet, kanal farkı) | Kural seçenekleri sınırlıysa zorlanır | Kural koda yazılır |
| Siparişler kendi depo akışınıza girecek | Kısmen | Akışa göre kurulur |
| Abonelik ürün ya da sipariş sayısıyla artıyor | Hacim büyüdükçe pahalanır | Tek seferlik geliştirme ve bakım |
Hazır entegratör işinizi görüyorsa onu kullanın. Özel entegrasyon, stoğun ya da fiyatın kaynağı entegratörün bağlanamadığı bir sistemde olduğunda anlamlıdır. Keşifte sık önerdiğimiz kurgu ikisinin karışımıdır: pazaryerleri hazır araçta kalır, ERP ile o araç arasına küçük bir köprü yazılır. Bu kararın genel hâlini özel yazılım mı hazır yazılım mı yazımızda anlattık.
Özel entegrasyonu hangi sırayla kuruyoruz?
- Kaynakları yazıya dökeriz: stok nerede tutuluyor, fiyatı kim nasıl hesaplıyor, sipariş depoya bugün nasıl ulaşıyor.
- Ürünleri eşleştiririz. Her ürünün barkodu Trendyol’daki barkodla eşleşmeli; eşleşmeyenlerin listesi ilk çıktıdır.
- Stok ve fiyat akışını kurarız. Yalnızca değişen barkodlar gider, her toplu işlemin sonucu kontrol edilir.
- Sipariş akışını kurarız. Siparişler webhook ya da akış servisiyle alınır, depo ekranına düşer, statüler geri beslenir.
- Test ortamında deneriz. Trendyol’un test ortamında test siparişleriyle her statü denenir, sonra canlıya geçilir.
- İzlemeyi açarız. Hata veren istekler ve eşleşmeyen ürünler bir hata panelinde görünür.
İlk sürümde yalnızca stok ve sipariş akışını kapsarız. Ürün aktarma ve otomatik fiyat kuralları, akış oturduktan sonra eklenir. Bu işi e-ticaret ve pazaryeri entegrasyonu hizmetimiz kapsamında yürütüyoruz.
Ne zaman özel entegrasyon yaptırmamalısınız?
Tek kanalda satıyorsanız, ürün sayınız azsa ve stok günde bir kez elle güncellendiğinde tedarik edememe yaşamıyorsanız entegrasyona henüz gerek yok. Satıcı panelindeki toplu güncelleme bu ölçekte yeter.
Satış düşükse entegrasyon tek başına çare olmaz. Ürün, fiyat ve puan tarafında hangi işin önce geldiğini Trendyol satış artırma yazımızda anlattık.
Nereden başlamalısınız?
Stoğunuzun, fiyatınızın ve siparişlerinizin bugün hangi programda durduğunu üç satırla yazın. Üçü de aynı yerdeyse ve o yer hazır entegratörlerce destekleniyorsa onlara bakın. Farklı yerlerdeyse bağlantının hangi parçasının özel yazılması gerektiğini birlikte çıkarırız: Keşif görüşmesi planla.
Sık sorulanlar
01 Trendyol'da stok ne kadar sürede güncellenir?
Trendyol, onaylı ürünlerin stok ve fiyatının eş zamana yakın güncellendiğini belirtiyor. İstek kuyruğa alındığı için sonucu toplu işlem numarasıyla ayrıca kontrol etmek gerekir.
02 Hazır entegratör kullanırken özel yazılım gerekir mi?
Çoğu mağazada gerekmez. Stoğun ya da fiyatın kaynağı entegratörün bağlanamadığı bir sistemdeyse, iki sistem arasına küçük bir köprü yazmak yeterli olur.
03 Entegrasyonu canlıya almadan nasıl deneriz?
Trendyol'un test ortamında test siparişi oluşturup statü değişikliklerini deneyebilirsiniz. Canlıya bu denemeler bittikten sonra geçilir.
KAYNAKLAR