Descrizione
Parser deterministico di fatture elettroniche FatturaPA (FPR12 e FPA12) da XML a JSON tipizzato — il pezzo che trasforma il ciclo passivo in dati lavorabili: cedente e cessionario (denominazione, Partita IVA, Codice Fiscale, con supporto Nome+Cognome delle ditte individuali), tipo documento, numero, data, valuta, importo totale, TUTTE le righe (descrizione, quantità, prezzi, aliquota), riepiloghi IVA per aliquota e scadenze di pagamento con importi. Parsing con libxml2 (lo stesso motore della validazione XSD del nodo di invio) e XPath namespace-agnostic: gli XML dei diversi gestionali vengono letti allo stesso modo. Una fattura-lotto con N corpi produce N elementi nell'array. Validazione XSD opzionale contro lo schema UFFICIALE v1.2.2 dell'Agenzia delle Entrate (offline). Deterministico per design: a differenza di un LLM che rilegge l'XML, gli importi estratti sono ESATTI e sempre uguali — l'AI a valle riceve il JSON pulito e non può sbagliare un totale. Output: { fatture: [{cedente, cessionario, numero, data, importoTotaleDocumento, righe[], riepilogoIva[], scadenze[]}], count, xsd? }. Use case: (1) scadenzario automatico — PEC in ingresso → p7m extract → parse → db_insert delle scadenze con alert Telegram 5 giorni prima; (2) controllo fornitori con AI — Liara confronta i prezzi di riga con lo storico e segnala rincari; (3) registrazione contabile assistita verso il gestionale (Odoo/Fatture in Cloud) coi dati già strutturati; (4) report IVA mensile aggregando i riepiloghi per aliquota.
