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.
Perché un catalogo
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
| Cluster | Controparti | Esempi di flussi |
|---|---|---|
| Mercato e regolazione | SII tramite Porta di Comunicazione (PdC) e portale, distributori, GSE | richieste di switching, voltura, prestazioni tecniche, esiti, anagrafica punti, misure |
| Vendite e agenzie | canali di vendita, agenti, piattaforme di proposta | acquisizione contratti, provvigioni, legami agenzia-canale |
| Firma e identità | firma elettronica, identificazione | firma digitale dei contratti, SPID/identificazione |
| Credito e antifrode | società di informazioni commerciali | credit check, scoring, segnalazioni antifrode |
| Pagamenti | banche, circuiti carte, gestori di pagamento | mandati SEPA, addebiti diretti, carte, pagamenti digitali |
| Incassi | banche e tesoreria | flussi di riconciliazione, bollettini, attestazioni di pagamento |
| Stampa e postalizzazione | fornitori di stampa e recapito | bollette cartacee, solleciti, raccomandate |
| Fatturazione elettronica | Sistema di Interscambio (SDI) | invio fatture, ricezione ricevute e scarti |
| Contabilità | ERP contabile | registrazione documenti, esiti, fatture passive |
| Recupero crediti e legale | società di recupero, studi legali | cessione e affido pratiche |
| Contact center | CTI, IVR, telefonia | schermata al cliente, tracciamento chiamate |
| App e area clienti | canali digitali | consultazione e richieste self-service |
| Data platform e BI | data lake, reporting | estrazioni, flussi per analisi |
| Marketing | marketing automation, CDP | consensi, campagne, segmentazione |
| Indirizzi | stradario, normalizzazione | validazione indirizzi |
| Accessi | gestione identità e accessi (IAM) | SSO, ruoli |
| Fibra | operatori wholesale e infrastrutturati | verifica 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:
- Scopo e riferimenti (documenti funzionali, norme; ciò che il fornitore non può leggere va riassunto nel documento).
- Acronimi e sistemi coinvolti.
- Schema architetturale con sequenza dei flussi.
- 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.
- Diagrammi di sequenza per scenario (attivazione, modifica, disattivazione).
- Dettagli transazionali: protocollo, tipo di interfaccia, raggiungibilità, autenticazione, risposta sincrona o asincrona, ACK/NACK, gestione eccezioni, codifica.
- Contesto: frequenza (tempo reale, batch, a eventi), modalità di allineamento (completo, incrementale, differenziale, quasi in tempo reale).
- Formati: struttura dei payload, codifiche, validazioni.
- Sicurezza e dati personali: base giuridica, minimizzazione, cifratura, retention.
- 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.