Ana içeriğe geç

Giriş

🎯 Bu modül ne yapar?​

İndirimler modülü, ürünlere ve siparişlere indirimleri yönetmenizi ve uygulamanızı sağlar - yüzde bazlı promosyonlardan sabit tutar indirimlerine kadar - e-ticaret mağazanızda kupon kodları, kategori indirimleri ve müşteri özel tekliflerini destekler.

Bunu promosyon motorunuz olarak düşünün - OneEntry yönetim panelinde indirim kurallarını tanımlayın, bunları ürünlere veya tüm siparişlere uygulayın, ödeme sırasında kupon kodlarını doğrulayın ve müşterileriniz için fiyat ayarlamalarını otomatikleştirin.

📖 Basit Açıklama​

Her e-ticaret mağazasının esnek indirimlere ihtiyacı vardır:

  • 🏷️ Yüzde İndirimleri - Seçilen ürünlerde %10 indirim
  • 💰 Sabit İndirimler - 50$ üzerindeki siparişlerde 5$ indirim
  • 🎟️ Kupon Kodları - Belirli kampanyalar için promosyon kodları
  • 📦 Kategori İndirimleri - Tüm ürün kategorilerinde indirimler
  • 👤 Müşteri İndirimleri - Belirli müşteriler veya gruplar için özel fiyatlandırma
  • 📅 Zaman Sınırlı Teklifler - Belirli başlangıç ve bitiş tarihleri olan satışlar

İndirim yönetimi olmadan yaşanan sorunlar:

  • 🔒 Esnek olmayan fiyatlandırma - Her promosyon için kod değişiklikleri gerektirir
  • 📊 Takip etmesi zor - Merkezi bir indirim yönetimi yok
  • 🔄 Otomasyon yok - Her satış için manuel fiyat güncellemeleri

İndirimler çözümü:

Faydalar:

  • 🔒 Esnek promosyonlar - Yönetim panelinde indirimleri oluşturun ve yönetin
  • 📊 Merkezi kontrol - Tüm indirimler tek bir yerde
  • 🔄 Otomatik uygulama - Ödeme sırasında indirimler otomatik olarak uygulanır
  • 🎟️ Kupon doğrulama - Gerçek zamanlı kupon kodu doğrulaması

✨ Temel Kavramlar​

İndirim Nedir?​

İndirim, ürünlerin veya siparişlerin maliyetini azaltan bir fiyatlandırma kuralıdır:

  • İndirim Türü - Yüzde (örneğin, %20) veya sabit tutar (örneğin, 10$)
  • İndirim Değeri - Azaltılacak miktar veya yüzde
  • İşaretleyici - Filtreleme ve referans için benzersiz tanımlayıcı
  • Geçerlilik Süresi - İsteğe bağlı başlangıç ve bitiş tarihleri
  • Kupon Kodu - Müşteri tetiklemeli indirimler için isteğe bağlı promosyon kodu

İndirim Yapısı​

Her indirim bu yapıya sahiptir:

{
  id: 1,
  identifier: 'summer_sale',
  localizeInfos: {
    title: 'Summer Sale'
  },
  discountType: 'percentage',
  discountValue: 20,
  isActive: true,
  validFrom: '2025-06-01T00:00:00.000Z',
  validTo: '2025-08-31T23:59:59.999Z',
}

İndirim Türleri​

TürAçıklamaÖrnek
yüzdeFiyatı bir yüzde ile azaltTüm yaz ürünlerinde %20 indirim
sabitFiyatı sabit bir tutar ile azalt50$ üzerindeki siparişlerde 10$ indirim

Yaygın İndirim İşlemleri​

İşlemAçıklamaÖrnek Kullanım Durumu
Tüm İndirimleri AlTüm mevcut indirimleri listeleYönetim paneli indirim yönetimi
İşaretleyici ile İndirim AlBelirli bir indirimi getirİndirim rozeti gösterme
Kuponu DoğrulaKupon kodunun geçerli olup olmadığını kontrol etÖdeme kupon alanı

Neden İndirimler Modülünü Kullanmalıyım?​

