Hub
Hub nasıl çalışır: el sıkışmadan uzlaştırmaya
Bir partner bağlantısı dört çağrıyla kimlik kurar, bir kabul kararıyla kapsam açar ve her şarjlanmayı bir uzlaştırma penceresine taşır. Her adımın protokol çağrısı, veri yönü ve arkasındaki kanıt kaydı bu sayfada.
El sıkışma
Dört adım
İlk üç adım OCPI 2.2.1 credentials modülünün standart akışıdır ve önce sandbox’ta yapılır. Dördüncü adım protokolde yoktur: ilişkiyi iki taraf portalda kabul eder ve veri ancak o zaman akar.
- 01 OCPI
Sürümleri keşfet
GET /ocpi/versions · Authorization: Token <TOKEN_A>
Katılımda verilen Token A ile hub’ın sunduğu OCPI sürümlerini (2.2.1 ve 2.3.0) ve her birinin version-details adresini okursunuz.
- 02 OCPI
Modül uçlarını oku
GET /ocpi/2.2.1 · Authorization: Token <TOKEN_A>
Version details her modül ucunu rolüyle listeler; Türkiye partnerleri için tr-cdradditionals burada görünür.
- 03 OCPI
Kimlik bilgilerini değiş
POST /ocpi/2.2.1/credentials · body: your credentials + TOKEN_B
Versions adresinizi ve Token B’yi gönderirsiniz; hub kendi kimlik bilgileri ve Token C ile yanıtlar. Bundan sonra hub sizi Token B ile, siz hub’ı Token C ile çağırırsınız. Token A geçersizleşir.
- 04 portal
İlişkileri kabul et
hub portal · partner relationship · both sides accept
Tamamlanan el sıkışma veri akışı yaratmaz. Her partner ilişkisi iki tarafça açıkça kabul edilir ve bir paylaşım setine işaret eder; lokasyon, tarife, şarjlanma ve CDR ancak o zaman hareket eder.
Her rol için ön koşul
- Versions ucu (GET /ocpi/versions) ve version details (GET /ocpi/2.2.1 veya /ocpi/2.3.0)
- Credentials modülü, gönderen ve alan arayüzler
- TLS 1.2 veya üstü HTTPS; hub’dan izin listesi gerekmeden erişilebilen uçlar
Ağ ve davranış
- 10 saniye içinde yanıt (bağlantı zaman aşımı)
- Tekrarlanan gönderimlerin idempotent işlenmesi
- Üretimden önce bir sandbox turu: el sıkışma, ardından cihaz simülatörüne karşı her modül
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
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
Partner sandbox’ı· Kaynak kod incelemesi
OCPI adaptöründeki sandbox route’ları ile sahte partner ve cihaz simülatörü, bir partnerin katılımdan önce el sıkışmayı tamamlamasına ve her modülü test verisiyle denemesine izin verir.
Destekler:Test ortamının katılımın parçası olduğunu.
Göstermez:Self-servis kaydı; sandbox kimlik bilgileri başvuru incelendikten sonra verilir.
Kaynak: ChargeBridge hub kaynak deposu (özel), belirtilen tarihte incelendi · Doğrulama4 Ekim 2026
Kapsam
Kapsam bir karardır, varsayılan değil
Paylaşım setleri
CPO lokasyonlarını paylaşım setlerinde gruplar; bir eMSP veya NSP ile ilişki bir sete işaret eder. Tarife görünürlüğü aynı kapsamı izler. Hiçbir sette olmayan lokasyon her partnere görünmezdir.
İki tarafça kabul edilen ilişki
Tamamlanan el sıkışma tek başına veri akışı açmaz. İki taraf arasında açıkça kabul edilmiş, aktif bir partner ilişkisi yoksa hiçbir lokasyon, tarife, şarjlanma, CDR veya token akmaz. Varsayılan kapalıdır.
Denetim defteri
Kapsamı daraltmak veya genişletmek tek işlemdir ve her değişiklik denetim defterine yazılır: kim, ne zaman, hangi set, hangi partner. Yazılmamış izin, verilmemiş izindir.
Kanıtı incele
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
Veri akışı
Ne akar, hangi yönde
CPO’dan eMSP’ye lokasyon, canlı durum, tarife, şarjlanma ve CDR; eMSP’den CPO’ya token, gerçek zamanlı yetkilendirme ve komutlar. Her satır kabul edilmiş ilişkiler boyunca ve hub kaynak kodundaki route tablolarıyla doğrulanmış hâliyle yönlendirilir.
| Modül | Sürüm | CPO | eMSP | Ne taşır | Durum |
|---|---|---|---|---|---|
| credentials | 2.2.1 | Gönderen ve alan | Gönderen ve alan | Partner ile hub arasındaki kayıt el sıkışması ve token yaşam döngüsü. | Sunulur |
| locations | 2.2.1 | Gönderen | Alan | Lokasyonlar, EVSE’ler ve konnektörler, canlı durumla. | Sunulur |
| sessions | 2.2.1 | Gönderen | Alan | Başlangıçtan bitişe süren şarjlanmalar. | Sunulur |
| cdrs | 2.2.1 | Gönderen | Alan | Şarj detay kayıtları (CDR): şarjlanmanın faturalanabilir kaydı. | Sunulur |
| tariffs | 2.2.1 | Gönderen | Alan | Fiyat bileşenleri ve kısıtlarıyla tarife tanımları. | Sunulur |
| tokens | 2.2.1 | Alan | Gönderen | Sürücü token’ları (RFID, uygulama) ve gerçek zamanlı yetkilendirme. | Sunulur |
| commands | 2.2.1 | Alan | Gönderen | Hub üzerinden iletilen uzaktan başlat, durdur, rezerve et ve kilit aç. | Sunulur |
| chargingprofiles | 2.2.1 | Alan | Gönderen | Hub üzerinden ayarlanan ve okunan akıllı şarj profilleri. | Sunulur |
| hubclientinfo | 2.2.1 | Alan | Alan | Hub, her partnere hangi tarafların hangi rolle bağlı olduğunu bildirir. | Sunulur |
| bookings | 2.3.0 | Alan | Gönderen | Bir cihazın zaman aralığı için rezervasyonu; oluşturma ve iptal. | Sunulur |
| parking | 2.3.0 | Gönderen | Alan | Lokasyonlara bağlı park yeri bilgisi. | Sunulur |
| payment | 2.3.0 | Gönderen | Alan | OCPI 2.3.0’da tanımlanan ad-hoc (kartlı) şarj için ödeme-oturumu nesneleri. | Sunulur |
| tokens (groups) | 2.3.0 | Alan | Gönderen | Filo ve ortak hesap senaryoları için token gruplama. | Sunulur |
| tr-cdr-additionals | TR eki | Gönderen | Alan | Türkiye profili: yerel mevzuatın ve vergi kurallarının gerektirdiği CDR alanları, OCPI eki olarak taşınır. | Sunulur |
Kapsam metni, doğrulama tarihi ve kanıt düzeyi her modül için OCPI modülleri →
Para
Şarjlanma → CDR → uzlaştırma penceresi
Süren şarjlanma durum geçişleriyle iletilir; bitince CPO CDR’ı gönderir. CDR tarife ve şarjlanmayla doğrulanır, idempotent alınır ve o partner çifti için açık uzlaştırma penceresine girer. Pencere kapanınca hub imzalı netleştirme ekstresi çıkar.
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
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
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
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
Uzlaştırma mimarisi: sözleşmeler, pencereler, ekstreler, yükümlülükler· Belge
İkili, sürümlü sözleşmeler dönemi, ek süreyi, itiraz penceresini, ücret dağılımını, ödeme otomasyonunu ve kur politikasını tanımlar; pencereler OPEN → GRACE_PERIOD → RECONCILING → CLOSED, ekstreler GENERATED → PUBLISHED → ACKNOWLEDGED ilerler ve hub imzalıdır; yükümlülükler borçlu, alacaklı, tutar ve vade taşır.
Destekler:Uzlaştırma sayfasında anlatılan yapıyı.
Göstermez:Herhangi bir oran, tutar veya gerçek para hareketini; elle mod dışındaki ödeme otomasyonu finansal go-live kapısından sonra partner başına kurulur.
Kaynak: Hub deposu, docs/architecture/settlement (alan modeli, durum makineleri, dönem hesabı) · Doğrulama4 Ekim 2026
- 01sessions
Şarjlanma iletilir
Durum geçişleri ve şarj dönemleri, yalnız kabul edilmiş ilişki boyunca.
- 02cdrs
CDR doğrulanır
Tarife ve şarjlanmayla karşılaştırılır; tekrar gönderim idempotent alınır.
- 03tr-cdradditionals
TR alanları eşleşir
Türkiye kapsamındaki CDR, ek kaydıyla CDR anahtarı üzerinden buluşur.
- 04OPEN → CLOSED
Pencereye girer
Partner çiftinin açık penceresine; kapanışta hub imzalı ekstre.
Sınırlar
Hub’ın yapmadıkları
Her cümle ilgili modülün kapsam metninden gelir; kimse varsaymasın diye yazılmıştır.
- 01
Şarj programı hesaplamaz: akıllı şarj profillerini iletir, hesaplamaz.
chargingprofiles → - 02
Ödeme kuruluşu değildir ve kart sahibi verisi işlemez; para, tarafların kendi ödeme sağlayıcıları arasında hareket eder.
payment → - 03
Cihazları sorgulamaz: durum güncellemelerini CPO yayımladığı kadar güncel iletir.
locations → - 04
Kabul edilmiş ilişki olmadan veri taşımaz: el sıkışma tamamlanmış olsa bile.
credentials →
Sık sorulan sorular
El sıkışmayı tamamladım; partnerim neden lokasyonlarımı görmüyor?
Çünkü el sıkışma kimliği kurar, kapsamı değil. Partnerle ilişkinin iki tarafça kabul edilmiş ve bir paylaşım setine işaret ediyor olması gerekir. Hiçbir sette olmayan lokasyon her partnere görünmezdir.
Partnerim farklı OCPI sürümünde; ne yapmam gerekir?
Hiçbir şey. Hub sürümü her partnerle ayrı uzlaşır ve nesnelerin farklılaştığı yerde 2.2.1 ile 2.3.0 arasında çevirir. Kendi sürümünüzü seçer, partnerinizinkini hub’a bırakırsınız.
Bir şarjlanma ne zaman uzlaştırmaya girer?
CPO CDR’ı gönderdiğinde. CDR tarife ve şarjlanmayla doğrulanır ve o partner çifti için açık pencereye girer. Geç gelen CDR’lar ek sürede alınır; itirazlar kapanıştan önce görünür. Ayrıntılar uzlaştırma sayfasında.
İş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