Sizin sisteminiz ticari verinin sahibi kalır; platform teknik veriyi işletir.
Abone, sözleşme, tarife ve fatura sizin sisteminizde. Sayaç, okuma, olay, iş emri ve depo platformda. Ortak anahtar tek: tesisat numarası. Bu ayrım sayesinde faturalama sisteminizde yazılım değişikliği gerekmez.
Sayaç, okuma, olay, iş emri, depo, kalibrasyon.
Abone, sözleşme, tarife, fatura, tahsilat.
Üç sözleşme, sıfır değişiklik.
Bugün sayaç verisini nasıl alıyorsanız (okuyucu rota dosyası, endeks dosyası, kesme listesi) platform aynı arayüzlerin yerine geçer.
Ana veri, içeri
Abone no, tesisat no, adres, abonelik durumu, sayaç seri no. Günlük tam ya da fark dosyası olarak SFTP kutunuza bırakılır; platform gece alır, sonuç dosyasıyla raporlar. Eksik satır silinmez, işaretlenir.
Dönem endeksi, dışarı
Dönem sonunda doğrulanmış endeksler sizin el terminali dosya formatınızda üretilir. Faturalama sistemi için "başka bir okuyucu" gelmiş gibidir. İsteyen firma aynı veriyi API ile çeker.
Emir ve sonuç
Kesme/açma listesi platforma gelir, vana komutu çift onayla iletilir, sonuç aynı formatta saha raporu olarak döner. Kurumsal firmalar için REST karşılığı ve webhook.
Abone ya da tesisat numarasıyla, tek çağrıda.
Firmanızın abone uygulaması ya da faturalama sistemi, abone veya tesisat numarasıyla sayaç verisine ulaşır. Kimlik: firma başına entegrasyon istemcisi (OAuth2 client credentials), kapsamlı yetkiler, IP izin listesi, isteğe bağlı mTLS. Her çağrı kullanım defterine kaydedilir.
| Uç | Ne verir |
|---|---|
GET /v1/subscribers/{aboneNo}/usage-points | Abonenin tesisatları ve takılı sayaç özeti |
GET /v1/usage-points/{tesisatNo} | Sayaç durumu: vana, son veri zamanı, saat sapması, pil, sinyal, kalibrasyon geçerliliği |
GET …/readings?from&to&granularity | Endeks ve tüketim; saatlik, günlük, aylık; ölçülen / tahmini kalite bayrağı |
GET …/events | Olay ve alarmlar, abone dilinde açıklamayla |
POST …/requests | Talep aç (sayaç kontrolü, endeks itirazı, taşınma); iş emrine dönüşür, durumu izlenir |
GET /v1/readings/billing?period | Dönem sonu endeksleri, tüm tesisatlar, sayfalı ya da CSV |
PUT /v1/master-data/usage-points | Ana veri toplu güncelleme ve satır bazlı doğrulama raporu |
PUT /v1/webhooks | Vana değişti, alarm, sessiz sayaç, talep güncellendi, dönem hazır olayları |
GET /v1/usage-points/34-KAD-0001127/readings?from=2026-08-01&to=2026-09-01&granularity=day
Authorization: Bearer eyJ…
200 { "unit": "m3", "kind": "Vm",
"items": [ { "period": "2026-08-01", "indexEnd": 12604.9, "consumption": 2.8, "quality": "MEASURED" } ] }/v1; en az 12 ay geri uyumluluk; hatalar RFC 7807 biçiminde, okunabilir başlıkla. Sınırlar: anahtar alma IP başına dakikada 30, veri uçları istemci başına dakikada 600 (deneme ortamında 120); aşımda 429. Entegrasyon anahtarını firma yöneticiniz konsoldan üretir; ayrıntılı uç belgesi ve deneme ortamı konsolda, firmanızın yetki verdiği kişilere açıktır. Güvenlik açığı bildirimi: /.well-known/security.txt.Ana veri sözleşmesi
UTF-8 CSV, noktalı virgül, başlık satırı zorunlu. Zorunlu sütunlar: tesisat_no, abone_no, abonelik_durumu, il, ilce. İsteğe bağlı: sayaç seri, adres satırı, koordinat, abone tipi, iletişim.
Dosya kazanır; dosyada olmayan tesisat silinmez, "kaynakta yok" olarak işaretlenir; tam dosyada satırların beşte birinden fazlası kaybolursa çalışma durur ve yöneticiye sorulur.
Kişisel veri
Platform kimlik numarası, fatura, borç ve tarife tutmaz. İletişim bilgisi yalnız firma verirse ve verdiği kadar tutulur; abonelik kapanınca firma ayarındaki süre sonunda anonimleştirilir.
Firma veri sorumlusu, platform işleticisi veri işleyendir; sözleşmeye veri işleme eki ve alan listesi eklenir.
İlk tam yüklemeden ilk dönem kapanışına.
Beş adım; ilk üçü çoğu firmada birkaç gün, dönem testi bir fatura dönemi sürer.
- 01 Sınır toplantısı: hangi veri kimde kalıyor, tesisat numarası formatı, dönem takvimi.
- 02 Ana veri dosyasının ilk tam yüklemesi ve doğrulama raporu (aynı gün).
- 03 Pilot sayaç grubu: kurulum iş emirleri, ilk okumalar, okuma kalitesi izleme.
- 04 Dönem endeksi dosyasının faturalama sisteminde test edilmesi.
- 05 İsteğe bağlı: entegrasyon istemcisi, API ve webhook; sandbox ile geliştirici testi.
Tam uç listesi, şemalar ve örnek kodlar geliştirici portalında yayımlanacak. Erken erişim için bize yazın.