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:
1 parent
07555de700
commit
321aae7e81
19 files changed
+8249
-25
No files matched your search
+4
-1
@@ -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
@@ -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.
|
||||
@@ -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
|
||||
|
||||
@@ -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.
|
||||
|
||||
@@ -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
|
||||
|
||||
@@ -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
@@ -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
|
||||
|
@@ -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)];
|
||||
}
|
||||
}
|
||||
@@ -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();
|
||||
|
||||
Reference in new issue
Block a user