Mahsuplaşma Grubu Kurulum Sihirbazı

Grup Kurulum Sihirbazı, bir mahsuplaşma grubunu yedi adımda uçtan uca kurmanızı sağlar: kapsam beyanı, tesis/üye seçimi, Ek-1 alanları, özel kurallar, sayaç ataması + ESS bilgileri, bedelli limit hesapları ve son uygunluk önizlemesi. Kurulum Akışı sayfasındaki API adımlarının tamamı bu sihirbazla ekran üzerinden yapılabilir; API akışı ileri düzey / otomasyon senaryoları için referans olmaya devam eder.

Sihirbaz adımları (üstteki adım göstergesinde bu sırayla görünür):

Kapsam → Tesisler → Ek-1 → Özel Kurallar → Sayaç + ESS → Limit → Önizleme

Yetkiler

• Sihirbaz manage:netting yetkisi gerektirir. Yetkisi olmayan kullanıcı sihirbaz sayfasına girse bile sihirbaz yüklenmez — "Grup kurulumu için yönetim yetkisi gerekir" bilgilendirme kartı ve grup listesine geri dönüş bağlantısı gösterilir.
• read:netting bile yoksa sayfa erişim reddi kartı gösterir.
• Salt-okuma (read:netting) kullanıcı "Grup kurulumunu başlat" / "Kurulumu sürdür" butonlarını görmez; gruplar listesindeki "Kurulum tamamlanmadı" rozetini görür ama rozet tıklanabilir değildir.

Her alanın anlamını tek listede mi arıyorsunuz?

Bu sayfa sihirbazı adım sırasına göre anlatır ve her adımda o adımın formundaki alanları tek tek açıklar. Bir alanı (ör. EIC kodu, sözleşme gücü, başlangıç limiti) adımdan bağımsız tek bir listede aramak isterseniz Alan Sözlüğü sayfasına bakın — orada her alan için "bu ne / nereden bulunur / boş bırakırsam ne olur" tanımı toplu hâlde bulunur. API düzeyindeki karşılığı için Kurulum Akışı.

---

Sihirbaz akış haritası

Aşağıdaki diyagram sihirbazın yedi adımını, adımlar arasındaki kapıları (İleri butonunun ne zaman açıldığı) ve önizlemedeki bloklayıcı bulgu dalını gösterir. Dikkat edilecek en önemli nokta: bloklayıcı bulgu hesabı durdurmaz — kurulum yine tamamlanır, üretim "bedelsiz riskiyle" simüle edilir (Md.6(4)/9(6); ayrıntı aşağıda "Adım 7 — Önizleme" bölümünde).

Diyagram düz metin görünüyorsa

Diyagramlar Mermaid ile yazılmıştır. Docdaki Mermaid eklentisi henüz etkin değilse bu blok bir kod kutusu olarak görünür; içeriği yine okunabilir (kutular = adımlar, baklava = kapı/karar). Adımların ayrıntısı zaten aşağıda metin olarak da anlatılır.

---

Sihirbaza erişim

Nereden	Ne zaman görünür	Nereye gider
Mahsuplaşma genel bakış (/mahsuplasma) — "İlk mahsuplaşma grubunuzu kurun" kartındaki "Grup kurulumunu başlat" butonu	Hiç grup yokken + manage:netting	/mahsuplasma/groups/new
Gruplar sayfası (/mahsuplasma/groups) — boş-durum kartındaki "Grup kurulumunu başlat" butonu	Hiç grup yokken + manage:netting	/mahsuplasma/groups/new
Gruplar listesi — durum sütunundaki amber "Kurulum tamamlanmadı" rozeti	Grup Müşteri tanımlı durumundayken (rozet linki yalnız manage:netting ile)	/mahsuplasma/groups/{id}/setup
Grup detayı — başlıktaki "Kurulumu sürdür" butonu	Grup Müşteri tanımlı durumunda + manage:netting	/mahsuplasma/groups/{id}/setup

İki giriş modu vardır:

• Yeni kurulum (/mahsuplasma/groups/new) — grup henüz yoktur; sihirbaz Adım 1'den başlar. Grup, Adım 2'nin sonunda ("Grubu oluştur ve üyeleri ekle") oluşur ve o andan itibaren kurulum sürdürülebilir hâle gelir.
• Kurulumu sürdürme (/mahsuplasma/groups/{id}/setup) — yarım bırakılmış bir kurulum kaldığı yerden devam eder; giriş adımı sunucudaki kayıtlı verilerden otomatik belirlenir (aşağıya bakın).

---

Taslak davranışı — hiçbir veri kaybolmaz

Sihirbazın taslak mantığı sunucu-taraflıdır: her adımda girdiğiniz veriler ("Beyanı kaydet", "Grubu oluştur", "Tesisi kaydet", "Limit hesabı oluştur" vb. butonlarla) anında backend'e yazılır. Tarayıcıda (localStorage vb.) taslak saklanmaz. Bu yüzden:

• Sihirbazı yarım bırakmak güvenlidir — sekmeyi kapatsanız, oturumunuz düşse, başka bilgisayardan girseniz bile kayıtlı adımlar kaybolmaz.
• Yarım kurulum, gruplar listesindeki "Kurulum tamamlanmadı" rozetinden veya grup detayındaki "Kurulumu sürdür" butonundan sürdürülür.
• Sürdürme girişinde sihirbaz, kaldığınız adımı sunucu verisinden türetir ve doğrudan o adımdan açılır. Türetme sırası:

