Skip to content

Gsoftware-srl/scadenzeapi

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

4 Commits
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

ScadenzeAPI

Le scadenze fiscali italiane, finalmente via API. JSON, feed iCal e webhook che ti avvisa quando una scadenza viene prorogata.

Stato: validazione. Non esiste ancora un backend in produzione — stiamo verificando se c'è abbastanza domanda reale prima di costruirlo. Questo repo è la specifica pubblica del prodotto. Tutto quello che c'è da sapere è più sotto, senza giri di parole.

Dicci se ti serve (2 minuti) — nessun pagamento, nessun impegno. Se il posto founding ti interessa, ne parliamo via email.


Il problema

Se il tuo software deve ricordare o mostrare scadenze fiscali italiane, il dato non esiste in un formato che un programma possa consumare in modo affidabile:

  • Lo scadenzario ufficiale dell'Agenzia delle Entrate è consultabile solo via web, navigabile per mese. Nessun download, nessuna API, nessun dataset nel catalogo open data.
  • Le proroghe arrivano con decreti in Gazzetta Ufficiale, spesso a ridosso della scadenza, e vanno interpretate a mano.
  • Gli .ics gratuiti che trovi in giro (Qonto, Tot, siti editoriali) sono snapshot statici: nessuna proroga, nessun webhook, nessuno storico.

Il risultato: ogni software house si costruisce e mantiene il proprio scadenzario in casa. Un lavoro che nessuno vuole fare ma che tutti devono fare.

La proposta

Tre modi di consumare lo stesso dato, sempre aggiornato:

Risorsa Funzione
GET /v1/deadlines Elenco scadenze filtrabile per regime, periodo, categoria
GET /v1/deadlines/{id} Dettaglio con riferimento normativo e storico
GET /v1/calendar.ics Feed iCal sottoscrivibile, si aggiorna da solo nel calendario
POST /v1/webhooks Registra un endpoint per le notifiche di variazione

Eventi webhook: deadline.postponed (proroga), deadline.added (nuovo adempimento), deadline.changed (altra variazione).

Esempio — GET /v1/deadlines

{
  "id": "forfettario-saldo-acconto-2026",
  "descrizione": "Imposta sostitutiva: saldo 2025 e 1° acconto 2026",
  "categoria": "versamento",
  "regime": ["forfettario"],
  "scadenza": "2026-06-30",
  "scadenza_originale": "2026-06-30",
  "prorogato": false,
  "riferimento_normativo": "L. 190/2014, art. 1",
  "fonte": "Agenzia delle Entrate",
  "ultimo_aggiornamento": "2026-01-10T09:00:00Z"
}

Esempio — webhook deadline.postponed

{
  "event": "deadline.postponed",
  "deadline_id": "forfettario-saldo-acconto-2026",
  "scadenza_precedente": "2026-06-30",
  "scadenza_nuova": "2026-07-20",
  "riferimento": "D.L. 89/2026",
  "pubblicato_in_gu": "2026-06-12",
  "timestamp": "2026-06-13T08:00:00Z"
}

Payload completi in examples/, schema dei dati in schema/. Sono esempi illustrativi, non il dataset del servizio.

Da dove viene il dato (e perché fidarsi)

Il valore del servizio non è tecnologico: è redazionale. Il processo, per esteso:

  1. Calendario base dallo scadenzario ufficiale dell'Agenzia delle Entrate.
  2. Rilevamento proroghe monitorando la Gazzetta Ufficiale (D.L./DPCM) più la stampa fiscale specializzata.
  3. Validazione umana di un commercialista partner prima di ogni pubblicazione. Mai pubblicazione automatica.

Ogni scadenza è versionata: tieni lo storico originale-vs-prorogata, utile per audit e per capire cosa è cambiato e quando.

Ambito: si parte dal forfettario

Il primo regime coperto è il forfettario (imposta sostitutiva saldo/acconti, contributi INPS, casi IVA particolari): poche scadenze, curabili bene fin dal primo giorno. Gli altri regimi e le forme societarie arrivano dopo, in base a cosa chiedono i founding customer.

Ti serve un altro regime prima? Apri una issue o dillo nel form: le priorità le decidono i primi clienti.

Prezzi previsti

Listino indicativo a regime (IVA esclusa). I founding customer pagano la metà, per sempre.

Piano Prezzo/mese Include
Free 0€ Feed iCal + 100 chiamate/mese, best-effort
Starter 29€ 5.000 chiamate, webhook, 1 regime
Pro 79€ 50.000 chiamate, tutti i regimi, proroghe prioritarie
Business 149€ Volumi alti, SLA, supporto prioritario

Offerta founding (primi 10)

  • 50% a vita sul piano che scegli
  • Voce diretta su quali regimi e quali dati sviluppiamo prima
  • Nessun pagamento adesso: compili il form, ti scrivo io, decidi con calma

Compila il form (2 minuti) — chiediamo solo cosa costruisci e come gestisci oggi le scadenze. Nessuna carta di credito, nessun impegno: se il posto founding ti interessa ti mando i dettagli via email e valuti.

Trasparenza totale

Questo prodotto si costruisce solo se abbastanza persone dimostrano di volerlo davvero. È una regola interna precisa: senza un numero minimo di clienti founding reali, non se ne fa nulla e lo diciamo apertamente. Preferiamo perdere tempo noi ora che farti integrare un'API che moriremo di mantenere.

Se il tema ti tocca ma l'offerta non ti convince, ci è utilissimo anche un "no" motivato in una issue.

FAQ

C'è già l'.ics gratuito di Qonto/Tot, perché pagare? Quelli sono calendari statici compilati una volta l'anno come lead magnet. Non hanno API, non coprono i regimi in modo parametrico, non ti avvisano delle proroghe e non hanno uno storico. Se il tuo software mostra una scadenza sbagliata perché è uscito un decreto ieri, il problema è tuo.

Perché non lo fate open source / open data? Il dato grezzo è pubblico e lo resta. Quello che paghi è la cura redazionale continua — qualcuno che legge la Gazzetta Ufficiale ogni giorno e un commercialista che valida prima di pubblicare — più l'infrastruttura (API, webhook, SLA). È esattamente il lavoro che oggi ogni software house duplica in casa.

È consulenza fiscale? No. È un servizio informativo: ti diamo il dato curato e il riferimento normativo, non interpretazioni sul tuo caso specifico. Per quelle serve il tuo commercialista.

Contatti


ScadenzeAPI (nome di lavoro) è un progetto di Gsoftware srl, in validazione da luglio 2026. Servizio informativo, non consulenza fiscale.

About

Le scadenze fiscali italiane via API — JSON, iCal, webhook. In validazione.

Topics

Resources

License

Stars

0 stars

Watchers

0 watching

Forks

Packages

 
 
 

Contributors