Entegrasyon
Trendyol Entegrasyonu: API ile Ürün, Stok ve Sipariş Senkronu
Trendyol entegrasyonu, ürün, stok, fiyat ve sipariş verisinin Trendyol satıcı API'si üzerinden siteniz ya da ERP'nizle kendiliğinden akmasıdır. Kategori eşlemeden iade akışına kadar bağlantıyı iş kurallarınıza göre kuruyoruz.
Trendyol entegrasyonu, ürün kartlarını, stok ve fiyat bilgisini ve siparişleri satıcı panelinde elle yönetmek yerine Trendyol'un satıcı API'si üzerinden sistemleriniz arasında otomatik taşır. Ürün sitenizde ya da ERP'nizde değiştiğinde Trendyol'daki ilan da güncellenir; Trendyol'da sipariş geldiğinde stok diğer kanallarda düşer ve sipariş faturalanmak üzere sisteminize yazılır.
Bu sayfa Trendyol API entegrasyonunun teknik tarafını anlatıyor: hangi işlemler otomatikleşir, kategori eşleme nasıl yapılır, Shopify, özel site ve ERP senaryolarında akış nasıl kurulur ve hangi sınırlar vardır. Tüm pazaryerleri için genel yaklaşımımız pazaryeri entegrasyonu, mimarimiz e-ticaret ve ERP entegrasyonu sayfasında.
Trendyol satıcı API'siyle neler otomatikleşir?
Trendyol'un satıcılara açtığı API, panelde yapılan işlerin büyük kısmını programla yapmayı sağlar. Erişim için satıcı panelindeki entegrasyon bilgileri bölümünden API anahtarı ve gizli anahtar alınır; her istek bu bilgilerle doğrulanır ve istek başlığında satıcı kimliğiniz belirtilir.
| İşlem | Yön | Nasıl çalışır |
|---|---|---|
| Ürün oluşturma ve güncelleme | Sizden Trendyol'a | Ürünler toplu istekle gönderilir, sonuç işlem kimliğiyle ayrıca sorgulanır |
| Stok ve fiyat | Sizden Trendyol'a | Tek istekte birçok barkodun stoku, liste fiyatı ve satış fiyatı güncellenir |
| Sipariş paketleri | Trendyol'dan size | Yeni paketler çekilir, toplama ve faturalama durumları geri bildirilir |
| Kargo | Trendyol'dan size | Paketin kargo firması ve takip numarası paket bilgisiyle gelir |
| Fatura | Sizden Trendyol'a | Kesilen faturanın bağlantısı ilgili pakete iletilir |
| İade | Trendyol'dan size | İade talepleri çekilir, depoya ulaşan ürün için onay ya da gerekçeli itiraz gönderilir |
| Müşteri soruları | İki yönlü | Ürün soruları çekilir, cevaplar sizin ekranınızdan gönderilir |
Bir ayrıntı entegrasyonun doğruluğunu belirler: Trendyol ürün, stok ve fiyat isteklerini anında işlemez. İsteği kabul edip bir işlem kimliği (batchRequestId) döner; hangi barkodun başarılı, hangisinin hatalı olduğu bu kimlikle ayrıca sorgulanır. Bu sonucu okumayan bir entegrasyon reddedilen güncellemeyi gönderilmiş sayar ve stok farkı sessizce büyür. Bizim kurgumuzda her toplu isteğin sonucu takip edilir, hatalı satırlar sebebiyle birlikte hata ekranına düşer.
Kategori ve özellik eşleme süreci
Trendyol'a ürün gönderirken en çok emek isteyen iş eşlemedir. Ürün en alt seviyedeki bir Trendyol kategorisine bağlanır ve o kategorinin özellikleri doldurulur. Özelliklerin bir kısmı zorunludur, bir kısmı varyant oluşturur (renk, beden gibi), bazıları yalnızca Trendyol'un değer listesinden seçilebilir.
| Sizdeki alan | Trendyol alanı | Not |
|---|---|---|
| Varyant barkodu | barcode | Her varyantta benzersiz olmalı |
| Model kodu | productMainId | Aynı modelin varyantlarını tek ilanda toplar |
| Stok kodu (SKU) | stockCode | ERP ile eşleşmenin anahtarı |
| Koleksiyon ya da ürün türü | categoryId | En alt kategori seçilir |
| Marka | brandId | Trendyol'un marka listesindeki kimlik |
| Renk, beden, materyal | Kategori özellikleri | Değer listesine eşlenir |
| KDV oranı | vatRate | Satış fiyatı KDV dahil gönderilir |
Eşleme tablolarını panelden yönetilebilir kurarız; yeni bir kategori ya da renk değeri geldiğinde ekibiniz eşlemeyi kendisi tanımlar. İlk aktarımdan önce kataloğu şu açılardan tararız:
- Barkodu eksik ya da birden fazla üründe tekrar eden varyantlar
- Trendyol'un değer listesinde karşılığı olmayan renk ve beden adları
- Trendyol'daki marka kaydıyla birebir tutmayan marka adları
- Görseli ya da açıklaması yetersiz ürünler
Reddedilen ürünlerin çoğu bu dört başlıktan çıkar. Aktarımdan önce düzeltmek, onaydan sonra tek tek uğraşmaktan daha ucuzdur.
Shopify, özel site ve ERP senaryoları
Shopify mağazası
Shopify'ın kendi pazaryeri kanalı Trendyol'u kapsamaz; App Store'daki Trendyol uygulamaları üçüncü taraf geliştiricilere aittir ve standart akış için yeterli olabilir. Shopify'daki seçenekleri ve özel kurguyu Shopify Trendyol entegrasyonu sayfasında ayrıca anlattık.
Özel e-ticaret sitesi
Siteniz size özel bir altyapıda çalışıyorsa Trendyol bağlantısı sitenin arka yüzüne modül olarak eklenir. Stok tek tabloda tutulur, Trendyol siparişleri diğer siparişlerle aynı ekranda kaynak etiketiyle görünür. Sitede fiyat değiştiğinde Trendyol fiyatı tanımlı kanal kuralına göre yeniden hesaplanır.
ERP merkezli yapı
Stok ve fiyatın ana kaynağı ERP ise Trendyol, ERP'den beslenen kanallardan biri olur. Trendyol siparişi ERP'de satış belgesine dönüşür; kargo bedeli ve indirimler ayrı satırlarla yazılır ki toplam Trendyol'daki tutarla tutsun. Logo, Nebim V3 ve Odoo tarafındaki belge yapısını ERP entegrasyonu sayfasında anlattık. Pazaryeri tarafını aylık abonelikli bir entegratör programıyla yönetiyorsanız her şeyi baştan yazmak gerekmez; programın API'si varsa ERP köprüsünü ona bağlarız.
Bir Trendyol siparişinin akışı
- Yeni sipariş paketleri kısa aralıklarla sorgulanır. Kaçan paket kalmasın diye geriye dönük bir tarama da çalışır.
- Sipariş sitenize ya da ERP'nize yazılır ve aynı barkodun stoku diğer kanallarda düşer.
- Depo toplamaya başladığında paket durumu Trendyol'a bildirilir.
- E-fatura ya da e-arşiv kesilir, fatura bağlantısı pakete gönderilir.
- Paket çoğunlukla Trendyol'un anlaşmalı kargosuyla çıkar, takip numarası siparişinize yazılır. Kargo firmasına doğrudan bağlanmanız gereken durumlar kargo entegrasyonu sayfasında.
- Teslim ve iade durumları siparişe ve stoka yansır.
Ürün onay süreleri, istek limitleri ve iade akışındaki sınırlar
- Yeni ürünler Trendyol'un içerik kontrolünden geçer ve onaylanana kadar satışa açılmaz. Onay süresi Trendyol'a bağlıdır. Entegrasyon bu süreyi kısaltmaz, ama reddedilen ürünleri sebebiyle listeleyip düzeltmeyi hızlandırır.
- Trendyol uç noktalara göre istek sınırı uygular. Bu yüzden stok ve fiyatı ürün ürün değil toplu gönderir, yalnızca değişen barkodları iletiriz. Sınıra takılan istekler artan aralıklarla yeniden denenir.
- İade Trendyol'da başlar, ürün deponuza ulaştıktan sonra onaylanır ya da gerekçeyle itiraz edilir. Stokun geri alınması ve iade faturası ERP'de ayrıca kurgulanır. Bu adım atlanırsa iade edilen ürün satışa dönmez.
- Komisyon kategoriye göre değiştiği için Trendyol fiyatı genellikle site fiyatınızdan bir kanal kuralıyla (oran ya da sabit fark) türetilir. Kural sizin kararınızdır, entegrasyon onu uygular.
- Trendyol'un test ortamına erişim için IP tanımı istenir. Her akış testte tam denenemediği için canlıda sınırlı ürünle pilot yapılır.
Trendyol akışınızı birlikte çizelim
Ürünlerinizin nerede yönetildiğini, sipariş hacminizi ve kullandığınız ERP'yi yazın; hangi verinin hangi yönde akacağını netleştirelim.
Trendyol API entegrasyonu süreci
- Keşif. Ürün sayısı, varyant yapısı, stok kaynağı ve sipariş hacmi çıkarılır; API bilgileri ve test erişimi istenir.
- Eşleme. Kategori, özellik, marka ve fiyat kuralları tablo olarak hazırlanır ve sizinle onaylanır.
- Geliştirme. Ürün, stok, sipariş ve iade akışları kuyruk, tekrar deneme ve hata ekranıyla birlikte yazılır.
- Pilot. Sınırlı bir ürün grubu gönderilir, onay sonuçları ve ilk siparişler birlikte kontrol edilir.
- Yaygınlaştırma. Kataloğun geri kalanı aktarılır, eski yöntem kontrollü biçimde kapatılır.
- İzleme. Hata ekranı, alarmlar ve stok mutabakatı düzenli takip edilir.
Aynı altyapıya diğer pazaryerlerini de bağlayabilirsiniz: Hepsiburada, N11 ve Amazon kanallarında stok tek kaynaktan dağıtılır.
Trendyol entegrasyonu maliyetini belirleyen kalemler
- Ürün ve varyant sayısı, kategori çeşitliliği
- Akışların kapsamı: yalnızca stok ve fiyat mı, sipariş, fatura, iade ve sorular da mı
- Stok ve fiyatın ana kaynağı: site, Shopify ya da ERP
- Kanal bazlı fiyat kuralları ve kampanya ihtiyaçları
- Bağlanacak diğer sistemler: ERP, e-fatura, kargo
- İzleme ekranı, raporlar ve yayın sonrası bakım
Bu yaklaşımın dayandığı canlı işlerimiz
- Shopify ile Nebim V3 arasında sipariş, stok ve ürün aktarımı
- Tedarikçi ve pazaryeri XML ürün akışları (XML Product Export & XML Feed, Built for Shopify rozetli)
- Shopify mağazalarında Yurtiçi Kargo gönderimleri
- Siparişlerden otomatik Paraşüt e-fatura
SSS