Il catalogo delle integrazioni di un venditore di energia: cosa collegare e come documentarlo

Mappa dei sistemi con cui un CRM/billing deve dialogare, e un modello di scheda per governarli

Processo verticaleutilityCRMintegrazioniSIIspecifiche19 novembre 2026 · 6 min di lettura

Il progetto parte con un elenco di integrazioni e ne scopre molte altre in corso d'opera. Il SII, i distributori e lo SDI sono imposti dal mercato; vendite, pagamenti e stampa li sceglie l'azienda. Un master con un identificativo per ogni flusso è lo strumento di governo più utile.

Nei progetti di sostituzione di CRM e billing le integrazioni sono la prima causa di slittamento: sono tante, coinvolgono fornitori diversi e ciascuna ha un proprio ciclo di vita. Un catalogo unico, organizzato per cluster (famiglie di flussi omogenei), permette di sapere quali flussi esistono, chi è il proprietario, in che stato di specifica e di test si trova, e quali processi di business ne dipendono.

La mappa tipica

ClusterContropartiEsempi di flussi
Mercato e regolazioneSII tramite Porta di Comunicazione (PdC) e portale, distributori, GSErichieste di switching, voltura, prestazioni tecniche, esiti, anagrafica punti, misure
Vendite e agenziecanali di vendita, agenti, piattaforme di propostaacquisizione contratti, provvigioni, legami agenzia-canale
Firma e identitàfirma elettronica, identificazionefirma digitale dei contratti, SPID/identificazione
Credito e antifrodesocietà di informazioni commercialicredit check, scoring, segnalazioni antifrode
Pagamentibanche, circuiti carte, gestori di pagamentomandati SEPA, addebiti diretti, carte, pagamenti digitali
Incassibanche e tesoreriaflussi di riconciliazione, bollettini, attestazioni di pagamento
Stampa e postalizzazionefornitori di stampa e recapitobollette cartacee, solleciti, raccomandate
Fatturazione elettronicaSistema di Interscambio (SDI)invio fatture, ricezione ricevute e scarti
ContabilitàERP contabileregistrazione documenti, esiti, fatture passive
Recupero crediti e legalesocietà di recupero, studi legalicessione e affido pratiche
Contact centerCTI, IVR, telefoniaschermata al cliente, tracciamento chiamate
App e area clienticanali digitaliconsultazione e richieste self-service
Data platform e BIdata lake, reportingestrazioni, flussi per analisi
Marketingmarketing automation, CDPconsensi, campagne, segmentazione
Indirizzistradario, normalizzazionevalidazione indirizzi
Accessigestione identità e accessi (IAM)SSO, ruoli
Fibraoperatori wholesale e infrastrutturativerifica copertura, attivazione, guasti

I flussi del SII meritano un cenno: lo scambio avviene via portale web (singole pratiche o caricamenti massivi) oppure tramite PdC da sistema a sistema (A2A), con struttura dei messaggi conforme alla specifica pubblicata dall'Acquirente Unico. Le specifiche dei processi sono pubbliche e cambiano nel tempo: ad esempio il processo di Preliminary Check, introdotto come fase propedeutica per lo switching del reseller, è descritto in un documento pubblico del SII con data di avvio da verificare.

Il modello di scheda di specifica

Per ogni flusso conviene un documento strutturato (schema di sistema, o SDD) accanto a una scheda sintetica funzionale (IFA). I contenuti minimi:

  1. Scopo e riferimenti (documenti funzionali, norme; ciò che il fornitore non può leggere va riassunto nel documento).
  2. Acronimi e sistemi coinvolti.
  3. Schema architetturale con sequenza dei flussi.
  4. Sommario eventi: per ciascun servizio, scopo, direzione (monodirezionale o bidirezionale), metodo (web service, file transfer, database to database, messaggistica), evento, funzione, sistema di origine e di destinazione.
  5. Diagrammi di sequenza per scenario (attivazione, modifica, disattivazione).
  6. Dettagli transazionali: protocollo, tipo di interfaccia, raggiungibilità, autenticazione, risposta sincrona o asincrona, ACK/NACK, gestione eccezioni, codifica.
  7. Contesto: frequenza (tempo reale, batch, a eventi), modalità di allineamento (completo, incrementale, differenziale, quasi in tempo reale).
  8. Formati: struttura dei payload, codifiche, validazioni.
  9. Sicurezza e dati personali: base giuridica, minimizzazione, cifratura, retention.
  10. Monitoraggio e riconciliazione: log, allarmi, riprocessamento.

Una matrice di completezza con una colonna per ogni sezione evita schede monche.

