Pazaryeri Entegrasyonu Öncesi Bilinmesi Gereken Teknik Konular

Pazaryeri entegrasyonu yaptırmak, ürünleri birkaç kanala kopyalamaktan ibaret değildir. Ürün verisi, stok, fiyat, sipariş, kargo, fatura, iade, komisyon ve hata yönetimi aynı teknik plan içinde düşünülmezse entegrasyon kısa sürede operasyon yüküne dönüşür. İlk başta “ürünler aktarılsın yeter” gibi görünen ihtiyaç, satış hacmi arttığında stok çakışması, yanlış fiyat, eksik fatura ve geciken kargo bildirimleriyle büyür.

Pazaryeri entegrasyonu, e-ticaret siteniz ile Trendyol, Hepsiburada, n11 veya benzer satış kanalları arasında düzenli veri alışverişi kurma işidir. Bu veri alışverişi tek yönlü veya çift yönlü olabilir. Ürünler sitenizden pazaryerine gidebilir, pazaryerinden gelen siparişler tek panele düşebilir, stok ve fiyat güncellemeleri merkezi sistemden tüm kanallara dağıtılabilir.

Bu yüzden pazaryeri entegrasyonu yaptırmadan önce yalnızca “hangi pazaryerlerine bağlanacağız?” sorusu değil, “hangi veri hangi sistemde ana kaynak olacak, hangi olay hangi sistemi güncelleyecek?” sorusu cevaplanmalıdır.

Pazaryeri entegrasyonunda ilk karar: ana kaynak hangi sistem?

Entegrasyon planının temeli ana kaynak kararına dayanır. Ürün adı, açıklama, stok, fiyat, görsel, barkod, varyant ve kategori bilgisi hangi sistemden yönetilecek? E-ticaret paneli mi, ERP mi, ön muhasebe programı mı, stok yazılımı mı, yoksa özel bir ara panel mi? Bu net değilse aynı ürün farklı kanallarda farklı bilgilerle görünebilir.

Örneğin fiyatı e-ticaret panelinden, stoğu depo yazılımından, açıklamayı pazaryeri panelinden, görselleri başka bir klasörden yönetiyorsanız ekip kısa sürede hangi bilginin güncel olduğunu takip edemez. Ürün sayısı azsa bu durum elle çözülebilir gibi görünür; fakat varyant, kampanya ve çoklu pazaryeri arttıkça manuel düzeltme sürdürülemez hale gelir.

Ürün verisi entegrasyonu neden en kritik aşamadır?

Pazaryerlerinde ürün aktarımı yalnızca ürün adı ve fiyat göndermek değildir. Kategori, marka, barkod, varyant, görsel, açıklama, KDV oranı, teslimat süresi, garanti bilgisi ve pazaryerine özel zorunlu alanlar doğru eşleşmelidir. Trendyol geliştirici dokümantasyonu, API servisleriyle ürün transferi, stok-fiyat güncelleme, sipariş işlemleri ve fatura gönderimi gibi işlemlerin yapılabildiğini açıklar Trendyol Developers. Bu da entegrasyonun yalnızca tek bir uçtan oluşmadığını gösterir.

Ürün verisi hatalı kurulursa sonraki tüm akış etkilenir. Barkod yanlışsa stok güncellemesi yanlış ürüne gidebilir. Varyantlar doğru ayrılmadıysa müşteri siyah 42 numara yerine lacivert 40 numara satın alabilir. Kategori eşleşmesi yanlışsa pazaryeri ürünü reddedebilir veya yanlış filtrelerde gösterebilir.

Örnek ürün veri alanları

Gerçekçi bir ürün entegrasyonu için SKU, barkod, ürün adı, varyant, marka, kategori, satış fiyatı, liste fiyatı, stok, KDV oranı, görsel URL’leri, açıklama, kargo süresi ve pazaryeri durum kodu gibi alanlar planlanabilir. Bu alanların hangisi zorunlu, hangisi opsiyonel, hangisi kanal bazlı değişiyor baştan belirlenmelidir.

Kategori ve özellik eşleştirme nasıl planlanmalı?

Her pazaryerinin kategori ağacı ve zorunlu özellikleri farklı olabilir. Bir pazaryerinde “renk” serbest metin gibi girilebilirken, başka bir pazaryerinde önceden tanımlı değer listesinden seçilmesi gerekebilir. Bu nedenle entegrasyonun en önemli işlerinden biri kategori ve özellik haritalamasıdır.

Bu haritalama yapılmadan ürün aktarımı başlatılırsa çok sayıda ürün hata alır. Operasyon ekibi de “ürünler neden gitmedi?” sorusunu tek tek takip etmek zorunda kalır. Özellikle tekstil, ayakkabı, elektronik, yedek parça, kozmetik ve yapı malzemeleri gibi varyantı ve teknik özelliği yoğun sektörlerde kategori eşleştirme ayrı bir proje adımı gibi ele alınmalıdır.

