Operatori ARERA e fornitori servizi

Obiettivo

Il catalogo ARERA e una sorgente Super Admin per riconoscere operatori di servizi e utenze: luce, gas, acqua, rifiuti, calore e altri settori regolati.

Il dato rimane centrale e non viene duplicato negli amministratori finche non serve pubblicarlo come fornitore operativo.

Import Super Admin

Pagina: admin-filament/superadmin/operatori-arera

Il file atteso e l'export Excel ARERA operatori-export-*.xlsx con intestazioni come:

Societa
Id Soggetto
Natura Giuridica
Partita IVA
Gruppo Societario
Sito Internet
Sede Legale
Sede Operativa
Settori Attivita
Contatti Cliente
Contatti Clienti2

La pagina supporta due modalita:

Scarica ZIP ARERA: scarica direttamente un file ZIP dal dominio arera.it, estrae gli Excel contenuti e aggiorna il catalogo.
Importa Excel ARERA: importa un file Excel gia scaricato/caricato manualmente.

Gli URL ARERA cambiano nel tempo perche includono data e ora. La maschera contiene preset rapidi ma permette anche di incollare un URL ZIP aggiornato, per esempio:

operatori-export-...zip
export-mercato-vend...zip
export-gas-vend...zip

L'import e idempotente sulla P.IVA normalizzata: rilanciare lo stesso ZIP aggiorna i record esistenti senza duplicare operatori.

Nota operativa: l'export completo ARERA puo essere pesante e richiedere diversi minuti. Se viene interrotto, i record gia importati restano validi e l'operazione puo essere rilanciata.

L'import usa Partita IVA come chiave certa e salva:

arera_operatori: anagrafica operatore centrale
arera_nature_giuridiche: natura giuridica normalizzata
arera_settori_attivita: settori normalizzati
arera_operatore_settore: relazione molti-a-molti tra operatore e settori

Normalizzazione dati

I valori separati da ; in Settori Attivita, Contatti Cliente e Contatti Clienti2 vengono separati e indicizzati per ricerca.
Sede Legale e Sede Operativa vengono salvate sia come testo originale sia nei campi indirizzo, CAP, citta e provincia quando il formato e riconoscibile.
Sito Internet viene salvato con schema https:// se il file contiene solo il dominio.

Aggancio ad amministratore

La tabella ARERA non e un passaggio manuale per creare fornitori agli amministratori. Il flusso corretto e automatico: quando arriva una FE, NetGescon usa la P.IVA del fornitore per cercare l'operatore ARERA e classificare il fornitore nello scope dell'amministratore/stabile.

La procedura automatica:

l'import FE crea o trova rubrica_universale e fornitori nello scope amministratore;
AreraFornitoreClassifier cerca arera_operatori.partita_iva_normalizzata;
copia dati utili ARERA come sito web, sede e settori quando disponibili;
marca il fornitore con tag arera e servizi_utenze;
imposta fornitori.escludi_righe_fe = true per evitare import righe FE non affidabili per questi operatori;
salva in operational_config il riferimento ARERA e i settori.

Quando il fornitore ARERA e collegato a una FE di uno stabile, NetGescon prova anche a creare/aggiornare fornitore_stabile_impostazioni:

per settore gas usa service_type = riscaldamento e service_supplier_kind = gas;
se nello stabile esiste una voce spesa riscaldamento con descrizione compatibile (Combustibile, Gas, Metano), la imposta come voce_spesa_default_id;
la voce resta modificabile dalla pagina impostazioni fornitori per stabile.

Esempi verificati:

B1 GAS S.P.A. P.IVA 10991371005: classificato come Gas vendita, sito http://www.b1gas.it, righe FE escluse.
ROMA OIL COMPANY S.R.L. P.IVA 12420101003: classificato come Gas vendita, sito http://www.romaoilcompany.it, righe FE escluse.
Per lo stabile 0021, entrambi sono stati associati alla voce spesa 46 (Combustibile, gestione riscaldamento).

Nota Google indirizzi

L'integrazione Google per normalizzare vie e indirizzi va trattata come servizio separato: il catalogo ARERA conserva sempre il testo originale e i campi parsati localmente. Una futura normalizzazione Google dovra arricchire i campi senza cancellare sede_legale_raw e sede_operativa_raw.

4.1 KiB Executable File Raw Blame History