Her ücretli şarj oturumu, kimin kime ne kadar ödeyeceğine karar veren tek bir belgeyle biter: şarj detay kaydı, yani CDR. Sürücüler onu doğrudan görmez, ama faturalar, roaming mutabakatları, vergi raporları ve itirazlar ona dayanır. CDR'lar yanlış olduğunda para sessizce kaybolur ve ortak ilişkileri zedelenir.
Bu rehber bir CDR'ın neleri içerdiğini, CSMS'in onu OCPP verisinden nasıl oluşturduğunu ve ortaklarla nasıl mutabakat yapılacağını anlatıyor.
- CDR, tamamlanmış bir şarj oturumunun nihai ve değiştirilemez kaydıdır.
- OCPP işlem ve sayaç verisi ile geçerli tarifeden oluşturulur.
- Gönderildikten sonra CDR düzenlenmez; düzeltmeler alacak CDR'larıyla yapılır.
- Kendi oturum verinizle aylık mutabakat sessiz gelir kaybını önler.
CDR nedir?
CDR, sona ermiş bir şarj oturumunu tanımlar: kim, nerede, ne zaman şarj etti, ne kadar enerji verildi, hangi fiyatlar uygulandı ve toplam tutar nedir. Roaming'de CPO, CDR'ları eMSP'ye gönderir; eMSP bunları sürücüsünü faturalamak ve CPO'ya ödeme yapmak için kullanır. İçeride aynı kayıt kendi faturalarınızın ve raporlarınızın temelidir. Şarj sırasındaki canlı karşılığı ise oturum nesnesidir; bunu OCPI 2.2.1 modülleri rehberimizde anlattık.
OCPI CDR'ındaki temel alanlar
| Alan | İçeriği |
|---|---|
| id | CPO'nun verdiği benzersiz CDR kimliği |
| start_date_time / end_date_time | UTC olarak oturum başlangıcı ve bitişi |
| session_id | İlgili oturuma bağlantı |
| cdr_token | Kullanılan kimlik: RFID UID, uygulama token'ı ve sözleşme kimliği |
| auth_method | Oturumun nasıl yetkilendirildiği, ör. beyaz liste veya gerçek zamanlı |
| cdr_location | Şarj anındaki adres, koordinat, EVSE kimliği ve soket bilgisi |
| currency ve tariffs | Para birimi ve uygulanan tarifeler |
| charging_periods | Enerji, süre ve park boyutlarını içeren zaman blokları |
| signed_data | Doğrulama için isteğe bağlı imzalı sayaç değerleri |
| total_cost, total_energy, total_time, total_parking_time | Faturalamada kullanılan toplamlar |
| credit, credit_reference_id | Alacak CDR'ını işaretler ve asıl kayda bağlar |
CSMS, CDR'ı OCPP'den nasıl oluşturur?
- Başlangıç: Cihaz, başlangıç sayaç değeri ve yetkili kimlikle StartTransaction (OCPP 1.6J) ya da eventType Started olan bir TransactionEvent (OCPP 2.0.1) gönderir.
- Şarj sırasında: MeterValues mesajları ayarlı aralıklarla enerji, güç ve bazen şarj durumunu bildirir.
- Bitiş: StopTransaction ya da TransactionEvent Ended son sayaç değerini, durma nedenini ve ayarlandıysa işlem verisini verir.
- Fiyatlama: CSMS, oturum başında geçerli olan tarifeyi enerji, süre ve boşta bekleme süresine uygular.
- Kesinleştirme: CDR oluşturulur, saklanır ve ortaklara gönderilir ya da faturalamada kullanılır.
Mesaj akışını StartTransaction ve StopTransaction yazımızda anlattık.
Şarj dönemleri: gizli ayrıntı
CDR yalnızca bir toplam değildir. Şarj dönemleri, fiyatı etkileyen bir boyut değiştiğinde oturumu bloklara böler; örneğin zamana bağlı tarife penceresi bittiğinde ya da araç şarjı bitirip takılı kaldığında. Ortaklar fiyatı yeniden hesaplamak için bu dönemleri kullanır. Dönemleriniz yayınladığınız tarifeyle uyuşmazsa eMSP toplamınızı doğrulayamaz ve itiraz eder.
Alacak CDR'ları ve düzeltmeler
Gönderilmiş bir CDR nihaidir. Sayaç hatası ya da yanlış uygulanan tarife gibi bir sorun varsa önce asıl kaydı sıfırlayan bir alacak CDR'ı, ardından yeni ve doğru bir CDR gönderirsiniz. Böylece iki tarafın da izleyebileceği bir denetim izi kalır. Karşılığında alacak kaydı olmadan kendi veritabanınızdaki toplamları asla sessizce değiştirmeyin.
İmzalı sayaç değerleri
Ölçüm kuralları katı olan pazarlarda cihazlar sayaç okumalarını imzalayabilir; böylece sürücü ya da üçüncü bir taraf enerji değerlerinin değiştirilmediğini doğrulayabilir. Bu imzalı değerler CDR'ın signed data alanında taşınabilir. İmzalamayı sayaç ve yazılım desteklemelidir; yerel kuralları ve donanımınızın yeteneklerini kontrol edin.
Yanlış CDR'ların yaygın nedenleri
- Cihaz yeniden başladığında ya da bağlantıyı kaybettiğinde eksik kalan stop işlemleri ve açık kalan oturumlar.
- Yazılım güncellemesinden sonra sıçrayan veya sıfırlanan sayaç değerleri.
- Cihaz saatindeki kayma; yanlış zamanlar ve yanlış zamana bağlı fiyat.
- Değişiklikten önce başlamış oturumlara uygulanan tarife değişiklikleri.
- Şarj bitişi yerine kablo bağlantı süresi üzerinden hesaplanan bekleme ücretleri; bkz. bekleme ücretleri.
- Tekrar denemelerden sonra idempotency kontrolü olmadan gönderilen mükerrer CDR'lar.
Mutabakat kontrol listesi
- CSMS'teki ortak başına oturum sayısını gönderilen ve onaylanan CDR'larla karşılaştırın.
- Ortak başına aylık toplam enerjiyi ortağın ekstresiyle karşılaştırın.
- Sıfır enerjili, çok uzun süren veya negatif değerli oturumları inceleyin.
- Her alacak CDR'ının var olan bir asıl kayda referans verdiğini kontrol edin.
- Her ortakla bir itiraz süresi ve süreci üzerinde anlaşın ve belgeleyin.
Saklama ve gizlilik
CDR'lar kişiye bağlanabilen token kimlikleri ve konumlar gibi kişisel veriler içerir. Vergi ve sözleşme yükümlülüklerinin gerektirdiği süre boyunca saklayın, erişimi kısıtlayın ve dışa aktarımlarda ve ortak paylaşımlarında KVKK ve veri koruma kurallarınızı uygulayın.
Sıkça sorulan sorular
CDR'ı kim oluşturur?
Cihazı ve sayaç verisini kontrol ettiği için CPO'nun platformu oluşturur. eMSP ise alır ve faturalamada kullanır.
eMSP bir CDR'ı reddedebilir mi?
eMSP, ortaklık sözleşmesi kapsamında CDR'a itiraz edebilir. Temiz tarifeler, doğru sayaç verisi ve net şarj dönemleri itirazları azaltır.
CDR ne kadar hızlı gönderilmeli?
Oturum kesinleşir kesinleşmez. Gecikmeler eMSP'de fatura gecikmesi yaratır ve mutabakatı zorlaştırır.
Üreticy, OCPP sayaç verisinden CDR oluşturur, tarifelerinizi uygular ve denetim ile ortak mutabakatı için tam kayıt tutar. Faturalama ve raporlama özelliklerine bakın veya bize ulaşın.