Sıra	Koşul	Giriş adımı
1	Kapsamın "aynı resmî taraf" beyanı yok	Kapsam
2	Grubun aktif üyesi yok	Tesisler
3	Grup Ek-1'den muaf değil VE hiçbir üye tesiste Ek-1 çekirdek alanı dolu değil	Ek-1
4	Uygunluk değerlendirmesi hiç koşulmamış	Özel Kurallar
5	Ana sayaç eksikliği bulgusu (R003M) bloklayıcı-FAIL	Sayaç + ESS
6	Limit-yok bulgusu (R007/R00L) bloklayıcı-FAIL (mesken grubu değilse)	Limit
7	Yukarıdakilerin hiçbiri	Önizleme

"Kurulum tamamlanmadı" rozeti neye bağlı?

Rozet, grubun resmî yaşam döngüsü durumuna bağlıdır: grup "Müşteri tanımlı" (customer_defined) durumunda kaldığı sürece görünür. Sihirbazın son adımını bitirmek grubu otomatik olarak "Ek-1 gönderildi" durumuna ilerletmez (bu resmî bir süreç adımıdır) — dolayısıyla rozet, grup resmî akışta ilerletilene kadar görünmeye devam eder ve kuruluma dönüş her zaman mümkündür.

Sihirbazda her adımda Geri dönülebilir; İleri butonu adım bazlı kapılarla kontrol edilir (aşağıda her adımda belirtilir).

---

Adım 1 — Kapsam

Mahsuplaşma grubu bir kapsam (aynı resmî tarafa ait tesisler kümesi) altında kurulur. Bu adımda:

• Mevcut bir kapsam seçersiniz veya "Yeni kapsam oluştur" mini formuyla yeni bir kapsam açarsınız (kapsam adı + opsiyonel not).
• Seçili kapsam beyansızsa "Aynı resmî taraf beyanı" bölümü görünür: beyan kaynağını seçip "Beyanı kaydet" ile beyanı işlersiniz.

VKN girilmez ve saklanmaz

Kapsam adı Zeus içi bir takma addır (alias). VKN veya kimlik bilgisi istenmez ve girilmez — form bunu açık bir bilgi kutusuyla hatırlatır (veri minimizasyonu). Ayrıntı: Kurulum Akışı — Adım 1.

Beyan kaynağı dört seçenekten biridir (güçlülük sırasıyla):

Müşteri beyanı < Resmî belge < LÜM raporu / GTS raporu (son ikisi eş düzey)

Provenance koruması — zayıf kaynakla yeniden beyan reddedilir

Kapsam zaten daha güçlü bir kaynakla beyanlıysa, daha zayıf bir kaynakla yeniden beyan sunucu tarafından 409 ile reddedilir ve sihirbaz açıklayıcı bir hata bildirimi gösterir. Aynı veya daha güçlü kaynakla yeniden beyan serbesttir (idempotent yeniden-teyit + yükseltme). Beyanlı kapsamda kaynak + tarih rozeti gösterilir; "Yeniden beyan et" butonu opsiyoneldir.

• İleri kapısı: kapsam seçili VE "aynı resmî taraf" beyanı kayıtlı olmalıdır.
• Sürdürme modunda kapsam gruba bağlı olduğu için değiştirilemez (seçici kilitli gelir, bilgi notu gösterilir).

Adım 1 form alanları — ne, nereden bulunur, boş bırakırsam:

