Shopify İade Modülü

Proje Hakkında

Shopify İade Modülü, NaraMaxx e-ticaret ekosistemi için geliştirilmiş kapsamlı bir iade yönetim sistemidir. Müşterilerden gelen iade taleplerini otomatik olarak Shopify Admin paneline entegre eder ve tüm iade sürecini uçtan uca yönetir.

Temel Özellikler

🔄 Otomatik İade Oluşturma

Müşteri iade talebinde bulunduğunda, sistem Shopify Admin API üzerinden returnCreate GraphQL mutation'ını kullanarak otomatik olarak resmi bir Shopify iadesi oluşturur. İade talebi sadece sipariş notuna eklenmez; Shopify'ın kendi iade sistemiyle tam entegre çalışır. Bu sayede iade durumu, geri ödeme ve stok güncellemeleri tamamen otomatize edilir.

📦 Çok Kanallı İade Desteği

Hem Shopify web mağazası hem de NaraMaxx mobil uygulaması üzerinden yapılan siparişlerin iade süreçlerini destekler. Trendyol marketplace entegrasyonu ile pazaryeri siparişlerinin iade süreçleri de aynı panel üzerinden yönetilebilir.

📊 İade Analitik Paneli

Gerçek zamanlı dashboard ile iade oranları, ortalama işlem süreleri, en çok iade edilen ürünler ve iade sebeplerinin dağılımı gibi kritik metrikleri takip eder. Bu veriler, ürün kalitesi ve müşteri memnuniyetinin iyileştirilmesi için değerli içgörüler sağlar.

🔔 Webhook Entegrasyonu

Shopify webhook'ları ile iade durumu değişikliklerinde (onay, red, kargo, geri ödeme) anlık bildirimler alınır. Sistem, durum değişikliklerini otomatik olarak işler ve ilgili aksiyonları tetikler.

💰 Otomatik Geri Ödeme

Onaylanan iadeler için Shopify Refund API üzerinden otomatik geri ödeme işlemi başlatılır. Kısmi iade, tam iade ve değişim senaryoları desteklenir. PayTR ödeme altyapısı ile uyumlu çalışır.

Teknik Mimari

Backend

• Node.js + Express: RESTful API sunucusu
• Shopify Admin API (GraphQL): returnCreate, returnApprove, refundCreate mutation'ları
• Webhook Handler: İade durum güncellemeleri ve stok senkronizasyonu
• MongoDB: İade talep geçmişi, log kayıtları ve analitik veriler

Frontend

• React Dashboard: İade yönetim paneli ve analitik görünümleri
• Müşteri Portalı: Self-servis iade talebi oluşturma arayüzü
• Shopify App Extension: Sipariş detay sayfasında entegre iade yönetimi

Entegrasyonlar

• Shopify Admin API: Sipariş, iade ve geri ödeme yönetimi
• Shopify Storefront API: Müşteri taraflı sipariş görüntüleme
• Kargo API: İade kargo takip numarası oluşturma ve takibi
• PayTR: Geri ödeme işlemleri

İade Akış Süreci

1. Talep: Müşteri web veya mobil uygulama üzerinden iade talebinde bulunur
2. Doğrulama: Sistem, siparişin iade koşullarını (süre, kategori, durum) otomatik kontrol eder
3. Shopify Kaydı: returnCreate mutation ile Shopify'da resmi iade kaydı oluşturulur
4. Onay: Yönetici panelinden talep incelenir ve onaylanır/reddedilir
5. Kargo: Onaylanan iadeler için iade kargo etiketi oluşturulur
6. Teslim: Ürün depoya ulaştığında kalite kontrolü yapılır
7. Geri Ödeme: Refund API ile otomatik geri ödeme işlemi tamamlanır
8. Stok: İade edilen ürünler otomatik olarak stok envanterine eklenir

Mevcut Durum

Modül aktif olarak geliştirilmektedir. Shopify returnCreate entegrasyonu tamamlanmış, webhook handler ve analitik dashboard geliştirme aşamasındadır. Trendyol marketplace iade entegrasyonu sonraki fazda planlanmaktadır.