Sınıf: FrmSubeEkle · Modül: MOD-SISTEM · Türetildiği: ERPPRO.FormEditBase · Yaşam döngüsü: ACTIVE_CRITICAL · Kapsam: ERPGOLD_CORE
Nedir?
Şube tanımlama ekranıdır; Sistem.Subeler'e yazar. Şube, ERPGOLD'da hesapların, stokların ve bilançonun ayrıldığı kapsamdır: her şubenin bilanço birimi, şube tipi, limit kontrolü ve maliyet yeniden değerleme tarihi burada belirlenir [DOCUMENT:kitap#4.2] [DB_OBJECT:Sistem.Subeler] [DOCUMENT:18_Glossary/TERM-SUBE.md]. Üç sekmesi vardır: Genel Bilgiler (kod, açıklama, bilanço birimi, şube grubu/türü/tipi, sermaye, limit kontrolü, M.Tarihi, durum), Resmi Bilgiler (RESMİ ŞUBE anahtarı, ünvan, vergi dairesi/no, ticaret sicil no, YET.MU.NO, RSB kodu, RS Aktar, adres, işlem limiti) ve Entegrator (e-belge entegratörü, kullanıcı/şifre/Customer ID, gönderim tercihi, test ortamı) [SOURCE_CODE:ERPPRO/Form/Tanımlamalar/Sistem/FrmSubeEkle.Designer.vb:151-1274] [DOCUMENT:06_Workflows/WF-SUBE-TANIMLAMA.md]. Yeni şube kaydedilince tetikleyici o şubeye otomatik ANAKASA açar [BUSINESS_RULE:BR-KASA-005] [DB_OBJECT:Sistem.CreateKasa].
Ne zaman kullanılır?
- Yeni şube açılırken; resmi (faturalı, e-belge gönderen) şube kurulurken [DOCUMENT:06_Workflows/WF-SUBE-TANIMLAMA.md] [DOCUMENT:12_Support/KnownIssues/H-024.md].
- E-belge entegratörü kimlik bilgileri, taslak/hemen gönder tercihi, kimliksiz belge limitleri değiştirilirken [DOCUMENT:12_Support/Playbooks/PB-019.md] [DOCUMENT:06_Workflows/WF-EBELGE-LIMIT-GUNCELLEME.md].
- Şubenin limit kontrolü, bilanço birimi ya da RS aktarımı açılıp kapatılırken.
Adım adım kullanım
- ADMIN ile ANA MENÜ ▸ Tanımlamalar ▸ Sistem Tanimlari ▸ Sube Tanımlama ▸ YENİ KAYIT (şirket kaydı mevcut olmalı) [DOCUMENT:06_Workflows/WF-SUBE-TANIMLAMA.md#ön-koşullar].
- Genel Bilgiler: Sirket, Kodu (şube adı), Acıklama, Bilanco birimi, Sube Grubu, Sube Turu, Sube Tipi (DÖVİZ / GENEL — boş bırakılmamalı, rapor süzgeçleri), Sermaye + Birim, Limit Control anahtarı, M.Tarihi (maliyet yeniden değerleme tarihi), Durum [SOURCE_CODE:FrmSubeEkle.Designer.vb:165-659].
- Resmi Bilgiler: Resmi Sube anahtarı ON → Islem Limiti (TL) kutusu açılır [SOURCE_CODE:FrmSubeEkle.vb:106-113]; Unvan, Vergi Dairesi, Vergi No, Tic. Sicil No, YET.MU.NO, RSB KODU, RS Aktar, Adres / Sehir / Ilce / Il Kodu / Posta Kodu.
- Entegrator: Entegrator : (Uyumsoft / EDM / İce / ticari1 — kod listesi [DOCUMENT:kitap#4.6]), User Name :, Password :, Customer ID:, Gönderim Tercihi : (Hemen Gönder / Taslak Olarak Kayıt Et), Test Ortanımnda Çalış. Kimlik bilgileri gizlidir; wiki'ye yazılmaz.
- Kayıt; ardından Ctrl+F5 ya da program yeniden açılır — tanım tabloları belleğe bir kez yüklenir [DOCUMENT:06_Workflows/WF-SUBE-TANIMLAMA.md adım 3].
- Ek kasa gerekiyorsa Kasa Tanımlama; kullanıcılar Kullanıcı Tanımlama ile şubeye atanır. KAYIT SİL şubeyi pasife alır, silmez [DOCUMENT:06_Workflows/WF-SUBE-TANIMLAMA.md#sonuç].
Not: makaledeki otomatik alan tablosunda etiketler kaymıştır (ör. "Password : | TxtAdres"); gerçek etiketler yukarıda ve aşağıdaki tabloda Designer'dan alınmıştır.
Alanların anlamı
| Ekran etiketi | İş anlamı (kolon, Sistem.Subeler) |
|---|---|
| Sirket / Kodu / Acıklama | Bağlı şirket, şube kodu (ana menü başlığında görünür), ad (SirketId, Kodu, Aciklama) |
| Bilanco (birim) | Bilanço ve kâr/maliyet raporlarının birimi; maden kartı varsayılan birimi (BilancoBirimId) [DOCUMENT:09_CodeArchitecture/CONFIGURATION.md#cfg-sube-bilancobirimid] |
| Sube Grubu / Sube Turu | Serbest gruplama (SubeGrubu, SubeTuru) |
| Sube Tipi | DÖVİZ / GENEL — DÖVİZ şubede resmi kasadaki faturasız işlemler raporlarda gizlenir (SubeTipi) [DOCUMENT:09_CodeArchitecture/CONFIGURATION.md#cfg-sube-subetipi] [DOCUMENT:18_Glossary/TERM-SUBE-TIPI-DOVIZ-GENEL.md] |
| Sermaye + Birim | Sermaye tutarı ve birimi (Sermaye salt okunur, SermayeBirimId) |
| Limit Control | Açıksa çıkış/peşin-dışı işlemlerde "Hesap Limiti Aşılıyor…" kontrolü (IsLimitControl) [DOCUMENT:09_CodeArchitecture/CONFIGURATION.md#cfg-sube-islimitcontrol] (CTR-014) |
| M.Tarihi | Maden maliyeti yeniden değerleme başlangıcı (RevCostDate) [DOCUMENT:09_CodeArchitecture/CONFIGURATION.md#cfg-sube-revcostdate] |
| Durum | Aktif/Pasif; pasif şubede tetikleyici "SUBE PASIF HALDE. ISLEM YAPAMAZSINIZ..." (IsActive) [BUSINESS_RULE:BR-KASA-004] |
| Resmi Sube | Şubede belge uyum/kontrol fonksiyonları açılır (belgelendirilmiş işlem havuzu ayrıca hesaplanır); e-belge, BTrans, Seri İşlem şeridi ve Fiş İptal düğmesi (IsResmi) [DOCUMENT:09_CodeArchitecture/CONFIGURATION.md#cfg-sube-isresmi] |
| Islem Limiti (TL) | Resmi işlem eşiği (ResmiIslemLimitiTL) — kod kullanımı görülmedi (GAP) |
| Unvan / Vergi Dairesi / Vergi No / Tic. Sicil No / YET.MU.NO / RSB KODU / Adres … | Resmi belge kimliği; YET.MU.NO e-döviz belgesinde şube kimliği (Unvan, VergiDairesi, VergiNo, TicaretSicilNo, YetkiliMuesseseNo, RSBKodu, Adres, Sehir, Ilce, IlKodu, PostaKodu) |
| RS Aktar | Açıksa "Resmi aktar" işaretli işlemler Cari.RsAktar ile resmi hesaba kopyalanır (RsAktar) [BUSINESS_RULE:BR-FATURA-007] |
| Entegrator : / User Name : / Password : / Customer ID: | E-belge entegratörü ve hesabı; ikisi doluysa fatura penceresi entegratöre gönderir (Entegrator, EntUserName, EntPassword, EntCustId) [DOCUMENT:09_CodeArchitecture/CONFIGURATION.md#cfg-sube-entusername] |
| Gönderim Tercihi : | Hemen Gönder / Taslak (EBelgeTaslak) [BUSINESS_RULE:BR-FATURA-005] |
| Test Ortanımnda Çalış | Entegratör test ortamı (EBelgeTest) |
E-belge kimlik ve limit kolonları (EBelgeTcknControl, EBelgeUsdLimit, EBelgeTlLimit) tabloda vardır ancak bu formun Designer etiketlerinde görülmedi — GAP: hangi ekrandan yazıldığı doğrulanmadı [DOCUMENT:09_CodeArchitecture/CONFIGURATION.md#cfg-sube-ebelgeusdlimit].
Hesaplama / doğrulama mantığı
- Ekranda doğrulama mesajı yoktur; Resmi Sube kapatılınca Islem Limiti temizlenir [SOURCE_CODE:FrmSubeEkle.vb:106-113].
- Kayıt sonrası tetikleyici ANAKASA açar [BUSINESS_RULE:BR-KASA-005]. Entegratör parolası düz metin saklanıyor olabilir (Sube DAO'sunda
Cryptoçağrısı görülmedi — INFERRED, doğrulanmadı) [DOCUMENT:09_CodeArchitecture/Security/SEC-AUTHN.md#10]. - Şube alanları oturumda
LoginInformation.Subeolarak yüklenir; değişiklik yeniden giriş/yenileme gerektirir.
Stok / bakiye / rapor etkisi
Defter etkisi yok — tanım ekranı. Ancak şube ayarları defter davranışını belirler: limit kontrolü kaydı reddedebilir; RS Aktar resmi kopya işlem üretir; bilanço birimi bilanço/pozisyon değerlemesini; şube tipi rapor süzgeçlerini değiştirir [DOCUMENT:09_CodeArchitecture/CONFIGURATION.md].
Sık yapılan kullanıcı hataları
- Resmi işlemler çalışmıyor, "resmi" bölüm boş — RESMİ ŞUBE/RESMİ KASA kapalı [DOCUMENT:12_Support/KnownIssues/H-024.md] [DOCUMENT:12_Support/Playbooks/PB-042.md].
- Yeni şubede bilanço boş veya yanlış birimde — Bilanco birimi [DOCUMENT:12_Support/KnownIssues/H-025.md] [DOCUMENT:12_Support/Playbooks/PB-056.md].
- Resmi işlem limiti / e-belge kimlik zorunluluğu güncellemesi [DOCUMENT:12_Support/KnownIssues/H-166.md] [DOCUMENT:12_Support/KnownIssues/H-151.md] [DOCUMENT:12_Support/Playbooks/PB-019.md].
- "Entegrator faturayı Kabul Etmedi…" — entegratör kimlik/ortam ayarı [DOCUMENT:12_Support/KnownIssues/H-147.md] [DOCUMENT:12_Support/Playbooks/PB-020.md].
- Tanımladım ama listede yok — Ctrl+F5 [DOCUMENT:12_Support/Playbooks/PB-039.md].
- "Hesap Limiti Aşılıyor…" beklenmiyordu — Limit Control açık [DOCUMENT:12_Support/KnownIssues/H-042.md] [DOCUMENT:12_Support/Playbooks/PB-047.md].
İlgili ticket temaları
- PRB-TANIMLAMA-000, PRB-FATURA-000, PRB-BILANCO-000; zincirler SYM-TANIMLAMA, SYM-FATURA.
- Playbook'lar: PB-042, PB-019, PB-056.
Müşteri varyasyonları
- Döviz bürosu şubeleri Sube Tipi = DÖVİZ, e-döviz belgesi ve YET.MU.NO kullanır; kuyumcu şubeleri GENEL tiptedir [DOCUMENT:18_Glossary/TERM-SUBE-TIPI-DOVIZ-GENEL.md] [DOCUMENT:kitap#9.3].
- Entegratör seçimi müşteriye göre (Uyumsoft / EDM / İce / ticari1) [DOCUMENT:kitap#4.6].
- Kimliksiz belge limitleri mevzuatla değişir (5.000 $ / 85.000 TL güncellemesi) — tarihli kaynak PB-019; güncel eşik için GAP-MEVZUAT.
Kim kullanır? Nereden açılır?
- ANA MENÜ ▸ Tanımlamalar ▸ Sistem Tanimlari ▸ Sube Tanımlama
- Liste ekranındaki Ekle/Düzenle:
AIO.Sistem.Sube.FormEditBase→ bu form
Yaşam döngüsü kanıtı
ACTIVE_CRITICAL — ANA MENÜ: Tanımlamalar ▸ Sistem Tanimlari ▸ Sube Tanımlama; DAO FormEditBase hedefi: AIO.Sistem.Sube
Alanlar → veritabanı
| Ekrandaki alan | Kontrol | Tablo.Kolon | Yön |
|---|---|---|---|
| YET.MU.NO | CmbSirket |
Sistem.Subeler.SirketId |
yaz |
| Acıklama | TxtUnvan |
Sistem.Subeler.Unvan |
yaz |
| Entegrator : | CmbEntegrator |
Sistem.Subeler.Entegrator |
yaz |
| Kodu | TxtKodu |
Sistem.Subeler.Kodu |
yaz |
| — | cmbVergiDairesi |
Sistem.Subeler.VergiDairesi |
yaz |
| Acıklama | TxtAciklama |
Sistem.Subeler.Aciklama |
yaz |
| User Name : | TxtEntUserName |
Sistem.Subeler.EntUserName |
yaz |
| Sube Turu | TxtVergiNo |
Sistem.Subeler.VergiNo |
yaz |
| — | CmbSubeGrubu |
Sistem.Subeler.SubeGrubu |
yaz |
| User Name : | TxtSicilNo |
Sistem.Subeler.TicaretSicilNo |
yaz |
| — | CmbSubeTuru |
Sistem.Subeler.SubeTuru |
yaz |
| Password : | TxtEntPassword |
Sistem.Subeler.EntPassword |
yaz |
| Bilanco | TxtRSBKodu |
Sistem.Subeler.RSBKodu |
yaz |
| — | CmbSubeTipi |
Sistem.Subeler.SubeTipi |
yaz |
| Password : | TxtAdres |
Sistem.Subeler.Adres |
yaz |
| Bilanco | CmbBilancoBirimi |
Sistem.Subeler.BilancoBirimId |
yaz |
| Customer ID: | TxtEntCusID |
Sistem.Subeler.EntCustId |
yaz |
| Password : | TxtIl |
Sistem.Subeler.Sehir |
yaz |
| M.Tarihi | TxtIlce |
Sistem.Subeler.Ilce |
yaz |
| User Name : | TxtSermaye |
Sistem.Subeler.Sermaye |
oku |
| Birim | CmbSermayeBirimi |
Sistem.Subeler.SermayeBirimId |
yaz |
| Customer ID: | TxtIlKodu |
Sistem.Subeler.IlKodu |
yaz |
| Password : | CmbDurum |
Sistem.Subeler.IsActive |
yaz |
| Gönderim Tercihi : | CmbTaslak |
Sistem.Subeler.EBelgeTaslak |
yaz |
| Posta Kodu | TxtPostaKodu |
Sistem.Subeler.PostaKodu |
yaz |
| Gönderim Tercihi : | ChkIsResmi |
Sistem.Subeler.IsResmi |
yaz |
| M.Tarihi | TxtTarih |
Sistem.Subeler.RevCostDate |
yaz |
| Resmi Sube | chkTest |
Sistem.Subeler.EBelgeTest |
yaz |
| Customer ID: | ToggleSwitch1 |
Sistem.Subeler.IsLimitControl |
yaz |
| Islem Limiti (TL) | TxtResmiIslemLimitiTL |
Sistem.Subeler.ResmiIslemLimitiTL |
yaz |
| RS Aktar | ChkRsAktar |
Sistem.Subeler.RsAktar |
yaz |
| YET.MU.NO | TXTYmmNo |
Sistem.Subeler.YetkiliMuesseseNo |
yaz |
Kullanıcı olayları
| Olay | Metot | Dosya:satır |
|---|---|---|
ChkIsResmi.Toggled |
ChkIsResmi_Toggled |
FrmSubeEkle.vb:106 |
PanelControl2.Paint |
PanelControl2_Paint |
FrmSubeEkle.vb:115 |
Okuduğu / yazdığı tablolar (kod içi SQL, statik)
| Tablo | Fiiller |
|---|---|
Sistem.Birimler |
SELECT |
Sistem.Sirketler |
SELECT |
Kullandığı DAO / iş sınıfları
Bilinen kusurlar / dikkat
- Dinamik SQL: 1 ifade — parametresiz birleştirme riski (TD-DYNAMIC-SQL).
Kaynaklar
SOURCE_CODE:ERPPRO/Form/Tanımlamalar/Sistem/FrmSubeEkle.Designer.vbSOURCE_CODE:ERPPRO/Form/Tanımlamalar/Sistem/FrmSubeEkle.vbDERIVED:docs/knowledge-base/screens/FrmSubeEkle.md(KB-docs statik analiz)DERIVED:kb_src/erppro/scan.json(olay/SQL/çağrı)
Bilinmeyenler
- Hangi sürümde eklendiği: VERSION_UNKNOWN (GAP-CODE-VERSION-DATE).