Trendyol Entegrasyonu Nasıl Çalışır? Ürün, Stok, Sipariş ve Fatura

Trendyol entegrasyonu nedir?

Trendyol entegrasyonu, satıcının ürün ve sipariş operasyonlarını kendi e-ticaret altyapısı, ERP, stok programı veya merkezi yönetim paneli üzerinden yürütmesini sağlayan API bağlantısıdır. Entegrasyonla ürün oluşturma, ürün bilgisi güncelleme, stok ve fiyat gönderme, siparişleri alma, kargo paketlerini yönetme ve fatura iletme gibi işlemler otomatikleştirilebilir.

Doğru kurulumda hangi sistemin ana veri kaynağı olduğu baştan belirlenir. Ürün açıklaması e-ticaret panelinden, stok ERP’den ve fiyat başka bir dosyadan yönetiliyorsa çakışma riski yükselir. Entegrasyon bütün kaynakları tek bir kurala bağlamalıdır.

Trendyol entegrasyonunun temel modülleri

Ürün aktarımı nasıl yapılır?

Ürün gönderiminden önce ürünün Trendyol katalog yapısında hangi kategoriye, markaya ve özelliklere karşılık geldiği belirlenir. Her ürün için satıcı barkodu, ürün ana kimliği, başlık, marka, kategori, açıklama, görseller, KDV oranı, teslimat süresi ve kategoriye bağlı özellikler hazırlanır.

Varyantlı ürünlerde renk, beden veya kapasite gibi seçenekler aynı ürün grubu altında düzenlenir. Her satılabilir varyantın benzersiz barkodu ve doğru özellik değerleri bulunmalıdır. Ürün onaylandıktan sonra bazı temel alanların değiştirilememesi veya sınırlı güncellenmesi mümkün olduğundan ilk eşleştirme dikkatli yapılmalıdır.

1. Kaynak ürünü hazırlayın: Başlık, açıklama, barkod, marka, görsel, KDV ve varyant verilerini doğrulayın.
2. Kategoriyi eşleştirin: Ürünü uygun uç kategoriye bağlayın.
3. Zorunlu özellikleri alın: Kategoriye ait zorunlu, varyant ve filtre özelliklerini doldurun.
4. Markayı eşleştirin: Yerel marka adını Trendyol marka kimliğiyle bağlayın.
5. Toplu gönderimi oluşturun: Ürünleri servis limitlerine uygun gruplara ayırın.
6. Batch sonucunu takip edin: Başarılı ve hatalı kayıtları ürün bazında işleyin.

Kategori, marka ve özellik eşleştirme

Pazaryeri entegrasyonlarında en fazla hata üreten alanlardan biri kategori ve özellik eşleştirmesidir. Kaynak sistemde “Kadın Ayakkabı” olarak tutulan kategori Trendyol’da daha alt bir uç kategoriye karşılık gelebilir. Bu kategoriye bağlı numara, materyal, topuk tipi, renk ve kullanım alanı gibi özellikler zorunlu olabilir.

Eşleştirme ekranında kaynak kategori, hedef kategori, özellik adı, özellik değeri ve dönüşüm kuralı ayrı tutulmalıdır. Böylece aynı ürün grubu tekrar gönderildiğinde manuel işlem gerekmez. Yeni bir özellik veya değer geldiğinde kayıt hata kuyruğuna alınmalı; sessizce yanlış değer gönderilmemelidir.

Stok ve fiyat senkronizasyonu

Stok ve fiyat, ürün içeriğinden ayrı ve daha sık güncellenen verilerdir. Satış birden fazla kanaldan yapılıyorsa fiziksel stoktan güvenlik stoğu düşülerek satılabilir miktar hesaplanabilir. Sipariş geldiğinde stok ana sistemde rezerve edilmeli ve diğer kanallara hızlıca yansıtılmalıdır.

Liste fiyatı ve satış fiyatı ilişkisi doğrulanmalı; negatif stok, geçersiz fiyat veya para birimi hataları gönderimden önce engellenmelidir. Güncelleme başarısız olursa ürün bazında tekrar denenmeli ve kullanıcıya görünür hata bırakılmalıdır.

Sipariş ve kargo paketi yönetimi

Trendyol siparişleri paket yapısıyla alınır. Aynı müşteri siparişi birden fazla pakete ayrılabilir; paket kimliği, sipariş satırı, adet, kargo firması, teslimat bilgisi ve durum alanları doğru saklanmalıdır. Entegrasyonun yalnızca yeni siparişleri çekmesi değil, durum değişikliklerini de işlemesi gerekir.

1. Yeni sipariş veya paket alınır.
2. Barkod yerel ürünle eşleştirilir ve stok rezerve edilir.
3. Depo toplama ve paketleme görevi oluşturulur.
4. Kargo etiketi veya takip bilgisi işlenir.
5. Fatura hazırlanır ve ilgili pakete bağlanır.
6. Durum değişiklikleri pazaryeri ve yerel sistem arasında eşitlenir.

Aynı siparişin iki kez kaydedilmesini önlemek için dış sistem paket kimliği benzersiz tutulmalıdır. Webhook ve periyodik sorgu birlikte kullanılıyorsa yinelenen olaylar güvenli biçimde işlenmelidir.

