Il vostro sistema resta proprietario dei dati commerciali; la piattaforma gestisce quelli tecnici.
Utenti, contratti, tariffe e fatture restano nel vostro sistema. Contatori, letture, eventi, ordini di lavoro e magazzini vivono nella piattaforma. La chiave comune è una sola: il numero del punto di misura. Grazie a questa separazione nel vostro sistema di fatturazione non serve alcuna modifica software.
Contatori, letture, eventi, ordini di lavoro, magazzini, taratura.
Utenti, contratti, tariffe, fatture, incassi.
Tre contratti, zero modifiche.
Comunque riceviate oggi i dati dei contatori — file di percorso del letturista, file degli indici, elenco distacchi — la piattaforma prende il posto di quelle stesse interfacce.
Anagrafica, in ingresso
Numero utente, numero del punto di misura, indirizzo, stato della fornitura, matricola del contatore. Depositato nella vostra cartella SFTP come file giornaliero completo o differenziale; la piattaforma lo preleva di notte e risponde con un file di esito. Una riga mancante non viene mai cancellata, solo contrassegnata.
Indice di periodo, in uscita
Alla chiusura del periodo gli indici validati vengono prodotti nel formato del vostro terminale portatile. Per il sistema di fatturazione è come se fosse passato un altro letturista. Chi preferisce può prelevare gli stessi dati via API.
Ordine ed esito
L'elenco di distacco e riattivazione arriva alla piattaforma, il comando alla valvola parte con doppia approvazione e l'esito torna come rapporto di campo nello stesso formato. Per le aziende più strutturate esistono l'equivalente REST e i webhook.
Per numero utente o punto di misura, in una sola chiamata.
La vostra app per gli utenti o il sistema di fatturazione raggiunge i dati del contatore tramite il numero utente o del punto di misura. Identità: un client di integrazione per azienda (OAuth2 client credentials), permessi circoscritti, elenco IP autorizzati e mTLS opzionale. Ogni chiamata viene scritta nel registro dei consumi.
| Endpoint | Che cosa restituisce |
|---|---|
GET /v1/subscribers/{aboneNo}/usage-points | I punti di misura dell'utente e una sintesi dei contatori installati |
GET /v1/usage-points/{tesisatNo} | Stato del contatore: valvola, ultimo dato, deriva dell'orologio, batteria, segnale, validità della taratura |
GET …/readings?from&to&granularity | Indice e consumo; orario, giornaliero, mensile; indicatore misurato / stimato |
GET …/events | Eventi e allarmi, con una spiegazione nel linguaggio dell'utente |
POST …/requests | Apri una richiesta (verifica del contatore, contestazione dell'indice, trasloco); diventa un ordine di lavoro e ne segui lo stato |
GET /v1/readings/billing?period | Indici di chiusura periodo, tutti i punti di misura, paginati o in CSV |
PUT /v1/master-data/usage-points | Aggiornamento massivo dell'anagrafica con report di validazione riga per riga |
PUT /v1/webhooks | Valvola cambiata, allarme, contatore silente, richiesta aggiornata, periodo pronto |
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; almeno 12 mesi di compatibilità all'indietro; errori in forma RFC 7807 con un titolo leggibile. Limiti: token 30 al minuto per IP, endpoint dei dati 600 al minuto per client (120 nella sandbox); 429 al superamento. Le credenziali di integrazione le genera l'amministratore della vostra azienda nella console; il riferimento dettagliato e la sandbox sono nella console, aperti alle persone che la vostra azienda autorizza. Per segnalare una vulnerabilità: /.well-known/security.txt.Il contratto sull'anagrafica
CSV UTF-8, separato da punto e virgola, riga di intestazione obbligatoria. Colonne obbligatorie: tesisat_no, abone_no, abonelik_durumu, il, ilce. Facoltative: matricola del contatore, riga di indirizzo, coordinate, tipo di utente, recapiti.
Vince il file. Un punto di misura assente dal file non viene cancellato ma contrassegnato come "non presente in origine"; se un file completo perde più di un quinto delle righe l'elaborazione si ferma e interpella l'amministratore.
Dati personali
La piattaforma non conserva codici fiscali, fatture, crediti o tariffe. I recapiti sono conservati solo se l'azienda li fornisce e solo nella misura fornita; alla chiusura della fornitura vengono anonimizzati allo scadere del periodo impostato dall'azienda.
La vostra azienda è titolare del trattamento e l'operatore della piattaforma è responsabile del trattamento; al contratto si allegano l'accordo sul trattamento dei dati e l'elenco dei campi.
Dal primo caricamento completo alla prima chiusura di periodo.
Cinque passi; per la maggior parte delle aziende i primi tre richiedono pochi giorni e il test di periodo dura un ciclo di fatturazione.
- 01 Incontro sui confini: quali dati restano dove, formato del numero di punto di misura, calendario dei periodi.
- 02 Primo caricamento completo del file di anagrafica e relativo report di validazione (stesso giorno).
- 03 Gruppo pilota di contatori: ordini di posa, prime letture, monitoraggio della qualità delle letture.
- 04 Test del file degli indici di periodo nel vostro sistema di fatturazione.
- 05 Facoltativo: client di integrazione, API e webhook, con test per sviluppatori nell'ambiente di prova.
L'elenco completo degli endpoint, gli schemi e il codice di esempio saranno pubblicati nel portale sviluppatori. Per l'accesso anticipato, scriveteci.