83 lines
4.1 KiB
Markdown
Executable File
83 lines
4.1 KiB
Markdown
Executable File
# 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:
|
|
|
|
1. l'import FE crea o trova `rubrica_universale` e `fornitori` nello scope amministratore;
|
|
2. `AreraFornitoreClassifier` cerca `arera_operatori.partita_iva_normalizzata`;
|
|
3. copia dati utili ARERA come sito web, sede e settori quando disponibili;
|
|
4. marca il fornitore con tag `arera` e `servizi_utenze`;
|
|
5. imposta `fornitori.escludi_righe_fe = true` per evitare import righe FE non affidabili per questi operatori;
|
|
6. 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`.
|