Accesso attivo — Utente  ·  Dashboard  ·  Esci
Centro Documentazione

Documentazione TaxAi

Guide tributi comunali, manuali tecnici, FAQ e risorse riservate per Comuni, funzionari e partner integratori.

Documentazione Pubblica
Risorse disponibili per tutti

Presentazione, scheda funzionale e guide introduttive liberamente accessibili.

Gratuito

Overview Piattaforma TaxAi

Architettura microservizi, stack tecnologico, modello SaaS multi-tenant e funzionalità principali.

Leggi
Gratuito

Guida ai 6 Tributi Gestiti

IMU, TARI, Acqua, COSAP, Pagamenti e Notifiche: descrizione funzionale di ogni modulo.

Leggi
Gratuito

Assistente AI & RAG

Come funziona il sistema AI multilingua: Voyage AI embeddings, Qdrant vector DB e Claude claude-sonnet-4-6.

Leggi
Gratuito

FAQ — Domande Frequenti

Risposte alle domande più comuni su IMU, TARI, scadenze, pagamenti e utilizzo della piattaforma.

Leggi
Architettura
Piattaforma TaxAi — Overview

SaaS multi-tenant basato su 10 microservizi PHP/Slim4, gateway Nginx, AI/RAG integrata e frontend Vanilla JS.

Backend PHP 8.4

10 microservizi Slim 4 con PSR-4, JWT e multi-tenant

MySQL 8.0

10 database dedicati (uno per microservizio)

Nginx Gateway

API gateway con reverse proxy, SSL e rate limiting

AI/RAG Stack

Voyage AI + Qdrant vector DB + Claude claude-sonnet-4-6

Redis 7

Cache sessioni e rate limiting distribuito

Docker Compose

14 container orchestrati su Hetzner EU

Microservizi e porte

auth-ms :4111 — Autenticazione JWT
property-ms :4102 — Immobili
imu-ms :4103 — Calcolo IMU
tari-ms :4104 — TARI rifiuti
acqua-ms :4105 — Servizio idrico
suolo-ms :4106 — COSAP
payment-ms :4107 — F24/PagoPA
notification-ms :4108 — Alert
document-ms :4109 — AI/RAG
report-ms :4110 — Analytics
I 6 Tributi
Funzionalità per tributo

Ogni tributo ha il suo microservizio dedicato con logica di calcolo, gestione rate e integrazione PagoPA.

IMU

Calcolo per tipologia catastale (A/B/C/D), prima e seconda casa, terreni agricoli. Aliquote da delibere comunali, ravvedimento operoso 1/30, 1/8, 1/5, 1/2. Generazione F24 pre-compilato con codici tributo.

Calcolo aliquoteRavvedimentoF24Delibere

TARI

Tariffe ARERA per utenze domestiche (n. componenti × superficie) e non domestiche (categoria ATECO). Piani rateazione 2/4 rate, avvisi di pagamento, gestione esenzioni e riduzioni per compostaggio.

ARERARateEsenzioniAvvisi

Acqua

Gestione contatori con lettura manuale/automatica, fasce tariffarie (agevolata/ordinaria/eccedenza), bollettazione periodica, bonus idrico ARERA, reclami e storico consumi 36 mesi.

ContatoriFasceBonus ARERAStorico

COSAP

Concessioni OSP per dehors, tavoli, ponteggi, cantieri, sagre e mercati. Calcolo canone per tipologia e m², rinnovi automatici, decadenza, reclami e storico concessioni.

DehorsCantieriRinnoviCanone

Pagamenti

Generazione F24 con codici tributo pre-compilati. Integrazione PagoPA per pagamenti online. Ricevute digitali, riconciliazione automatica con tesoriere, storico transazioni e export CSV/XML.

F24PagoPARiconciliazioneExport

Notifiche

Sistema alert multicanale (email, SMS, push browser) per scadenze tributi, avvisi accertamento, comunicazioni delibere aggiornate, promemoria ravvedimento operoso e messaggi del Comune.

EmailSMSPushScadenze
Intelligenza Artificiale
Come funziona il sistema AI

Pipeline RAG (Retrieval Augmented Generation) completamente integrata con normative comunali specifiche.

1. Domanda

Cittadino scrive la domanda in qualsiasi lingua

2. Embedding

Voyage AI voyage-law-2 converte in vettore 1024D

3. Retrieval

Qdrant cerca i 5 chunk più rilevanti per cosine similarity

4. Risposta

Claude claude-sonnet-4-6 genera risposta con fonti citate

Corpus indicizzato

29 chunk disponibili: normative IMU, TARI, COSAP, F24, ravvedimento, delibere comunali e scadenze — in IT, EN, FR, DE, AR.

Multilingua automatico

L'AI rileva la lingua della domanda e risponde nella stessa lingua, incluso arabo con supporto RTL nel frontend.

Endpoint API

POST /api/documents/ai/ask — richiede Bearer JWT + X-API-Key. Risposta: answer + sources[].

FAQ
Domande frequenti

Le risposte alle domande più comuni su tributi, piattaforma e accesso al servizio.

