Modülün amacı
Döviz bürosu / yetkili müessese iş kolunun ERPGOLD üzerindeki görünümü. Ayrı bir "döviz motoru" yoktur: döviz alış-satışı çekirdek deftere (MOD-CARI) PEŞİN (IslemTipi=1) ve RESMİ (IslemTipi=11) tipleriyle, NAKİT (IslemKodu=3) ve PARİTE ekranlarından yazılır; resmi belge tarafı Cari.IslemDetaylari'nın 37 mevzuat kolonunda tutulur; BSMV, e-döviz belgesi, istatistik kodu, MASAK yasaklı sorgusu ve BTrans bu iş koluna özgü kontrollerdir. [DERIVED:03_ERPGOLD_Product/VARIANT_MATRIX.md; [DERIVED:08_Database/Tables/TBL-DOV.MUSTERI.md, TBL-DOV.FATURA.md, TBL-DOV.HARCAMALAR.md]
ERPGOLDV2 kurulumunda işlemlerin %82'si NAKİT, 318.324 PEŞİN, 22.862 RESMİ, 1.514 MAHSUP; cari işlemin yalnız %1,4'ü stok üretir. [DOCUMENT:14_Customers_Internal/Installations/INST-ERPGOLDV2.md]
DB şemaları: Dov, Market (Market.MarketItem/MarketPanel MANUAL_REVIEW, 0 satır — MOD-DIGER'de listelenir).
Hangi müşteri tipleri kullanır
- Döviz bürosu — birincil; VARIANT_MATRIX'te
DOVIZ_VARIANTsatırları:IslemTipiPEŞİN/RESMİ/MAHSUP,Cari.IslemDetaylari37 kolon,Cari.Islemler.IsArbitiraj. - Sarraf ve Perakende kuyumcu — döviz bozdurma yan iş olarak; PERAKENDE ekranı ve BSMV aynı (SECTOR_KNOWLEDGE).
- Kuyumcu/rafineri kurulumunda PEŞİN ve RESMİ tip 0 kullanım — bu modül fiilen kapalıdır (INST-KUYUMCU).
Ana kavramlar
- Döviz bürosu, Şube tipi DÖVİZ/GENEL, Resmi şube, Resmi kasa, Resmi stok — SEC-DOVIZ
- PEŞİN (tip 1), RESMİ (tip 11), MAHSUP (tip 12), PARİTE (tip 10), ARBİTRAJ — SEC-ALIS, SEC-SATIS, SEC-PARITE, SEC-ARBITRAJ
- Kur: Kur listesi, Alış/satış kuru, Pano kuru, Sistem kuru, TCMB kuru, EDS, İşlem kur farkı, Peşin kur tipi
- BSMV, E-fatura / e-döviz belgesi, İstatistik kodu, BTrans, RS / RS aktar, Perakende ekranı, Pozisyon
Menü konumu
MENU_TREE — Ribbon Hesap Yonetimi: [SOURCE_CODE:Form/Genel/FrmMainForm.Designer.vb:270]
| Grup | Düğme (kod) | Ekran |
|---|---|---|
| Seri Islemler | Gise Islemleri (GISEISLEMEKRANI), BTRANS (BTRANS), Merkez Bankası Kurları (TCMBKUR), E-Fatura Listesi (EFATURALISTESI) |
GiseEkrani, CreateBTransDoviz, FrmTCMBKur, FrmEFaturaListesi |
| Rapor | Pozisyon (POZISYON), Durum Raporu, Hacim Raporu, Kasa Durum Raporu |
FrmPozisyon, FrmPozisyonHacim, FrmPozisyonDurumRaporu, FrmNakitStoklari |
| Ayarlar | Kur Giris Ekranı (KURGIRISI) |
FrmKurGirisEkrani |
| Tanımlamalar › Sistem Tanimlari | Parite Tanımlama (PARITETANIMLAMA), Vadeli Islem Kodlari |
FrmPariteEkle, FrmVadeliIslemKoduEkle |
PARİTE (X) ve NAKİT işlem ekranları iScreen içinden; Market (ANLIKFIYATLAR) ve Anlık Fiyat Tanımları düğmeleri kodsuzdur (TD-46).
Ekranlar
| Ekran | Sınıf | Yaşam döngüsü | Bir cümle |
|---|---|---|---|
| PARİTE | iFDoviz |
ACTIVE_CRITICAL | İki döviz arası takas; çapraz kur ve ikinci bacak (BR-KUR-010) |
| NAKİT | iFNakit |
ACTIVE_CRITICAL | Döviz alış/satış, BSMV, PEŞİN/RESMİ tip seçimi (MOD-CARI) |
| PERAKENDE | ParakendeSatis |
UNUSED_CANDIDATE (bkz. MOD-CARI Bilinmeyenler) | Banko önü peşin döviz/altın; 7.000 TL isimsiz sınırı, 3.000 USD uyarısı |
| Gişe İşlemleri | GiseEkrani |
ACTIVE_CRITICAL | Gişe (vezne) hızlı işlem ekranı; Stok.Gise3NakitStoklari |
| Musteri Tanımlama | FrmDovMusteriEkle |
ACTIVE_NORMAL | Dov.Musteri kartı — V2'de 0 satır |
| FrmDovFaturaEkranı, FrmDovStoklar, FrmZiynetIscilikleri | — | ACTIVE_RARE | FrmMainForm'dan çağrılan döviz yardımcı ekranları |
| Döviz Panosu, FrmPano, FrmPanoAddItem | DovizPanosu |
ACTIVE_RARE | Pano (vitrin) kur gösterimi — Sistem.DovizPanosu |
| Merkez Bankası Kurları, Kur Giriş | FrmTCMBKur, FrmKurGirisEkrani |
ACTIVE_NORMAL / ACTIVE_CRITICAL | TCMB günlük kur; kur listesi girişi (MOD-SISTEM) |
| FrmDovHarcama | FrmDovHarcama |
UNUSED_CANDIDATE | Dov.Harcamalar — referans yok |
Ana iş akışları
Döviz akışları MOD-CARI/MOD-FATURA'ya atanmıştır: WF-NAKIT-PESIN-DOVIZ-SATIS (BSMV'li peşin satış), WF-NAKIT-PARITE, WF-PARITE-EKRANI, WF-VADELI-ARBITRAJ, WF-PERAKENDE-SATIS, WF-PERAKENDE-IPTAL, WF-GUN-SONU, WF-KUR-LISTESI-GUNCELLEME (elle / KOPYALA / EDS), WF-EFATURA-GONDER, WF-EBELGE-LIMIT-GUNCELLEME, WF-AY-SONU-BTRANS, WF-MASAK-YASAKLI-SORGULAMA.
Kullanılan tablolar
| Tablo | Sınıf (08_Database/INDEX.md) | Satır V2 | Rol |
|---|---|---|---|
| Cari.Islemler, Cari.IslemDetaylari | CRITICAL / ACTIVE | 1,5 M / — | Asıl döviz defteri ve 37 mevzuat kolonu (MOD-CARI) |
| Sistem.Kurlar, Sistem.DovizPanosu, Sistem.Pariteler, Sistem.Vadeli | CRITICAL / ACTIVE | 22.575 / 12 / 52 / 153 | Kur listesi, pano, parite ve vadeli kod tanımları (MOD-SISTEM) |
| Muhasebe.MuhasebeArsiv | MANUAL_REVIEW | 305.448 | Resmi işlemlerin muhasebe/BTrans görüntüsü (MOD-FATURA) |
| Pozisyon.Pozisyonlar | INDIRECTLY_USED | 94 | Açık pozisyon (ERPBooster) |
Kullanılan fonksiyon / SP / view / trigger'lar
- View: Dov.GunSonuRaporu (satır bakiyesi = Devir + Alacak + Borç — BR-GUNSONU-001), Dov.HaraketFoyu
- Fonksiyonlar: Dov.GetMusteri, Dov.GetFaturaIslemleri, Dov.GetStoklar, Dov.GetNakitStoklari, Dov.GetMadenStoklari, Dov.GetHarcamalar; çekirdekten FN.GetKur, FN.GetPariteAvg, Sistem.GetKurListesi, Sistem.GetDovizPanosu, Stok.Gise3NakitStoklari, Stok.GetResmiStoklar
- SP: Sistem.KurEkle, Sistem.KurKopyala, Cari.RSAktar, Pozisyon.Write; trigger yalnız Cari.AcceptTransaction (ETTN'li işlemi kilitler, RESMİ/MAHSUP'u deftere yazmaz)
Raporlar
RPT-18 Pozisyon, RPT-28 Hacim (Reports.GetPozisyonDetayV2), RPT-66 Resmi Pozisyon (Reports.ResmiPozisyon), RPT-13 Fatura Kontrol (Reports.ResmiIslemRaporu), RPT-26 BTrans Döviz Kontrol, RPT-72 Merkez Bankası, RPT-78 E-Döviz Kontrol, RPT-86 Kur Listesi, Reports.GetPozisyonDetay, Reports.GetNakitGirisCikis; metrikler MET-NET-POZISYON, MET-KUR-FARKI, MET-PESIN-HACIM. Gün sonu raporu Dov.GunSonuRaporu görünümüdür; menü kaydı bulunamadı (GAP).
Entegrasyonlar
INT-KUR-EDS (EDS → kur/pano), INT-EDS-DISPLAY, INT-TCMB, INT-TICKDATA (UNVERIFIED), INT-EFATURA, INT-EDOVIZ-ISTATISTIK, INT-MASAK-AMLSCAN, INT-BTRANS, INT-ERPBOOSTER (pozisyon ön hesaplama), INT-FXTRADER-MT4 (MOD-FX).
Ayarlar
CFG-SUBE-SUBETIPI (DÖVİZ/GENEL), CFG-SUBE-ISRESMI, CFG-KASA-RESMIKASA, CFG-SUBE-RESMIISLEMLIMITITL, CFG-SUBE-YETKILIMUESSESENO, CFG-SUBE-RSAKTAR, CFG-BSMV / CFG-BSMVTIPI, CFG-PESINKURTIPI, CFG-ISLEMKURFARKI, CFG-KURREFRESHINTERVAL, CFG-SUBE-EBELGEUSDLIMIT / TLLIMIT / TCKNCONTROL, CFG-EDS-SQLPROCNAME (ERP dışı), koda gömülü CFG-HARD-PERAKENDE-7000, CFG-HARD-PERAKENDE-3000USD (TD-28 sabit MASAK eşikleri).
İş kuralları
Modüle atanmış: BR-DOVIZ-001 parite ekranı etiketleri, BR-KUR-010 çapraz kur ve ikinci bacak. Döviz iş kolunu belirleyen çekirdek kurallar: BR-BSMV-001…006 (BSMV formülü, görünürlük, e-faturada vergi; CTR-010), BR-TIP-004 RESMİ/MAHSUP defter üretmez, BR-KUR-007 kur farkı uyarısı (CTR-006), BR-GUNSONU-001, BR-PERAKENDE-002…006, BR-FATURA-002 aynı para cinsiyle fatura kesilemez, BR-FATURA-003 TL işleminde istatistik kodu, BR-DEVIR-001 hesap türleri (Yetkili Kurum=1). Enum: Parite.Islem, Parite.Yon, ParakendeSatis.IType, InvoiceHelper.Fatura_Cinsi.
Sık sorunlar
PRB-KUR-000 (160 — kur/pano/EDS), PRB-FATURA-000 (1.286 — e-döviz/ETTN/resmi işlem), PRB-BTRANS-000 (1.035), PRB-POZISYON-000 (68), PRB-VADELI-000 (47). Playbook: PB-036 kur listesi girilmemiş, PB-046 kur sapma uyarısı, PB-050 perakende eşikleri, PB-042 şube/kasa resmi değil, PB-019 resmi işlem limiti, PB-020 e-belge hataları, PB-061 EDS akışı durdu, PB-062 MASAK yasaklı.
Bilinen kusurlar
H-032 parite fiyatı ters, H-045/H-046 fiyat/kur eski, H-057 parite karşılığı görünmüyor, H-058 EMANET iki satır, H-080 PARİTE (X) düzeltilemiyor, H-144/H-145 aynı para cinsi / TL faturası, H-151 e-belge limitleri, H-160 EDS yavaş. Teknik borç: TD-21 GetKur her zaman alış, TD-22 kur fallback sessiz, TD-25 KurListesi timer, TD-28 sabit MASAK eşikleri. Çelişkiler: CTR-006/007/008/009/010, CTR-025 (NAKİT girişinde hangi satırlar), CTR-027 (PARITE mi EMANET mi).
Müşteri varyasyonları
- MüşteriŞemasıD (ERPGOLDV2): döviz kurulumunun müşteri-özel rapor katmanı — [FN-MüşteriŞemasıD.GETPOZISYON], [FN-MüşteriŞemasıD.GETPOZISYONDETAY], [FN-MüşteriŞemasıD.GETNAKITSTOKLARI], [FN-MüşteriŞemasıD.BAKIYEEKSTRESI]; menü raporları RPT-79/80/81/82
CUSTOMER_SPECIFIC.MüşteriŞemasıD.GetCariBakiyeHaraketleri,MüşteriŞemasıD.GetEnvantermenüde var, DB'de yok (GAP-RPT-BROKEN-01). - KUYUMCU şemaları (MüşteriŞemasıA/MüşteriŞemasıB/MüşteriŞemasıC): döviz modülüyle ilişkili nesne yok; PEŞİN/RESMİ 0 kullanım.
Kritik kod parçaları
İlgili eğitimler
TRN-010 döviz, TRN-013 şube tipi DÖVİZ/GENEL, TRN-019 hangi kur hangi yönde, TRN-020 kur farkı uyarısı, TRN-021 BSMV, TRN-024 vadeli ve parite, TRN-036 kur listesi/pano/TCMB, TRN-040 resmi stok ve resmi işlem, TRN-065 BTrans/yılbaşı rutinleri, TRN-099 parite (arbitraj).
Kaynaklar
DB_QUERY: Dov.* satır sayıları ve işlem tipi dağılımı ERPGOLDV2 (2026-09-11) · DB_OBJECT:Dov.GunSonuRaporu, Cari.IslemDetaylari · SOURCE_CODE:ekran/Ekran/ParakendeSatis.vb; Form/Genel/FrmMainForm.Designer.vb:270 · DERIVED: VARIANT_MATRIX, 05_Screens/_lifecycle.json, 08_Database/INDEX.md · TICKET_THEME: PRB-KUR-000, PRB-FATURA-000.
Bilinmeyenler
- GAP:
Dov.GunSonuRaporugörünümünün menüdeki rapor kaydı bulunamadı; gün sonu raporunun ekrandan nasıl alındığı doğrulanmadı (GAP-PROCESS-04 ile ilişkili). - GAP:
Marketşeması ve kodsuz Market/Anlık Fiyat düğmeleri (TD-46) — planlanan anlık fiyat modülünün durumu bilinmiyor. - GAP-MEVZUAT: e-döviz belgesi kimlik/limit eşikleri (5.000 $ / 85.000 TL) destek dokümanından (PB-019, H-166); güncel mevzuat doğrulanmadı — kesin hüküm verilmez.
