Pazaryeri İade Entegrasyonu: 5 Pazaryeri ve Nebim V3
Pazaryeri İade Entegrasyonu PazarYeri-Iade, Trendyol, Hepsiburada, N11, Idefix ve Pazarama üzerinden gelen iade taleplerini tek bir merkezde toplamak ve bu süreçleri Nebim V3 ERP ile birlikte yönetmek amacıyla geliştirdiğim .NET tabanlı entegrasyon platformudur.
Birden fazla pazaryerinde satış yapan firmalarda iade operasyonları zamanla oldukça karmaşık hale gelebiliyor. Her pazaryerinin farklı servis yapısı, iade durumları ve işlem akışları bulunurken ERP tarafında da fatura, ürün, sipariş ve iade işlemlerinin ayrıca takip edilmesi gerekiyor.
Bu projede amacım, birbirinden farklı çalışan bu süreçleri tek bir operasyon yapısında birleştirmekti. Böylece kullanıcı farklı pazaryeri ekranları arasında sürekli geçiş yapmak yerine iadeleri ortak bir sistem üzerinden takip edebiliyor, gerekli işlemleri gerçekleştirebiliyor ve Nebim V3 tarafındaki süreçlerle ilişkilendirebiliyor.
Uygulamayı C#, .NET 8, ASP.NET Core, Entity Framework Core ve Microsoft SQL Server kullanarak geliştirdim. Pazaryeri entegrasyonları ayrı bir entegrasyon katmanında yönetilirken otomatik senkronizasyon işlemleri bağımsız Worker servisleri üzerinden çalışıyor.
Diğer geliştirdiğim uygulamaları Projeler sayfasından inceleyebilirsiniz.
İçindekiler
- Pazaryeri İade Entegrasyonu Projesinin Amacı
- Desteklenen Pazaryerleri
- Merkezi İade Yönetimi
- Ortak İade Operasyon Yapısı
- Trendyol İade Entegrasyonu
- Hepsiburada İade Entegrasyonu
- N11 İade Entegrasyonu
- Idefix İade Entegrasyonu
- Pazarama İade Entegrasyonu
- Nebim V3 ERP Entegrasyonu
- Gider Pusulası Süreci
- Otomatik Senkronizasyon
- Çok Şirketli Yapı
- Yazılım Mimarisi
- Veri Yönetimi
- Bildirim ve Destek Süreçleri
- Güvenlik Yaklaşımı
- Kullanılan Teknolojiler
- Teknik Olarak Öne Çıkan Noktalar
- Sonuç
Pazaryeri İade Entegrasyonu Projesinin Amacı
Birden fazla e-ticaret kanalında satış yapan firmalar için iade süreçleri önemli bir operasyon yükü oluşturuyor.
Her pazaryeri farklı API teknolojileri, farklı durum kodları ve farklı işlem adımları kullanabiliyor. Bir platformda “aksiyon bekleyen” olarak tanımlanan süreç başka bir platformda tamamen farklı bir durum koduyla ifade edilebiliyor.
Bunun yanında iadenin yalnızca pazaryeri tarafında tamamlanması da yeterli değil. ERP üzerinde ilgili satış, ürün, fatura ve finansal işlemlerin doğru şekilde yürütülmesi gerekiyor.
Pazaryeri İade Entegrasyonu projesini bu iki operasyon dünyasını tek sistem içerisinde buluşturmak amacıyla geliştirdim.
Hedefim, teknik olarak birbirinden farklı çalışan pazaryerlerini kullanıcı açısından ortak ve anlaşılır bir iş akışına dönüştürmekti.
Desteklenen 5 Pazaryeri
Platform aktif olarak beş farklı pazaryeri ile çalışacak şekilde geliştirildi:
- Trendyol
- Hepsiburada
- N11
- Idefix
- Pazarama
Her platformun entegrasyon yöntemi aynı değil. Projede REST API, SOAP Web Services ve pazaryerlerine özgü farklı servis modelleri birlikte kullanılıyor.
Bu teknik farklılıkları kullanıcı tarafına mümkün olduğunca yansıtmadan entegrasyon katmanında çözmeye çalıştım.
Sonuç olarak operatör hangi pazaryerinde çalışırsa çalışsın benzer bir kullanım deneyimi üzerinden iade sürecini takip edebiliyor.
Merkezi İade Yönetimi
Farklı pazaryerlerinden alınan iade kayıtları merkezi bir yapıda toplanıyor.
Kullanıcı iadeleri pazaryerine ve işlem durumuna göre görüntüleyebiliyor. Böylece operasyon sırasında hangi iadelerin yeni geldiği, hangilerinin işlem beklediği ve hangilerinin tamamlandığı daha kolay takip ediliyor.
Genel operasyon yapısında;
- yeni oluşturulan iade talepleri,
- kargoya verilen iadeler,
- satıcı aksiyonu bekleyen kayıtlar,
- tamamlanan işlemler,
- hatalı kayıtlar
birbirinden ayrıştırılıyor.
Her pazaryeri tüm aşamaları desteklemediği için ekran yapısı ilgili platformun gerçek operasyon sürecine göre şekilleniyor.
Bu yapı sayesinde pazaryeri iade entegrasyonu, farklı sistemlerden gelen verileri yalnızca bir araya getirmekle kalmıyor; operasyon açısından anlamlı ortak bir yapıya dönüştürüyor.
Ortak İade Operasyon Yapısı
Projede üzerinde en fazla çalıştığım konulardan biri pazaryerlerindeki farklı iade durumlarının ortak bir modele dönüştürülmesi oldu.
Örneğin aynı operasyonel aşama farklı pazaryerlerinde farklı isimlerle veya durum kodlarıyla ifade edilebiliyor.
Bu nedenle pazaryerine özel durumları doğrudan kullanıcı arayüzüne taşımak yerine, entegrasyon katmanında yorumlayarak ortak operasyon aşamalarına dönüştürdüm.
Böylece listeleme, filtreleme ve işlem takibi daha tutarlı hale geldi.
Trendyol İade Entegrasyonu
Trendyol tarafında müşteri tarafından oluşturulan iadeler farklı operasyon aşamalarına göre takip edilebiliyor.
İade henüz yeni oluşturulmuş olabilir, müşteri ürünü kargoya vermiş olabilir veya satıcının işlem yapması gereken aşamaya gelmiş olabilir.
Satıcı aksiyonu gerektiren kayıtlarda kalan sürenin takip edilebilmesi de operasyon açısından önemli bir özellik.
Operatör ürün fiziksel olarak ulaştığında gerekli kontrolleri yaptıktan sonra iade hakkında karar verebiliyor.
Bu sürecin ardından pazaryeri ve Nebim V3 tarafındaki işlemler birbiriyle bağlantılı olarak ilerliyor.
Hepsiburada İade Entegrasyonu
Hepsiburada üzerinden gelen iade kayıtları platform servisleri aracılığıyla alınarak PazarYeri-Iade içerisindeki ortak iade modeline dönüştürülüyor.
Kullanıcı bu iadeleri merkezi panel içerisinde görüntüleyebiliyor ve desteklenen satıcı işlemlerini gerçekleştirebiliyor.
Buradaki temel yaklaşım, Hepsiburada’nın kendi servis yapısının teknik detaylarını operasyon ekibinden mümkün olduğunca uzak tutmak.
Böylece kullanıcı farklı bir pazaryerine geçtiğinde tamamen farklı bir sistem öğrenmek zorunda kalmıyor.
N11 İade Entegrasyonu
N11 tarafında diğer bazı pazaryerlerinden farklı olarak SOAP tabanlı web servisleri kullanılıyor.
Projede REST ve SOAP servislerinin aynı entegrasyon mimarisi içerisinde birlikte çalışmasını sağlayacak bir yapı geliştirdim.
N11’in kendine özgü iade durumları sistem içerisinde korunuyor ancak kullanıcı tarafında ortak operasyon mantığı devam ediyor.
Bu entegrasyon, farklı teknolojiler kullanan harici sistemlerin aynı uygulama içerisinde yönetilebilmesi açısından projenin önemli parçalarından biri oldu.
Idefix İade Entegrasyonu
Idefix üzerinden gelen iade kayıtları da merkezi sisteme aktarılıyor ve iadenin ilerleme durumuna göre farklı aşamalarda takip edilebiliyor.
Özellikle satıcı aksiyonu bekleyen iadelerde zaman takibi yapılabilmesi operasyon ekibinin öncelikli kayıtları daha hızlı fark etmesini sağlıyor.
Böylece manuel kontrol ihtiyacı azalırken işlem süresi kritik olan iadeler daha görünür hale geliyor.
Pazarama İade Entegrasyonu
Pazarama tarafında iade taleplerinin alınmasının yanında satıcı tarafından gerçekleştirilebilecek farklı kararlar da sistem içerisinde yönetiliyor.
İadenin mevcut durumuna göre onay, ret veya inceleme gibi operasyonlar gerçekleştirilebiliyor.
Pazarama’dan alınan bilgiler diğer pazaryerlerinde olduğu gibi ortak iade listesi ve detay ekranlarında sunuluyor.
Bu sayede beş farklı platformdan gelen iadeler tek bir pazaryeri iade entegrasyonu yapısı içerisinde yönetilebiliyor.
Nebim V3 ERP Entegrasyonu
Projenin önemli bölümlerinden biri Nebim V3 ERP entegrasyonu.
Bir iadenin pazaryerinde işleme alınması operasyonun yalnızca bir tarafını oluşturuyor. ERP üzerinde de ilgili satış ve fatura bilgilerinin bulunması, ürünün eşleştirilmesi ve gerekli iade işlemlerinin gerçekleştirilmesi gerekiyor.
PazarYeri-Iade, gerekli durumlarda Nebim V3 tarafındaki satış verilerini sorgulayarak pazaryeri iadesiyle ilişkilendirebiliyor.
Operasyon sırasında;
- satış bilgileri,
- ürün bilgileri,
- barkod bilgileri,
- fatura bilgileri,
- iade faturası bilgileri,
- ilgili finansal veriler
kullanılabiliyor.
Böylece pazaryeri tarafındaki iade ile ERP tarafındaki ticari kayıt birbirinden kopuk iki farklı süreç olarak kalmıyor.
Gider Pusulası Süreci
Gerekli iade senaryolarında Nebim V3 üzerinden gider pusulası oluşturma süreci de sistem içerisinden yürütülebiliyor.
İlgili satış ve fatura verileri kullanılarak ERP tarafına aktarılması gereken bilgiler hazırlanıyor.
İşlem başarıyla tamamlandığında elde edilen bilgiler uygulamadaki iade kaydıyla ilişkilendiriliyor.
Bu yaklaşım, operatörün pazaryeri ve ERP arasında manuel olarak veri taşıma ihtiyacını önemli ölçüde azaltıyor.
Otomatik Pazaryeri Senkronizasyonu
Pazaryeri İade Entegrasyonu yalnızca kullanıcının manuel olarak başlattığı işlemler üzerinden çalışmıyor.
Projede web uygulamasından bağımsız çalışan bir Worker yapısı bulunuyor.
Worker servisleri pazaryerlerini arka planda kontrol ederek yeni veya güncellenmiş iade kayıtlarını otomatik şekilde sisteme aktarabiliyor.
Böylece günlük operasyon için sürekli manuel senkronizasyon başlatılması gerekmiyor.
İhtiyaç halinde kullanıcıların manuel senkronizasyon başlatabilmesi de mümkün.
Otomatik ve manuel kullanımın birlikte desteklenmesi özellikle entegrasyon sorunlarının kontrol edilmesi sırasında önemli bir esneklik sağlıyor.
Çok Şirketli Yapı
Platform tek bir firmaya bağlı sabit bir entegrasyon olarak geliştirilmedi.
Farklı şirketler aynı uygulama üzerinde kendi operasyon alanlarıyla çalışabiliyor.
Her şirket;
- kendi kullanıcılarına,
- kendi pazaryeri bağlantılarına,
- kendi Nebim V3 bağlantısına,
- kendi SQL bağlantısına,
- kendi entegrasyon ayarlarına
sahip olabiliyor.
Şirket verilerinin ve entegrasyon bilgilerinin birbirinden ayrılması sayesinde platform farklı müşteriler için kullanılabilecek şekilde genişletilebilir bir yapıya sahip.
Yazılım Mimarisi
Projede sorumlulukları birbirinden ayıran katmanlı bir mimari kullandım.
Domain
Temel entity, enum ve domain modellerini içeriyor.
Application
Uygulama servisleri, iş kuralları ve servis sözleşmeleri bu katmanda bulunuyor.
Persistence
Entity Framework Core ve Microsoft SQL Server ile ilgili veri erişim yapısını içeriyor.
Integration
Trendyol, Hepsiburada, N11, Idefix, Pazarama ve Nebim V3 entegrasyonlarının birbirinden ayrıldığı katman.
Infrastructure
Uygulamanın ortak altyapı servislerini barındırıyor.
Web
Operasyon kullanıcılarının iadeleri takip ettiği ASP.NET Core tabanlı web uygulaması.
Worker
Pazaryeri senkronizasyonlarını arka planda gerçekleştiren bağımsız servis.
Bu ayrım sayesinde pazaryerlerinden birinde yapılacak değişiklik diğer entegrasyonların ve kullanıcı arayüzünün mümkün olduğunca az etkilenmesini sağlıyor.
SQL Server ve Veri Yönetimi
Platformun merkezi veri altyapısında Microsoft SQL Server kullanılıyor.
Uygulama içerisinde;
- şirketler,
- kullanıcılar,
- iade kayıtları,
- entegrasyon bilgileri,
- operasyon durumları,
- bildirimler,
- işlem geçmişleri
gibi uygulamaya ait veriler saklanıyor.
Nebim V3 üzerindeki şirket verileri ise ihtiyaç duyulduğu anda ilgili şirket bağlantısı üzerinden sorgulanıyor.
Bu ayrım sayesinde uygulamanın kendi operasyon verileri ile müşterinin ERP verileri birbirinden bağımsız tutulabiliyor.
Bildirim ve Destek Süreçleri
İade operasyonlarında kullanıcıların gerekli durumlarda bilgilendirilebilmesi için e-posta altyapısı da sisteme dahil edildi.
İşlem sonucuna göre bildirim gönderilebiliyor ve gerektiğinde oluşturulan belgeler e-postaya eklenebiliyor.
Platform içerisinde ayrıca destek taleplerinin toplanabildiği bir yapı bulunuyor.
Bu sayede operasyon sırasında oluşabilecek entegrasyon sorunları veya kullanıcı talepleri sistematik biçimde takip edilebiliyor.
Güvenlik Yaklaşımı
Pazaryeri ve ERP entegrasyonlarında kullanılan bağlantı bilgilerinin korunması önemli olduğu için güvenlik uygulamanın temel parçalarından biri olarak ele alındı.
Genel yaklaşımda;
- şirket bazlı veri ayrımı,
- rol bazlı yetkilendirme,
- hassas entegrasyon bilgilerinin korunması,
- kullanıcı arayüzünde gizli alanların maskelenmesi,
- denetim kayıtları,
- kontrollü kullanıcı erişimi
gibi mekanizmalar kullanılıyor.
Buradaki amaç özellikle birden fazla şirketin kullanabileceği entegrasyon platformunda her şirketin operasyon bilgilerinin birbirinden ayrılmış şekilde yönetilmesini sağlamak.
Kullanılan Teknolojiler
Backend
- C#
- .NET 8
- ASP.NET Core
- Entity Framework Core
- Background Worker
Veritabanı
- Microsoft SQL Server
- T-SQL
- Stored Procedures
ERP
- Nebim V3
- ERP Integrations
- Data Integration
- Data Synchronization
Pazaryeri Entegrasyonları
- Trendyol
- Hepsiburada
- N11
- Idefix
- Pazarama
- Marketplace APIs
Entegrasyon
- REST API
- SOAP Web Services
- Web Services
- SMTP
Mimari
- Layered Architecture
- Integration Architecture
- Background Processing
Backend tarafında kullandığım ASP.NET Core teknolojisi hakkında daha fazla bilgiye Microsoft ASP.NET Core üzerinden ulaşabilirsiniz.
Teknik Olarak Öne Çıkan Noktalar
5 Pazaryerinin Tek Entegrasyon Yapısında Birleştirilmesi
Projede en önemli teknik konulardan biri beş farklı pazaryerinin birbirinden farklı iade modellerini ortak bir sistem içerisinde birleştirmek oldu.
Bir platform REST API kullanırken diğerinin SOAP kullanması veya aynı operasyon aşamasına farklı bir isim vermesi kullanıcı açısından önemli olmamalıydı.
Bu nedenle pazaryerlerine özgü detayları entegrasyon katmanında tutarak kullanıcı tarafında daha standart bir iş akışı oluşturdum.
Pazaryeri ve Nebim V3 Sürecinin Birleştirilmesi
Pazaryerinden iade kaydının alınması operasyon probleminin yalnızca ilk bölümünü çözüyor.
İadenin ERP üzerindeki satış, ürün ve finansal verilerle de eşleştirilmesi gerekiyor.
Nebim V3 entegrasyonunu iade operasyonunun içerisine dahil ederek pazaryeri ve ERP süreçlerinin aynı iş akışında ilerlemesini sağladım.
Otomatik ve Manuel İşlemlerin Birlikte Desteklenmesi
Entegrasyon süreçleri Worker üzerinden otomatik çalışabiliyor.
Bunun yanında ihtiyaç halinde kullanıcı manuel olarak da senkronizasyon başlatabiliyor.
Bu yapı günlük operasyonu otomatik hale getirirken kontrol ve problem çözme senaryolarında operatöre gerekli esnekliği sağlıyor.
Sonuç
PazarYeri-Iade, farklı e-ticaret kanallarındaki iade operasyonlarını tek bir sistemde birleştirmek amacıyla geliştirdiğim kapsamlı bir pazaryeri iade entegrasyonu projesidir.
Platform içerisinde;
- Trendyol iade entegrasyonu,
- Hepsiburada iade entegrasyonu,
- N11 iade entegrasyonu,
- Idefix iade entegrasyonu,
- Pazarama iade entegrasyonu,
- merkezi iade yönetimi,
- otomatik senkronizasyon,
- Nebim V3 ERP entegrasyonu,
- gider pusulası işlemleri,
- çok şirketli kullanım,
- SQL Server tabanlı veri yönetimi,
- e-posta bildirimleri,
- rol bazlı yetkilendirme,
- katmanlı entegrasyon mimarisi
tek bir platform içerisinde bir araya getirildi.
Benim için projenin en önemli tarafı, beş farklı pazaryerinin iade operasyonları ile Nebim V3 ERP süreçlerini aynı sistem içerisinde yöneten merkezi bir Pazaryeri İade Entegrasyonu geliştirmek oldu.