Come si calcola la IMU per una seconda casa?
L'IMU per la seconda casa si calcola: Rendita catastale × 1,05 × 160 × aliquota delibera comunale. L'acconto va versato entro il 16 giugno (50% dell'imposta calcolata con l'aliquota dell'anno precedente) e il saldo entro il 16 dicembre. Il Comune imposta le aliquote tramite delibera del Consiglio Comunale, visibile nella piattaforma TaxAi nella sezione Impostazioni IMU.
Quando scade il pagamento della TARI?
Le scadenze TARI sono stabilite da ogni Comune con delibera. Tipicamente la TARI viene pagata in 2 o 4 rate nel corso dell'anno (aprile, luglio, ottobre e dicembre). TaxAi invia automaticamente notifiche email e push 30 e 7 giorni prima della scadenza. Puoi verificare le scadenze specifiche nella sezione "Scadenze" della tua dashboard.
Come si accede al portale? Serve SPID?
L'accesso avviene con le credenziali email/password assegnate dal Comune, oppure tramite SPID (Sistema Pubblico di Identità Digitale) o CIE (Carta di Identità Elettronica). Il Comune assegna il profilo utente (cittadino, funzionario, amministratore). La sessione dura 8 ore ed è protetta da JWT firmato.
Come funziona il ravvedimento operoso IMU?
Il ravvedimento operoso permette di regolarizzare un versamento IMU omesso o insufficiente pagando un'imposta ridotta + interessi legali. TaxAi calcola automaticamente la sanzione in base ai giorni di ritardo: 1/30 (entro 14gg), 1/8 (entro 90gg), 1/5 (entro 1 anno), 1/4 (entro 2 anni). Il calcolo è disponibile nella sezione "Ravvedimento" della dashboard.
Come posso pagare online? È sicuro?
TaxAi integra PagoPA (il sistema nazionale per i pagamenti verso la PA) e genera F24 pre-compilati scaricabili per il pagamento tramite banca, Poste o CAF. I pagamenti PagoPA sono cifrati TLS 1.3 e certificati dalla Banca d'Italia. Le ricevute digitali vengono archiviate automaticamente nel tuo fascicolo fiscale.
L'assistente AI risponde in altre lingue?
Sì. L'assistente AI di TaxAi supporta italiano, inglese, francese, tedesco e arabo. Rileva automaticamente la lingua della domanda e risponde nella stessa lingua. Per l'arabo il frontend attiva automaticamente la modalità RTL (right-to-left). Puoi anche impostare la lingua preferita nel profilo utente.
I dati sono al sicuro? Il Comune dove sono ospitati?
I dati di ogni Comune sono isolati in database dedicati (multi-tenant con tenant_id obbligatorio su ogni query). I server sono ospitati su Hetzner EU (Germania), con backup giornalieri, crittografia AES-256 e TLS 1.3 su tutte le comunicazioni. La piattaforma è conforme al GDPR (Reg. UE 2016/679). Viene firmato un DPA personalizzato per ogni Comune.
Area Riservata
Documentazione per utenti registrati

Manuali completi, API reference, guide configurazione Comune e template disponibili dopo l'accesso.

Accesso riservato agli utenti TaxAi

Accedi con le credenziali assegnate dal Comune per sbloccare manuali tecnici, API reference completa e template operativi.

Manuale Utente Completo
PDF · 186 pagine
Guida Onboarding Comune
Step-by-step
API Reference REST
OpenAPI 3.0
Configurazione IMU/TARI
Aliquote + delibere
Template Report Comune
Excel + PDF
Integrazione PagoPA
Guida tecnica
Accedi alla piattaforma Richiedi accesso

  Credenziali assegnate dal Comune di riferimento

Benvenuto — Accesso riservato attivo

Manuale Utente Completo

Guida completa alla piattaforma TaxAi: configurazione profilo, gestione tributi, pagamenti, AI assistant, notifiche e reportistica. Inclusi screenshot e workflow.

PDF186 pagineAgg. 2026
Scarica manuale

Guida Onboarding Comune

Istruzioni per i funzionari comunali: attivazione tenant, importazione archivi catastali, configurazione aliquote IMU/TARI, creazione utenti e delibere.

GuidaFunzionariStep-by-step
Leggi guida

API Reference Completa

Documentazione REST API di tutti e 10 i microservizi TaxAi. Endpoint, payload JSON, autenticazione JWT, esempi cURL e schema OpenAPI 3.0.

RESTOpenAPI 3.0JSON
API Docs

Configurazione IMU e TARI

Guida per l'ufficio tributi: inserimento delibere aliquote, configurazione fasce TARI per categoria ATECO, gestione riduzioni, esenzioni e ravvedimento.

IMUTARIDelibere
Leggi guida

Template Report Comune

Modelli Excel e PDF per la rendicontazione annuale: gettito IMU/TARI/acqua, tasso di riscossione, accertamenti in corso, report per il tesoriere e per il Ministero.

ExcelPDF8 template
Scarica template

Integrazione PagoPA & F24

Guida tecnica per l'integrazione PagoPA: IUV generation, notice number, RT (ricevuta telematica), riconciliazione automatica e gestione stornamenti.

PagoPAF24IUV
Guida integrazione

Configurazione AI Corpus

Come indicizzare normative specifiche del Comune nel sistema RAG: formato documenti, script di indicizzazione, aggiornamento corpus e test embedding Voyage AI.

Voyage AIQdrantRAG
Guida AI

Sicurezza & GDPR

Documentazione sicurezza: architettura multi-tenant, isolamento dati, gestione JWT, log accessi, backup policy, DPA e procedure per data breach GDPR art. 33.

GDPRJWTDPA
Scarica doc sicurezza

Vai alla tua Dashboard

Gestisci tributi, pagamenti, notifiche e assistente AI dalla piattaforma.

Dashboard TaxAi

Inizia a usare TaxAi

Accedi alla piattaforma con le credenziali del tuo Comune o contatta il team Agile per l'attivazione.

Accedi ora Richiedi attivazione Comune