Türkiye
Türkiye’nin düzenleyici gerçekliği için kuruldu
Yerel raporlama ve vergi kurallarının gerektirdiği alanlar OCPI eki olarak CDR ile taşınır. Avrupa merkezli hub’lar bunu sonradan ekler; hub oradan başladı. Bu sayfa eki, spesifikasyonun bağlayıcı yorumunu, katılımda alınan alanları ve iki kapıyı anlatır.
Atıf
Spesifikasyon kime ait
Ek, hub’ın icadı değil. E-Gridium yayımlanmış spesifikasyonu uygular; yoruma açık noktalardaki okuması aşağıdaki tabloda ve her partnerle entegrasyon öncesi yazılı olarak mutabık kalınır.
OCPI-TR Custom Modules · v1.0.0OCPI-TR özel modül spesifikasyonu ZES tarafından hazırlandı. E-Gridium spesifikasyonu yayımlandığı hâliyle uygular ve ekosisteme açtığı için ZES’e teşekkür eder; spesifikasyonun yoruma açık bıraktığı noktalarda hub’ın bağlayıcı yorumu aşağıdadır ve her partnerle entegrasyon öncesi yazılı olarak mutabık kalınır.
Kaynak: ocpi-adapter · tr-cdr-additionals.controller.ts; docs/integration/TR_CDRADDITIONALS_PROFILE.mdKanıtı incele
Türkiye CDR eki (tr-cdr-additionals)· Kaynak kod incelemesi
Ayrı bir denetleyici ve entegrasyon profili her CDR’ın yanında TRY/kWh birim fiyatını, KDV kırılımını ve raporlama tanımlayıcılarını taşır. Temelindeki OCPI-TR özel modül spesifikasyonu (v1.0.0, Ocak 2026) ZES tarafından hazırlandı; E-Gridium yayımlandığı hâliyle uygular ve emek için ZES’e teşekkür eder.
Destekler:Türkiye profilinin gönderen ve alan tarafta OCPI eki olarak var olduğunu.
Göstermez:Herhangi bir kurumun düzenleyici kabulünü; alanlar tarafların kendi raporlaması için gerekenlerdir.
Kaynak: OCPI-TR Özel Modüller spesifikasyonu v1.0.0 (ZES, 19 Ocak 2026) ve hub kaynak deposu (özel) · Doğrulama4 Ekim 2026
Tüm kanıt kayıtları →Türkiye profili: tr-cdradditionals’ın bağlayıcı yorumu· Belge
Spesifikasyonun boşluk bıraktığı yerlerde hub’ın uyguladığı sekiz kural: birim fiyat anlamı ve hassasiyeti, KDV işleme, sürümlü düzeltme, idempotency yanıtları, version details ile keşif, 24 saatlik uyum açığı raporuyla nihai eşleşme, seri numarası okuma, taşıma güvenliği. Açık noktalar entegrasyondan önce spesifikasyonun yazarıyla teyit edilir.
Destekler:Türkiye sayfasındaki kural tablosunu.
Göstermez:Düzenleyici kabulü; profil, entegre olan taraflar arasında teknik bir mutabakattır.
Kaynak: OCPI-TR Özel Modüller spesifikasyonu v1.0.0 (ZES, 19 Ocak 2026) ve hub uygulama profili docs/integration/TR_CDRADDITIONALS_PROFILE.md · Doğrulama4 Ekim 2026
Profil
Bağlayıcı okuma
Spesifikasyonun boşluk bıraktığı 8 noktada hub’ın uyguladığı kural. Alan adları, durum kodları ve birimler spesifikasyondaki hâliyle yazılmıştır.
| Konu | Kural | Anahtar |
|---|---|---|
| Birim fiyat | Şarjlanmanın gerçekleştiği gün o lokasyon için geçerli aktif enerji birim fiyatı; TRY/kWh, dört ondalık. Çok zamanlı tarifeli lokasyonlarda şarjlanma ağırlıklı ortalama beklenir. | TRY/kWh · 4 decimals |
| KDV | KDV dahil alanı isteğe bağlıdır ve yoksa türetilmez; kayıt yalnız KDV hariç olarak işaretlenir. KDV dahil değerin hariç değerden küçük olması reddedilir. | VAT incl. · optional |
| Düzeltmeler | Nesne spesifikasyonda değişmezdir. Alıcı tarafta hub sürümlü ekleme uygular: aynı CDR anahtarı için daha yeni last_updated bir düzeltmedir; en güncel sürüm geçerli sayılır, eskiler denetim izi olarak kalır. Gönderen olarak hub nesneyi asla yeniden göndermez. | last_updated · versioned |
| Idempotency | İlk kayıt: 201 ve Location başlığı. Birebir aynı tekrar: 200 ve aynı Location. Aynı last_updated ile farklı içerik ya da daha eski last_updated: 400 ve OCPI durum kodu 2001. | 201 · 200 · 400/2001 |
| Keşif | Modül, OCPI version-details kataloğunda tr-cdradditionals kimliği ve alıcı rolüyle ilan edilir; partner desteği partnerin kendi version-details ilanından keşfedilir, ek konfigürasyon istenmez. | version details · receiver |
| CDR ile eşleşme | CDR ile ek kaydı arasında sıralama garantisi yoktur; eşleşme CDR anahtarı üzerinden nihaidir. Ek kaydı 24 saat içinde gelmeyen Türkiye kapsamındaki CDR reddedilmez, uyum açığı olarak raporlanır. Türkiye kapsamı lokasyonun ülkesine göre belirlenir. | CDR key · 24 h |
| Seri numarası | Sayaç seri numarası olarak okunur; EVSE, CDR’ın kendi lokasyon verisinden alınır. | meter serial |
| Taşıma ve güvenlik | Modül, taşıyıcı OCPI kanalının kimlik doğrulamasını kullanır (el sıkışma sonrası Token B/C); ek kimlik bilgisi yoktur. Ülke ve taraf kodları büyük harfe çevrilir; CiString alanlar yalnız yazdırılabilir ASCII kabul eder. | Token B/C · TLS |
Kanıtı incele
Türkiye CDR eki (tr-cdr-additionals)· Kaynak kod incelemesi
Ayrı bir denetleyici ve entegrasyon profili her CDR’ın yanında TRY/kWh birim fiyatını, KDV kırılımını ve raporlama tanımlayıcılarını taşır. Temelindeki OCPI-TR özel modül spesifikasyonu (v1.0.0, Ocak 2026) ZES tarafından hazırlandı; E-Gridium yayımlandığı hâliyle uygular ve emek için ZES’e teşekkür eder.
Destekler:Türkiye profilinin gönderen ve alan tarafta OCPI eki olarak var olduğunu.
Göstermez:Herhangi bir kurumun düzenleyici kabulünü; alanlar tarafların kendi raporlaması için gerekenlerdir.
Kaynak: OCPI-TR Özel Modüller spesifikasyonu v1.0.0 (ZES, 19 Ocak 2026) ve hub kaynak deposu (özel) · Doğrulama4 Ekim 2026
Türkiye profili: tr-cdradditionals’ın bağlayıcı yorumu· Belge
Spesifikasyonun boşluk bıraktığı yerlerde hub’ın uyguladığı sekiz kural: birim fiyat anlamı ve hassasiyeti, KDV işleme, sürümlü düzeltme, idempotency yanıtları, version details ile keşif, 24 saatlik uyum açığı raporuyla nihai eşleşme, seri numarası okuma, taşıma güvenliği. Açık noktalar entegrasyondan önce spesifikasyonun yazarıyla teyit edilir.
Destekler:Türkiye sayfasındaki kural tablosunu.
Göstermez:Düzenleyici kabulü; profil, entegre olan taraflar arasında teknik bir mutabakattır.
Kaynak: OCPI-TR Özel Modüller spesifikasyonu v1.0.0 (ZES, 19 Ocak 2026) ve hub uygulama profili docs/integration/TR_CDRADDITIONALS_PROFILE.md · Doğrulama4 Ekim 2026
Modül
Modül
Modül, OCPI version-details kataloğunda alıcı rolüyle ilan edilir; CPO gönderir, eMSP alır. Taşıyıcı OCPI kanalının kimlik doğrulamasını kullanır ve ek kimlik bilgisi istemez.
OCPI modülleri →CPO: Gönderen · eMSP: Alan
Türkiye profili: yerel mevzuatın ve vergi kurallarının gerektirdiği CDR alanları, OCPI eki olarak taşınır.
TRY/kWh birim fiyatı, KDV kırılımı ve iki tarafın raporlama için ihtiyaç duyduğu tanımlayıcılar; CPO tarafından CDR ile birlikte gönderilir. Profil, OCPI-TR özel modül spesifikasyonu olarak ZES tarafından hazırlandı; E-Gridium uygular ve ekosisteme açtığı için ZES’e teşekkür eder.
- Taşıdığı
- TRY/kWh birim fiyat, KDV kırılımı, raporlama tanımlayıcıları
- Eşleşme
- CDR anahtarı üzerinden, nihai; 24 saatte uyum açığı raporu
- Keşif
- version details · tr-cdradditionals · alıcı
Son doğrulama: 4 Ekim 2026 · Kaynak: ocpi-adapter · tr-cdr-additionals.controller.ts; docs/integration/TR_CDRADDITIONALS_PROFILE.md
Kanıtı incele
Türkiye CDR eki (tr-cdr-additionals)· Kaynak kod incelemesi
Ayrı bir denetleyici ve entegrasyon profili her CDR’ın yanında TRY/kWh birim fiyatını, KDV kırılımını ve raporlama tanımlayıcılarını taşır. Temelindeki OCPI-TR özel modül spesifikasyonu (v1.0.0, Ocak 2026) ZES tarafından hazırlandı; E-Gridium yayımlandığı hâliyle uygular ve emek için ZES’e teşekkür eder.
Destekler:Türkiye profilinin gönderen ve alan tarafta OCPI eki olarak var olduğunu.
Göstermez:Herhangi bir kurumun düzenleyici kabulünü; alanlar tarafların kendi raporlaması için gerekenlerdir.
Kaynak: OCPI-TR Özel Modüller spesifikasyonu v1.0.0 (ZES, 19 Ocak 2026) ve hub kaynak deposu (özel) · Doğrulama4 Ekim 2026
Türkiye profili: tr-cdradditionals’ın bağlayıcı yorumu· Belge
Spesifikasyonun boşluk bıraktığı yerlerde hub’ın uyguladığı sekiz kural: birim fiyat anlamı ve hassasiyeti, KDV işleme, sürümlü düzeltme, idempotency yanıtları, version details ile keşif, 24 saatlik uyum açığı raporuyla nihai eşleşme, seri numarası okuma, taşıma güvenliği. Açık noktalar entegrasyondan önce spesifikasyonun yazarıyla teyit edilir.
Destekler:Türkiye sayfasındaki kural tablosunu.
Göstermez:Düzenleyici kabulü; profil, entegre olan taraflar arasında teknik bir mutabakattır.
Kaynak: OCPI-TR Özel Modüller spesifikasyonu v1.0.0 (ZES, 19 Ocak 2026) ve hub uygulama profili docs/integration/TR_CDRADDITIONALS_PROFILE.md · Doğrulama4 Ekim 2026
Katılım ve sandbox
Katılımda alınanlar
Ek alanların her CDR’da doldurulabilmesi için iki tarafın kimliği ticari katılımda alınır. Teknik kapı el sıkışmayı ve veri akışını açar; finansal kapı gerçek parayı.
Taraf kaydı
- 01Her tarafın unvanı ve vergi numarası (VKN), ticari katılımda taraf kaydına yazılır.
- 02Tarafın varsa şarj ağı işletmeci lisans numarası.
- 03Kişisel veri akmadan önce her partnerle KVKK kapsamında veri işleme sözleşmesi.
Teknik kapı
- İmzalı roaming katılım sözleşmesi ve veri işleme sözleşmesi
- Unvan, vergi numarası ve varsa şarj ağı işletmeci lisans numarası
- Hub’dan erişilebilen bir OCPI versions ucu ve el sıkışma için Token A
- Lokasyon, tarife, şarjlanma ve CDR için gönderen; token ve komut için alan uygulama
Finansal kapı
Sunulur, uzlaştırma dry-run- Her CDR’da tr-cdr-additionals alanlarının doldurulması
- Sözleşmede belirlenen tahsilat ve faturalama bilgileri
Finansal kapı ayrıca hub tarafında kapanır: her partnerle veri işleme sözleşmesi, düzenleyici kayıtlar ve e-fatura hattı. O zamana kadar uzlaştırma dry-run çalışır ve fatura kesilmez.
Uzlaştırma ve takas →Hub çıktısı mutabakat özetidir, mali belge değildir; KDV hesabı ve e-fatura, CDR’ı üreten tarafın sorumluluğundadır.
Neden
Neden önce Türkiye
Roaming çekirdeği, yerel raporlama alanlarının üstüne kuruldu; tersi değil.
Raporlama CDR’da başlar
Türkiye’de bir şarjlanmanın raporlanması için gereken birim fiyat, KDV kırılımı ve tanımlayıcılar standart OCPI CDR’ında yoktur. Hub bu alanları sonradan eşlemek yerine CDR ile birlikte taşır.
İki taraf aynı veriyi görür
CPO ve eMSP aynı CDR’a ve aynı ek alanlara bakar; mutabakat farklı tablolardan değil, tek kayıttan yapılır.
Avrupa hub’ları sonradan ekler
Pan-Avrupa hub’lar yerel vergi ve raporlama alanlarını dış katman olarak çözer. ChargeBridge bu alanlardan başladı; roaming çekirdeği onların üstüne kuruldu.
İşin nasıl ilerlediği
- 01Rolünüz ve versions ucunuzla başvurun
- 02Katılım sözleşmesini ve veri işleme sözleşmesini imzalayın
- 03Sandbox’ta el sıkışın, sonra ilişkileri kabul edin