feat: provinces and municipalities from the ISTAT list in the base data (#45)

New companies now get the 110 provinces and 7,894 municipalities in force
(ISTAT list of 26/02/2026, CC BY 4.0), so the tax code calculation and the
municipality lookups work without loading anything. The list lives in the
Italian pack behind a new IPlaceDirectory feature and is added by the base
seeder like the rest of the base data: missing codes only, never touching
existing rows. The pack data version moves to IT 2026.3 so existing
companies receive the lists at the next start.

Postal codes are left out: the only candidate source (comuni-json) has no
licence for them and stops at 2020 (ADR 0028).

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This commit is contained in:
Alby96andClaude Opus 5.5 committed 2026-11-12 09:07:12 +01:00
1 parent 07555de700
commit 321aae7e81
19 files changed
+8249 -25

No files matched your search

+4 -1
View File
@@ -29,7 +29,10 @@ un'immagine `gitea.encke-hake.ts.net/balbosoft/khaemhat:X.Y.Z`.
sistema) e cambi manuali.
- Dati di base aggiunti alla creazione dell'azienda e a ogni avvio, solo per i codici mancanti: paesi, valute, unità
di misura, codici IVA, pagamenti, tipi documento, numeratori, causali, trasporti, deposito, listino ed esercizio in
corso. Versione salvata nelle impostazioni dell'azienda (`IT 2026.2`).
corso. Versione salvata nelle impostazioni dell'azienda (`IT 2026.3`).
- Province e comuni dall'elenco ISTAT dei codici dei comuni al 26/02/2026 (ADR 0028, CC BY 4.0): 110 province e
7.894 comuni con codice catastale, provincia, regione e codice ISTAT, nei dati di base del pacchetto italiano
(`IT 2026.3`). I CAP non sono inclusi: si completano nella tabella *Comuni*.
- `scripts/seed.sh --base [--company CODICE]`, incluso nell'immagine in `/app/scripts/`.
- Codici automatici (ADR 0027): maschere per clienti, fornitori, lead, articoli, cespiti, opportunità, ticket,
contratti e interventi con `{seq:0000}`, `{anno}` e `{categoria}`, anteprima del prossimo codice, codice manuale
+4 -4
View File
@@ -2,11 +2,11 @@
> Punto di ripresa per ogni sessione. Aggiornare a fine sessione.
**Ultimo aggiornamento:** 2026-11-11
**Ultimo aggiornamento:** 2026-11-12
**Milestone corrente:** M4 — Tabelle, anagrafiche, articoli (issue #37-#46), ramo `feat/37-tabelle-anagrafiche`.
Fatti: pacchetto fiscale (#37), validatori e VIES (#40), tabelle azienda, profilo, esercizi e cambi con le maschere
(#38, #39), dati di base e `scripts/seed.sh --base` (#45, senza gli elenchi ISTAT e ABI/CAB: serve il via
dell'utente al download), codici automatici e compilazione automatica (#43). ADR 0025-0027.
(#38, #39), dati di base e `scripts/seed.sh --base` (#45) con province e comuni ISTAT (ADR 0028; mancano CAP e
banche ABI/CAB, senza fonte con licenza compatibile), codici automatici e compilazione automatica (#43). ADR 0025-0028.
**Prossimo passo:** anagrafiche (#41) e articoli e listini (#42) con i dati di esempio, import/export guidato (#44),
chiusura M4 (#46). #35 (PNG ad alta risoluzione) resta
aperta e non blocca.
@@ -17,7 +17,7 @@ filtro predefinito nei radar.
## Fatto
- Specifica normativa in `docs/SPEC.md`; `CLAUDE.md` con emendamenti E1-E6.
- ADR 0001-0027.
- ADR 0001-0028.
- Mockup in `docs/mockups/` (22 in alta risoluzione + galleria, 88 miniature, `mockup.css`, indice).
- Icone in `assets/`; deploy in `deploy/` (compose Unraid, `.env.example`, template Unraid).
- Documentazione tecnica: `ARCHITECTURE.md`, `DATA-MODEL.md` (provvisorio, sarà generato), `MODULES.md`, `API.md`,
@@ -35,6 +35,8 @@ grandi (8.000 comuni, decine di migliaia di sportelli) che non sono nel reposito
6. **Elenchi pubblici caricati a parte.** Province, comuni con CAP e banche ABI/CAB non sono nel seed di 0.4.0:
arriveranno come file di dati con origine e licenza indicate (ISTAT, CC BY 4.0, per province e comuni) dopo il
via dell'utente al download. Fino ad allora le tabelle si riempiono a mano o con l'import CSV.
*Aggiornato dall'ADR 0028:* province e comuni ISTAT sono nei dati di base dalla versione `IT 2026.3`; CAP e
banche restano fuori.
7. **Riga di comando.** `scripts/seed.sh --base [--company CODICE]` esegue la sequenza di avvio senza servire pagine
(migrazioni, prima azienda) e aggiunge i dati di base a un'azienda o a tutte quelle attive. Nel container lo
script è in `/app/scripts/` e passa da `entrypoint.sh` con il verbo `seed`; in sviluppo usa `dotnet run`.
@@ -0,0 +1,47 @@
# ADR 0028 - Province e comuni dall'elenco ISTAT nel pacchetto fiscale, CAP esclusi
- **Stato:** accettata
- **Data:** 2026-11-12
- **Modifica:** ADR 0026 punto 6; SPEC §11.1, §11.12, §14; milestone M4, issue #45
## Contesto
L'ADR 0026 rimandava province, comuni con CAP e banche ABI/CAB a file di dati con origine e licenza verificate,
caricati dopo il via dell'utente. Il via è arrivato il 2026-11-12 per due fonti:
- l'**elenco dei codici dei comuni dell'ISTAT** (*Codici statistici delle unità amministrative territoriali*),
pubblicato con licenza **CC BY 4.0** (note legali ISTAT). Il file CSV allo stesso indirizzo è fermo al gennaio 2024
e ha ancora le 107 province precedenti al riordino della Sardegna; il file xlsx è aggiornato al **26/02/2026** e ha
le **110 province** e i **7.894 comuni** in vigore;
- il repository **comuni-json** per i CAP. La sua licenza non è MIT come si era ipotizzato: i comuni vengono
dall'ISTAT (CC BY), ma per i CAP l'autore dichiara che le fonti non indicano una licenza e che al repository
**non si applica nessuna licenza**. I dati sono fermi al 01/01/2020, prima delle fusioni di comuni successive.
## Decisione
1. **Province e comuni nel pacchetto fiscale.** Sono dati italiani, quindi stanno in `Khaemhat.Fiscal.Italy`
(`Data/province.csv`, `Data/comuni.csv`, risorse incorporate) dietro una nuova funzione facoltativa del pacchetto,
`IPlaceDirectory` (province, comuni, origine). `BaseTablesSeeder` li aggiunge come il resto dei dati di base: solo
i codici mancanti, mai modificando una riga già presente.
2. **Formato ridotto.** Dal foglio ISTAT si tengono, per le province, sigla, denominazione e regione; per i comuni,
codice catastale (il **codice** del comune, ADR 0026), denominazione in italiano, sigla della provincia, regione e
codice ISTAT a 6 cifre. I file si rigenerano dal foglio ISTAT con lo stesso schema; ogni aggiornamento porta una
nuova versione dei dati del pacchetto (da `IT 2026.2` a `IT 2026.3`).
3. **Attribuzione.** L'origine (ISTAT, data dell'elenco, CC BY 4.0) è scritta in `ItalianPlaces.ListSource`, nella
wiki *Dati di base e di esempio* e in questo ADR.
4. **Niente CAP da comuni-json.** Un file senza licenza non entra in un repository pubblico né nell'immagine
distribuita, e i CAP del 2020 sarebbero comunque incompleti. I comuni arrivano con il campo CAP vuoto: l'utente lo
completa a mano o con l'**Importa CSV** della tabella, e la compilazione dal CAP usa quello che trova. Una fonte
di CAP con licenza compatibile (ad esempio l'elenco dei codici postali di GeoNames, CC BY 4.0) si valuta a parte,
con un nuovo via dell'utente al download.
5. **Banche ABI/CAB** restano fuori finché non c'è una fonte aperta con licenza chiara (ADR 0026, ADR 0027 punto 6).
## Conseguenze
- Un'azienda nuova ha subito province e comuni: il calcolo del codice fiscale e la scelta del comune funzionano
senza caricare nulla. Le aziende esistenti li ricevono al primo avvio con la versione `IT 2026.3`, o con
*Aggiorna tabelle di base*.
- Il caricamento di base aggiunge circa 8.000 righe alla creazione dell'azienda: su SQLite resta sotto i due secondi;
su PostgreSQL va misurato insieme alle altre misure di riferimento (`docs/DATA-MODEL.md` §6.1).
- Un comune soppresso per fusione resta nella tabella di chi lo aveva già: va disattivato a mano. Le variazioni
vanno annotate nel `CHANGELOG` quando si aggiorna l'elenco.
+18 -8
View File
@@ -21,26 +21,26 @@ alto a destra, es. *Database: khaemhat_demo*).
*Mockup 089 — riepilogo di tabelle di base, dati di esempio, documenti reali e utenti demo con i pulsanti **Aggiorna
tabelle di base**, **Carica dati di esempio**, **Rimuovi dati di esempio**, **Anteprima differenze**; a destra le
ultime migrazioni; sotto, i **pacchetti di dati di base** della versione `IT 2026.2` con contenuto, righe e stato
ultime migrazioni; sotto, i **pacchetti di dati di base** della versione `IT 2026.3` con contenuto, righe e stato
(anteprima ridotta)*
Il riepilogo mostra:
| Voce | Esempio |
|---|---|
| **Tabelle di base** | versione del pacchetto (`IT 2026.2`), righe, data dell'ultimo aggiornamento |
| **Tabelle di base** | versione del pacchetto (`IT 2026.3`), righe, data dell'ultimo aggiornamento |
| **Dati di esempio** | *presenti* con i conteggi (clienti, fornitori, articoli, documenti, registrazioni, cespiti, lead) oppure *assenti* |
| **Documenti reali** | numero di documenti non dimostrativi (0 in un'azienda demo) |
| **Utenti demo** | utenti dimostrativi e relativa password |
## Le tabelle di base
Sono raccolte in **pacchetti** con una **versione** (oggi `IT 2026.2`, salvata nelle impostazioni dell'azienda).
Sono raccolte in **pacchetti** con una **versione** (oggi `IT 2026.3`, salvata nelle impostazioni dell'azienda).
Il pacchetto italiano fa parte del pacchetto fiscale Italia (vedi [Fiscalità italiana](Fiscalita-italiana)).
| Pacchetto | Contenuto |
|---|---|
| **Paesi e comuni** | paesi ISO, province, comuni con CAP e codice catastale |
| **Paesi e comuni** | paesi ISO, province, comuni con codice catastale e codice ISTAT (CAP da completare) |
| **Valute e unità di misura** | valute, unità di misura |
| **Codici IVA e nature** | aliquote 22, 10, 5, 4; esenti (ESE10 N4); non imponibili (NI8 N3.1, NI41 N3.2, NI71 N3.3, NI8C N3.5); fuori campo (FC7 N2.1, altre N2.2); escluse (ESC15 N1); reverse charge (RC17 N6.x); split payment; non soggette; indetraibili 50% e 100%; forfettari |
| **Modalità e condizioni di pagamento** | modalità `MP01`-`MP23`, condizioni di pagamento |
@@ -64,10 +64,20 @@ con codice TD, numeratori, causali di magazzino, deposito principale, porti, tra
aspetto dei beni, rese, categorie, listino base e l'esercizio dell'anno in corso con i suoi mesi. Le righe fiscali
vengono dal pacchetto del paese dell'azienda.
**Province, comuni e banche ABI/CAB** non sono ancora inclusi: sono elenchi pubblici (ISTAT per province e comuni)
che verranno aggiunti come file di dati con origine e licenza indicate. Nel frattempo si caricano con l'**Importa CSV**
delle rispettive tabelle. Il **codice** di un comune è il suo codice catastale (es. `H501` per Roma). Le altre
voci dell'elenco (piano dei conti, causali contabili, registri IVA, cespiti, codici tributo, CRM) arrivano con i
**Province e comuni** (dalla versione `IT 2026.3`) vengono dall'elenco ISTAT dei codici dei comuni aggiornato al
26/02/2026: 110 province con sigla e regione, 7.894 comuni con codice catastale, provincia, regione e codice ISTAT.
Il **codice** di un comune è il suo codice catastale (es. `H501` per Roma), lo stesso del codice fiscale.
> Fonte: ISTAT, *Codici statistici delle unità amministrative territoriali*, licenza
> [CC BY 4.0](https://creativecommons.org/licenses/by/4.0/deed.it).
**I CAP non sono inclusi**: l'ISTAT non li pubblica e non c'è ancora una fonte con una licenza che permetta di
distribuirli. Si completano a mano nella tabella *Comuni* o con l'**Importa CSV** (colonne `Code` e `PostalCodes`;
più CAP separati da virgola, oppure un intervallo come `10121-10156`). La compilazione dal CAP propone i comuni che
hanno il CAP scritto. Anche le **banche ABI/CAB** non sono ancora incluse: banca e BIC dall'IBAN vengono da un conto
dell'azienda presso la stessa banca. Un comune soppresso per fusione resta nella tabella finché non lo disattivi.
Le altre voci dell'elenco (piano dei conti, causali contabili, registri IVA, cespiti, codici tributo, CRM) arrivano con i
moduli che le usano.
### Aggiorna tabelle di base
+1 -1
View File
@@ -7,7 +7,7 @@ Questa pagina raccoglie in un solo posto i **codici e le regole fiscali italiane
SDI, nature IVA, modalità e condizioni di pagamento, regimi fiscali, codici tributo F24 e scadenze. Serve come
riferimento rapido mentre si compilano anagrafiche, codici IVA e documenti.
Tutte queste tabelle sono **caricate dai dati di base** (pacchetto dati, per esempio `IT 2026.2`) e si aggiornano da
Tutte queste tabelle sono **caricate dai dati di base** (pacchetto dati, per esempio `IT 2026.3`) e si aggiornano da
**Amministrazione → Dati di base e di esempio** con **Aggiorna tabelle di base**. Le descrizioni ufficiali complete
sono quelle delle *specifiche tecniche della fattura elettronica* dell'Agenzia delle Entrate, caricate nel seed: in
caso di dubbio fa fede il testo mostrato dal programma, non questa pagina.
+1 -1
View File
@@ -63,7 +63,7 @@ Il riquadro **Versione** riporta:
| **Motore DB** | PostgreSQL 17 · minima 16 |
| **Cache** | Redis (opzionale) o memoria |
| **Fuso orario** | `Europe/Rome` |
| **Pacchetto fiscale** | Italia · dati `IT 2026.2` |
| **Pacchetto fiscale** | Italia · dati `IT 2026.3` |
| **Istanza** | nome host e numero di aziende |
La stessa versione compare nella barra superiore (solo `major.minor`), nella barra di stato (completa) e
+2 -2
View File
@@ -50,7 +50,7 @@ fiscale sono controllati dal pacchetto fiscale del paese; se un errore è in un'
sulla scheda del primo errore. Il logo per le stampe arriva con i modelli di stampa dei documenti.
Il profilo è una scheda unica (una sola per azienda). In alto a destra un badge indica la versione del **pacchetto
fiscale** in uso (es. *IT 2026.2*).
fiscale** in uso (es. *IT 2026.3*).
| Scheda / gruppo | Campi |
|---|---|
@@ -89,7 +89,7 @@ periodo (vedi [IVA](IVA)) e la chiusura dell'esercizio lo rende di sola lettura
| Tabella | Contenuto |
|---|---|
| **Paesi** | codici ISO 3166-1, appartenenza all'UE, codice SDI per l'estero (`XXXXXXX`) |
| **Province** e **Comuni** | CAP e codice catastale (il codice del comune è il codice catastale): servono per la compilazione da CAP e per il calcolo del codice fiscale. Gli elenchi ISTAT si caricano a parte, vedi [Dati di base e di esempio](Dati-di-base-e-esempio) |
| **Province** e **Comuni** | Sigla, regione, codice catastale (il codice del comune), codice ISTAT e CAP: servono per la compilazione da CAP e per il calcolo del codice fiscale. Province e comuni arrivano con i dati di base dall'elenco ISTAT; i CAP si completano a mano o con l'Importa CSV, vedi [Dati di base e di esempio](Dati-di-base-e-esempio) |
| **Valute** e **Cambi** | valute con i cambi giornalieri della BCE; in *Cambi* (`/tabelle/cambi`) si vedono i cambi per data e origine e si inserisce un cambio manuale |
| **Unità di misura** | codici interni e codice usato nell'XML SDI |
| **Codici IVA** | aliquota, natura SDI, riferimento normativo, esigibilità, tipo, indetraibilità, conti IVA, validità (vedi sotto) |
@@ -11,7 +11,8 @@ namespace Khaemhat.Application.Seeding;
/// The base tables of SPEC §14 available from M4: countries, currencies, units, VAT codes (from the fiscal pack),
/// payment methods and terms and document types (from the pack's <see cref="IBaseTablesTemplate"/>), transport tables,
/// warehouse reasons, the main warehouse, categories, the base price list, the numerators and the fiscal year of the
/// current year. Provinces, municipalities and banks come from datasets loaded separately (ADR 0026).
/// current year, and the provinces and municipalities of the pack's <see cref="IPlaceDirectory"/> (ADR 0028). Banks
/// come from a dataset loaded separately (ADR 0026).
/// </summary>
/// <param name="years">Creates the current fiscal year.</param>
public sealed class BaseTablesSeeder(FiscalYearService years) : ISeeder
@@ -58,6 +59,24 @@ public sealed class BaseTablesSeeder(FiscalYearService years) : ISeeder
{
ArgumentNullException.ThrowIfNull(context);
await context.EnsureAsync("countries", ReadCountries(), cancellationToken).ConfigureAwait(false);
if (context.Pack.GetFeature<IPlaceDirectory>() is { } places)
{
await context.EnsureAsync("provinces", places.Provinces.Select(p => new Province { Code = p.Code, Description = p.Name, Region = p.Region }), cancellationToken)
.ConfigureAwait(false);
await context.EnsureAsync(
"municipalities",
places.Municipalities.Select(m => new Municipality
{
Code = m.Code,
Description = m.Name,
ProvinceCode = m.ProvinceCode,
Region = m.Region,
IstatCode = m.StatisticalCode,
PostalCodes = m.PostalCodes,
}),
cancellationToken).ConfigureAwait(false);
}
await context.EnsureAsync("currencies", Currencies.Select(c => new Currency { Code = c.Code, Description = c.Name, Symbol = c.Symbol, Decimals = c.Decimals }), cancellationToken)
.ConfigureAwait(false);
await context.EnsureAsync("units_of_measure", Units(), cancellationToken).ConfigureAwait(false);
@@ -240,3 +240,34 @@ public interface IBaseTablesTemplate
/// <summary>The document types.</summary>
IReadOnlyList<DocumentTypeTemplate> DocumentTypes { get; }
}
/// <summary>A province (or equivalent first-level area) of the country's official list.</summary>
/// <param name="Code">The abbreviation, such as <c>TO</c>.</param>
/// <param name="Name">The name.</param>
/// <param name="Region">The region.</param>
public sealed record ProvinceTemplate(string Code, string Name, string Region);
/// <summary>A municipality of the country's official list.</summary>
/// <param name="Code">The code used by the tax rules (the Italian cadastral code, such as <c>L219</c>).</param>
/// <param name="Name">The name.</param>
/// <param name="ProvinceCode">The province (a <see cref="ProvinceTemplate.Code"/>).</param>
/// <param name="Region">The region.</param>
/// <param name="StatisticalCode">The code of the national statistics office, if any.</param>
/// <param name="PostalCodes">The postal codes, comma separated, when the list has them.</param>
public sealed record MunicipalityTemplate(string Code, string Name, string ProvinceCode, string Region, string? StatisticalCode, string? PostalCodes);
/// <summary>
/// The official list of provinces and municipalities shipped with the pack, loaded into the base tables (ADR 0026,
/// ADR 0028). Like the rest of the base data it only adds the codes a company is missing.
/// </summary>
public interface IPlaceDirectory
{
/// <summary>Where the list comes from and its date, shown in the documentation and the logs.</summary>
string Source { get; }
/// <summary>The provinces.</summary>
IReadOnlyList<ProvinceTemplate> Provinces { get; }
/// <summary>The municipalities.</summary>
IReadOnlyList<MunicipalityTemplate> Municipalities { get; }
}
File diff suppressed because it is too large. Load diff
+111
View File
@@ -0,0 +1,111 @@
sigla;denominazione;regione
AG;Agrigento;Sicilia
AL;Alessandria;Piemonte
AN;Ancona;Marche
AO;Valle d'Aosta/Vallée d'Aoste;Valle d'Aosta/Vallée d'Aoste
AP;Ascoli Piceno;Marche
AQ;L'Aquila;Abruzzo
AR;Arezzo;Toscana
AT;Asti;Piemonte
AV;Avellino;Campania
BA;Bari;Puglia
BG;Bergamo;Lombardia
BI;Biella;Piemonte
BL;Belluno;Veneto
BN;Benevento;Campania
BO;Bologna;Emilia-Romagna
BR;Brindisi;Puglia
BS;Brescia;Lombardia
BT;Barletta-Andria-Trani;Puglia
BZ;Bolzano/Bozen;Trentino-Alto Adige/Südtirol
CA;Cagliari;Sardegna
CB;Campobasso;Molise
CE;Caserta;Campania
CH;Chieti;Abruzzo
CI;Sulcis Iglesiente;Sardegna
CL;Caltanissetta;Sicilia
CN;Cuneo;Piemonte
CO;Como;Lombardia
CR;Cremona;Lombardia
CS;Cosenza;Calabria
CT;Catania;Sicilia
CZ;Catanzaro;Calabria
EN;Enna;Sicilia
FC;Forlì-Cesena;Emilia-Romagna
FE;Ferrara;Emilia-Romagna
FG;Foggia;Puglia
FI;Firenze;Toscana
FM;Fermo;Marche
FR;Frosinone;Lazio
GE;Genova;Liguria
GO;Gorizia;Friuli-Venezia Giulia
GR;Grosseto;Toscana
IM;Imperia;Liguria
IS;Isernia;Molise
KR;Crotone;Calabria
LC;Lecco;Lombardia
LE;Lecce;Puglia
LI;Livorno;Toscana
LO;Lodi;Lombardia
LT;Latina;Lazio
LU;Lucca;Toscana
MB;Monza e della Brianza;Lombardia
MC;Macerata;Marche
ME;Messina;Sicilia
MI;Milano;Lombardia
MN;Mantova;Lombardia
MO;Modena;Emilia-Romagna
MS;Massa-Carrara;Toscana
MT;Matera;Basilicata
NA;Napoli;Campania
NO;Novara;Piemonte
NU;Nuoro;Sardegna
OG;Ogliastra;Sardegna
OR;Oristano;Sardegna
OT;Gallura Nord-Est Sardegna;Sardegna
PA;Palermo;Sicilia
PC;Piacenza;Emilia-Romagna
PD;Padova;Veneto
PE;Pescara;Abruzzo
PG;Perugia;Umbria
PI;Pisa;Toscana
PN;Pordenone;Friuli-Venezia Giulia
PO;Prato;Toscana
PR;Parma;Emilia-Romagna
PT;Pistoia;Toscana
PU;Pesaro e Urbino;Marche
PV;Pavia;Lombardia
PZ;Potenza;Basilicata
RA;Ravenna;Emilia-Romagna
RC;Reggio Calabria;Calabria
RE;Reggio nell'Emilia;Emilia-Romagna
RG;Ragusa;Sicilia
RI;Rieti;Lazio
RM;Roma;Lazio
RN;Rimini;Emilia-Romagna
RO;Rovigo;Veneto
SA;Salerno;Campania
SI;Siena;Toscana
SO;Sondrio;Lombardia
SP;La Spezia;Liguria
SR;Siracusa;Sicilia
SS;Sassari;Sardegna
SV;Savona;Liguria
TA;Taranto;Puglia
TE;Teramo;Abruzzo
TN;Trento;Trentino-Alto Adige/Südtirol
TO;Torino;Piemonte
TP;Trapani;Sicilia
TR;Terni;Umbria
TS;Trieste;Friuli-Venezia Giulia
TV;Treviso;Veneto
UD;Udine;Friuli-Venezia Giulia
VA;Varese;Lombardia
VB;Verbano-Cusio-Ossola;Piemonte
VC;Vercelli;Piemonte
VE;Venezia;Veneto
VI;Vicenza;Veneto
VR;Verona;Veneto
VS;Medio Campidano;Sardegna
VT;Viterbo;Lazio
VV;Vibo Valentia;Calabria
1 sigla denominazione regione
2 AG Agrigento Sicilia
3 AL Alessandria Piemonte
4 AN Ancona Marche
5 AO Valle d'Aosta/Vallée d'Aoste Valle d'Aosta/Vallée d'Aoste
6 AP Ascoli Piceno Marche
7 AQ L'Aquila Abruzzo
8 AR Arezzo Toscana
9 AT Asti Piemonte
10 AV Avellino Campania
11 BA Bari Puglia
12 BG Bergamo Lombardia
13 BI Biella Piemonte
14 BL Belluno Veneto
15 BN Benevento Campania
16 BO Bologna Emilia-Romagna
17 BR Brindisi Puglia
18 BS Brescia Lombardia
19 BT Barletta-Andria-Trani Puglia
20 BZ Bolzano/Bozen Trentino-Alto Adige/Südtirol
21 CA Cagliari Sardegna
22 CB Campobasso Molise
23 CE Caserta Campania
24 CH Chieti Abruzzo
25 CI Sulcis Iglesiente Sardegna
26 CL Caltanissetta Sicilia
27 CN Cuneo Piemonte
28 CO Como Lombardia
29 CR Cremona Lombardia
30 CS Cosenza Calabria
31 CT Catania Sicilia
32 CZ Catanzaro Calabria
33 EN Enna Sicilia
34 FC Forlì-Cesena Emilia-Romagna
35 FE Ferrara Emilia-Romagna
36 FG Foggia Puglia
37 FI Firenze Toscana
38 FM Fermo Marche
39 FR Frosinone Lazio
40 GE Genova Liguria
41 GO Gorizia Friuli-Venezia Giulia
42 GR Grosseto Toscana
43 IM Imperia Liguria
44 IS Isernia Molise
45 KR Crotone Calabria
46 LC Lecco Lombardia
47 LE Lecce Puglia
48 LI Livorno Toscana
49 LO Lodi Lombardia
50 LT Latina Lazio
51 LU Lucca Toscana
52 MB Monza e della Brianza Lombardia
53 MC Macerata Marche
54 ME Messina Sicilia
55 MI Milano Lombardia
56 MN Mantova Lombardia
57 MO Modena Emilia-Romagna
58 MS Massa-Carrara Toscana
59 MT Matera Basilicata
60 NA Napoli Campania
61 NO Novara Piemonte
62 NU Nuoro Sardegna
63 OG Ogliastra Sardegna
64 OR Oristano Sardegna
65 OT Gallura Nord-Est Sardegna Sardegna
66 PA Palermo Sicilia
67 PC Piacenza Emilia-Romagna
68 PD Padova Veneto
69 PE Pescara Abruzzo
70 PG Perugia Umbria
71 PI Pisa Toscana
72 PN Pordenone Friuli-Venezia Giulia
73 PO Prato Toscana
74 PR Parma Emilia-Romagna
75 PT Pistoia Toscana
76 PU Pesaro e Urbino Marche
77 PV Pavia Lombardia
78 PZ Potenza Basilicata
79 RA Ravenna Emilia-Romagna
80 RC Reggio Calabria Calabria
81 RE Reggio nell'Emilia Emilia-Romagna
82 RG Ragusa Sicilia
83 RI Rieti Lazio
84 RM Roma Lazio
85 RN Rimini Emilia-Romagna
86 RO Rovigo Veneto
87 SA Salerno Campania
88 SI Siena Toscana
89 SO Sondrio Lombardia
90 SP La Spezia Liguria
91 SR Siracusa Sicilia
92 SS Sassari Sardegna
93 SV Savona Liguria
94 TA Taranto Puglia
95 TE Teramo Abruzzo
96 TN Trento Trentino-Alto Adige/Südtirol
97 TO Torino Piemonte
98 TP Trapani Sicilia
99 TR Terni Umbria
100 TS Trieste Friuli-Venezia Giulia
101 TV Treviso Veneto
102 UD Udine Friuli-Venezia Giulia
103 VA Varese Lombardia
104 VB Verbano-Cusio-Ossola Piemonte
105 VC Vercelli Piemonte
106 VE Venezia Veneto
107 VI Vicenza Veneto
108 VR Verona Veneto
109 VS Medio Campidano Sardegna
110 VT Viterbo Lazio
111 VV Vibo Valentia Calabria
@@ -0,0 +1,41 @@
using Khaemhat.Fiscal.Abstractions;
using Khaemhat.Infrastructure.Files;
namespace Khaemhat.Fiscal.Italy;
/// <summary>
/// The Italian provinces and municipalities from the ISTAT list of municipality codes (ADR 0028): abbreviation, name and
/// region of the 110 provinces, and cadastral code, name, province, region and ISTAT code of every municipality. The
/// list has no postal codes. The files are read once, the first time they are needed.
/// </summary>
public sealed class ItalianPlaces : IPlaceDirectory
{
/// <summary>The source of the embedded files.</summary>
public const string ListSource = "ISTAT, Codici statistici delle unità amministrative territoriali, 26/02/2026 (CC BY 4.0)";
private readonly Lazy<IReadOnlyList<ProvinceTemplate>> _provinces = new(ReadProvinces);
private readonly Lazy<IReadOnlyList<MunicipalityTemplate>> _municipalities = new(ReadMunicipalities);
/// <inheritdoc />
public string Source => ListSource;
/// <inheritdoc />
public IReadOnlyList<ProvinceTemplate> Provinces => _provinces.Value;
/// <inheritdoc />
public IReadOnlyList<MunicipalityTemplate> Municipalities => _municipalities.Value;
private static IReadOnlyList<ProvinceTemplate> ReadProvinces() =>
[.. Read("province.csv").Select(l => new ProvinceTemplate(l[0], l[1], l[2]))];
private static IReadOnlyList<MunicipalityTemplate> ReadMunicipalities() =>
[.. Read("comuni.csv").Select(l => new MunicipalityTemplate(l[0], l[1], l[2], l[3], l[4], null))];
private static List<IReadOnlyList<string>> Read(string file)
{
using var stream = typeof(ItalianPlaces).Assembly.GetManifestResourceStream("Khaemhat.Fiscal.Italy.Data." + file)
?? throw new InvalidOperationException($"The file {file} is missing from the assembly.");
using var reader = new StreamReader(stream);
return [.. CsvReader.Parse(reader.ReadToEnd(), ';').Skip(1)];
}
}
+2 -1
View File
@@ -9,7 +9,7 @@ namespace Khaemhat.Fiscal.Italy;
public sealed class ItalyFiscalPack : FiscalPackBase
{
/// <summary>The version of the Italian base data and code lists.</summary>
public const string Version = "IT 2026.2";
public const string Version = "IT 2026.3";
/// <summary>Creates the pack with every feature this version delivers.</summary>
public ItalyFiscalPack()
@@ -20,6 +20,7 @@ public sealed class ItalyFiscalPack : FiscalPackBase
AddFeature<ITaxPaymentFormExporter>(new F24Exporter());
AddFeature<ITaxIdentifierRules>(new ItalianTaxIdentifierRules());
AddFeature<IBaseTablesTemplate>(new ItalianBaseTables());
AddFeature<IPlaceDirectory>(new ItalianPlaces());
// ABI and CAB are read from every Italian IBAN; bank names and BICs arrive with the ABI list (ADR 0026).
AddFeature<IBankDirectory>(new ItalianBankDirectory([]));
@@ -4,6 +4,11 @@
<RootNamespace>Khaemhat.Fiscal.Italy</RootNamespace>
</PropertyGroup>
<!-- Provinces and municipalities from the ISTAT list (ADR 0028). -->
<ItemGroup>
<EmbeddedResource Include="Data/*.csv" />
</ItemGroup>
<ItemGroup>
<ProjectReference Include="../Khaemhat.Core/Khaemhat.Core.csproj" />
<ProjectReference Include="../Khaemhat.Fiscal.Abstractions/Khaemhat.Fiscal.Abstractions.csproj" />
@@ -0,0 +1,51 @@
using Khaemhat.Fiscal.Abstractions;
namespace Khaemhat.Fiscal.Italy.Tests;
/// <summary>The provinces and municipalities of the ISTAT list shipped with the pack (ADR 0028).</summary>
[TestClass]
public sealed class ItalianPlacesTests
{
private static readonly IPlaceDirectory Places = new ItalyFiscalPack().Require<IPlaceDirectory>();
[TestMethod]
public void List_HasEveryProvinceAndMunicipality_WithUniqueCodes()
{
Assert.HasCount(110, Places.Provinces);
Assert.HasCount(7894, Places.Municipalities);
Assert.HasCount(Places.Provinces.Count, Places.Provinces.Select(p => p.Code).Distinct(StringComparer.Ordinal));
Assert.HasCount(Places.Municipalities.Count, Places.Municipalities.Select(m => m.Code).Distinct(StringComparer.Ordinal));
Assert.Contains("ISTAT", Places.Source);
}
[TestMethod]
public void EveryMunicipality_BelongsToAProvinceOfItsRegion()
{
var provinces = Places.Provinces.ToDictionary(p => p.Code, StringComparer.Ordinal);
foreach (var municipality in Places.Municipalities)
{
Assert.IsTrue(provinces.TryGetValue(municipality.ProvinceCode, out var province), municipality.Code);
Assert.AreEqual(province.Region, municipality.Region, municipality.Code);
Assert.MatchesRegex("^[A-Z][0-9]{3}$", municipality.Code);
Assert.MatchesRegex("^[0-9]{6}$", municipality.StatisticalCode!);
}
}
[TestMethod]
[DataRow("L219", "Torino", "TO", "Piemonte", "001272")]
[DataRow("H501", "Roma", "RM", "Lazio", "058091")]
[DataRow("A952", "Bolzano", "BZ", "Trentino-Alto Adige/Südtirol", "021008")]
public void Municipality_HasTheCadastralCodeOfTheTaxCode(string code, string name, string province, string region, string istat)
{
Assert.AreEqual(new MunicipalityTemplate(code, name, province, region, istat, null), Places.Municipalities.Single(m => m.Code == code));
}
[TestMethod]
public void Provinces_FollowTheSardinianReform()
{
var sardinia = Places.Provinces.Where(p => p.Region == "Sardegna").Select(p => p.Code).Order(StringComparer.Ordinal).ToArray();
CollectionAssert.AreEqual(new[] { "CA", "CI", "NU", "OG", "OR", "OT", "SS", "VS" }, sardinia);
}
}
@@ -12,7 +12,7 @@ public sealed class ItalyFiscalPackTests
public void Pack_IsItalianWithItsDataVersion()
{
Assert.AreEqual("IT", Pack.CountryCode);
Assert.AreEqual("IT 2026.2", Pack.DataVersion);
Assert.AreEqual("IT 2026.3", Pack.DataVersion);
}
[TestMethod]
@@ -123,13 +123,21 @@ public sealed class CodeRulesTests
var tables = services.GetRequiredService<TableService>();
var autoFill = services.GetRequiredService<AutoFillService>();
await tables.SaveAsync(Root, company, new Province { Code = "TO", Description = "Torino", Region = "Piemonte" });
await tables.SaveAsync(Root, company, new Municipality { Code = "L219", Description = "Torino", ProvinceCode = "TO", Region = "Piemonte", PostalCodes = "10121-10156" });
await tables.SaveAsync(Root, company, new Municipality { Code = "G674", Description = "Pinerolo", ProvinceCode = "TO", Region = "Piemonte", PostalCodes = "10064" });
// The base data brings every municipality of the ISTAT list, without postal codes: the users add them.
var municipalities = await tables.ActiveAsync<Municipality>(Root, company);
Assert.HasCount(7894, municipalities);
Assert.IsEmpty(await autoFill.PlacesByPostalCodeAsync(Root, company, "10128"));
var turinRow = municipalities.Single(m => m.Code == "L219");
turinRow.PostalCodes = "10121-10156";
await tables.SaveAsync(Root, company, turinRow);
var pinerolo = municipalities.Single(m => m.Code == "G674");
pinerolo.PostalCodes = "10064";
await tables.SaveAsync(Root, company, pinerolo);
var turin = (await autoFill.PlacesByPostalCodeAsync(Root, company, "10128")).Single();
Assert.AreEqual(new PlaceSuggestion("L219", "Torino", "TO", "Piemonte", "10128"), turin);
Assert.AreEqual("10064", (await autoFill.PlacesByNameAsync(Root, company, "pin")).Single().PostalCode);
Assert.AreEqual("10064", (await autoFill.PlacesByNameAsync(Root, company, "pinerolo")).Single().PostalCode);
Assert.IsTrue((await autoFill.PlacesByNameAsync(Root, company, "pin")).Count > 1);
Assert.IsEmpty(await autoFill.PlacesByPostalCodeAsync(Root, company, "1012"));
Assert.IsEmpty(await autoFill.PlacesByPostalCodeAsync(Root, company, "10157"));
@@ -58,7 +58,7 @@ public sealed class CompanyTablesTests
Assert.HasCount(12, years[0].Periods);
var runner = services.GetRequiredService<SeedRunner>();
Assert.AreEqual("IT 2026.2", await runner.VersionAsync(company));
Assert.AreEqual("IT 2026.3", await runner.VersionAsync(company));
var again = await runner.UpdateBaseAsync(Root, company);
Assert.AreEqual(0, again.Total, string.Join(", ", again.Added.Select(a => a.Key + "=" + a.Value)));
await app.StopAsync();