Hepsiburada API Portalı, satıcı operasyonlarını yönetmek için dokümantasyon, API Reference ve yenilikler gibi kaynaklar sunar Hepsiburada API Portal. Entegrasyona başlamadan önce kullanılacak pazaryerlerinin güncel dokümanları incelenmeli, kategori ve özellik kuralları buna göre modellenmelidir.

Stok ve fiyat güncelleme sıklığı nasıl belirlenmeli?

Pazaryeri entegrasyonunda stok ve fiyat akışı ürün aktarımından daha kritik olabilir. Çünkü ürün bir kez aktarıldıktan sonra asıl operasyon stok ve fiyat güncellemeleriyle devam eder. Ürün sayısı fazla, satış kanalı çok veya stok hızlı değişiyorsa güncelleme sıklığı doğru planlanmalıdır.

Trendyol’un stok ve fiyat güncelleme servis dokümanı, ürünlerin fiyat ve stok bilgilerinin ilgili servisle güncellenebildiğini ve her istekte gönderilebilecek ürün sayısı gibi teknik sınırların bulunduğunu açıklar Trendyol Stock and Price. n11 tarafında da RestAPI fiyat-stok güncelleme servisi üzerinden ürünlerin fiyat ve stok bilgisinin güncellenebildiği belirtilir n11 Mağaza Destek.

Bu örnekler, entegrasyonda “anlık güncelleme yapalım” kararının her zaman sınırsız bir işlem anlamına gelmediğini gösterir. API limitleri, toplu işlem sınırları, hata yanıtları, bekleyen işlemler ve tekrar deneme mantığı teknik tasarımda düşünülmelidir.

Siparişleri tek panelde toplamak neyi değiştirir?

Pazaryerlerinden gelen siparişleri tek panelde toplamak operasyon ekibi için büyük kolaylık sağlar. Ekip farklı pazaryeri panellerine tek tek girip sipariş kontrol etmek yerine siparişleri merkezi ekranda görebilir. Fakat bunun sağlıklı çalışması için sipariş durumları, müşteri bilgileri, ürün satırları, kargo şirketi, ödeme bilgisi ve fatura durumu standartlaştırılmalıdır.

E-ticaret entegrasyon hizmeti planlanırken her kanalın sipariş durumları ortak bir iç durum modeline çevrilmelidir. Örneğin bir pazaryerinde “onaylandı”, başka birinde “paketlenebilir”, diğerinde “hazırlanıyor” görünen süreçler iç panelde “hazırlanacak sipariş” olarak gruplanabilir. Bu yapılmazsa merkezi panel sadece kalabalık bir listeye dönüşür.

Kargo ve fatura akışı entegrasyonda nasıl yer almalı?

Pazaryeri siparişleri yalnızca web sitesine çekilmekle bitmez. Sipariş hazırlanacak, kargo etiketi oluşturulacak, takip bilgisi işlenecek, fatura veya e-arşiv süreci tamamlanacak ve gerekirse pazaryerine geri bildirim gönderilecektir. Bu zincirin hangi adımları otomatik, hangi adımları manuel kontrollü olacak baştan belirlenmelidir.

Kargo entegrasyonu tarafında alıcı adresi, telefon, kargo firması, paket adedi, desi, takip numarası ve teslimat durumu gibi bilgiler net olmalıdır. Fatura tarafında ise sipariş numarası, müşteri bilgisi, ürün satırları, KDV oranı, komisyon, indirim ve kargo bedeli gibi alanlar muhasebe sistemiyle uyumlu taşınmalıdır.

Burada her pazaryerinin operasyon kuralı farklı olabilir. Bazı siparişlerde kargo anlaşması pazaryeri üzerinden yürürken, bazılarında satıcının kendi kargo anlaşması devreye girebilir. Bazı kanallarda fatura pazaryeri paneliyle eşleşirken, bazı yapılarda e-fatura/e-arşiv sistemiyle özel bağlantı gerekir. Bu nedenle entegrasyon kapsamı yalnızca ürün aktarımıyla sınırlandırılmamalıdır.

API limitleri, hata yönetimi ve loglama unutulmamalı

Pazaryeri API’leri sınırsız ve hatasız çalışacak varsayımıyla tasarlanmamalıdır. İstek limitleri, bakım dönemleri, geçici bağlantı hataları, ürün reddi, kategori uyuşmazlığı, barkod hatası, eksik görsel, yanlış fiyat ve yetki problemi gibi durumlar yaşanabilir. Sağlıklı entegrasyonda bu hatalar görünür olmalıdır.

