Metadata-Version: 2.4
Name: scadenze
Version: 0.1.2
Summary: Scadenze fiscali italiane 2026, dal terminale
Project-URL: Homepage, https://nbflows.com
Project-URL: Repository, https://github.com/nimesh-bothalage/scadenze
Author-email: Nimesh Bothalage <nimeshbflows@gmail.com>
License: MIT License
        
        Copyright (c) 2026 Nimesh Bothalage
        
        Permission is hereby granted, free of charge, to any person obtaining a copy
        of this software and associated documentation files (the "Software"), to deal
        in the Software without restriction, including without limitation the rights
        to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
        copies of the Software, and to permit persons to whom the Software is
        furnished to do so, subject to the following conditions:
        
        The above copyright notice and this permission notice shall be included in all
        copies or substantial portions of the Software.
        
        THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
        IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
        FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
        AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
        LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
        OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
        SOFTWARE.
License-File: LICENSE
Keywords: cli,f24,fisco,italia,iva,scadenze
Classifier: Development Status :: 3 - Alpha
Classifier: Environment :: Console
Classifier: License :: OSI Approved :: MIT License
Classifier: Natural Language :: Italian
Classifier: Programming Language :: Python :: 3
Classifier: Topic :: Office/Business :: Financial
Requires-Python: >=3.10
Requires-Dist: icalendar>=6.0
Requires-Dist: rich>=13.0
Requires-Dist: typer>=0.12
Description-Content-Type: text/markdown

# scadenze

> Le scadenze fiscali italiane 2026, dal terminale.

![Python 3.10+](https://img.shields.io/badge/python-3.10%2B-blue)
![Licenza MIT](https://img.shields.io/badge/licenza-MIT-green)
![Test](https://img.shields.io/badge/test-16%20passed-brightgreen)

CLI per consultare le principali scadenze fiscali italiane del 2026: IVA,
ritenute, LIPE, contributi INPS, IMU, dichiarazioni e acconti — con gli
slittamenti per weekend, festivi e differimento feriale già applicati.

![Demo animata del CLI](docs/demo.gif)

## Installazione

```sh
uv tool install scadenze   # oppure: pip install scadenze
```

Per provarlo dal repository senza installare:

```sh
git clone https://github.com/nimesh-bothalage/scadenze
cd scadenze
uv run scadenze prossime
```

## Uso

```sh
scadenze prossime                 # scadenze nei prossimi 30 giorni
scadenze prossime --giorni 60
scadenze mese settembre           # anche: scadenze mese 9
scadenze cerca lipe
scadenze --categoria iva prossime # filtra per categoria
scadenze export --ical -o scadenze.ics
scadenze export --csv -o scadenze.csv   # apribile in Excel
```

La colonna **Tra** evidenzia in rosso le scadenze entro 7 giorni.
Il file `.ics` esportato si importa in Google Calendar, Outlook o Apple
Calendar.

**Categorie disponibili**: `iva`, `ritenute`, `inps`, `inail`, `imu`,
`imposte`, `dichiarazioni`, `bollo`, `societa`.

## Il dataset

54 scadenze del 2026 in [un unico JSON](scadenze/data/scadenze_2026.json),
generato da [`scripts/genera_dataset.py`](scripts/genera_dataset.py):

- versamenti mensili F24 (IVA e ritenute) con gli slittamenti 2026:
  18 maggio e 20 agosto (differimento feriale)
- IVA trimestrale, LIPE, bollo fatture elettroniche, rate fisse INPS
  artigiani e commercianti
- scadenze annuali: CU, dichiarazione IVA, IMU, saldo e acconti delle
  imposte (inclusa la proroga al 20 luglio per soggetti ISA e forfettari,
  D.L. 89/2026), 730, Redditi, 770, acconto IVA

Ogni scadenza segue lo schema:

```json
{
  "id": "iva-liquidazione-2026-08",
  "data": "2026-08-20",
  "titolo": "Liquidazione IVA mensile",
  "descrizione": "Versamento IVA relativa a luglio 2026 (contribuenti mensili; differimento feriale)",
  "categoria": "iva",
  "soggetti": ["partita_iva_mensile"],
  "modello": "F24",
  "ricorrenza": "mensile"
}
```

Trovato un errore in una data? Apri una issue o una PR: è il contributo
più prezioso per un progetto come questo.

## ⚠️ Disclaimer

I dati sono forniti **a scopo puramente informativo** e possono contenere
errori o non riflettere proroghe e modifiche normative successive.
Verificare sempre le date sullo
[scadenzario dell'Agenzia delle Entrate](https://www.agenziaentrate.gov.it/portale/scadenzario-fiscale)
o con il proprio commercialista. Questo strumento non sostituisce una
consulenza professionale.

## Roadmap

- [x] Revisione delle date su fonti ufficiali (scadenzario AdE, Fisco Oggi,
      Circolare INPS 14/2026 — luglio 2026)
- [x] Export CSV
- [ ] Dataset 2027
- [ ] Notifiche/reminder

## Sviluppo

```sh
uv sync
uv run pytest                             # 16 test
uv run python scripts/genera_dataset.py   # rigenera il dataset
uv run python scripts/genera_screenshot.py
uv run python scripts/genera_gif.py       # richiede Edge (Windows)
```

## Chi sono

Progetto di Nimesh Bothalage — [nbflows.com](https://nbflows.com).

## Licenza

[MIT](LICENSE)
