ChargeBridge · OCPI roaming ve takas hub’ı
Bir kez bağlanın. Kapsamı belirleyin. Dönem başına uzlaşın.
ChargeBridge, şarj ağı işletmecileri ile mobilite hizmet sağlayıcılarının tek OCPI bağlantısı üzerinden buluştuğu hub’dır. Hangi partnerin neyi göreceği sizin açık kararınızdır; her şarjlanma CDR olur, her CDR bir uzlaştırma penceresine girer.
Roller
Kimler bağlanır
Üç rol, bir bağlantı. Bir taraf aynı anda CPO ve eMSP olabilir; hub iki rol bağlamını ayrı tutar.
CPO
locations · tariffs · sessions · cdrs →Şarj ağı işletmecileri için
Lokasyon ve tarifelerinizi bir kez yayımlayın; hangi eMSP’nin hangi sahayı göreceğine partner başına karar verin; şarjlanma, CDR ve uzlaştırma ekstrelerini tek yerden alın.
Bu roldeki partnerler şunu ister
- Her biri için ayrı entegrasyon olmadan birden fazla eMSP uygulamasının sürücülerine ulaşmak
- Her partnerin hangi saha ve tarifeleri göreceğinin kontrolünü elde tutmak
eMSP
← tokens · commands · authorizeMobilite hizmet sağlayıcıları için
İlişkiniz olan her CPO’dan lokasyon, canlı durum ve tarifeleri alın; token’larınızı bir kez gönderin; tek komut kanalından başlatın, durdurun ve rezerve edin.
Bu roldeki partnerler şunu ister
- Her ağı entegre etmeden uygulamada daha fazla cihaz göstermek
- Partner cihazlarında sürücüleri gerçek zamanlı yetkilendirmek
NSP
locations · tariffs (yalnız alıcı)Navigasyon ve veri sağlayıcıları için
CPO’ların size yayımlamayı seçtiği lokasyon, durum ve tarifeleri alın; şarjlanma, CDR ve uzlaştırma yok, çünkü ne cihaz işletirsiniz ne de sürücüye satış yaparsınız.
Bu roldeki partnerler şunu ister
- Harita veya araç ürününde doğru cihaz müsaitliği göstermek
- Ağları tek tek entegre etmek veya kazımak yerine tek akış almak
Mimari
Üç katman, tek bağlantı
Roaming yalnız veri alışverişi değildir: kapsam kararları, protokol uyumu ve para akışı aynı anda çalışmak zorundadır. Hub üçünü ayrı tutar.
- KAPSAM 01
Kapsam
Hangi lokasyonun hangi partnere görüneceğine siz karar verirsiniz. Paylaşım setleri, partner başına ilişkiler ve yayın kapıları; varsayılan kapalıdır ve her değişiklik denetim defterine yazılır.
sharing set → relationship → publish gate
Hub nasıl çalışır → - PROTOKOL 02
Protokol
OCPI 2.2.1 ve 2.3.0 yan yana. Sürüm uzlaşması, kimlik el sıkışması ve token yaşam döngüsü hub tarafında yürür; başka sürümdeki partner sizin sorununuz olmaktan çıkar.
versions → credentials → Token B/C
OCPI modülleri → - UZLAŞTIRMA 03
Uzlaştırma
CDR doğrulama, uzlaştırma pencereleri, bilateral netleştirme ve hash zincirli defter. İtirazlar kapanıştan önce görünür; hub ücreti ayrı satırdır ve asla netleştirilmez.
CDR → window → statement → obligation
Uzlaştırma ve takas →
Kanıt
Hub ne yapar, kanıtıyla
Bu sitedeki her başlık iddiası bir kanıt kaydına bağlıdır: kaynak kodu incelemesi, belge veya test paketi. Kayıt, neyi desteklediğini ve neyi göstermediğini birlikte söyler.
Kanıt kayıtları →- 01
Hub’a tek OCPI bağlantısı her partnerle ayrı entegrasyonun yerini alır; hangi partnerin neyi göreceği sizin açık kararınız olarak kalır.
Kanıtı incele
OCPI 2.2.1 route tablosu· Kaynak kod incelemesi
OCPI adaptörü 2.2.1 sürüm ucunun altında credentials, locations, sessions, cdrs, tariffs, tokens, commands, chargingprofiles ve hubclientinfo denetleyicilerini kimlik doğrulama, idempotency, hız sınırı ve denetim ara katmanlarıyla bağlar.
Destekler:Dokuz 2.2.1 modülünün hub’da uygulanmış ve yönlendirilmiş olduğunu.
Göstermez:Belirli bir partnerin uygulamasıyla birlikte çalışabilirliği; o, partner başına sandbox’ta ve kabul listesinde kurulur.
Kaynak: ChargeBridge hub kaynak deposu (özel), belirtilen tarihte incelendi · Doğrulama4 Ekim 2026
Tüm kanıt kayıtları →Varsayılan kapalı partner ilişkileri· Kaynak kod incelemesi
İki taraf arasında açıkça kabul edilmiş, aktif bir partner ilişkisi yoksa hiçbir lokasyon, tarife, şarjlanma, CDR veya token akmaz; yayın kapsamı varsayılan olarak kapalıdır ve değişiklikler denetim defterine yazılır.
Destekler:Tamamlanan credentials el sıkışmasının veri akışını açmadığını ve kapsamın açık, denetlenebilir bir karar olduğunu.
Göstermez:Sözleşmesel veri paylaşım izinlerini; onlar imzalı sözleşme ve veri işleme sözleşmesinden gelir.
Kaynak: ChargeBridge hub kaynak deposu (özel), belirtilen tarihte incelendi · Doğrulama4 Ekim 2026
- 02
OCPI 2.2.1 ve 2.3.0 yan yana; farklı sürümdeki partner hub tarafında çevrilir.
Kanıtı incele
OCPI 2.2.1 route tablosu· Kaynak kod incelemesi
OCPI adaptörü 2.2.1 sürüm ucunun altında credentials, locations, sessions, cdrs, tariffs, tokens, commands, chargingprofiles ve hubclientinfo denetleyicilerini kimlik doğrulama, idempotency, hız sınırı ve denetim ara katmanlarıyla bağlar.
Destekler:Dokuz 2.2.1 modülünün hub’da uygulanmış ve yönlendirilmiş olduğunu.
Göstermez:Belirli bir partnerin uygulamasıyla birlikte çalışabilirliği; o, partner başına sandbox’ta ve kabul listesinde kurulur.
Kaynak: ChargeBridge hub kaynak deposu (özel), belirtilen tarihte incelendi · Doğrulama4 Ekim 2026
Tüm kanıt kayıtları →OCPI 2.3.0 route tablosu· Kaynak kod incelemesi
Ayrı bir 2.3.0 sürüm ucu rezervasyon, park yeri, ödeme oturumu ve token gruplarını yönlendirir; 2.2.1 ve 2.3.0 partnerleri arasında çeviri katmanı vardır.
Destekler:OCPI 2.3.0 nesnelerinin kabul edilip iletildiğini ve karışık sürümlü partnerlerin bağlanabildiğini.
Göstermez:Adı verilen bir partnerle 2.3.0’ın üretimde kullanımını; ödeme-oturumu nesneleri hub’ı ödeme kuruluşu yapmaz.
Kaynak: ChargeBridge hub kaynak deposu (özel), belirtilen tarihte incelendi · Doğrulama4 Ekim 2026
- 03
Her CDR bir uzlaştırma penceresine girer; netleştirme ekstreleri hash zincirli defterden çıkar. Faturalama finansal go-live kapısıyla başlar.
Kanıtı incele
Uzlaştırma penceresi durum makinesi· Kaynak kod incelemesi
Takas platformu her uzlaştırma penceresini OPEN, GRACE_PERIOD, RECONCILING ve CLOSED aşamalarından geçirir; geç gelen CDR’lar ek sürede girer, itirazlar kapanıştan önce görünür.
Destekler:Uzlaştırma dönemlerinin, netleştirme ekstrelerinin ve ödeme yükümlülüklerinin platform tarafından üretildiğini.
Göstermez:Hub üzerinden partnerler arasında para hareket ettiğini: uzlaştırma, finansal go-live kapısı kapanana kadar dry-run çalışır ve faturalama o zamana kadar çitlidir.
Kaynak: ChargeBridge hub kaynak deposu (özel), belirtilen tarihte incelendi · Doğrulama4 Ekim 2026
Tüm kanıt kayıtları →Hash zincirli uzlaştırma defteri· Kaynak kod incelemesi
Defter kayıtları hash ile zincirlenir, bir ekstre girdileriyle yeniden doğrulanabilir; hub ücretleri her taraf için ayrı satır olarak kaydedilir ve roaming tutarlarıyla asla netleştirilmez.
Destekler:Defterin kurcalanmaya karşı izlenebilirliğini ve “hub ücreti netleştirme dışında” kuralını.
Göstermez:Ücret oranlarını veya paylaşımlarını; onlar katılım sözleşmesindedir, bu sitede değil.
Kaynak: ChargeBridge hub kaynak deposu (özel), belirtilen tarihte incelendi · Doğrulama4 Ekim 2026
- 04
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.
Kanıtı incele
Tüm kanıt kayıtları →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
12
servis
593
migrasyon
87
mimari karar
~1.500
test dosyası
83
OpenAPI yolu
On iki servis, 593 migrasyon, 87 mimari karar ve yaklaşık 1.500 test dosyası: hub mühendisliği yapılmış ve belgelenmiş bir sistemdir; sayılar trafiği değil kod tabanını anlatır.
Kanıtı incele
Hub’ın mühendislik ayak izi· Kaynak kod incelemesi
Tek monorepo’da on iki servis (OCPI adaptörü, takas platformu, kimlik, roaming mesh, PKI, harita verisi, sandbox, operasyon MCP, sahte partner/cihaz ve migrasyonlar), 593 veritabanı migrasyonu, 87 mimari karar kaydı, yaklaşık 1.500 test dosyası ve toplam 83 yol içeren üç OpenAPI dokümanı.
Destekler:Hub’ın prototip değil, mühendisliği yapılmış ve belgelenmiş bir sistem olduğunu.
Göstermez:Üretim ölçeğini, partner sayısını veya hizmet seviyelerini; sayılar trafiği değil kod tabanını anlatır.
Kaynak: Hub kaynak deposu, 4 Ekim 2026 sayımı · Doğrulama4 Ekim 2026
Otomatik test paketi· Test paketi
OCPI adaptörü, takas platformu, kimlik servisi, roaming mesh ve hub portalında yaklaşık 1.500 test dosyası: birim, sözleşme, uçtan uca, özellik tabanlı ve mutasyon testleri.
Destekler:Protokol akışlarının ve uzlaştırma mantığının otomatik testlerle kapsandığını.
Göstermez:Paketin en son hangi sürümde ve tarihte geçtiğini; tarihli çalıştırma raporu hazır olunca yayımlanacak.
Kaynak: Hub kaynak deposu, test dizinleri (4 Ekim 2026 sayımı) · Doğrulama4 Ekim 2026
Protokol
Dört çağrıda bağlanın
OCPI 2.2.1 credentials el sıkışması hub tarafında standart hâliyle yürür: sürüm keşfi, modül uçları, kimlik değişimi. Dördüncü adım protokolde değil portaldadır ve veri akışını asıl açan odur.
- 01
Sürümleri keşfet
GET /ocpi/versions · Authorization: Token <TOKEN_A>
- 02
Modül uçlarını oku
GET /ocpi/2.2.1 · Authorization: Token <TOKEN_A>
- 03
Kimlik bilgilerini değiş
POST /ocpi/2.2.1/credentials · body: your credentials + TOKEN_B
- 04
İlişkileri kabul et
hub portal · partner relationship · both sides accept
Hizmet nerede
İki kapı: teknik açık, finansal dry-run
Teknik kapı
El sıkışma, veri akışı, ekstreler
Finansal kapı
Veri işleme sözleşmeleri, kayıtlar, e-fatura
Teknik bağlantı katılan partnerler için canlı: el sıkışma, veri akışı ve uzlaştırma ekstreleri. Uzlaştırma, finansal go-live kapısı kapanana kadar (her partnerle veri işleme sözleşmesi, düzenleyici kayıtlar, e-fatura) dry-run çalışır. Bu sitede partner adı veya sayısı yayımlanmaz; bağlı taraflar birbirini hub dizininde görür.
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ı.
- 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.
- 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.
- 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.
Şirket
E-Gridium ve Electroop
Electroop ve E-Gridium, ortak sahiplik altında faaliyet gösteren ayrı şirketlerdir. ChargeBridge, E-Gridium’un ürünüdür.
Hub, partnerin hangi şarj yazılımını kullandığından bağımsız olarak E-Gridium tarafından işletilir; uyumlu her OCPI uygulaması bağlanabilir.
İş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