FatturaPA: Parse XML → JSON

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.

⚙️ Parametri di configurazione

Campi mostrati nell’editor quando si configura il nodo. Generati direttamente dal NodeDefconfigFields.

⬆️ Output del nodo

Campi disponibili nei nodi successivi via $node.<alias>.json.<field>:

• fatture
• count
• xsd

💡 Esempio configurazione

Snippet JSON del nodo come compare nel workflow. I valori sono derivati daidefaultValue e dai parametri required.

{
  "id": "node-italia_fatturapa_parse-1",
  "defId": "italia_fatturapa_parse",
  "label": "FatturaPA: Parse XML → JSON",
  "config": {
    "validateXsd": false
  }
}

🔗 Nodi correlati nella stessa categoria