Alan	Ne?	Zorunlu?	Ne yazacağım / seçeceğim?	Nereden bulunur?	Boş / yanlış olursa?
Kapsam adı	Kapsamın Zeus içi takma adı (alias). Gerçek VKN DEĞİL	✅ Evet (≤120 karakter)	Sizin belirlediğiniz serbest ad — ör. "Müşteri A — Ana Kapsam"	Kendiniz belirlersiniz; müşteri/proje adından türetin. VKN İSTENMEZ (KVKK / veri minimizasyonu — gerçek VKN Zeus'ta tutulmaz)	Boş bırakılamaz → İleri kapısı geçmez. Yanlış ad hesabı bozmaz, sonradan düzeltilir
Not	Kapsam için serbest açıklama	❌ Hayır (serbest metin, uzunluk sınırı yok)	İstediğiniz açıklama	—	Etkisi yok
Harici referans	Müşterinin kendi kayıt sistemindeki referans / LÜM (Lisanssız Üretim Modülü) rapor alias'ı	❌ Hayır (≤80 karakter)	İç dosya/başvuru numarası — ör. LUM-2026-00123	Müşterinin kendi kayıt sistemi (LÜM başvuru/rapor no, iç proje kodu). Zeus üretmez	Boş kalması sorun değil — yalnız ileride LÜM raporlarını eşleştirmeyi kolaylaştıran etiket
Beyan kaynağı	"Bu tesisler aynı resmî tarafa ait" beyanının hangi belgeye dayandığı	✅ Evet (beyan kaydı için)	Aşağıdaki 4 seçenekten elinizdeki en güçlü belgeye uyanı	Elinizdeki belge tipi (müşteri yazısı / resmî belge / LÜM raporu / GTS raporu)	Beyan kaydedilmezse İleri kapısı geçmez. Zayıf → güçlü değişim serbest; güçlü → zayıf 409 ile reddedilir

Beyan kaynağı seçenekleri (soldan sağa "belge gücü" artar):

Seçenek (teknik)	Ekrandaki etiket	Ne zaman bunu seç?
customer_declaration	Müşteri beyanı	Elinizde yalnız müşterinin sözlü/yazılı beyanı var; resmî belge yok
official_document	Resmî belge	Tapu, sözleşme, vergi levhası gibi resmî bir belge tesislerin aynı tarafa ait olduğunu gösteriyor
lum_report	LÜM raporu	LÜM (Lisanssız Üretim Modülü) resmî raporu elinizde
gts_report	GTS raporu	GTS (Görevli Tedarik Şirketi — GTŞ) raporu elinizde

not_checked beyan kaynağı sayılmaz

"Kontrol edilmedi" (not_checked) bir beyan kaynağı olarak kabul edilmez — beyanı kaydetmek için yukarıdaki 4 seçenekten biri gereklidir.

---

Adım 2 — Tesisler + grup

Bu adımda gruba katılacak tesisleri seçer, üye rollerini atar ve (yeni kurulumda) grubu oluşturursunuz.

Tesis seçimi:

• Kapsama bağlı tesisler tabloda listelenir; çoklu seçim yapılır.
• Seçilen her tesise bir üye rolü atanır: Üretim / Tüketim / Karma. Rol ön-değeri tesisin kendi rolünden gelir; satır bazında değiştirilebilir.
• Uygun tesis yoksa "Yeni tesis oluştur" mini formuyla tesis açılır — yalnız temel alanlar girilir (ad, tesis rolü, opsiyonel alt bölge); Ek-1 ve özel kural alanları sonraki adımlarda doldurulur.

"Yeni tesis oluştur" mini formu — alanlar:

Alan	Ne?	Zorunlu?	Ne yazacağım / seçeceğim?	Nereden bulunur?	Boş / yanlış olursa?
Tesis adı	Tesisin Zeus içi adı	✅ Evet	Tesisin proje/tesis adı — ör. "Depo Çatı GES"	Proje / lisans / çağrı mektubu belgesindeki tesis adı	Boş bırakılamaz
Tesis rolü	Tesisin mahsuplaşmadaki işlevi	✅ Evet	Üretim (production) = GES/üreten tesis · Tüketim (consumption) = sayaçtan çeken abone · Karma (mixed) = hem üretir hem tüketir	Tesisin ne yaptığından: panelli/üreten mi, çeken abone mi	Yanlış rol; uygunluk (R002/R003/R007) ve Limit adımını etkiler. Rol satır bazında sonradan değiştirilebilir
Alt bölge	Tesisin bağlı olduğu Zeus saha/alt bölge kaydı	❌ Hayır	Listeden ilgili alt bölge	Zeus saha yapınız (Ayarlar → saha/alt bölge). Yoksa boş bırakın	Boş kalması sorun değil; sayaç atama adımında cihaz listesini daraltmakta kullanılır

Üye rolü, tesis rolünden gelir ama ayrıdır

Tabloda seçtiğiniz tesis rolü, tesisi gruba eklerken üye rolüne ön-değer olur; her satırda Üretim / Tüketim / Karma olarak değiştirebilirsiniz.

Grup bilgileri (yalnız yeni kurulumda görünür):

Alan	Ne?	Zorunlu?	Ne yazacağım / seçeceğim?	Nereden bulunur?	Boş / yanlış olursa?
Grup adı	Grubun Zeus içi adı (tenant içinde tekil)	✅ Evet (≤120 karakter)	Serbest ad — ör. "Müşteri A — 2026 Mahsuplaşma"	Kendiniz belirlersiniz	Boş bırakılamaz
Fatura dönemi başlangıcı	Md.6(2) "geçmiş döneme üye yazma yasağı"nın referans tarihi	✅ Evet (tarih; varsayılan ayın 1'i)	Fatura döneminin başladığı gün — genelde takvim ayının 1'i	Elektrik faturasındaki fatura dönemi başlangıcı	Yanlış tarih, geçmişe üye eklemeyi hatalı biçimde açar/kapatır
Üyelik başlangıcı (valid_from)	Eklenen üyelerin üyelik başlangıç tarihi	✅ Evet (tarih; varsayılan bugün)	Üyeliğin başladığı gün	Fatura döneminden; belirsizse bugünü bırakın	Grubun/dönemin başından öncesine set edilemez → 422

"Grubu oluştur ve üyeleri ekle" butonu grubu oluşturur (grup "Müşteri tanımlı" durumunda doğar) ve seçilen tesisleri sırayla üye ekler. Sürdürme modunda grup formu görünmez; seçilenler "Seçilenleri üye ekle" butonu ve ayrı bir valid_from alanıyla mevcut gruba eklenir.

Md.6(2) — geçmiş fatura dönemine üyelik yazılamaz

Üyelik başlangıcı, grubun fatura döneminden veya içinde bulunulan fatura döneminden (hangisi erkense) öncesine set edilemez — sunucu 422 ile reddeder ve sihirbaz hata bildirimini gösterir. Tarih alanlarının yardım metinleri bu kuralı açıklar.

Bir tesis aynı dönemde TEK grupta olabilir

Aynı tesisi çakışan bir dönemde ikinci bir gruba eklemeye çalışmak 409 ile reddedilir. Önce mevcut üyeliğin dönemini kapatmak gerekir (bkz. Kurulum Akışı — Adım 4).

Mevcut üyeler adımın üstünde tarihçeli tabloda listelenir (rol, başlangıç, bitiş). "Üyelikten çıkar" butonu üyeliği kalıcı siler — onay dialogu, tarihçeyi korumak için silmek yerine üyeliği bitiş tarihiyle kapatmanın (grup detay sayfasından) tercih edildiğini hatırlatır. Üye ekleme/çıkarma Md.6(5) Ek-1 güncelleme uyarısını tetikler (aşağıya bakın).

• İleri kapısı: grup oluşturulmuş VE en az 1 aktif üye olmalıdır.

---

Adım 3 — Ek-1 (koşullu)

Ek-1, mahsuplaşma başvurusunda şebeke işletmecilerine teslim edilen formdur. Bu adım koşulludur:

Md.6(12) — aynı bölge muafiyeti (otomatik tespit)

Üye tesislerin tamamı aynı şebeke işletmecisi bölgesindeyse sistem bunu otomatik tespit eder ve mavi bilgi kutusu gösterir: "Md.6(12): Ek-1 başvurusu gerekmez". "Muafiyeti işaretle" butonu muafiyeti grup kaydına işler ("Ek-1 muaf" rozeti görünür). Muaf grupta bu adım atlanabilir; alanlar yine de LÜM kaydı için doldurulabilir.

Muaf değilse (veya alanları doldurmak isterseniz), tesis başına Ek-1 alan formu doldurulur:

Alan grubu	Alanlar
Kodlar	EIC kodu, ETSO kodu
Kurumlar	Şebeke işletmecisi, dağıtım şirketi, sayaç okuyan kurum (seçici; listede yoksa "Yeni kurum ekle" mini formuyla oluşturulur ve ilgili seçiciye otomatik atanır)
Tedarikçi	Tedarikçi adı, tedarikçi ETSO-E kodu
Güç	Sözleşme gücü (kW), kurulu güç (kW) — ondalık için nokta veya virgül kullanılabilir

Ek-1 alanları — ne, nereden bulunur, boş bırakırsam (her tesis için ayrı doldurulur):

Alan	Ne?	Zorunlu?	Ne yazacağım / seçeceğim?	Nereden bulunur?	Boş / yanlış olursa?
EIC kodu	EIC (Energy Identification Code — Avrupa enerji kimlik kodu) — tesise/bağlantıya verilen kod	❌ Hayır (≤32 karakter)	Tesisin EIC kodu — genelde 16 karakter, Türkiye'de EPİAŞ'ın verdiği kodlar "40" ile başlar	Şebeke işletmecisi yazışması / EPİAŞ kaydı / bağlantı anlaşması ekleri. Bilmiyorsanız şebeke işletmecinizden isteyin	Boş kalırsa uygunlukta bilgi/uyarı bulgusu olur, hesabı durdurmaz. Zeus formatı zorlamaz (yalnız ≤32 karakter kabul eder)
ETSO kodu	ETSO kodu — EIC'in eski adı; bazı belgelerde hâlâ "ETSO" yazar	❌ Hayır (≤32)	Belgede "ETSO" diye geçen kod (çoğu zaman EIC ile aynı değerdir)	EPİAŞ / şebeke kaydı	EIC ile aynı işlevde; boş kalması hesabı durdurmaz
Sözleşme gücü (kW)	Bağlantı anlaşmasında tanımlı sözleşme gücü	❌ Hayır (≥0, 3 ondalık)	Sayısal kW — ör. 250 veya 250,5 (nokta ya da virgül)	Bağlantı anlaşması veya elektrik faturasındaki "sözleşme gücü" satırı	Boş/yanlışsa Md.6(5) güç kontrolü ve Ek-1 eksik kalır; uygunlukta bulgu
Kurulu güç (kW)	Tesisin kurulu (AC) gücü	❌ Hayır (≥0, 3 ondalık)	Sayısal kW — datasheet'teki toplam AC gücü — ör. 275	Proje / lisans / çağrı mektubu (invertör datasheet'inin toplam AC gücü)	Boş/yanlışsa R009 (üretim kurulu güç beyanı) uyarısı; hesabı durdurmaz
Şebeke işletmecisi	Bölgedeki dağıtım/şebeke işletmecisi kurumu	❌ Hayır (seçim)	Listeden ilgili kurum; yoksa "Yeni kurum ekle"	Ek-1 formu / faturadaki dağıtım şirketi	Üye tesislerin tümü aynı işletmeciyse Md.6(12) muafiyeti; farklıysa Ek-1 gerekir. Boşsa muafiyet hesaplanamaz
Dağıtım şirketi	Tesisin dağıtım şirketi (DSO)	❌ Hayır (seçim)	Listeden — ör. Başkent, GDZ, AYDEM	Elektrik faturası / bölge	Boş kalması hesabı durdurmaz
Sayaç okuyan kurum	OSOS / sayacı okuyan kurum	❌ Hayır (seçim)	Listeden ilgili kurum	Ek-1 formu	Boş kalması hesabı durdurmaz
Tedarikçi adı	Enerji tedarikçisi (perakende satış şirketi)	❌ Hayır (≤200)	Faturadaki tedarikçi adı	Elektrik faturası (tedarikçi/şirket adı)	R003 tek-tedarikçi kontrolüne veri sağlar; boşsa kontrol eksik kalır
Tedarikçi ETSO-E kodu	Tedarikçinin ETSO-E kodu	❌ Hayır (≤32)	Tedarikçiye ait ETSO-E kodu	EPİAŞ kaydı	Boş kalması hesabı durdurmaz

"Yeni kurum ekle" — hangi kurum tipleri var?

Kurum seçicilerinde ilgili kurum yoksa "Yeni kurum ekle" mini formu açılır. Kurum tipi (org_type) yedi değerden biridir: Sayaç okuyan kurum, Şebeke işletmecisi, Dağıtım şirketi, Tedarikçi, Sorumlu tedarikçi, OSB/EB, Piyasa işletmecisi. Kuruma ad + (varsa) organizasyon numarası + EIC/ETSO girilir ve kayıt otomatik olarak açtığınız seçiciye atanır.

Önemli davranışlar:

• Alanlar zorunlu tutulmaz — eksikler uygunluk değerlendirmesinde bulgu olarak görünür. Bu bilinçli bir tasarımdır: eksik alan sihirbazı kilitlemez.
• Tesis seçici ile üye tesisler arasında geçiş yapılır; her tesis "Tesisi kaydet" ile ayrı ayrı kaydedilir.
• İleri kapısı: yalnız kaydedilmemiş değişiklik engeli vardır — formda kaydedilmemiş değişiklik varken İleri geçilemez (amber "Kaydedilmemiş değişiklikler var" notu görünür).
• Sözleşme/kurulu güç alanı değiştirilip kaydedilirse ve grup Ek-1'den muaf değilse, Md.6(5) Ek-1 güncelleme uyarısı tetiklenir (aşağıya bakın).

---

Adım 4 — Özel kurallar

Grubun ve tesislerin özel durumları soru-cevap biçiminde işaretlenir; uygunluk motoru (R001–R013) bu cevaplarla değerlendirme yapar.

Grup özellikleri (onay kutuları):

Onay kutusu	Ne demek?	İşaretlersem ne olur?	Ne zaman işaretlerim?
Mesken grubu (is_mesken_group)	Grup mesken (konut) abonelerinden oluşuyor	Md.7(4): bedelli limit uygulanmaz, aylık hesap yapılır, Limit adımı (6) atlanır, R007 muaf	Abone grubu faturada "mesken" ise
OSB/EB üzerinden beslenen tesis var (has_osb_eb_case)	Grupta en az bir tesis OSB/EB üzerinden besleniyor	R003 tek-tedarikçi istisnası + R012 dalı devreye girer	Tesis OSB/EB (Organize Sanayi Bölgesi / Endüstri Bölgesi) hattından besleniyorsa
Tesisler birden fazla dağıtım bölgesinde (has_multi_region)	Üye tesisler farklı dağıtım bölgelerinde	Hesabı durdurmaz — "yaklaşık hesap" (approximate) uyarısı (R004)	Tesislerin dağıtım şirketleri/bölgeleri farklıysa
5/1-ç özel durumu — öz tüketim (has_special_m51_cedilla)	Üretim + tüketim aynı ölçüm noktasında	İlgili tesislerde "aynı ölçüm noktası anahtarı" doldurulmalı; R006 matrisi çalışır	Tesis Md.5/1-ç kapsamındaysa (çağrı mektubu/lisans)
5/1-d özel durumu — kojenerasyon (has_special_m51_d)	Kojenerasyon tesisi	Çağrı mektubu başvuru tarihi 02/04/2026 ile kıyaslanır; tesiste tarih alanı doldurulmalı	Tesis Md.5/1-d kapsamındaysa

Tesis özel kuralları (tesis seçici ile tesis başına):

Alan	Ne?	Zorunlu?	Ne yazacağım / seçeceğim?	Nereden bulunur?	Boş / yanlış olursa?
Mahsuplaşma rejimi	Tesisin mevzuat sınıflandırması	⚠️ Mahsuplaşma için kritik	Aşağıdaki 7 seçenekten uygun rejim	Çağrı mektubu / lisans belgesi; belirsizse şebeke işletmecinize sorun	Mahsuplaşma için TÜM üyeler LÜM — Yönetmelik Md.26 olmalı; değilse R001 bloklayıcı
Tesis tip kodu	Yönetmelik Md.5/1 hangi bent kapsamında	❌ Hayır (5/1-ç ve 5/1-d için önemli)	Aşağıdaki 11 bentten uygun olanı	Çağrı mektubu / lisans (hangi bent yazıyor)	Boşsa öz tüketim/kojenerasyon özel hesap tipleri tespit edilemez
Abone grubu	Tüketim tesisinin abone (tarife) grubu	⚠️ Tüketim tesisleri için kritik	Aşağıdaki 6 seçenekten faturadaki abone grubu	Elektrik faturası ("abone grubu" satırı)	Grup içi tüketim tesisleri aynı abone grubunda olmalı; değilse R002 bloklayıcı
Aynı ölçüm noktası anahtarı	Aynı ölçüm noktasını paylaşan tesisleri eşleştiren serbest etiket	❌ (5/1-ç, 5/1-d'de gerekli)	Kendi belirlediğiniz kısa etiket — aynı noktayı paylaşan tesislere AYNI metni yazın (ör. OLCUM-A)	Kendiniz belirlersiniz (serbest, ≤80 karakter); sahadaki ölçüm noktası mimarisine göre	Öz tüketim tesisleri aynı anahtarla eşleşmezse R006 matrisi bulgu üretir
Çağrı mektubu başvuru tarihi	5/1-d tesisinin çağrı mektubu başvuru tarihi	❌ (5/1-d'de gerekli)	Başvuru tarihi (takvimden)	Çağrı mektubu belgesi	02/04/2026 öncesi/sonrası farklı hüküm uygulanır; boşsa kıyas yapılamaz
Tesis OSB/EB üzerinden enerji alıyor	Bu tesis özelinde OSB/EB bağlantısı	❌ Hayır (işaret)	İşaretle / boş bırak	OSB/EB bağlantı durumu	R003/R012 dallarını etkiler

Mahsuplaşma rejimi seçenekleri (7):

Seçenek (teknik)	Ekrandaki etiket	Ne zaman bunu seç?
lum_yonetmelik_26	LÜM — Yönetmelik Md.26	Mahsuplaşma için bu olmalı — lisanssız üretim, Yönetmelik Md.26 kapsamı
excluded_yonetmelik_23	Kapsam dışı — Md.23	Tesis Md.23 kapsamında (mahsuplaşma dışı)
excluded_support_period_completed	Kapsam dışı — destek süresi doldu	10 yıllık destek süresi dolmuş (PYS listesine geçmiş)
excluded_yonetmelik_30_8	Kapsam dışı — Md.30/8	Md.30/8 kapsamı
excluded_mixed_23_26	Kapsam dışı — karma 23/26	Karma 23/26 durumu
licensed	Lisanslı	Lisanslı üretim (mahsuplaşma dışı)
unknown	Bilinmiyor	Sınıflandırma henüz belli değil (uygunlukta bulgu üretir)

Tesis tip kodu bentleri (11):

Seçenek (teknik)	Ekrandaki etiket	Ne zaman bunu seç?
m5_1_c	Md.5/1-c	Çağrı mektubu Md.5/1-c bendi
m5_1_cedilla	Md.5/1-ç (öz tüketim — aynı ölçüm noktası)	Öz tüketim; üretim + tüketim aynı ölçüm noktasında
m5_1_d	Md.5/1-d (kojenerasyon — çağrı mektubu)	Kojenerasyon; çağrı mektubu tarihi kıyaslanır
m5_1_h	Md.5/1-h	Çağrı mektubu Md.5/1-h bendi
m5_1_f	Md.5/1-f	Çağrı mektubu Md.5/1-f bendi
m5_1_g	Md.5/1-g	Çağrı mektubu Md.5/1-g bendi
m5_1_g_breve	Md.5/1-ğ	Çağrı mektubu Md.5/1-ğ bendi
m5_1_i_dotless	Md.5/1-ı	Çağrı mektubu Md.5/1-ı bendi
m5_1_i	Md.5/1-i	Çağrı mektubu Md.5/1-i bendi
m11_1	Md.11/1	Md.11/1 kapsamı
m11_3	Md.11/3	Md.11/3 kapsamı

Abone grubu seçenekleri (6):

Seçenek (teknik)	Ekrandaki etiket	Ne zaman bunu seç?
mesken	Mesken	Konut aboneliği
ticarethane	Ticarethane	İş yeri / ticari abonelik
sanayi	Sanayi	Sanayi aboneliği
tarimsal_sulama	Tarımsal sulama	Tarımsal sulama aboneliği
aydinlatma	Aydınlatma	Genel aydınlatma aboneliği
other	Diğer	Yukarıdakilerin hiçbiri değil

Bent tiplerinin mevzuat karşılıkları ve uygunluk kurallarındaki rolü için bkz. Uygunluk Kuralları. Alanların adımdan bağımsız tanımı için Alan Sözlüğü.

Ara uygunluk değerlendirmesi: adımın sonunda "Uygunluğu değerlendir" butonu R001–R013 motorunu çalıştırır; sonuçlar kural kodu + şiddet rozeti (bilgi/uyarı/hata/engelleyici) + sonuç rozeti (geçti/kaldı/denetlenmedi/ uygulanmaz) + mesaj olarak listelenir.

Bloklayıcı bulgu İleri geçişi ENGELLEMEZ

Bu adımın kapısı yalnız değerlendirmenin en az bir kez koşulmuş olmasıdır. Bloklayıcı bulgular olsa bile İleri gidilebilir — hesap durmaz; Md.6(4)/9(6) gereği üretim bedelsiz riskiyle simüle edilir (bkz. Adım 7).

---

Adım 5 — Sayaç + ESS

Bu adım üç bölümden oluşur. Kapısı serbesttir — ana sayaç eksikliği uygunlukta bloklayıcı bulgu (R003M) olarak Önizleme adımında yakalanır.

Sayaç atama (gömülü sihirbaz)

Tesis seçicisinden bir üye tesis seçilir; o tesis için Sayaç Atama ve Kanal Eşleme Sihirbazı (PR-5) bu adımın içine gömülü olarak açılır — davranışı birebir aynıdır (ölçüm noktası, cihaz + rol, kanal eşleme, saatlik enerji önizlemesi). Ana sayaç ataması yapıldığında uygunluk sonuçları tazelenir; Önizleme adımı güncel sonuçla açılır.

Ana sayaç atanmazsa R003M

main_production (ana üretim) sayacı atanmazsa uygunluk değerlendirmesinde bloklayıcı bulgu (R003M) oluşur — adımın üstündeki bilgi kutusu bunu hatırlatır.

İnvertör tipi önerileri

Tesislerdeki invertör cihazları için sistem, cihaz şablon adından tip önerisi üretir (örn. SOFAR/HYD şablonları → ESS invertörü; SUN2000/KTLX/grid-tie şablonları → şebeke invertörü; belirsiz → öneri yok). Tablo cihaz, şablon, mevcut tip, önerilen tip ve gerekçe gösterir.

• Otomatik atama yoktur — yalnız işaretlediğiniz satırlar "Seçilenleri uygula" ile uygulanır (yanlış-sınıflama riskine karşı bilinçli tasarım). Önerisi olmayan satır seçilemez.
• Uygulama atomiktir: listedeki tek bir geçersiz kayıt tüm işlemi durdurur (kısmi uygulama yok); hata bildirimi ayrıntıyı gösterir.

ESS (depolama) bilgileri

Tesis başına doldurulan ESS (Enerji Depolama Sistemi — batarya) mini formu:

Alan	Ne?	Zorunlu?	Ne yazacağım / seçeceğim?	Nereden bulunur?	Boş / yanlış olursa?
Tesiste ESS var	Tesiste batarya/depolama olup olmadığı (kapı)	❌ Hayır	Batarya varsa işaretle; yoksa boş bırak	Sahada batarya var mı	İşaretlenmezse kapasite alanları etkinleşmez ve gönderilmez
Üretim ölçüm topolojisi	PV ve ESS'in sayaca göre konumu	❌ Hayır	Aşağıdaki 5 seçenekten sahadaki mimariye uyanı	Sahadaki ölçüm/pano mimarisi	Sayaç arkası PV + ESS seçilirse SKB riski amber uyarısı çıkar
ESS toplam güç (kW)	Bataryanın toplam gücü	❌ (ESS varsa girin)	Sayısal kW	ESS datasheet	Boş kalması hesabı durdurmaz
ESS toplam enerji (kWh)	Bataryanın toplam enerji kapasitesi	❌ (ESS varsa girin)	Sayısal kWh	ESS datasheet	Boş kalması hesabı durdurmaz
Min / Maks SOC (%)	İzin verilen en düşük / en yüksek şarj yüzdesi	❌ Hayır	0–100 arası; min < maks olmalı	ESS ayarı / datasheet	min ≥ maks ise reddedilir
Tur verimi	Şarj-deşarj tur verimi (round-trip)	❌ Hayır	0–1 arası — ör. 0,92	ESS datasheet	Boş kalması hesabı durdurmaz

Üretim ölçüm topolojisi seçenekleri (5):

Seçenek (teknik)	Ekrandaki etiket	Ne zaman bunu seç?
pv_only_meter	Yalnız PV sayacı	Sayaç yalnız PV üretimini ölçüyor; ESS yok veya ayrı ölçülüyor
pv_plus_ess_behind_meter	Sayaç arkası PV + ESS	PV ve ESS aynı sayacın arkasında — SKB riski taşır
ess_separate_meter	ESS ayrı sayaç	ESS'in kendi ayrı sayacı var
consumption_side_ess	Tüketim tarafı ESS	ESS tüketim tarafında konumlanmış
unknown	Bilinmiyor	Ölçüm mimarisi henüz belli değil

Sayaç arkası PV + ESS = SKB riski

"Sayaç arkası PV + ESS" topolojisi seçildiğinde amber uyarı görünür: bu topoloji SKB (sistem kullanım bedeli) riski taşır — şebekeden şarj, üretimden ayrıştırılamaz ve üretimin bedelsiz sanal sayaca ayrıştırılması / SKB'ye yazılması riskleri doğar.

---

Adım 6 — Limit

Mesken dışı gruplarda her tüketim (veya karma) rollü üye tesis için ilgili yıla ait bir bedelli limit hesabı açılır (Md.7(1)). Limit hesabı olmayan tüketim tesisi bloklayıcı bulgu (R007) üretir — ama hesap yine de bedelsiz riskle simüle edilir (adım kapısı serbesttir).

• Tüketim tesisi seçici yalnız tüketim/karma rollü üyeleri listeler; seçilen tesisin mevcut limit hesapları (yıl + başlangıç limiti + kaynak) varsa üstte gösterilir.
• Yeni limit hesabı formu: yıl, başlangıç limiti (kWh — zorunlu), limit kaynağı, resmî limit (kWh, opsiyonel), kaynak referansı, not.
• Limit kaynağı seçenekleri: Manuel / Müşteri beyanı / LÜM raporu / Şebeke işletmecisi / Hesaplanan. "Müşteri beyanı" seçilirse bilgi kutusu görünür: resmî LÜM verisi gelene kadar beyan esas alınır ve uygunluk sonuçlarında bilgi rozeti taşınır.
• Tesis × yıl tekildir — aynı tesis + yıl için ikinci hesap açma denemesi "Bu tesis ve yıl için limit hesabı zaten var" hatasıyla reddedilir (409).

Limit hesabı alanları — tüketim/karma tesis başına:

Alan	Ne?	Zorunlu?	Ne yazacağım / seçeceğim?	Nereden bulunur?	Boş / yanlış olursa?
Yıl	Limitin geçerli olduğu fatura yılı	✅ Evet	4 haneli yıl — ör. 2026	Fatura dönemi yılı	Tesis × yıl tekildir; aynı tesis+yıl ikinci kez → 409
Başlangıç limiti (kWh)	Tesisin dönem başı bedelli tüketim limiti	✅ Evet (≥0, 3 ondalık)	Sayısal kWh — ör. 120000	LÜM (Lisanssız Üretim Modülü) resmî limiti; LÜM verisi gelene kadar müşteri beyanı esas alınır	Boşsa limit hesabı açılamaz; mesken dışı tüketim tesisi limitsizse R007 bloklayıcı
Resmî limit (kWh)	LÜM raporundaki güncel resmî limit	❌ Hayır	Sayısal kWh (varsa)	LÜM raporu	Boş kalması sorun değil; başlangıç limiti esas alınır
Limit kaynağı	Limit değerinin nereden geldiği	❌ Hayır	Aşağıdaki 5 seçenekten belge tipinize uyanı	Elinizdeki belge tipi	Müşteri beyanı seçilirse uygunlukta bilgi rozeti taşınır
Kaynak referansı	Belge/rapor numarası	❌ Hayır (≤200)	LÜM rapor no / belge no	İlgili belge	Etkisi yok — yalnız izlenebilirlik için
Not	Serbest açıklama	❌ Hayır (≤500)	İstediğiniz açıklama	—	Etkisi yok

Limit kaynağı seçenekleri (5):

Seçenek (teknik)	Ekrandaki etiket	Ne zaman bunu seç?
manual	Manuel	Değeri elle girdiniz; belirli bir belgeye dayanmıyor
customer_declared	Müşteri beyanı	Müşterinin beyan ettiği limit (LÜM verisi gelene kadar)
lum_report	LÜM raporu	Değer LÜM resmî raporundan alındı
grid_operator	Şebeke işletmecisi	Değer şebeke işletmecisinden alındı
calculated	Hesaplanan	Değer başka verilerden hesaplandı

Mesken grubu — adım atlanır

Grup mesken olarak işaretliyse bu adım form yerine bilgi kutusu gösterir: Md.7(4) gereği mesken gruplarında bedelli limit uygulanmaz (aylık hesap; R007 muaf) — doğrudan İleri geçilir.

Limitlerin nasıl hesaplandığı, hareket defteri ve transfer için bkz. Bedelli Limit Hesapları.

---

Adım 7 — Önizleme

Adıma girildiğinde final uygunluk değerlendirmesi bir kez otomatik koşulur; "Yeniden değerlendir" butonuyla istediğiniz zaman tekrarlayabilirsiniz (son değerlendirme zamanı gösterilir).

Sonuç üç sınıftan biriyle sunulur:

Sınıf	Renk	Anlamı
Hesaplanabilir	Yeşil	Tüm bloklayıcı kurallar geçti; saatlik mahsuplaşma hesabı normal akışta koşar
Uyarılarla hesaplanır	Amber	Bloklayıcı bulgu yok; listelenen uyarı/bilgi bulguları hesap kalitesini etkileyebilir
Bloklayıcı — bedelsiz riskiyle simüle edilir	Kırmızı	Hesap DURMAZ: Md.6(4)/9(6) gereği üretim bedelsiz sanal sayaca yazılır ve bedelsiz risk (TL) grup panosunda izlenir. Bulguları giderdikçe yeniden değerlendirin

Ayrıca iki liste gösterilir:

• "Veri kaynağı bağlanınca kontrol edilecek kurallar" — bu ayrı bölümde yalnızca gerçekten bloklayıcı olup henüz değerlendirilememiş (denetlenmedi / not_checked durumundaki) kurallar (örn. R00L — bedelli limit) listelenir: gerekli veri kaynağı bağlandığında değerlendirilir ve sonucu etkileyebilir. R008 / R009 / R011 kuralları uyarı (warning) şiddetindedir — bunlar not_checked olsa bile bu bölümde değil, aşağıdaki genel Bulgular listesinde görünür ve grubu bloklamaz. Bu ayrım önemlidir: yalnızca bloklayıcı sınıftan bir kural not_checked ise grup "uygun" sayılmaz; uyarı sınıfı bir kuralın not_checked kalması grubun geçerliliğini engellemez (bkz. Uygunluk Kuralları).
• Bulgular — kalan tüm kural sonuçları (kural kodu + şiddet + durum + mesaj).

"Kurulumu tamamla" butonu kurulum bitti bildirimini gösterir ve sizi grup detay sayfasına yönlendirir — uygunluk durumu ve hesap sonuçları oradan izlenir (bkz. Web Arayüzü — Grup Detayı).

---

Md.6(5) — Ek-1 güncelleme uyarısı

Sihirbaz kullanımı sırasında aşağıdakilerden biri olursa, sihirbazın üstünde amber bir uyarı bandı belirir:

• Üye ekleme veya çıkarma (Adım 2),
• Bir tesiste sözleşme gücü / kurulu güç değişikliğinin kaydedilmesi (Adım 3).

Uyarı metni: "Md.6(5): Üyelik veya güç bilgisi değişti — Ek-1 formu güncellenip gruptaki TÜM şebeke işletmecilerine yeniden teslim edilmelidir."

Muaf gruplar hariç

Grup Ek-1'den muafsa (Md.6(12) — tüm tesisler aynı şebeke işletmecisi bölgesinde) bu uyarı gösterilmez; yeniden teslim şartı muaf gruplar için geçerli değildir.

---

Sık karşılaşılan durumlar

Durum	Açıklama / çözüm
İleri butonu pasif (Adım 1)	Kapsam seçilmemiş veya "aynı resmî taraf" beyanı kaydedilmemiş
İleri butonu pasif (Adım 2)	Grup oluşturulmamış veya hiç aktif üye yok
İleri butonu pasif (Adım 3)	Formda kaydedilmemiş değişiklik var — önce "Tesisi kaydet"
İleri butonu pasif (Adım 4)	Ara uygunluk değerlendirmesi hiç koşulmamış — "Uygunluğu değerlendir"
Beyan 409 ile reddedildi	Daha zayıf kaynakla yeniden beyan denemesi — aynı/daha güçlü kaynak seçin
Üye ekleme 422	Md.6(2): valid_from geçmiş fatura dönemine denk geliyor — tarihi düzeltin
Üye ekleme 409	Tesis aynı dönemde başka grupta — önce eski üyeliğin dönemini kapatın
Limit hesabı 409	Aynı tesis + yıl için hesap zaten var — mevcut hesabı kullanın
Sihirbaz görünmüyor, kilit kartı var	manage:netting yetkiniz yok — yöneticinize başvurun

Hata kodlarının tam listesi için bkz. SSS ve Sorun Giderme.

---

İlgili sayfalar

• Alan Sözlüğü — sihirbazdaki her alanın adımdan bağımsız, tek listede "bu ne / nereden bulunur / boş bırakırsam ne olur" tanımı.
• Kurulum Akışı (Uçtan Uca) — aynı kurulumun API düzeyindeki referansı (otomasyon / ileri düzey).
• Web Arayüzü — /mahsuplasma sayfa ağacı ve ekranlar.
• Sayaç Atama ve Kanal Eşleme — Adım 5'e gömülü sihirbazın ayrıntılı kılavuzu.
• Uygunluk Kuralları — R001–R013 katalog ve severity mantığı.
• Bedelli Limit Hesapları — Adım 6'nın arka planı.
• SSS ve Sorun Giderme — hata kodları.