İhtiyaç
Mağaza işlemlerinin farklı panellerde manuel takibi yerine, sipariş ve katalog bilgisinin ERP ile aynı doğrultuda ilerlemesi gerekiyordu. Entegrasyon, yüksek ürün hacmini izlenebilir bir akışla yönetmek için geliştirildi.
Çözüm yaklaşımım
Hepsiburada Merchant API servislerini modüler bir mimari altında bir araya getirdim. Zamanlanmış işler yeni siparişleri alıyor ve ERP veri modeline eşliyor. Stok hareketleri, fiyat değişiklikleri ve toplu ürün güncellemeleri aynı bağlantı katmanından yürütülüyor.
Sipariş ve gönderim durumları operasyon ekranlarında takip ediliyor. Her veri hareketini izleyebilmek için işlem geçmişi, API günlükleri ve eşitleme kayıtları tutuluyor. Başarısız istekler yeniden denenebiliyor; ortak bağlantı mimarisi diğer pazaryeri entegrasyonlarıyla birlikte geliştirilebiliyor.
Geliştirdiğim parçalar
- Hepsiburada Merchant API tam entegrasyonunu geliştirdim.
- Otomatik sipariş senkronizasyonunu kurdum.
- Stok senkronizasyonunu uyguladım.
- Toplu ürün güncelleme servislerini geliştirdim.
- Otomatik fiyat senkronizasyonu oluşturdum.
- Kargo durumu iş akışlarını entegre ettim.
- Senkronizasyon zamanlayıcısını kurdum.
- Merkezi API loglama altyapısını oluşturdum.
- Yeniden deneme mekanizmalarını uyguladım.
- Modüler konektör mimarisini tasarladım.
- API performansını optimize ettim.
- Operasyonel panoları geliştirdim.
- Senkronizasyon izlemeyi oluşturdum.
- ERP ürün eşlemesini entegre ettim.
- Manuel pazaryeri operasyonlarını azalttım.
- Senkronizasyon güvenilirliğini artırdım.
- Raporlama altyapısını geliştirdim.
- Üretim entegrasyonlarını sürdürdüm.
- Operasyonel iyileştirmeleri destekledim.
- Genişletilebilir entegrasyon servisleri oluşturdum.
İş akışı
- 1ERP
- 2Entegrasyon katmanı
- 3Hepsiburada Merchant API
- 4Sipariş / stok servisleri
- 5İşlem kayıtları
- 6Yönetim paneli
Dikkat gerektiren noktalar
- Büyük kataloglarda stok tutarlılığı
- Sipariş yaşam döngüsünü ERP ile eşlemek
- API kısıtları, hata kurtarma ve işlem görünürlüğü
Ayrıntılı proje notları+
Bu proje Hepsiburada mağaza operasyonlarını manuel süreçlerden kurtarmak amacıyla geliştirildi.
Merchant API dokümantasyonu detaylı şekilde incelenerek tüm servisler modüler bir yapı altında toplandı.
Platform belirli zaman aralıklarında çalışan servislerle yeni siparişleri otomatik olarak çekmektedir.
Sipariş verileri ERP sisteminin kullandığı standart veri modeline dönüştürülmektedir.
Stok hareketleri ERP tarafındaki değişikliklere göre otomatik olarak Hepsiburada'ya aktarılmaktadır.
Toplu fiyat güncelleme servisleri geliştirilerek manuel fiyat yönetimi ortadan kaldırıldı.
Ürün bilgilerinin toplu güncellenebilmesi için senkronizasyon servisleri oluşturuldu.
Sipariş durumları ERP ile senkronize edilerek operasyon ekiplerinin tek panel üzerinden çalışması sağlandı.
API üzerinden oluşan hata kayıtları ayrıntılı loglanarak başarısız işlemler yeniden çalıştırılabilir hale getirildi.
İşlem geçmişi kayıt altına alınarak tüm veri hareketleri izlenebilir hale getirildi.
Yönetim panelinde API sağlık durumu, senkronizasyon geçmişi ve işlem istatistikleri görüntülenmektedir.
Sistem yüksek ürün hacmi ve yoğun sipariş trafiğinde stabil çalışacak şekilde optimize edildi.
Platform diğer pazaryeri entegrasyonlarıyla ortak mimari kullanacak şekilde geliştirildi.
Böylece yeni pazaryerlerinin sisteme eklenmesi çok daha kısa sürede gerçekleştirilebilir hale geldi.
## Öğrenilenler
• Pazaryeri mimarisi
• Kurumsal entegrasyonlar
• Senkronizasyon servisleri
• Büyük veri seti işleme
• API izleme
• Hata toleransı
• Kuyruk sistemleri
• ERP birlikte çalışabilirliği
## Karşılaşılan problemler
• Merchant API kısıtları
• Yüksek senkronizasyon hacmi
• Stok tutarlılığı
• Büyük katalog yönetimi
• Sipariş yaşam döngüsü takibi
• Hata kurtarma
• Performans optimizasyonu
• Operasyonel izleme
## Mimari
ERP → Senkronizasyon motoru → Entegrasyon katmanı → Hepsiburada Merchant API → Sipariş servisleri → Stok servisleri → Raporlama → Admin panosu
## Veritabanı
MySQL, sipariş kayıtları, ürün eşleme, senkronizasyon kuyruğu, API logları, stok geçmişi, fiyat geçmişi, raporlama tabloları
## Admin özellikleri
Pazaryeri panosu, sipariş yönetimi, stok izleme, fiyat yönetimi, senkronizasyon geçmişi, API izleme, yeniden deneme işlemleri, raporlama, otomasyon zamanlayıcı, sağlık izleme
## Kullanıcı tarafı
Pazaryeri yöneticileri, operasyon ekibi, depo personeli, müşteri hizmetleri, yönetim, sistem yöneticileri
## Öne çıkan özellikler
✓ Otomatik sipariş senkronizasyonu
✓ Stok senkronizasyonu
✓ Toplu ürün güncellemeleri
✓ Fiyat senkronizasyonu
✓ Kargo takibi
✓ ERP entegrasyonu
✓ API izleme
✓ Yeniden deneme mekanizmaları
✓ Operasyonel pano
✓ Raporlama altyapısı