Uluslararası E-Ticaret: Çoklu Para Birimi, Dinamik Kur Çevrimi ve Global Vergi (VAT/KDV) Mimarisi

Türkiye'deki veya yerel bir pazardaki bir e-ticaret sitesini küresel satışa açmak yalnızca sitedeki metinleri İngilizceye çevirmekle bitmez. Finansal olarak karşınıza 3 devasa problem çıkar:

1. Döviz Kuru Kaybı (FX Slippage): Ürününüzü 100 USD'ye satarken bankanın uyguladığı kur marjı veya ödeme anındaki kur dalgalanması kârınızı eritebilir.
2. Avrupa Birliği KDV Kuralları (EU VAT OSS): Fransa'daki bir tüketiciye satarken %20 Fransız KDV'si, Almanya'dakine %19 Alman KDV'si uygulanmalıdır. B2B alımlarda ise Ters Vergilendirme (Reverse Charge) ile KDV sıfırlanmalıdır.
3. ABD Eyalet Satış Vergisi (US Sales Tax Nexus): Kaliforniya ile New York'un vergi oranları ve muafiyet sınırları tamamen farklıdır.

Stilmerce'in para birimi motoru, Avrupa Merkez Bankası (ECB) verilerini her saat başı arka plandaki BullMQ işçisiyle çeker ve Redis üzerinde önbelleğe alır:

// currency-converter.service.ts
export class CurrencyConverterService {
  async convertPrice(amountTRY: number, targetCurrency: string): Promise<number> {
    if (targetCurrency === 'TRY') return amountTRY;

    const rate = await this.redis.get(`fx_rate:TRY_${targetCurrency}`);
    // %1.5 Döviz Dalgalanma Tamponu (FX Slippage Buffer) ekle
    const protectedRate = Number(rate) * 0.985;

    // Psikolojik fiyatlandırma (Charm Pricing: .90 veya .99 ile bitir)
    const rawConverted = amountTRY * protectedRate;
    return Math.ceil(rawConverted) - 0.10;
  }
}

Müşteri teslimat adresini seçtiği mikrosaniyede vergi hesaplama motoru devreye girer:

• Müşteri bir AB ülkesi seçtiğinde (Örn: İtalya), ülkenin güncel KDV oranı (%22) faturaya eklenir.
• Eğer müşteri geçerli bir VIES AB Vergi Numarası girerse, API VIES sunucularından numarayı doğrular ve B2B Reverse Charge kuralıyla KDV'yi otomatik olarak %0'a çeker.