FaydasıAçıklama
Otomatik PromosyonlarHer satış için manuel fiyat düzenlemesi yok
Kupon YönetimiPromosyon kodlarını oluşturun, dağıtın ve doğrulayın
Esnek KurallarYüzde, sabit, kategori veya müşteri indirimleri
Zaman Sınırlı TekliflerBaşlangıç/bitiş tarihleri ile kampanyalar planlayın
Çok Dilli Destekİndirim adları dil bazında yerelleştirilmiştir

📋 Bilmeniz Gerekenler​

İndirimler Yönetim Panelinde Oluşturulur​

İndirimleri SDK aracılığıyla oluşturamazsınız - bunlar OneEntry yönetim panelinde oluşturulur.

Oluşturma Süreci:

  • İsim Sağlayın - İndirim tanımı (zorunlu)
  • İşaretleyici Sağlayın - Benzersiz tanımlayıcı (zorunlu)
  • İndirim Türünü Seçin - Yüzde veya sabit tutar
  • İndirim Değerini Ayarlayın - Azaltılacak miktar
  • İsteğe bağlı olarak Geçerlilik Süresini Ayarlayın - Başlangıç ve bitiş tarihleri

Kupon Doğrulama​

Ödeme sırasında kupon kodlarını gerçek zamanlı olarak doğrulamak için validateDiscountsCoupon() kullanın.

💡 Önemli Notlar​

İndirimler Yönetim Panelinde Oluşturulur​

İndirimler modülü şunları yönetir:

  • ✅ Tüm aktif indirimleri alma
  • ✅ Belirli bir indirimi işaretleyici ile alma
  • ✅ Ödeme sırasında kupon kodlarını doğrulama
  • ❌ İndirimleri oluşturmaz veya değiştirmez (yönetim panelini kullanın)

Sizin sorumluluğunuz:

  • Ürün listelemelerinde indirim rozetlerini gösterin
  • Ödeme sırasında kupon giriş alanlarını uygulayın
  • Sepet/sipariş özetinde indirim toplamlarını gösterin

📊 Hızlı Referans Tablosu​

YöntemAçıklama
getAllDiscounts()Tüm indirimleri al
getDiscountByMarker()İşaretleyici ile tek bir indirimi al
validateDiscountsCoupon()Bir indirim kupon kodunu doğrula

❓ Sıkça Sorulan Sorular (SSS)​

Ödeme sırasında indirim nasıl uygulanır?​

İndirimleri getDiscountByMarker() ile alın veya kupon kodunu validateDiscountsCoupon() ile doğrulayın. Siparişi oluşturmadan önce, dönen indirim değerini kullanarak azaltılmış fiyatı istemci tarafında hesaplayın.

Bir indirimin son kullanma tarihi olabilir mi?​

Evet! İndirimlerin isteğe bağlı validFrom ve validTo alanları olabilir. İndirimleri gösterirken bu alanları kontrol edin, böylece şu anda aktif olduklarından emin olursunuz.

Ürünlerde indirim rozetlerini nasıl gösteririm?​

Tüm indirimleri getAllDiscounts() ile alın, ardından iş mantığınıza göre indirimleri ürünlerle eşleştirin. İndirimin localizeInfos.title ve discountValue kullanarak bir rozet oluşturun.

Kupon kodu geçersiz olursa ne olur?​

validateDiscountsCoupon() kupon mevcut değilse veya süresi dolmuşsa false döner. Müşteriye uygun bir hata mesajı gösterin.

🎓 En İyi Uygulamalar​

  • İndirimleri yükleme sırasında önbelleğe al - Nadiren değişir; tekrar eden API çağrılarından kaçının
  • Kuponları sunucu tarafında doğrula - Siparişe uygulamadan önce her zaman doğrulayın
  • İndirimleri net bir şekilde gösterin - Orijinal ve indirimli fiyatları birlikte gösterin
  • Süresi dolmuş indirimleri yönetin - İndirim göstermeden önce validTo kontrol edin
  • Açıklayıcı işaretleyiciler kullanın - summer_sale_2025, discount1 değil
  • İndirim adlarını yerelleştirin - Çok dilli destek için localizeInfos kullanın

Modülün kullanıcı arayüzü hakkında daha fazla bilgi https://doc.oneentry.cloud/docs/category/discounts

İndirimler modülünün tanımı​


const { Discounts } = defineOneEntry(
  "your-project-url", {
    "token": "your-app-token"
  }
);

🔗 İlgili Belgeler​