Documentazione PongoFin
Guide tecniche e operative per la piattaforma finanziaria, PongoSID e PongoREI. Calcoli, categorizzazione, esempi e architettura — tutto in un posto.
Architettura della piattaforma
PongoFin trasforma dati bancari grezzi in intelligence finanziaria strutturata attraverso una pipeline di elaborazione a strati. Ogni transazione viene validata, normalizzata e classificata prima di entrare in qualsiasi calcolo o report.
Pipeline di elaborazione
- Import — Acquisizione di estratti conto e record finanziari da CSV, API o inserimento manuale
- Normalizzazione — Standardizzazione di formati, date e descrizioni
- Classificazione — Assegnazione di ogni transazione a una categoria contabile
- Riconciliazione — Incrocio dei movimenti bancari con i record contabili
- Analisi & Reporting — Generazione di indicatori finanziari, previsioni e report
Moduli principali
| Modulo | Funzione |
|---|---|
| Piattaforma finanziaria | Riconciliazione, conto economico, cashflow, business plan |
| PongoSID | Comunicazioni all'Anagrafe Rapporti Finanziari per soggetti obbligati |
| PongoREI | Gestione adempimenti REI e segnalazioni agli intermediari |
Fonti dati supportate
| Fonte | Formato |
|---|---|
| Estratti conto bancari | CSV, export strutturati |
| Integrazioni API | Sync in tempo reale o batch |
| Inserimenti manuali | Transazioni definite dall'utente |
transazione {
data
importo
descrizione
controparte
categoria
}
Questo garantisce un'elaborazione consistente indipendentemente dalla fonte o dal formato originale.
Metodi di calcolo
Tutti i calcoli finanziari della piattaforma seguono principi contabili standard, con strati analitici aggiuntivi per proiezioni e insight. Le regole sono deterministiche e ogni modifica, classificazione e riconciliazione viene tracciata con timestamp e attribuzione utente.
Normalizzazione dei dati
Durante l'import, ogni record passa attraverso:
- Parsing del file — Rilevamento della struttura ed estrazione dei campi
- Conversione date — Formato ISO unificato per tutte le fonti
- Gestione valuta — Conversione e normalizzazione alla valuta base
- Pulizia descrizioni — Rimozione del rumore, espansione abbreviazioni
- Identificazione tipo operazione — Classificazione credito / debito
Riconciliazione bancaria
La riconciliazione verifica la consistenza tra movimenti bancari e record contabili. Il motore di riconciliazione applica il matching su più attributi:
| Criterio di matching | Descrizione |
|---|---|
| Importo | Corrispondenza esatta o quasi-esatta del valore monetario |
| Prossimità data | Transazioni entro una tolleranza temporale configurabile |
| Similarità descrizione | Confronto testuale dei descrittori della transazione |
Gli elementi non abbinati vengono segnalati per revisione manuale, garantendo completa verificabilità.
Piano dei conti
Ogni transazione viene assegnata a una categoria contabile basata su un piano dei conti configurabile. Le categorie standard includono:
- Ricavi — Vendite, proventi da servizi, interessi attivi
- Costi operativi — Affitti, stipendi, forniture, utenze
- Imposte — IVA, IRPEF/IRES, ritenute
- Investimenti — Capex, acquisizioni asset
- Trasferimenti interni — Movimenti inter-conto
La classificazione è guidata da: regole deterministiche su importo, controparte o pattern di descrizione; riconoscimento keyword; configurazione utente; suggerimenti assistiti basati su dati storici.
Conto economico
Il conto economico viene calcolato aggregando le transazioni classificate su un periodo:
Ricavi
− Costi operativi
− Oneri finanziari
− Imposte
─────────────────
= Utile netto | Indicatore | Definizione |
|---|---|
| Margine operativo | Ricavi − Costi operativi |
| EBITDA | Utile prima di interessi, imposte, svalutazioni e ammortamenti |
| Utile netto | Risultato finale dopo tutti i costi, oneri finanziari e imposte |
Stato patrimoniale
| Sezione | Componenti |
|---|---|
| Attivo | Cassa, crediti, scorte, immobilizzazioni |
| Passivo | Debiti, finanziamenti, ricavi differiti |
| Patrimonio netto | Capitale sociale, utili portati a nuovo, utile di esercizio |
Previsioni finanziarie
La piattaforma genera proiezioni forward-looking basate su:
- Analisi dei flussi storici — Pattern passati di ricavi e costi
- Trend temporali — Tassi di crescita, curve di decadimento, momentum
- Modelli di proiezione — Tecniche statistiche applicate ai dati storici
Il sistema può stimare: flussi di cassa futuri, pattern stagionali e ciclicità, traiettorie di variazione ricavi e costi.
Business plan automatico
| Output | Descrizione |
|---|---|
| Proiezione ricavi | Ricavi futuri attesi per periodo |
| Proiezione costi | Evoluzione attesa dei costi |
| Previsione cashflow | Posizione di liquidità proiettata |
| Indicatori sostenibilità | Metriche di vitalità finanziaria e runway |
Integrità dei dati
- Validazione dati — Controlli di schema e formato su ogni record importato
- Verifica bilancio — Garantisce che debiti e crediti rimangano in equilibrio
- Rilevamento duplicati — Identifica e segnala potenziali transazioni duplicate
- Consistenza cross-report — Valida che i totali coincidano tra diverse viste di report
- Audit trail — Ogni modifica registrata con timestamp e attribuzione utente
Sistema di categorizzazione
Il sistema usa un approccio ibrido a 3 livelli per categorizzare le transazioni: regole deterministiche, un modello AI assistito e la revisione utente. Le categorie seguono uno schema gerarchico con categorie padre e sotto-categorie.
I 3 livelli di classificazione
| Livello | Metodo | Quando si applica |
|---|---|---|
| 1 — Regole deterministiche | Pattern su importo, controparte, descrizione | Prima applicazione, massima precisione |
| 2 — Modello AI | Classificazione basata su dati storici | Quando le regole non danno match sicuro |
| 3 — Revisione utente | Override manuale e feedback | Casi ambigui o nuovi pattern |
Struttura gerarchica delle categorie
Le categorie principali (con sotto-categorie) sono:
| Categoria | Tipo | Sotto-categorie principali |
|---|---|---|
| Ricavi | Entrata | Vendite prodotti, Prestazioni servizi, Interessi attivi, Rimborsi |
| Costi operativi | Uscita | Affitto, Utenze, Stipendi, Forniture, Marketing, Software |
| Imposte e contributi | Uscita | IVA versata, IRPEF/IRES, Contributi INPS, Ritenute |
| Investimenti | Uscita | Acquisto attrezzature, Sviluppo software, Partecipazioni |
| Finanziamenti | Entrata/Uscita | Mutui, Leasing, Linee di credito, Rimborso finanziamenti |
| Trasferimenti interni | Neutro | Giro conto, Prelievi cassa, Versamenti |
Regole di matching
Le regole deterministiche valutano:
- Controparte — Nome dell'ente/azienda nella causale (es. "AGENZIA ENTRATE" → Imposte)
- Pattern descrizione — Keyword e regex sulla causale bancaria
- Range importo — Importi tipici per categoria (es. stipendi ricorrenti)
- Frequenza e periodicità — Transazioni ricorrenti a importo fisso
- Codice SWIFT/BIC — Identificazione banca controparte
Configurazione personalizzata
Il piano dei conti è completamente configurabile. Le aziende possono adattare la struttura alla propria industry e ai requisiti di reporting. Le regole custom hanno priorità sulle regole di sistema e vengono applicate per prime.
Esempi di input e output
Questa sezione mostra esempi concreti di come la piattaforma elabora i dati bancari, dalla fase di import fino ai report finali.
Formato CSV dell'estratto conto
Il formato di input atteso per gli estratti conto bancari:
Data;Descrizione;Importo;Valuta;Saldo
2025-01-03;ACCREDITO STIPENDIO;+3200.00;EUR;5400.00
2025-01-05;PAGAMENTO AFFITTO;-1200.00;EUR;4200.00
2025-01-07;FORNITURA ENEL;-180.50;EUR;4019.50
2025-01-10;INCASSO FATTURA 2025-001;+4500.00;EUR;8519.50
2025-01-15;F24 IVA ACCONTO;-890.00;EUR;7629.50
2025-01-20;BONIFICO A FORNITORE XYZ;-560.00;EUR;7069.50
2025-01-25;RIMBORSO SPESE TRASFERTA;+120.00;EUR;7189.50 Output: transazioni classificate
Dopo l'elaborazione, ogni transazione è arricchita con categoria e metadati:
| Data | Descrizione | Importo | Categoria | Metodo |
|---|---|---|---|---|
| 2025-01-03 | Accredito stipendio | +3.200,00 € | Costi operativi / Stipendi | Regola |
| 2025-01-05 | Pagamento affitto | −1.200,00 € | Costi operativi / Affitto | Regola |
| 2025-01-07 | Fornitura ENEL | −180,50 € | Costi operativi / Utenze | Regola |
| 2025-01-10 | Incasso fattura 2025-001 | +4.500,00 € | Ricavi / Prestazioni servizi | Regola |
| 2025-01-15 | F24 IVA acconto | −890,00 € | Imposte / IVA versata | Regola |
| 2025-01-20 | Bonifico a fornitore XYZ | −560,00 € | Costi operativi / Forniture | AI |
| 2025-01-25 | Rimborso spese trasferta | +120,00 € | Ricavi / Rimborsi | AI |
Output: conto economico mensile
Aggregazione automatica delle transazioni classificate nel periodo:
| Voce | Importo |
|---|---|
| Ricavi totali | +4.620,00 € |
| Costi operativi | −4.940,50 € |
| Imposte | −890,00 € |
| Risultato netto | −1.210,50 € |
Riconciliazione bancaria — esempio
Il motore confronta le transazioni del conto bancario con le partite contabili. Le voci non abbinate vengono evidenziate per revisione:
| Movimento bancario | Partita contabile | Stato |
|---|---|---|
| Incasso fattura 001 — 4.500 € | Fattura 2025-001 — 4.500 € | Abbinato |
| Bonifico fornitore XYZ — 560 € | Ordine fornitore XYZ — 560 € | Abbinato |
| Accredito non identificato — 230 € | — | Da verificare |
Export e formati di output
| Tipo report | Formati disponibili |
|---|---|
| Estratto transazioni classificate | CSV, Excel, JSON |
| Conto economico | PDF, Excel, visualizzazione interattiva |
| Stato patrimoniale | PDF, Excel |
| Business plan | PDF, Excel con grafici |
| Report riconciliazione | PDF, CSV |
PongoSID — Anagrafe Rapporti Finanziari
PongoSID è il modulo dedicato alla preparazione e all'invio delle comunicazioni all'Anagrafe Rapporti Finanziari (ARF) per soggetti obbligati, studi professionali e intermediari finanziari.
A chi serve
- Banche e intermediari finanziari
- Fiduciarie e trust companies
- Studi professionali (dottori commercialisti, consulenti del lavoro)
- Soggetti obbligati ex D.P.R. 605/1973 e normativa collegata
- Operatori che gestiscono comunicazioni ARF su delega
Funzionalità principali
| Funzione | Descrizione |
|---|---|
| Preparazione flussi SID | Generazione del file XML/txt nel formato richiesto dall'Agenzia delle Entrate |
| Controlli pre-invio | Validazione dei dati prima della generazione del flusso per ridurre errori |
| Archivio comunicazioni | Storico ordinato di flussi generati, ricevute e verifiche |
| Gestione multi-soggetto | Comunicazioni per più soggetti obbligati nello stesso workspace |
| Tracciabilità | Log completo di ogni operazione con timestamp e utente |
Flusso operativo
- Inserimento o import dei dati dei rapporti finanziari
- Validazione automatica dei campi obbligatori e dei formati
- Revisione pre-invio con segnalazione delle anomalie
- Generazione del flusso SID nel formato corretto
- Archivio della comunicazione con ricevuta e data
Contatti e supporto
Per domande tecniche, richieste di accesso o supporto sull'utilizzo della piattaforma, scrivi a:
Risposta entro 1 giorno lavorativo. Per segnalazioni urgenti indica l'oggetto "URGENTE" nell'email.