İçeriğe geç
e-Gridium
Menü

Hub

Partnerler

Bağlanmak için başvurun English

Partnerler · Katılım ve sandbox

Katılım iki kapıdan geçer: teknik ve finansal

Teknik kapı partner başına kapanır; finansal kapı hub’ın tamamı için bir kez. İkisi birbirinden bağımsız ilerler: teknik olarak bağlı bir partner, finansal kapı kapanmadan da ekstrelerini görür. Bu sayfa iki kapıyı, el sıkışmayı, rol başına ön koşulları ve sandbox’ı anlatır.

Bağlanmak için başvurun İki kapı ↓ NSP’ler için ↓
OCPI credentials el sıkışması: Token A ile versions, version details, Token B ve C değişimi, ardından iki tarafça kabul edilen ilişki.
El sıkışma dört adımdır ve kimliği kurar; veri akışı ancak ilişki iki tarafça kabul edilince başlar.

İki kapı

Teknik kapı veriyi açar, finansal kapı parayı

01 · Teknik kapı

Partner başına kapanır

El sıkışma, veri akışı ve dry-run ekstreler

Sözleşme ve veri işleme sözleşmesi imzalandıktan sonra credentials el sıkışması önce sandbox’ta tamamlanır, ardından ilişkiler açıkça kabul edilir. Lokasyon, tarife, şarjlanma ve CDR’lar akar; her uzlaştırma penceresi netleştirme ekstresiyle kapanır. Bu aşamada ekstreler dry-run’dır: tutarlar görünür, fatura kesilmez.

Kapıyı kapatan

  • İmzalı katılım sözleşmesi ve veri işleme sözleşmesi
  • Hub’dan erişilebilen OCPI versions ucu ve Token A
  • Rolünüzün gönderen ve alan modülleri sandbox’ta denenmiş
  • İlk ilişki iki tarafça kabul edilmiş

Kapandığında açılan

  • El sıkışma ve hub dizininde tarafınız
  • Kabul edilmiş ilişkiler boyunca veri akışı
  • Her pencere için dry-run netleştirme ekstresi
1/4 Kaynak kodda var
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

Tüm kanıt kayıtları →

02 · Finansal kapı

Hub için bir kez kapanır

Gerçek para

Finansal kapı, netleştirme ekstrelerinin ödeme yükümlülüğüne ve faturaya dönüştüğü andır. Hub’ın tamamı için bir kez kapanır ve kapanmadan önce üç şartın yerine gelmesi gerekir. Kapanış tarihi bu sitede yayımlanmaz; bağlı partnerlere doğrudan bildirilir.

Kapıyı kapatan

  • Her bağlı partnerle imzalı veri işleme sözleşmesi
  • Düzenleyici kayıtların tamamlanması
  • E-fatura kanalının çalışır olması

Kapandığında açılan

  • Ekstreden ödeme yükümlülüğü
  • Fatura ve e-fatura
  • Sözleşmede seçilen kanaldan para hareketi
1/4 Kaynak kodda var
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ı →

El sıkışma

Dört çağrı, sonra bir karar

Hub’ın yürüttüğü OCPI 2.2.1 credentials el sıkışması. Adresler yer tutucudur; hub ucu katılımda verilir. Üç adım protokoldür, dördüncüsü portaldaki açık karardır.

  1. 01

    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.

  2. 02

    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.

  3. 03

    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.

  4. 04

    İ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.

Teknik ön koşullar

Hub’ın partner tarafında aradığı arayüzler

Her partnerden istenenler, rol başına modül arayüzleri ve ağ davranışı. Modül adları OCPI version details kataloğundaki kimliklerdir.

01 · Her partner

  • 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

02 · CPO

ModülArayüz
locationsGönderen
tariffsGönderen
sessionsGönderen
cdrsGönderen
tokensAlan
commandsAlan
tr-cdradditionalsGönderen (Türkiye)

03 · eMSP

ModülArayüz
locationsAlan
tariffsAlan
sessionsAlan
cdrsAlan
tokensGönderen + gerçek zamanlı yetkilendirme
commandsGönderen

04 · Ağ 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

Neye ihtiyacınız var

Rol başına gereksinimler, kapısıyla

Her madde hangi kapıya ait olduğunu söyler. Liste katılım sözleşmesinin yerine geçmez; eksik maddeler sandbox aşamasında birlikte listelenir.

CPO

6 madde