Fatura gönderimi

Fatura entegrasyonunda belge, doğru sipariş veya kargo paketiyle eşleştirilmelidir. Fatura numarası, oluşturma tarihi, belge türü ve erişilebilir belge bağlantısı gibi alanlar yerel sistemde saklanmalıdır. E-fatura sağlayıcısı ile Trendyol bağlantısı arasında başarısızlık olduğunda kullanıcı, hangi siparişin neden beklediğini görebilmelidir.

İptal ve iade işlemleri

Sipariş iptali, tedarik edememe ve iade aynı işlem değildir. Her durumun stok, finans ve sipariş kaydına etkisi ayrı tasarlanmalıdır. Tedarik edilemeyen ürün için neden kodu, adet ve paket satırı doğru gönderilmelidir. İade talebi geldiğinde ürün depoya ulaşmadan stok artırılmaması gerekebilir.

Batch sonucu ve hata kuyruğu

Ürün ve toplu güncelleme servisleri çoğunlukla işlemi hemen tamamlamak yerine bir batch kimliği döndürür. Entegrasyon bu kimliği kaydetmeli, sonucu belirli aralıklarla sorgulamalı ve her ürünün durumunu ayrı işlemelidir.

Hatalı ürün sessizce atlanmamalıdır. Ürün adı, barkod, servis, istek zamanı, hata mesajı ve son deneme bilgisi panelde görünmelidir.

Çoklu mağaza ve ana veri kaynağı

Birden fazla Trendyol mağazası, şirket veya ülke vitrini yönetiliyorsa her mağazanın kimlik bilgileri, fiyat kuralları, stok deposu ve ürün kapsamı ayrı tutulmalıdır. Aynı barkodun farklı mağazalarda farklı fiyat veya stokla satılması mümkündür; bu durumda kanal bazlı kayıt tasarımı gerekir.

Yetkilendirme ve servis limitleri

API anahtarları kod içine veya tarayıcı tarafına yazılmamalıdır. Kimlik bilgileri sunucuda güvenli biçimde saklanmalı, erişim kayıtları tutulmalı ve çalışan ayrıldığında yetkiler yenilenmelidir. Servis limitleri nedeniyle bütün ürünleri her dakika göndermek yerine değişiklik kuyruğu kullanılmalıdır.

Kurulum ve test akışı

1. Mağaza yetkilerini tanımlayın: Satıcı kimliği ve API erişimini güvenli biçimde kaydedin.
2. Kategori ve marka verisini çekin: Yerel eşleştirme tablolarını oluşturun.
3. Az sayıda ürünle test edin: Basit, varyantlı ve farklı kategoriden örnekler seçin.
4. Batch sonuçlarını doğrulayın: Başarılı ve reddedilen ürünleri panelde gösterin.
5. Stok-fiyat testini yapın: Değişikliklerin doğru barkoda ve doğru mağazaya gittiğini kontrol edin.
6. Sipariş senaryosu çalıştırın: Sipariş, paket, kargo, fatura, iptal ve iade akışlarını ayrı test edin.
7. Canlı izleme kurun: Hata oranı, bekleyen kuyruk ve son başarılı işlem zamanı raporlansın.

Trendyol entegrasyonu kontrol listesi

• Her ürün ve varyantın benzersiz barkodu var.
• Kategori, marka ve zorunlu özellik eşleştirmeleri kayıtlı.
• Ürün içeriği ile stok-fiyat güncellemesi ayrı kuyruklarda çalışıyor.
• Batch sonuçları ürün bazında takip ediliyor.
• Sipariş ve paket kimlikleri yinelenmeye karşı korunuyor.
• İptal, tedarik edememe ve iade durumları ayrı yönetiliyor.
• Fatura doğru paketle eşleştiriliyor ve belge bağlantısı erişilebilir.
• API limitleri ve yeniden deneme kuralları tanımlı.
• Kimlik bilgileri güvenli saklanıyor ve erişim kayıtları tutuluyor.
• Entegrasyon sürümü ve dokümantasyon değişiklikleri izleniyor.

Sık sorulan sorular

Trendyol entegrasyonu ürünleri otomatik onaylar mı?

Hayır. Entegrasyon ürünü doğru veriyle gönderir ve sonucu takip eder; katalog ve yayın değerlendirmesi pazaryeri kurallarına göre yapılır.

Stok ne kadar sık güncellenmeli?

Satış hacmi ve kanal sayısına göre belirlenir. Değişen stokların kuyrukla hızlı gönderilmesi, bütün kataloğun sürekli tekrar gönderilmesinden daha verimlidir.

Mevcut Trendyol ürünleri sisteme alınabilir mi?

Onaylı ürünler ürün filtreleme servisleriyle çekilerek yerel barkod ve ürün kartlarıyla eşleştirilebilir. Eşleşmeyen kayıtlar manuel onaya bırakılmalıdır.

Birden fazla mağaza yönetilebilir mi?

Evet. Her mağazanın yetkisi, fiyat kuralı, ürün kapsamı ve stok deposu ayrı tanımlanmalıdır.