Entegretzy: pazaryeri sipariş ve e-fatura entegrasyonu (SaaS)

Amaç

Pazaryerinde satan işletmelerin her gün yaptığı iş aynıdır: siparişi gör, faturasını kes, bağlantısını pazaryerine gir, paketi hazırla. Entegretzy bu döngüyü tek panele indirir; her adımı kaydeder ve hiçbir siparişi iki kez faturalamaz.

Ne yaptık

• Turborepo tek depo: Next.js 16 uygulaması (panel, API, webhook’lar), pazaryeri istemcileri (Trendyol sipariş akışı ve webhook, Hepsiburada, N11 REST + SOAP), sağlayıcıdan bağımsız e-fatura katmanı ve Nilvera istemcisi, iş zamanlayıcısı, e-posta paketi.

• Ek sunucu yok: Vercel Cron her dakika bir “tick” çağırır; vadesi gelen işler veritabanında kiralanarak (FOR UPDATE SKIP LOCKED) çalışır. İş fonksiyonları taşıma katmanından bağımsız; hacim artınca ayrı bir worker’a geçmek yalnızca o katmanı değiştirir.

• Kiracı yalıtımı PostgreSQL satır düzeyi güvenlikle (RLS): uygulama kısıtlı rolle bağlanır, her tenant erişimi tek bir sarmalayıcıdan geçer. Pazaryeri ve Nilvera anahtarları AES-256-GCM zarf şifrelemesiyle saklanır.

• Fatura akışı: paket pazaryerinde hazırlanıyor → alıcı e-Fatura mükellefiyse e-Fatura, değilse e-Arşiv → herkese açık PDF bağlantısı pazaryerine → paket faturalandı. Tutar uyuşmazlığında fatura kesilmez; idempotent yeniden deneme.

• Kimlik ve lisans kodzoft.com’da: kodzoft OIDC sağlayıcısı, “Kodzoft ile giriş”, abonelik değiştikçe imzalı lisans olayları (HMAC, zaman toleranslı, kuyruklu yeniden deneme).

• Arayüz: shadcn/ui, TanStack Table ile toplu fatura, URL’de yaşayan filtreler, komut menüsü, satış grafiği, açık/koyu tema. Resend ile uyarı e-postaları (24 saatte bir tekrar sınırı).

Öne çıkanlar

Sipariş aynı anda webhook ve sorgulama yoluyla gelse de upsert idempotent olduğu ve eski veri yeninin üzerine yazılmadığı için çakışma olmaz. Canlı: entegretzy.kodzoft.com.