Trendyol Entegrasyonu

Trendyol entegrasyonu ne işe yarar, neyi çözer?

Trendyol'da günde 10 sipariş alan bir satıcı ile 300 sipariş alan bir satıcının yaşadığı sorun aynıdır, sadece ölçeği değişir: her sipariş için ayrı bir fatura kesilmesi, o faturanın PDF olarak Trendyol paneline yüklenmesi, satılan ürünün stoğunun diğer kanallardan da düşürülmesi ve bunların hiçbirinin atlanmaması gerekir. Bu döngü elle yürütüldüğünde her gün saatler harcanır ve hata payı asla sıfırlanmaz.

Entegrasyon, bu döngüyü bir yazılıma devretmektir. TicariHub Trendyol'un satıcı API'sine bağlanır; siparişleri müşteri, adres, kargo ve kalem bilgileriyle çeker, faturayı sizin e-belge entegratörünüzden kestirir, oluşan PDF'i ilgili Trendyol siparişine yükler ve satılan miktarı merkezî stok havuzundan düşer; otomatik stok senkronu açıksa yeni adet bağlı diğer kanallara da gider.

Kritik nokta şudur: entegrasyon "veri kopyalamak" değildir. Kopyalayan bir sistem, Trendyol'un durum değişikliklerini kaçırdığında sessizce yanlış veri üretir. Bu yüzden TicariHub sipariş durumunu ileri yönlü günceller — yani teslim edilmiş bir sipariş, geç gelen eski bir kayıt yüzünden "yeni sipariş" durumuna geri düşmez. Faturası kesilmiş bir siparişin durumu da fatura koruması nedeniyle serbestçe değiştirilemez.

Trendyol satıcılarının en sık yaşadığı 6 sorun ve entegrasyonun çözümü

• Fatura kesildi ama panele yüklenmedi: Trendyol satıcıya "fatura bekleniyor" uyarısı düşürür ve tekrarlanırsa mağaza puanını etkiler. TicariHub'da kesim ve yükleme aynı akışın iki adımıdır; yükleme başarısız olursa sipariş açıkta kalmaz, hata listesine düşer ve yeniden denenir.
• Oversell (stokta olmayan ürünü satmak): Aynı ürünü Trendyol, Hepsiburada ve kendi sitenizde satarken stoklar ayrı ayrı tutulursa er ya da geç olmayan ürün satılır — bunun bedeli iptal, gecikme puanı ve olumsuz yorumdur. Merkezî stok havuzu, otomatik stok senkronunu açtığınızda bir kanaldaki satışı kısa bir bekleme içinde diğer kanallara yansıtır.
• Yanlış tutarla fatura kesmek: Pazaryerlerinde sipariş toplamı ile faturaya esas tutar her zaman aynı değildir; kupon, satıcı indirimi ve kargo payı hesabı değiştirir. TicariHub tutarları satır bazında ele alır ve fatura toplamının siparişle örtüşmesini denetler.
• Eksik veya sahte kimlik bilgisiyle fatura reddi: Bireysel müşterinin TCKN'si eksikse ya da 11111111111 gibi sahte bir değerse GİB belgeyi reddeder. TicariHub kimlik numarasını doğrulama algoritmasıyla kontrol eder, geçersizse faturayı kesmeden önce uyarır.
• İadenin muhasebeye işlenmemesi: İade edilen sipariş için ne fatura düzeltilir ne cari bakiye eksilir; ay sonunda müşteri bakiyeleri şişmiş görünür. TicariHub iadeyi tespit eder, fatura iptali ya da iade faturası seçeneği sunar ve cariyi ters yönde eşitler.
• Müşteri sorularının cevapsız kalması: Trendyol cevapsız soruları mağaza performansına yansıtır. Sorular TicariHub paneline düşer, oradan cevaplanır; cevapsız soru için uyarı kurabilirsiniz.

Trendyol API'si nasıl çalışır, teknik olarak neye dikkat etmek gerekir?

Trendyol satıcı entegrasyonları için sürümlenmiş bir REST API sunar ve bu API zaman içinde değişir. 2026 yılında eski sürüm kapatıldı; yeni sürümde sipariş, onaylı ürün ve onay bekleyen ürün uçları ayrıştı, toplu güncellemeler ayrı bir uçtan yürütülüyor ve sayfa başına kayıt sınırı düştü. Entegrasyonunu güncellemeyen satıcılar bu geçişte veri kaybı yaşadı.

Ürün eşleştirmesinde kimlik olarak barkod kullanılır. Bu, kataloğunda barkod disiplini olan satıcı için avantajdır: eşleştirme kendiliğinden oturur. Barkodsuz ya da mükerrer barkodlu katalogda ise ürünler tek tek bağlanmak zorunda kalır. Trendyol'a açılmadan önce barkodlarınızı tekilleştirmek, entegrasyondan alacağınız verimi doğrudan artırır.

Sipariş listeleri sayfalanır ve tarih aralığıyla süzülür. Yalnızca ilk sayfayı okuyan bir entegrasyon, yoğun günlerde siparişlerin bir kısmını hiç görmez — bu, satıcının fark etmesi en zor hatalardan biridir çünkü sistem hata vermez, sadece eksik çalışır. TicariHub sayfalamayı sonuna kadar takip eder ve çekilen kayıt sayısını raporlar.

Fatura sizin entegratörünüzden kesilir — bu neden önemli?

Piyasadaki bazı entegrasyon programları e-faturayı kendi entegratör hesapları üzerinden keser ve size belge başına ücret yansıtır. Bu model kısa vadede kolaydır, uzun vadede iki risk taşır: birincisi, belge maliyetiniz yazılım firmasının fiyat politikasına bağlı hale gelir; ikincisi, programdan ayrılmak istediğinizde arşiviniz ve seri düzeniniz orada kalır.

TicariHub farklı bir yol izler: fatura, sizin kendi adınıza sözleşme yaptığınız entegratör hesabınızdan, sizin kontörünüzle ve sizin seri numaranızla kesilir. TicariHub bu işlemde aracı kurum değil, yalnızca köprüdür. Belgeleriniz her koşulda sizin entegratörünüzde durur; yazılımı değiştirseniz bile arşiviniz sizde kalır.

Uygulamada Uyumsoft, İzibiz, Kolaysoft, Kolaybi, NES Bilgi, Digital Planet ve Turkcell e-Şirket gibi entegratörlerle çalışılabilir (Logo ailesi güncelleniyor). Hangi entegratörü kullandığınızı her kesim ekranında seçebilir, tercihinizi hatırlatabilirsiniz — birden fazla firma yönetenler için bu ayrım önemlidir.

Kurulum öncesi hazırlık listesi

• Trendyol Satıcı Paneli erişiminiz ve entegrasyon bilgilerini görme yetkiniz olsun (alt kullanıcılarda bu yetki kapalı olabilir).
• Kataloğunuzdaki barkodların tekil ve doğru olduğundan emin olun; mükerrer barkod eşleştirmeyi bozar.
• E-belge entegratörü sözleşmeniz ve kontörünüz hazır olsun; kontör bitmişse fatura kesimi başarısız olur.
• Firma unvanı, VKN, vergi dairesi ve adres bilgilerinizi eksiksiz girin — bunlar faturanın satıcı bölümünü oluşturur.
• Kaç günlük geçmiş sipariş çekeceğinize önceden karar verin; gereğinden uzun aralık ilk senkronu yavaşlatır.
• Otomatik fatura kesimini ilk gün açmayın. Birkaç gün elle kesip sonuçları gördükten sonra otomasyonu devreye alın.