Naming e governance

  • Identificativo univoco per flusso (lettera di famiglia, numero, eventuale sottonumero) e cartella con il nome "ID: obiettivo dell'interfaccia", organizzata per cluster.
  • Il master è la fonte unica: collega il flusso a processo, sistemi, proprietario, versione dei documenti, stato di test.
  • Approvazioni: valgono i verbali con approvazione esplicita o le mail in cui compaiono chiaramente entrambi i fornitori coinvolti; un documento non approvato resta in bozza.
  • Punti aperti con identificativo progressivo per ambito, titolo, proprietario, priorità, fase che bloccano, data di scadenza originale, flusso impattato.
  • Ritmo settimanale: bozza dello stato avanzamento, verifica congiunta, riunione, aggiornamento del master il giorno stesso.
  • Ambienti: per ogni flusso, quali ambienti sono disponibili e con quali dati di test.

Casi particolari e rischi

  • Flussi a più hop (CRM verso SII passando per un orchestratore) richiedono responsabilità chiare sull'esito finale.
  • Fatturazione elettronica: gli scarti SDI vanno ricondotti alla fattura e a un task di correzione.
  • Pagamenti: mandati e tracciati bancari hanno finestre di cut-off e codici di rifiuto standard.
  • Dati personali: ogni integrazione che sposta dati verso un terzo richiede nomina a responsabile del trattamento ove applicabile.
  • Flussi dismessi: tenere traccia di quelli eliminati, per non riattivarli per errore.

Errori frequenti

  • Specificare solo il "caso felice" e non rifiuti, timeout, duplicati e riprocessamento.
  • Lasciare l'idempotenza implicita: una notifica doppia non deve creare due pratiche.
  • Trascurare l'ordine degli eventi tra flussi diversi.
  • Non prevedere l'ambiente di test della controparte.
  • Documentazione che vive in mail e non nel repository.

Domande frequenti

Serve una scheda anche per un file giornaliero? Sì: frequenza, finestra di scambio e gestione dei ritardi sono parte del contratto.

IFA e SDD sono la stessa cosa? No: la prima sintetizza il requisito funzionale, la seconda il dettaglio tecnico per i fornitori.

Chi approva? I proprietari dei sistemi coinvolti, non solo il committente.

Come si tiene aggiornato il catalogo dopo il go-live? Con il processo di change: nessun flusso cambia senza aggiornare master e scheda.

Riferimenti normativi

  • Regolamento di funzionamento del SII, approvato con la Deliberazione ARERA 79/2012/R/com (in attuazione della ARG/com 201/10 che ha istituito il SII) e successivamente aggiornato (tra l'altro dalla 455/2020/R/com): https://www.arera.it/allegati/docs/12/079-12.pdf ; https://siiportale.acquirenteunico.it/funzionamento-del-sii/regolamento-di-funzionamento
  • Specifiche tecniche del Portale Web e della PdC (Acquirente Unico): https://siiportale.acquirenteunico.it/processi/trasversali/portale-web-e-pdc
  • Legge 13 agosto 2010, n. 129, art. 1-bis (istituzione del SII presso Acquirente Unico): https://www.normattiva.it
  • D.M. 3 aprile 2013, n. 55 e D.Lgs. 5 agosto 2015, n. 127, fatturazione elettronica e SDI: https://www.fatturapa.gov.it ; https://www.agenziaentrate.gov.it
  • Regolamento (UE) 2016/679 (GDPR): https://www.garanteprivacy.it
  • Regolamento (UE) n. 260/2012, requisiti tecnici per addebiti e bonifici SEPA: https://eur-lex.europa.eu
  • Direttiva (UE) 2015/2366 (PSD2) e D.Lgs. 15 dicembre 2017, n. 218: https://www.bancaditalia.it
  • D.Lgs. 7 marzo 2005, n. 82, Codice dell'amministrazione digitale (firme elettroniche): https://www.normattiva.it
  • Regolamento (UE) n. 910/2014 (eIDAS): https://eur-lex.europa.eu
  • Data di avvio del Preliminary Check e specifiche dei processi: sul portale del SII.
Questo articolo è una skill di OIAR

Quello che hai letto è il contenuto di una skill del catalogo OIAR, scritto per le persone. Una conoscenza come questa ma più ricca e profonda, scritta per gli agenti, guida le interviste, l'analisi e il report dentro la piattaforma. Le skill si usano in OIAR: per provarla su un tuo progetto serve un account.

catalogo-integrazioni-venditore-energiaMetodo per il catalogo delle integrazioni di un venditore di energia: mappa dei sistemi con cui un CRM e billing dialoga (SII, distributori, SDI, vendite, pagamenti, stampa, marketing), master con identificativo per flusso, scheda funzionale e tecnica. Usare per definire o rivedere il catalogo delle integrazioni di un progetto CRM.