Alan Sözlüğü — Master Referans

Bu sayfa, Mahsuplaşma modülündeki her form alanının ne olduğunu, hangi birimle yazıldığını, zorunlu olup olmadığını, değerini nereden bulacağınızı ve boş bırakırsanız / yanlış seçerseniz ne olacağını tek bir yerde toplayan merkezi başvuru sayfasıdır. Kurulum sırasında "şu alan neydi?" veya "bunun değerini nereden alacağım?" diye takıldığınızda ilk bakacağınız yer burasıdır.

Diğer kılavuz sayfaları (özellikle Grup Kurulum Sihirbazı ve Sayaç Atama ve Kanal Eşleme) adım adım ne yapacağınızı anlatır; bu sayfa ise her alanı sözlük gibi açıklar.

Nasıl okunur?

Her alan için şu beş soruyu kapatmaya çalıştık:

1. Bu alan ne? (anlam)
2. Zorunlu mu? (✅ zorunlu / ❌ opsiyonel)
3. Ne yazacağım / hangi seçeneği seçeceğim? (değer / birim)
4. Değeri NEREDEN bulurum? (kaynak belge)
5. Boş bırakır / yanlış seçersem ne olur? (sonuç)

Tablolarda kod_adı biçiminde gösterilen değerler, yazılımın içindeki teknik anahtarlardır (hata mesajlarında ve API'de bu adla görünür); yanında düz-Türkçe karşılığı verilmiştir.

---

1. Önce şunu bilin: değeri NEREDEN bulurum?

Mahsuplaşma alanlarının değerleri hep aynı birkaç kaynaktan gelir. Aşağıdaki karar diyagramı, aradığınız bilgiye göre hangi belgeye bakacağınızı gösterir:

Kaynak → hangi alanları verir? (hızlı referans)

Kaynak	Bu kaynaktan bulabileceğiniz alanlar
EPİAŞ kaydı (Şeffaflık Platformu / LÜM kaydı)	eic_code, etso_code, supplier_etso_e_code; ayrıca PTF/SMF piyasa fiyatları (yalnız bilgi amaçlı — bkz. EPİAŞ Piyasa Fiyatları)
Şebeke / dağıtım işletmecisi (DSO)	grid_operator_id, distribution_company_id, meter_reading_org_id, eic_code/etso_code teyidi
Elektrik faturası	abone_grubu, contract_power_kw ("sözleşme gücü" satırı), supplier_name, dağıtım şirketi adı
LÜM (Lisanssız Üretim Modülü)	initial_limit_kwh (resmî), current_official_limit_kwh, limit_source = lum_report — LÜM verisi gelene kadar müşteri beyanı esas alınır
Lisans belgesi / çağrı mektubu	Tesis adı, installed_power_kw, facility_type_code (hangi bent), mahsuplasma_regime, call_letter_application_date
ESS datasheet (batarya teknik dokümanı)	ess_total_capacity_kw, ess_total_energy_kwh, ess_min/max_soc_pct, ess_round_trip_efficiency
Sahadaki ölçüm kurulumu	production_metering_topology, energy_semantics, sign_convention, scale_factor, kanal adları
Zeus platform verisi	subregion_id (alt bölge), device_id (cihaz), cihaz template'indeki kanal/register adları
Serbest — siz belirlersiniz	name (kapsam/grup adı), notes, external_party_ref, same_measurement_point_key, year

VKN istenmez, saklanmaz

Mahsuplaşmada VKN (Vergi Kimlik Numarası) hiçbir yerde istenmez ve saklanmaz (KVKK / veri minimizasyonu). Kapsam adı yalnızca Zeus içi bir takma addır (alias) — gerçek VKN değildir. Ayrıntı: Grup Kurulum Sihirbazı — Adım 1.

---

2. Kurulum Sihirbazı alanları (7 adım)

Sihirbaz yedi adımdan oluşur: Kapsam → Tesisler → Ek-1 → Özel Kurallar → Sayaç + ESS → Limit → Önizleme. Ekran akışı için bkz. Grup Kurulum Sihirbazı. Her adımdaki alanlar aşağıda gruplanmıştır.

Her adım anında kaydedilir

Her alan grubu "kaydet" butonuyla anında sunucuya yazılır (tarayıcıda taslak tutulmaz). Sihirbazı yarım bırakmak güvenlidir — kaldığınız adımdan devam edebilirsiniz.

Adım 1 — Kapsam

Alan	Ne?	Zorunlu	Ne yazılır / NEREDEN	Boş/yanlış olursa
Kapsam adı (name)	Aynı resmî tarafa ait tesis kümesinin Zeus-içi takma adı (≤120 karakter)	✅	Serbest — siz belirlersiniz. VKN DEĞİL	Boş bırakılamaz; İleri geçilemez
Not (notes)	Serbest açıklama (≤500)	❌	Serbest	Etkisi yok
Harici referans (external_party_ref)	Müşterinin kendi kayıt sistemindeki referans / LÜM alias (≤80)	❌	Müşterinin iç kayıt sistemi (opsiyonel)	Sonraki LÜM eşleştirmesini zorlaştırabilir
Beyan kaynağı (declaration_source)	"Tesisler aynı resmî tarafa ait" beyanının dayanağı	✅	Elinizdeki belge tipi (bkz. enum tablosu)	Beyan kaydedilmeden İleri geçilemez; zayıf kaynakla üzerine yazma 409 ile reddedilir

Provenance (kaynak gücü) koruması

Kapsam daha güçlü bir kaynakla beyanlıysa, daha zayıf kaynakla yeniden beyan 409 ile reddedilir. Güç sırası: Müşteri beyanı < Resmî belge < LÜM raporu / GTŞ raporu. not_checked bir beyan kaynağı olarak kabul edilmez.

Adım 2 — Tesisler + grup

Grup formu (yeni kurulumda):

Alan	Ne?	Zorunlu	Ne yazılır / NEREDEN	Boş/yanlış olursa
Grup adı (name)	Grubun Zeus-içi adı (tenant içinde tekil, ≤120)	✅	Serbest	Boş geçilemez
Fatura dönemi başlangıcı (fatura_donemi_baslangic)	Md.6(2) "üyelik geriye yazılamaz" referans tarihi	✅	Fatura döneminden — takvim ayı başı (ör. ayın 1'i)	Yanlış tarih üyelik başlangıcı kurallarını kaydırır
Üyelik başlangıcı (member.valid_from)	Eklenen tüm üyelere uygulanan başlangıç	✅	Fatura döneminden; varsayılan bugün	Fatura döneminden öncesine set edilirse 422

Yeni tesis (temel alanlar):

Alan	Ne?	Zorunlu	Ne yazılır / NEREDEN	Boş/yanlış olursa
Tesis adı (name)	Tesisin adı (≤160)	✅	Proje / lisans belgesi	Boş geçilemez
Tesis rolü (facility_role)	Tesisin işlevi	✅	production/consumption/mixed (bkz. enum). GES = Üretim, abone = Tüketim	Yanlış rol uygunluk ve limit adımlarını bozar
Alt bölge (subregion_id)	Zeus saha yapısındaki alt bölge	❌	Zeus platform verisi (saha ağacınız)	Boşsa saha eşlemesi yapılmaz (opsiyonel)

İki bloklayıcı kural (Adım 2)

• Md.6(2): Üyelik başlangıcı fatura döneminden öncesine yazılamaz → 422.
• Bir tesis aynı dönemde yalnız bir grupta olabilir → çakışma 409.

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

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

Üye tesislerin tamamı aynı şebeke işletmecisi bölgesindeyse Ek-1 muaftır (sistem otomatik tespit eder, "Muafiyeti işaretle"). Muaf grupta bu adımın alanları zorunlu değildir (yine de LÜM kaydı için doldurulabilir).

Bu adımdaki alanların hiçbiri teknik olarak zorunlu değildir — eksik alan sihirbazı kilitlemez, ama uygunluk değerlendirmesinde bulgu olarak görünür.

Alan	Ne?	Birim	Ne yazılır / NEREDEN	Boş/yanlış olursa
EIC kodu (eic_code)	Energy Identification Code — Avrupa enerji kimlik kodu (≤32)	metin	EPİAŞ / şebeke kaydı (16 hane, "40…" ile başlar)	Ek-1'de eksik bulgu; başvuru gecikebilir
ETSO kodu (etso_code)	ETSO kodu (EIC'in eski adı, ≤32)	metin	EPİAŞ / şebeke kaydı	Eksik bulgu
Kurulu güç (installed_power_kw)	Tesisin kurulu gücü (≥0, 3 ondalık)	kW	Proje / lisans / çağrı mektubu (datasheet toplam AC gücü)	R009 (üretim gücü beyanı) uyarısı; Md.6(5) uyarısı tetiklenebilir
Sözleşme gücü (contract_power_kw)	Bağlantı sözleşme gücü (≥0, 3 ondalık)	kW	Elektrik faturası ("sözleşme gücü" satırı) / bağlantı anlaşması	Eksik bulgu; Md.6(5) uyarısı
Şebeke işletmecisi (grid_operator_id)	Bölgedeki dağıtım/şebeke işletmecisi	seçim (kurum)	Ek-1 formu / faturadaki dağıtım şirketi	Md.6(12) muafiyet tespiti yapılamaz
Dağıtım şirketi (distribution_company_id)	DSO (dağıtım şirketi)	seçim	Fatura / bölge (ör. Başkent, GDZ)	Eksik bulgu
Sayaç okuyan kurum (meter_reading_org_id)	OSOS / sayaç okuyan kurum	seçim	Ek-1 formu	Eksik bulgu
Tedarikçi adı (supplier_name)	Enerji tedarikçisi (≤160)	metin	Elektrik faturası (tedarikçi adı)	Eksik bulgu
Tedarikçi ETSO-E kodu (supplier_etso_e_code)	Tedarikçinin ETSO-E kodu (≤32)	metin	EPİAŞ kaydı	Eksik bulgu

Kurum listede yoksa

Şebeke işletmecisi / dağıtım şirketi / sayaç okuyan kurum seçicilerinde kurum yoksa "Yeni kurum ekle" ile oluşturulur: kurum tipi (org_type, bkz. enum), ad, organization_id, EIC/ETSO.

Adım 4 — Özel kurallar

Grup özellikleri (onay kutuları):

Alan	Ne yapar?	NEREDEN karar verilir
Mesken grubu (is_mesken_group)	Md.7(4): bedelli limit yok, aylık hesap, Limit adımı atlanır, R007 muaf	Abone grubu mesken mi? (faturadan)
OSB/EB üzerinden beslenen tesis var (has_osb_eb_case)	R003 tek-tedarikçi istisnası + R012 dalı	Grupta OSB/EB bağlantılı tesis var mı?
Birden fazla dağıtım bölgesinde (has_multi_region)	"Yaklaşık hesap" uyarısı (hesabı durdurmaz)	Tesislerin bölgeleri farklı mı?
5/1-ç özel durumu (has_special_m51_cedilla)	Üretim + tüketim aynı ölçüm noktası	Tesis Md.5/1-ç (öz tüketim) mi?
5/1-d özel durumu (has_special_m51_d)	Çağrı mektubu 02/04/2026 kıyası	Tesis Md.5/1-d (kojenerasyon) mi?

Tesis özel kuralları (tesis başına):

Alan	Ne?	Ne yazılır / NEREDEN	Boş/yanlış olursa
Mahsuplaşma rejimi (mahsuplasma_regime)	Mevzuat sınıflandırması	Bkz. enum. Belirsizse çağrı mektubu / lisans belgesi	R001 bloklayıcı: mahsuplaşma için tüm üyeler lum_yonetmelik_26 olmalı
Tesis tip kodu (facility_type_code)	Yönetmelik md.5/1 bendi	Bkz. enum. Çağrı mektubu / lisans	Özel hesap dalları (5/1-ç/d) tetiklenmez
Abone grubu (abone_grubu)	Tüketim tesisinin abone grubu	Bkz. enum. Elektrik faturası ("abone grubu" satırı)	R002 bloklayıcı: tüketim tesisleri aynı abone grubunda olmalı
Aynı ölçüm noktası anahtarı (same_measurement_point_key)	Aynı ölçüm noktasını paylaşan tesislere verilen serbest etiket (≤80)	Serbest — aynı noktayı paylaşanlara AYNI etiket (5/1-ç, 5/1-d)	5/1-ç/d matrisi (R006) doğru kurulmaz
Çağrı mektubu başvuru tarihi (call_letter_application_date)	5/1-d için başvuru tarihi	Çağrı mektubu belgesi	02/04/2026 kıyası yapılamaz
OSB/EB üzerinden enerji alıyor (receives_energy_from_osb_eb)	OSB/EB bağlantısı işareti	OSB/EB bağlantısı var mı?	R012 dalı doğru çalışmaz
Üretici tarife grubu (producer_tariff_group)	Üretim tesisinin SKB fiyat tabanı LÜ grubu override'ı (veriş yönlü dağıtım bedeli, Md.4-l). Opsiyonel — yalnız üretim/karma tesiste anlamlı	lisanssiz_uretici_1 (LÜ1; güneş dışı yenilenebilir) / lisanssiz_uretici_2 (LÜ2; güneş). Bkz. enum. Belirsizse boş bırakın	Boş = override yok: SKB fiyat tabanı source_type'tan türetilir (güneş→LÜ2, diğer yenilenebilir→LÜ1) + türev/varsayılan uyarısı (Hesap Çekirdeği — SKB). Yanlış seçim SKB tutarını yanlış tabana bağlar

"Uygunluğu değerlendir" bir kez koşulmalı

Bu adımın İleri kapısı yalnızca değerlendirmenin en az bir kez koşulmuş olmasıdır. Bloklayıcı bulgu olsa bile İleri gidilebilir — hesap durmaz, üretim bedelsiz riskiyle simüle edilir (bkz. Adım 7).

Adım 5 — Sayaç + ESS

Sayaç atama alanları için bkz. bölüm 3 — Sayaç Atama / Kanal Eşleme. Bu adımdaki ESS (batarya) alanları:

Alan	Ne?	Birim	Ne yazılır / NEREDEN	Boş/yanlış olursa
Tesiste ESS var (has_ess)	Bataryası var mı?	onay kutusu	İşaretli değilse kapasite alanları gönderilmez	ESS meta kaydedilmez
ESS toplam güç (ess_total_capacity_kw)	Bataryanın toplam gücü	kW	ESS datasheet	SKB/topoloji projeksiyonu eksik kalır
ESS toplam enerji (ess_total_energy_kwh)	Bataryanın enerji kapasitesi	kWh	ESS datasheet	Aynı
Min/Maks SOC (ess_min_soc_pct / ess_max_soc_pct)	Kullanılabilir şarj aralığı (0–100, min < max)	%	ESS ayarı / datasheet	Aynı
Tur verimi (ess_round_trip_efficiency)	Şarj-deşarj tur verimi	oran (0–1), ör. 0.92	ESS datasheet	Aynı
Üretim ölçüm topolojisi (production_metering_topology)	Sahadaki ölçüm mimarisi	seçim	Bkz. enum. Sahadaki ölçüm kurulumu	Yanlış seçim SKB riskini gizler / yanlış hesaplar

"Sayaç arkası PV + ESS" = SKB riski

pv_plus_ess_behind_meter topolojisi SKB (sistem kullanım bedeli) riski taşır: şebekeden şarj, üretimden ayrıştırılamaz. Bu seçildiğinde sihirbaz amber bir uyarı gösterir.

Adım 6 — Limit

Mesken gruplarında atlanır. Her tüketim/karma tesis için ilgili yıla ait bir bedelli limit hesabı açılır.

Alan	Ne?	Birim	Zorunlu	Ne yazılır / NEREDEN	Boş/yanlış olursa
Yıl (year)	Limitin geçerli olduğu yıl (2000–2100)	yıl	✅	Fatura dönemi yılı	Boş geçilemez; tesis×yıl tekildir → 409
Başlangıç limiti (initial_limit_kwh)	Yıllık bedelli üretim limiti	kWh	✅	LÜM resmî limiti; gelene kadar müşteri beyanı	Boşsa R007 bloklayıcı (mesken hariç)
Resmî limit (current_official_limit_kwh)	LÜM'den gelen resmî limit	kWh	❌	LÜM raporu (varsa)	Boşsa beyan esas alınır
Limit kaynağı (limit_source)	Limit değerinin dayanağı	seçim	❌	Bkz. enum. Belge tipine göre	Boşsa kaynak izlenemez
Kaynak referansı (source_ref)	Belge no / referans (≤120)	metin	❌	Belge numarası	Etkisi yok
Not (notes)	Serbest açıklama (≤500)	metin	❌	Serbest	Etkisi yok

Limitlerin nasıl işlediği (hareket defteri, transfer) için bkz. Bedelli Limit Hesapları.

Adım 7 — Önizleme

Form yok. Uygunluk (R001–R013 + R00T/R00L/R003M) sonucu üç sınıftan biriyle sunulur:

Sınıf	Renk	Anlamı
Hesaplanabilir (valid)	Yeşil	Tüm bloklayıcı kurallar geçti
Uyarılarla hesaplanır (valid_with_warnings)	Amber	Bloklayıcı yok; uyarı/bilgi bulguları var
Bloklayıcı — bedelsiz riskiyle simüle edilir (blocked)	Kırmızı	Hesap durmaz; üretim bedelsiz sanal sayaca yazılır (Md.6(4)/9(6))

Ayrı bir bölüm "veri kaynağı bağlanınca kontrol edilecek" (not_checked) kuralları listeler — örn. R008 / R009 / R011 / R00L. Ancak bu kuralların hepsi bloklayıcı değildir: yalnız R00L bloklayıcıdır; R008 / R009 / R011 uyarı (warning) şiddetindedir ve not_checked kalmaları grubu bloklamaz — grup yine "uygun" (valid) sayılabilir. Grup ancak bloklayıcı sınıftan bir kural (ör. R00L) not_checked iken "uygun" sayılamaz. Tam severity tablosu için bkz. Uygunluk Kuralları.

---

3. Sayaç Atama / Kanal Eşleme alanları

Bu sihirbaz (4 adım: Ölçüm Noktası → Cihaz & Rol → Kanal Eşleme → Önizleme) fiziksel cihazı bir ölçüm rolüne bağlar. Ayrıntı: Sayaç Atama ve Kanal Eşleme.

Alan	Ne?	Zorunlu	Ne yazılır / NEREDEN	Boş/yanlış olursa
Alt bölge (subregion_id)	Cihazın bağlı olduğu alt bölge	✅	Zeus saha yapısı	Cihaz seçici daralamaz
Cihaz (device_id)	Sayaç olarak atanacak fiziksel cihaz	✅	Zeus cihaz listesi (alt bölgeye göre daralır)	Atama yapılamaz
Ölçüm rolü (meter_role)	Cihazın mahsuplaşmadaki rolü	✅	Bkz. enum. İlk 4 = ANA rol	İlk-4 rolde dönem çakışması 409; main_production yoksa R003M bloklayıcı
Geçerlilik başlangıcı (valid_from)	Atamanın başladığı an	✅	Fatura dönemi başı (iş kararı — sessiz "şimdi" yasak)	Yanlış tarih geçmiş dönem hesabını bozar
Çekiş kanalı (energy_channel_import)	İçe (şebekeden çekiş) enerji kanalı	❌	Cihaz template'indeki register/kanal adı	Enerji çözümlemesi eksik
Veriş kanalı (energy_channel_export)	Dışa (şebekeye veriş) enerji kanalı	❌	Cihaz template kanal adı	Aynı
Güç kanalı (power_channel)	Anlık güç kanalı	❌	Cihaz template kanal adı	Güçten integrasyon yapılamaz
SOC kanalı (soc_channel)	Batarya şarj durumu kanalı	❌	Cihaz template kanal adı	SOC izlenemez
Enerji anlamı (energy_semantics)	Kanal değerinin anlamı	❌	Bkz. enum	Yanlışsa enerji yanlış hesaplanır
İşaret yönü (sign_convention)	Kanal işaretinin yorumu	❌	Bkz. enum	Yanlış yön çekiş/verişi ters çevirir
Ölçek çarpanı (scale_factor)	Ham değerin çarpanı (>0)	❌	CT oranı vb.; boşsa 1	Yanlış çarpan değerleri ölçekler
Faturaya esas (is_billing_relevant)	Bu kanal faturaya girer mi?	❌	Varsayılan true	—

Cihaz template kanal adlarını nerede görürüm?

Bir cihazın kanal/register adlarını görmek için: Cihazlar sayfasında ilgili cihazı açın → Cihaz Şablonu (Device Template) register listesine bakın. Buradaki register adları, kanal eşleme alanlarına yazacağınız değerlerdir.

---

4. Regüle Tarife alanları (superadmin)

Regüle tarife ulusal veridir ve yalnız süper yönetici girer (/console/regulated-tariffs, CSV/XLSX import). Tam kılavuz: Regüle Tarifeler.

Zorunlu başlıklar: valid_from, billing_period, abone_grubu, price_purpose, price.

Alan	Ne?	Ne yazılır / NEREDEN
valid_from / valid_to / billing_period	Tarife geçerlilik tarihleri (ISO YYYY-MM-DD)	EPDK tarife tablosu dönemi
abone_grubu	Abone grubu	Bkz. enum + tarife satırına özel lisanssiz_uretici_1/lisanssiz_uretici_2 (veriş yönlü dağıtım bedeli — detay; tesis formunda yoktur). EPDK tablosu
price_purpose	Tarife kaleminin amacı	Bkz. enum. EPDK kalemine göre
time_segment	Zaman dilimi (tek/gunduz/puant/gece; tek-zamanlı = boş)	EPDK tablosu
step_no	Kademe no (kademesizse boş)	EPDK
unit	Fiyat birimi	TRY_PER_KWH/TRY_PER_MWH/kurus_per_kwh/kurus_per_kw_month/kurus_per_kvarh; varsayılan TRY_PER_KWH. Amaç–birim eşlemesi import'ta doğrulanır (detay)
price	Fiyat değeri (>0)	EPDK'nın yayımladığı tarife tablosu

Import ATOMİKTİR

Tek bir satır hatalıysa hiçbir satır yazılmaz. ≤2 MB, ≤10.000 satır; CSV-injection koruması (=, +, @, -, tab ile başlayan hücre reddedilir). Onay akışı: draft → approved (değişmez) → archived.

---

5. Enum (seçenek) sözlüğü — teknik değer + düz-Türkçe + ne zaman seç

Aşağıdaki tablolar, formlardaki açılır listelerin her seçeneğini açıklar. Solda teknik değer (kod), ortada düz-Türkçe karşılığı, sağda ne zaman bunu seçmelisiniz.

Tesis / üye rolü (facility_role / member_role)

Değer	Türkçe	Ne zaman seçilir
production	Üretim	Yalnız üretim yapan tesis (ör. çatı/arazi GES)
consumption	Tüketim	Yalnız tüketim yapan tesis (abone)
mixed	Karma	Aynı tesiste hem üretim hem tüketim varsa

Beyan kaynağı (declaration_source)

Kapsamın "aynı resmî taraf" beyanının dayanağı. Güç sırası soldan sağa artar.

Değer	Türkçe	Ne zaman seçilir
customer_declaration	Müşteri beyanı	Yalnız müşterinin sözlü/yazılı beyanı varsa (en zayıf)
official_document	Resmî belge	Elinizde resmî bir belge varsa
lum_report	LÜM raporu	LÜM'den gelen rapora dayanıyorsa (en güçlü)
gts_report	GTŞ raporu	Görevli tedarik şirketi raporuna dayanıyorsa (LÜM ile eş düzey)
not_checked	Denetlenmedi	Başlangıç durumu — beyan olarak seçilemez

Üye beyan kaynağı (member.declaration_source)

Üyeliğin beyan kaynağı (kapsam beyanından ayrı eksen). Opsiyonel.

Değer	Türkçe	Ne zaman seçilir
customer_declared	Müşteri beyanlı	Üyelik müşteri beyanına dayanıyorsa
official_document	Resmî belge	Resmî belgeye dayanıyorsa
lum_report	LÜM raporu	LÜM raporuna dayanıyorsa
grid_operator	Şebeke işletmecisi	Şebeke işletmecisi verisine dayanıyorsa

Mahsuplaşma rejimi (mahsuplasma_regime)

Tesisin mevzuat sınıflandırması. Mahsuplaşma için tüm üyeler lum_yonetmelik_26 olmalıdır (R001 bloklayıcı).

Değer	Türkçe	Ne zaman seçilir
lum_yonetmelik_26	LÜM / Yönetmelik Md.26	Mahsuplaşmaya girecek lisanssız üretim tesisleri (tek geçerli rejim)
excluded_yonetmelik_23	Kapsam dışı — Yön. Md.23	Md.23 kapsamı; mahsuplaşmaya girmez
excluded_support_period_completed	Destek süresi doldu (10 yıl → PYS)	10 yıllık destek süresi bitmiş, PYS listesine geçmiş tesis
excluded_yonetmelik_30_8	Kapsam dışı — Yön. Md.30/8	Md.30/8 kapsamı
excluded_mixed_23_26	Karma 23/26 (kapsam dışı)	Hem Md.23 hem Md.26 karışımı
licensed	Lisanslı	Lisanslı üretim tesisi (mahsuplaşma dışı)
unknown	Bilinmiyor	Sınıflandırma belirsiz — çağrı mektubu/lisanstan netleştirin

Tesis tip kodu (facility_type_code)

Yönetmelik md.5/1 bentleri + Md.11. Değeri çağrı mektubu / lisans belgesinden alın (hangi bent kapsamında).

Değer	Türkçe	Ne zaman seçilir
m5_1_c	Md.5/1-c	c bendi kapsamındaki tesis
m5_1_cedilla	Md.5/1-ç (öz tüketim)	Üretim + tüketim aynı ölçüm noktasında (öz tüketim)
m5_1_d	Md.5/1-d (kojenerasyon)	Kojenerasyon tesisi (çağrı mektubu tarih kıyası gerekir)
m5_1_h	Md.5/1-h	h bendi
m5_1_f	Md.5/1-f	f bendi
m5_1_g	Md.5/1-g	g bendi
m5_1_g_breve	Md.5/1-ğ	ğ bendi
m5_1_i_dotless	Md.5/1-ı	ı bendi (noktasız)
m5_1_i	Md.5/1-i	i bendi (noktalı)
m11_1	Md.11/1	Md.11/1 kapsamı
m11_3	Md.11/3	Md.11/3 kapsamı

Abone grubu (abone_grubu)

Değeri elektrik faturasından alın ("abone grubu" satırı). Tüketim tesisleri aynı abone grubunda olmalı (R002 bloklayıcı).

Değer	Türkçe	Ne zaman seçilir
mesken	Mesken	Konut aboneliği
ticarethane	Ticarethane	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ğilse

Ölçüm rolü (meter_role)

Cihazın mahsuplaşmadaki rolü. İlk 4 rol "ANA rol"dür — aynı dönemde çakışırsa 409. main_production atanmazsa R003M bloklayıcı.

Değer	Türkçe	Ne zaman seçilir
main_production	Ana üretim sayacı	Tesisin ana üretim ölçümü (zorunlu — yoksa R003M)
main_consumption	Ana tüketim sayacı	Tesisin ana tüketim ölçümü
pcc_import_export	Ortak bağlantı (PCC) çekiş/veriş	Şebeke ile ortak bağlantı noktası ölçümü
osb_eb_consumption	OSB/EB tüketim	OSB/EB üzerinden tüketim ölçümü
same_measurement_point	Aynı ölçüm noktası	5/1-ç/d aynı-nokta ölçümü
sub_production	Alt üretim	İkincil/alt üretim ölçümü
sub_consumption	Alt tüketim	İkincil/alt tüketim ölçümü
auxiliary	Yardımcı	Yardımcı/ikincil ölçüm
internal	Dahili	Dahili (fatura dışı) ölçüm

Enerji anlamı (energy_semantics)

Kanal değerinin ne ifade ettiği. Zeus'ta energy_active_import = cumulative_counter; OSOS ACTIVE_* = interval_delta.

Değer	Türkçe	Ne zaman seçilir
interval_delta	Aralık farkı	Değer, dönem içindeki artışı (delta) veriyorsa (ör. OSOS ACTIVE_*)
cumulative_counter	Kümülatif sayaç	Değer, hiç sıfırlanmayan toplam sayaçsa (ör. Zeus energy_active_import)
power_integrated	Güçten integrasyon	Enerji yok, güçten integre ediliyorsa
unknown	Bilinmiyor	Anlam belirsizse

İşaret yönü (sign_convention / direction_convention)

Kanal işaretinin yorumu (çekiş mi veriş mi pozitif).

Değer	Türkçe	Ne zaman seçilir
import_positive	Çekiş pozitif	Şebekeden çekiş pozitif işaretliyse
export_positive	Veriş pozitif	Şebekeye veriş pozitif işaretliyse
signed_net	İşaretli net	Tek kanal net akışı işaretli veriyorsa (+çekiş / −veriş)
unknown	Bilinmiyor	Yön belirsizse

Üretim ölçüm topolojisi (production_metering_topology)

Sahadaki üretim + batarya ölçüm mimarisi.

Değer	Türkçe	Ne zaman seçilir
pv_only_meter	Yalnız PV sayacı	Sayaç sadece PV üretimini ölçüyorsa
pv_plus_ess_behind_meter	Sayaç arkası PV + ESS ⚠	PV ve batarya aynı sayacın arkasında — SKB riski
ess_separate_meter	ESS ayrı sayaç	Bataryanın ayrı sayacı varsa
consumption_side_ess	Tüketim tarafı ESS	Batarya tüketim tarafındaysa
unknown	Bilinmiyor	Mimari belirsizse

İnvertör tipi (inverter_type)

Cihaz template adından önerilir (SOFAR/HYD → ESS; SUN2000/KTLX/grid-tie → şebeke). Otomatik atanmaz; siz onaylarsınız.

Değer	Türkçe	Ne zaman seçilir
grid_inverter	Şebeke invertörü	Bataryasız, şebeke bağlı invertör (ör. Huawei SUN2000)
ess_inverter	ESS invertörü	Batarya/hibrit invertör (ör. SOFAR HYD)

Limit kaynağı (limit_source)

Bedelli limit değerinin dayanağı.

Değer	Türkçe	Ne zaman seçilir
manual	Manuel	Elle girildiyse
customer_declared	Müşteri beyanlı	Müşteri beyanına dayanıyorsa (LÜM gelene kadar)
lum_report	LÜM raporu	Resmî LÜM raporundan geldiyse
grid_operator	Şebeke işletmecisi	Şebeke işletmecisi verisinden geldiyse
calculated	Hesaplanan	Sistem tarafından hesaplandıysa

Tarife amacı (price_purpose)

Regüle tarife satırının hangi kalem olduğu (superadmin).

Değer	Türkçe	Ne zaman seçilir
mahsuplasma_related_tariff	Mahsuplaşmayla ilişkili tarife	Mahsuplaşma tutar hesabına giren ana tarife (Md.11)
mahsuplasma_lowest_related_tariff	En düşük ilişkili tarife	Md.11 en-düşük dalı için
sktt_active_energy	SKTT aktif enerji	Son Kaynak Tedarik Tarifesi aktif enerji kalemi
customer_bill_active_energy	Müşteri fatura aktif enerjisi	Müşteri faturasındaki aktif enerji fiyatı
system_usage	Sistem kullanım (SKB)	Sistem kullanım bedeli kalemi (EPDK "Dağıtım Bedeli kr/kWh" kolonu)
distribution	Dağıtım	Dağıtım bedeli kalemi (ayrı kayıt)
capacity	Güç bedeli	EPDK "Güç Bedeli" kolonu (kr/kW/ay); birim zorunlu kurus_per_kw_month. Güç aşımı girilmez (aşım = 2 × güç, sistem türetir)
reactive	Reaktif bedel	EPDK "Reaktif" kolonu (kr/kVArh); birim zorunlu kurus_per_kvarh
other	Diğer	Yukarıdakilerin dışındaki kalem

Kurum tipi (org_type)

Ek-1'de "Yeni kurum ekle" ile oluşturulan kurumun tipi.

Değer	Türkçe
meter_reading_org	Sayaç okuyan kurum (OSOS)
grid_operator	Şebeke işletmecisi
distribution_company	Dağıtım şirketi (DSO)
supplier	Tedarikçi
responsible_supplier	Görevli tedarik şirketi (GTŞ)
osb_eb	OSB / EB
market_operator	Piyasa işletmecisi (EPİAŞ)

Kaynak tipi (source_type) — üretim kaynağı

Üretim kaynağı. SKB fiyat tabanı açısından da önemlidir: producer_tariff_group override'ı boşsa Zeus SKB LÜ grubunu bu alandan türetir (solar→LÜ2, diğer yenilenebilir→LÜ1; hybrid/unknown → güneş-baskın LÜ2 varsayılan + uyarı — bkz. Hesap Çekirdeği — SKB).

Değer	Türkçe		Değer	Türkçe
solar	Güneş		geothermal	Jeotermal
wind	Rüzgâr		hybrid	Hibrit
hydro	Hidro		unknown	Bilinmiyor
biomass	Biyokütle

Üretici tarife grubu (producer_tariff_group)

Üretim tesisinin SKB fiyat tabanı (veriş yönlü dağıtım bedeli) LÜ grubu override'ı. Opsiyonel — boş bırakılırsa source_type'tan türetilir. Bu değerler tesisin abone grubu (abone_grubu) DEĞİLDİR; ayrı bir üretici tarife eşlemesidir.

Değer	Türkçe	Ne zaman seçilir
lisanssiz_uretici_1	Lisanssız Üretici 1 (LÜ1)	Güneş dışı yenilenebilir üretim (rüzgâr/hidro/biyokütle/jeotermal) — 5346 I Sayılı Cetvel (e) dışı
lisanssiz_uretici_2	Lisanssız Üretici 2 (LÜ2)	Güneş (GES) üretim — 5346 I Sayılı Cetvel (e) bendi
(boş)	Override yok	source_type'tan türet (varsayılan davranış) + türev/varsayılan uyarısı

Diğer sistem enum'ları (bilgi amaçlı)

Bu değerleri siz seçmezsiniz — sistem üretir; ekranlarda karşılaşabilirsiniz.

Alan	Değerler (kod → Türkçe)
data_source (sonuç kaynağı)	zeus_local → Zeus yerel · lum_official → LÜM resmî · gts_report → GTŞ raporu · customer_declared → Müşteri beyanlı · manual → Manuel
group_status (grup durumu)	customer_defined → Müşteri tanımlı · ek1_submitted → Ek-1 gönderildi · grid_operator_confirmed → Şebeke onayladı · lum_reported → LÜM'e raporlandı · inactive → Pasif · unknown → Bilinmiyor
eligibility_status (uygunluk)	not_checked → Denetlenmedi · valid → Hesaplanabilir · valid_with_warnings → Uyarılarla hesaplanır · blocked → Bloklayıcı · unknown → Bilinmiyor
eligibility şiddet (severity)	info → Bilgi · warning → Uyarı · error → Hata · blocking → Engelleyici
eligibility sonuç (status)	pass → Geçti · fail → Kaldı · not_checked → Denetlenmedi · not_applicable → Uygulanmaz
relationship_type (ilişki)	standard → Standart · same_measurement_point → Aynı ölçüm noktası · m5_1_cedilla_own_consumption → 5/1-ç öz tüketim · m5_1_d_same_point_priority → 5/1-d aynı-nokta önceliği · osb_eb_main_meter → OSB/EB ana sayaç · special → Özel
movement_type (limit hareketi)	initial → Başlangıç · mahsuplasan_consumption → Mahsuplaşan tüketim · bedelli_ihtiyac_fazlasi → Bedelli ihtiyaç fazlası · manual_adjustment → Manuel düzeltme · lum_adjustment → LÜM düzeltmesi · group_transfer_in → Grup transferi (giriş) · group_transfer_out → Grup transferi (çıkış) · correction_reversal → Düzeltme geri alma · correction_reapply → Düzeltme yeniden uygulama

movement_type kullanıcı tarafından SEÇİLMEZ

Limit hareket tipini siz seçmezsiniz — sistem her işlem için doğru tipi otomatik yazar (salt-append hareket defteri). Bu liste yalnız ekranlarda gördüğünüz hareketleri anlamanız içindir. Ayrıntı: Bedelli Limit Hesapları.

---

6. Hesaplanan (KPI) değerler — nereden gelir?

Grup panosundaki bu değerleri girmezsiniz — hesap çekirdeği üretir.

KPI	Ne anlatır?	Nasıl hesaplanır
Mahsuplaşan tüketim (mahsuplasan_tuketim)	Üretimle netleştirilen tüketim (kWh)	Saatlik hesap
Bedelli ihtiyaç fazlası (bedelli_ihtiyac_fazlasi)	Limit içinde kalan, bedelli değerlendirilen fazla üretim (kWh)	Saatlik hesap + limit dağıtımı
SKB ödemeli (skb_odemeli)	Sistem kullanım bedeli doğuran kısım (kWh + TL)	kWh: topoloji/senaryoya göre · TL: üretici LÜ grubu system_usage fiyatı (SKB fiyat tabanı)
Bedelsiz üretim (bedelsiz_uretim)	Limit aşımı / bloklayıcı nedeniyle bedelsiz kalan üretim (× regüle fiyat = TL risk)	Md.6(4)/9(6)
Kalan bedelli limit (kalan_bedelli_limit)	Yıl için kalan bedelli limit (kWh)	initial_limit_kwh + Σ(hareket.amount_kwh) (kullanım negatif; canlı VIEW)
Veri kalitesi (veri_kalitesi_pct)	Ölçüm verisinin tamlığı (%)	Kaynak kapsama oranı
Son hesap koşumu (son_hesap_run)	En son hesap zamanı	Hesap çekirdeği

Ayrıntı: Hesap Çekirdeği · Bedelli Limit Hesapları.

---

7. Kısaltma sözlüğü

Kısaltma	Açılımı	Kısaca ne?
VKN	Vergi Kimlik Numarası	Vergi mükellefi kimliği. Mahsuplaşmada istenmez/saklanmaz
EIC	Energy Identification Code	Avrupa enerji kimlik kodu (16 hane, "40…"). Kaynak: EPİAŞ/şebeke
ETSO	European Transmission System Operators (kodu)	EIC'in eski adı; aynı amaç
LÜM	Lisanssız Üretim Modülü	EPİAŞ bünyesindeki resmî lisanssız üretim modülü (resmî limit kaynağı)
GTŞ	Görevli Tedarik Şirketi	Bölgede görevli tedarik şirketi (kod adı: gts)
SKB	Sistem Kullanım Bedeli	Şebeke kullanımı için ödenen bedel (topolojiye göre risk)
SKTT	Son Kaynak Tedarik Tarifesi	Tedarikçi seçmeyen yüksek tüketimli abonelere uygulanan tarife
PTF	Piyasa Takas Fiyatı	Gün öncesi piyasası saatlik fiyatı (bilgi amaçlı — hesabın ana girdisi değil)
SMF	Sistem Marjinal Fiyatı	Dengeleme piyasası saatlik fiyatı (bilgi amaçlı)
PYS	Piyasa Yönetim Sistemi	EPİAŞ piyasa yönetim/uzlaştırma sistemi (destek süresi bitince geçilen liste)
OSB	Organize Sanayi Bölgesi	OSB dağıtım/tüketim senaryosu (R003 istisnası, R012)
EB	Endüstri Bölgesi	Endüstri bölgesi bağlantısı (OSB ile birlikte ele alınır)
PCC	Point of Common Coupling	Şebeke ile ortak bağlantı noktası (ölçüm rolü)
SOC	State of Charge	Bataryanın şarj durumu (%)
ESS	Energy Storage System	Enerji depolama sistemi (batarya)
DUY	Dengeleme ve Uzlaştırma Yönetmeliği	Piyasa dengeleme/uzlaştırma mevzuatı (ör. DUY 17/2, 133/5)
DSO	Distribution System Operator	Dağıtım şirketi / dağıtım sistemi işletmecisi
PV	Photovoltaic	Fotovoltaik (güneş paneli) üretim

---

İlgili sayfalar

• Mahsuplaşma — Genel Bakış — modül haritası ve kavramlar.
• Grup Kurulum Sihirbazı — bu alanların girildiği 7 adımlık ekran akışı.
• Kurulum Akışı (Uçtan Uca) — API düzeyi referans.
• Sayaç Atama ve Kanal Eşleme — bölüm 3'teki alanların ayrıntısı.
• Uygunluk Kuralları — R001–R013 katalog + severity.
• Bedelli Limit Hesapları — limit alanları + hareket defteri (movement_type).
• Regüle Tarifeler — bölüm 4'teki tarife alanları.
• Hesap Çekirdeği — KPI'ların nasıl üretildiği.
• Sistem Alarmları — eksik alan → alarm eşleşmesi.
• SSS ve Sorun Giderme — hata kodları (409/422 vb.).
• Teknik: Veri Modeli · Mimari · API Referansı