API entegrasyon hizmeti kapsamında her kritik işlem için log tutulmalıdır. Hangi ürün hangi pazaryerine ne zaman gönderildi, hangi yanıt döndü, stok güncellemesi kabul edildi mi, sipariş tekrar çekildi mi, fatura gönderimi hata aldı mı? Bu kayıtlar yoksa ekip sorunu tahminle çözmeye çalışır.

Pazaryeri entegrasyonu öncesi teknik kontrol tablosu

Aşağıdaki tablo, entegrasyon başlamadan önce teknik ekip, operasyon ekibi ve yönetim tarafında netleştirilmesi gereken başlıkları özetler. Bu liste, teklif aşamasında bile projenin gerçek kapsamını daha doğru görmenizi sağlar.

Kanal bazlı fiyat ve komisyon hesabı nasıl düşünülmeli?

Pazaryerlerinde aynı ürünü aynı fiyatla satmak her zaman doğru olmayabilir. Komisyon oranları, kargo maliyeti, hizmet bedelleri, kampanya katılımı, kupon kullanımı ve ödeme vadesi kanala göre değişebilir. Entegrasyon yalnızca fiyat gönderiyorsa ama kârlılık hesabı yapmıyorsa işletme çok satış yapıp düşük kârla karşılaşabilir.

Bu nedenle fiyat güncelleme sistemi kanal bazlı düşünülmelidir. Örneğin web sitesinde 1.000 TL olan ürün, pazaryeri komisyonu ve kargo maliyeti nedeniyle farklı fiyatlanabilir. Bazı işletmeler fiyatı merkezi belirler, bazıları kanal bazlı katsayı kullanır, bazıları ise belirli ürünlerde pazaryeri kampanyasına özel fiyat uygular. Hangi model seçilirse seçilsin, entegrasyon bu kurala göre veri üretmelidir.

Test süreci canlıya geçmeden önce nasıl yapılmalı?

Entegrasyon testinde yalnızca “ürün gitti mi?” diye bakmak yeterli değildir. Ürün oluşturma, güncelleme, stok düşme, fiyat değişme, sipariş çekme, kargo bilgisi gönderme, iade alma, iptal işleme ve hata senaryoları test edilmelidir. Testte gerçekçi varyantlı ürünler kullanılmalıdır; çünkü en çok hata sade ürünlerde değil, varyantlı ve kategori özelliği yoğun ürünlerde çıkar.

Örneğin test senaryosu şöyle yazılabilir: “Barkodlu, iki renk ve üç beden varyantlı ürün aktarılır. Bir varyantın stoğu sıfır yapılır. Kanal bazlı fiyat güncellenir. Sipariş simüle edilir. Sipariş tek panele düşer. Kargo bilgisi işlenir. İade talebi oluşur. İade onaylanınca stok güncellenir.” Bu senaryo, entegrasyonun gerçek operasyonu taşıyıp taşımadığını daha iyi gösterir.

Pazaryeri entegrasyonu yaptırmadan önce checklist

Aşağıdaki kontrol listesi, entegrasyon görüşmesine başlamadan önce hazırlık yapmanızı sağlar. Bu maddeler netleştiğinde hem teknik teklif daha doğru çıkar hem de canlıya geçiş riski azalır.

1. Bağlanacak pazaryerlerini ve öncelik sırasını belirleyin.
2. Ürün, stok ve fiyat için ana veri kaynağını seçin.
3. SKU ve barkod yapınızın tutarlı olup olmadığını kontrol edin.
4. Varyantlı ürünlerde renk, beden, ölçü gibi alanları standartlaştırın.
5. Kategori ve özellik eşleştirme ihtiyacını çıkarın.
6. Kanal bazlı fiyat, komisyon ve kampanya kurallarını belirleyin.
7. Siparişlerin hangi panelde toplanacağını netleştirin.
8. Kargo, fatura, iade ve iptal akışlarını yazılı hale getirin.
9. API hata loglarını kimin takip edeceğini belirleyin.
10. Canlıya geçmeden önce gerçekçi test senaryoları oluşturun.

Sonuç: pazaryeri entegrasyonu veri disipliniyle başarılı olur

Pazaryeri entegrasyonu yaptırmadan önce teknik konuları netleştirmek, projenin maliyetini ve riskini daha gerçekçi görmenizi sağlar. Ürün aktarımı, stok-fiyat güncelleme, sipariş çekme, kargo, fatura, iade, komisyon ve hata loglama aynı plan içinde düşünülmelidir.

İyi planlanan entegrasyon, işletmenin farklı pazaryerlerinde daha düzenli satış yapmasına yardımcı olur. Kötü planlanan entegrasyon ise aynı ürünün farklı fiyatla görünmesine, stokta olmayan ürünün satılmasına, siparişlerin kaçmasına ve operasyon ekibinin manuel iş yükünün artmasına neden olur. Bu yüzden entegrasyona API bağlantısı olarak değil, uçtan uca satış operasyonu olarak bakmak gerekir.