Para ve fatura

Tahsilat, cari ve belge

Siparişin bedeli üç yerde izlenir: ödeme kaydı, cari bakiye, fatura. Bunlar aynı tutarın kopyası değil, farklı sorulara cevap verir.

Ödeme: “Kart / havale bu sipariş için geçti mi?”
Cari: “Bu kullanıcının bu depodaki bakiyesi nedir?”
Fatura: “Yasal belge kesildi mi?”

`payment`

Görevi: Ödeme sağlayıcıları ve Mongo payments belgesi.

Yollar herkese açıktır (sağlayıcı geri bildirimi): payment, payment/magicpay, payment/paytr, payment/paywall.

Sipariş üzerindeki ödeme bloğu (purchase) sipariş belgesinin içindedir. payments koleksiyonu sağlayıcı işleminin kendisidir: platform, tutar, durum, işlem no, sipariş id.

Başarılı veya başarısız güncelleme payment.updated olayını üretir; dinleyici siparişi ödenmiş veya başarısız yapar. Akış: Ödeme.

`financial`

Görevi: Cari.

Yol	Erişim
`financial/user`	Kimliği doğrulanmış (depo erişimi olan)
`financial/admin`	Yönetici
`financial/officer`	Yetkili

Bakiye Prisma FinancialAccount tablosundadır: kullanıcı + isteğe bağlı depo, balance, creditLimit, kasa (boxBalance) ve palet (palletBalance) sayaçları. Pozitif bakiye alacak, negatif borç anlamına gelir (şema yorumu).

Hareket Mongo accountTransactions koleksiyonundadır: tutar, işlem sonrası bakiye, tip, referans, vade, onay durumu. Tip listesi ve Türkçe etiketler Cari ve fatura sayfasındadır.

Sipariş, iade, kapı tahsilatı ve stok alımı sistem tiplerini otomatik üretir. Yeni alıcı kaydında aktif tanım varsa REWARD da otomatik yazılır. Elle girilebilen çekirdek tipler kodda ayrı listedir (transfer, ödül, telafi, düşüm); ödül hem elle hem kayıt akışında kullanılabilir.

Kayıt ödülü tanımı

Ödül kartı Prisma tablosu değildir. RewardDefinition alanları kod listesindedir: id, code, name, amount, warehouseId, startDate, endDate, isActive. Aktiflik: aynı kod, isActive, başlangıç geçmişte, bitiş boş veya gelecekte.

Alıcı kaydı FinancialBuyerService.grantSignupReward çağırır. Akış ve güncel tanım: Kayıt ödülü.

`invoice`

Görevi: Kesilmiş veya gelen e-belge kaydı.

Yol	Niyet edilen rol
`invoice/buyer`	Alıcı (rol bekçisi var)
`invoice/admin`, `invoice/officer`	Yönetici / yetkili (etiket var, rol bekçisi yok)

Giden fatura invoices, gelen tedarikçi belgesi platformInvoices. Sağlayıcı enum’u yalnız IZIBIZ. Belge tipi: e-fatura, e-arşiv, makbuz. Numara üretimi Prisma InvoiceSequence (tip + önek + yıl).

Sipariş belgesine gömülen invoice özeti, yasal belgenin kısa kopyasıdır. Asıl UBL / sağlayıcı yanıtı fatura koleksiyonundadır.

Akış: Fatura ve HKS.

Siparişteki ödeme kırılımı

Satın alma, sipariş belgesine purchase nesnesini yazar. Burada yöntem (CASH, CARD, TRANSFER, CHECK, ACCOUNT), çevrimiçi/çevrimdışı tipi, satır kalemleri, kargo, taksit, cari kullanımı ve net toplam durur. Kapıda tahsilat transfer belgesindeki collectedPayments ile de izlenir.