Şarj ağı işletmecileri için

  • Teknik kapı

    İmzalı roaming katılım sözleşmesi ve veri işleme sözleşmesi

  • Teknik kapı

    Unvan, vergi numarası ve varsa şarj ağı işletmeci lisans numarası

  • Teknik kapı

    Hub’dan erişilebilen bir OCPI versions ucu ve el sıkışma için Token A

  • Teknik kapı

    Lokasyon, tarife, şarjlanma ve CDR için gönderen; token ve komut için alan uygulama

  • Finansal kapı

    Her CDR’da tr-cdr-additionals alanlarının doldurulması

  • Finansal kapı

    Sözleşmede belirlenen tahsilat ve faturalama bilgileri

CPO’lar için →

eMSP

6 madde

Mobilite hizmet sağlayıcıları için

  • Teknik kapı

    İmzalı roaming katılım sözleşmesi ve veri işleme sözleşmesi

  • Teknik kapı

    Unvan ve vergi numarası

  • Teknik kapı

    Hub’dan erişilebilen bir OCPI versions ucu ve el sıkışma için Token A

  • Teknik kapı

    Lokasyon, tarife, şarjlanma ve CDR için alan; token ve komut için gönderen uygulama

  • Teknik kapı

    Token’lar için gerçek zamanlı yetkilendirme ucu

  • Finansal kapı

    Sözleşmede belirlenen tahsilat ve faturalama bilgileri

eMSP’ler için →

NSP

2 madde

Navigasyon ve veri sağlayıcıları için

  • Teknik kapı

    Veri tüketicisi rolü için imzalı katılım sözleşmesi

  • Teknik kapı

    Lokasyon ve tarifeler için yalnız alan OCPI ucu

NSP’ler için →

NSP · veri tüketicisi

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.

Kullandığınız modüller

credentialslocationstariffshubclientinfo

Navigasyon veya veri sağlayıcısı (NSP) · Bağlanmak için başvurun

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
  • Her CPO’nun yayın kararına uymak

İşin nasıl ilerlediği

  1. 01

    Başvuru

    Veri tüketicisi olarak başvurursunuz; sözleşme aldığınız verinin kullanımını kapsar.

  2. 02

    El sıkışma

    Alan ucunuza karşı gelen kayıt.

  3. 03

    Yayın kararları

    Her CPO size yayımlayıp yayımlamayacağına ve neyi yayımlayacağına karar verir; varsayılan hiçbir şeydir.

Yalnız alıcı

NSP rolünün gönderen modülü yoktur. Şarjlanma, CDR, token ve komutlar veri tüketicisine asla ulaşmaz; uzlaştırma platformu rolün varlığından haberdar değildir.

Veri kullanımı

Akışla ne yapabileceğiniz protokolde değil sözleşmede belirlenir. Hub kapsamı, siz kullanımı uygularsınız.

Hub portalında gördükleriniz

  • ▸Sözleşmem ve ilişkilerim
  • ▸Kayıtlarım: alınan lokasyonlar
  • ▸Veri kalitesi

Test ortamı

Partner sandbox’ı

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.

1/4 Kaynak kodda var
Kanıtı incele

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

Tüm kanıt kayıtları →

Sonrası

Başvurduktan sonra ne olur

  1. 01

    Rolünüz ve versions ucunuzla başvurun

    Başvurunuz iş e-postanızdan yanıtlanır; rolünüz ve versions ucunuz doğrulanır.

  2. 02

    Katılım sözleşmesini ve veri işleme sözleşmesini imzalayın

    Sözleşme ve veri işleme sözleşmesi şablonları paylaşılır; imza sonrasında tarafınız hub dizininde oluşturulur ve sandbox kimlik bilgileri verilir.

  3. 03

    Sandbox’ta el sıkışın, sonra ilişkileri kabul edin

    Sandbox’ta el sıkışma ve modül kontrolleri tamamlanır; ilk ilişkiler kabul edilir ve veri akar.

İşin nasıl ilerlediği

  1. 01Rolünüz ve versions ucunuzla başvurun
  2. 02Katılım sözleşmesini ve veri işleme sözleşmesini imzalayın
  3. 03Sandbox’ta el sıkışın, sonra ilişkileri kabul edin

Ağınızı veya uygulamanızı bir kez bağlayın; gerisine partner başına karar verin.

Bağlanmak için başvurun Katılım ve sandbox →