Mappa della wiki

Una mappa completa di tutte le pagine della documentazione XIQUIL, organizzata per area funzionale.

Inizia qui

• Cos’è XIQUIL — a cosa serve la piattaforma e a chi è rivolta
• Installazione — installare XIQUIL con Docker o in modalità nativa
• Primo avvio — configurazione iniziale: soggetto, ambito, fondo, prima uscita
• Registrazione Hub — creare un account su hub.xiquil.com e ottenere la activation key
• Concetti base — glossario narrativo: ambito, fondo, movimento, categoria, scadenza, focus

Guida all’uso — Movimenti quotidiani

• Gestire le uscite — registrare spese, fatture e ricevute
• Gestire le entrate — registrare incassi, compensi e fatture attive
• Registrazione libera — scegliere se registrare un movimento come entrata o uscita
• Transazioni — movimenti puri tra fondi: giroconti, prelievi, depositi
• Flussi di cassa — vista automatica dei movimenti di denaro tra fondi
• Pagamenti senza fondo — marcare una scadenza come pagata senza specificare il conto
• Correzioni — modificare, stornare o eliminare documenti già registrati

Guida all’uso — Anagrafiche e struttura

• Ambiti — contesti economici separati: Personale, Famiglia, Partita IVA
• Soggetti — le persone e le entità proprietarie degli ambiti
• Fornitori — chi ti vende beni e servizi (controparte delle uscite)
• Clienti — chi ti paga (controparte delle entrate)
• Categorie — classificazione gerarchica delle uscite e entrate
• Fondi — conti correnti, carte, portafogli e contanti
• Focus — progetti e iniziative con budget dedicato

Guida all’uso — Documenti e import

• Import XML FatturaPA — importare fatture elettroniche da file XML
• Revisione documenti — revisionare immagini e PDF importati
• Tipi di documento — fattura elettronica (TDxx) e documento generico
• Documenti con voci — righe di dettaglio con categoria e focus per voce
• Esportare i dati — scaricare le tabelle in Excel o CSV
• Fattura elettronica: manuale vs import — quando usare il form e quando importare
• Scadenze dai documenti — come un documento genera scadenze di pagamento
• Corrispettivi — gestione corrispettivi periodici e numerazione
• Anagrafiche estere — fornitori e clienti UE ed extra-UE

Guida all’uso — Pianificazione e analisi

• Dashboard ambito — panoramica finanziaria per ambito
• Budget mensile — pianificare le spese mensili e confrontarle con la realtà
• Previsioni — proiezione di cashflow basata sui movimenti ricorrenti
• Obiettivi finanziari — risparmio, estinzione debiti e crescita patrimoniale
• Patrimonio netto — attività, passività e valore netto nel tempo
• Salute finanziaria — score e raccomandazioni per migliorare la situazione
• Simulatore — “posso permettermi X?” con scenari ipotetici
• Movimenti ricorrenti — automatizzare entrate e uscite che si ripetono
• Finanziamenti — mutui, prestiti e piani di ammortamento
• Oneri finanziari — commissioni bancarie, interessi e bolli
• Detrazioni 730 — marcare le spese detraibili e stimare il rimborso IRPEF

Guida all’uso — Calendario e scadenze

• Calendario (vista globale) — panoramica aggregata cross-ambito di scadenze ed eventi
• Scadenzario (per ambito) — vista interattiva delle scadenze di un singolo ambito

Guida all’uso — Lavoro e fiscale

• Dipendenti — anagrafica dei dipendenti e gestione del costo del lavoro
• Compensi e cedolini — cedolini paga e stato pagamento stipendi
• Versamenti F23/F24 — modelli di versamento fiscale e previdenziale

Guida all’uso — Plugin

• Riconciliazione Bancaria — import estratti conto CSV e abbinamento movimenti
• Report PDF Avanzati — generare report personalizzati con logo e layout

Guida all’uso — Preferenze e notifiche

• Notifiche — preferenze, canali e gestione degli avvisi
• Impostazioni — preferenze personali dell’utente

Amministrazione

• Utenti e permessi — gestire accessi, ruoli e permessi per ambito
• API Keys — chiavi per integrazioni esterne e script
• Marketplace plugin — installare e aggiornare plugin
• Review plugin — revisione versioni per sviluppatori plugin
• Backup e licenza — backup automatici e gestione licenza
• Log di sistema — leggere i log applicativi e diagnosticare
• Registro operazioni — audit trail immutabile delle modifiche
• Processi pianificati — job automatici: cosa fanno, quando girano, come configurarli
• Dispositivi — sessioni attive per dispositivo e utente, revoca
• Email (SMTP) — configurare il server di posta per notifiche e inviti
• Impostazioni avanzate — rate limiting, logging, retention e configurazioni operative

Installazione avanzata

• Docker Compose — configurazione avanzata Docker
• Windows nativo — installazione senza Docker su Windows
• Linux nativo — installazione senza Docker su Linux (systemd)
• macOS nativo — installazione senza Docker su macOS
• Synology NAS — deploy su NAS Synology
• TrueNAS SCALE — deploy su TrueNAS SCALE
• Unraid — deploy su Unraid
• Reverse proxy — configurare nginx, Traefik, Caddy davanti a XIQUIL
• Backup e ripristino — strategie di backup e procedure di ripristino

Account

• Licenze — vedere lo stato della licenza e gestire l’account Hub

FAQ

• Installazione — domande frequenti su requisiti e installazione
• Problemi comuni — errori frequenti e soluzioni
• Sicurezza e privacy — autenticazione, MFA, dispositivi e privacy
• Licenze e pricing — piani, prezzi, scadenze e limiti utenti

Per sviluppatori

• API Reference — endpoint e convenzioni delle API
• Contratto endpoint API — regole di compatibilità per le risposte backend
• Import XML — Riferimento — parser FatturaPA: dettagli tecnici
• Creare un plugin — percorso guidato per sviluppare un plugin
• Plugin SDK Python — API disponibili lato plugin
• Manifest e metadata plugin — campi richiesti per descrivere un plugin
• Pubblicare su Marketplace — processo di pubblicazione
• Pannello Developer — strumenti tecnici nell’app
• Contribuire al progetto — regole per contribuire in modo coerente