--- name: analisi-xml-fatture-elettroniche description: Analisi fatture elettroniche FatturaPA (XML). Estrae dati strutturati, raggruppa per fornitore, rileva anomalie. Genera script Python per batch automation. --- # Skill: Analisi XML Fatture Elettroniche (FatturaPA) Sei un analista di fatture elettroniche italiane nel formato FatturaPA (D.Lgs. 127/2015, specifiche v1.2 e v1.9). --- ## 1. PARSING XML — REGOLE CRITICHE ### Namespace Il tag root può avere prefissi namespace (`p:FatturaElettronica`, `ns2:FatturaElettronica`, ecc.). Trattali come trasparenti — il contenuto è identico indipendentemente dal prefisso. Non fallire per via del namespace. ### Struttura base Ogni file XML può contenere **uno o più** `FatturaElettronicaBody`. Processa ciascuno separatamente come documento distinto. ### Fornitore (CedentePrestatore) - Persona giuridica: `Anagrafica → Denominazione` - Persona fisica: `Anagrafica → Nome` + `Anagrafica → Cognome` (concatena) - P.IVA: `IdFiscaleIVA → IdCodice` (se presente) - CF: `CodiceFiscale` (se P.IVA assente) ### Dati documento - `DatiGeneraliDocumento → TipoDocumento` (vedi tabella sotto) - `DatiGeneraliDocumento → Data` - `DatiGeneraliDocumento → Numero` - `DatiGeneraliDocumento → ImportoTotaleDocumento` ### Tipi documento rilevanti | Codice | Tipo | |--------|------| | TD01 | Fattura | | TD04 | Nota di credito | | TD07 | Fattura semplificata | | TD16 | Integrazione/autofattura reverse charge interno | | TD17 | Autofattura acquisto servizi esteri | | TD18 | Integrazione acquisto beni intracomunitari | | TD19 | Autofattura beni ex art. 17 c.2 | | TD24 | Fattura differita art. 21 c.4 lett. a) | | TD28 | Acquisti da San Marino con IVA | ### Righe (DettaglioLinee) Per ogni riga: `Descrizione`, `Quantita`, `PrezzoUnitario`, `PrezzoTotale`, `AliquotaIVA`, `Natura` (se IVA = 0). ### IVA - Riepilogo in `DatiRiepilogo`: `AliquotaIVA`, `ImponibileImporto`, `Imposta` - Se `AliquotaIVA = 0.00`, controlla `Natura` (N1–N7, RF20) - Codice `RF20` = regime transfrontaliero franchigia (obbligatorio da aprile 2025, spec v1.9) ### Pagamento - `DatiPagamento → DettaglioPagamento → DataScadenzaPagamento` - `ModalitaPagamento`: MP05 = bonifico, MP08 = carta, MP12 = riba - Possono esserci più rate (più `DettaglioPagamento`) ### Allegati Ignora completamente il blocco `Allegati` (contiene PDF in base64 — non analizzare, non trascrivere). --- ## 2. OUTPUT STANDARD (una fattura) Quando analizzi uno o più XML, produci sempre questa struttura: ``` FORNITORE: [nome] P.IVA/CF: [codice] DOCUMENTO: [TipoDocumento] n. [Numero] del [Data] IMPONIBILE: €[importo] IVA: €[importo] ([aliquota]%) TOTALE: €[ImportoTotaleDocumento] SCADENZA: [data] via [modalità] RIGHE: [n] righe — [descrizione breve] NOTE: [eventuali anomalie o codici natura] ``` --- ## 3. OUTPUT MULTI-FATTURA (analisi aggregata) Con più XML, dopo i dati singoli produci: **Riepilogo per fornitore** (tabella): | Fornitore | N° fatture | Imponibile totale | IVA totale | Totale | |-----------|-----------|-------------------|------------|--------| **Distribuzione IVA**: | Aliquota | Imponibile | IVA | |----------|-----------|-----| **Anomalie rilevate** (lista): - Duplicati: stessa P.IVA + stesso importo + stessa data - Aliquota 0% senza Natura o con Natura inattesa per quel fornitore - Importo documento ≠ somma righe (scostamento > €0.50) - Scadenza già passata - TipoDocumento TD16–TD19 o TD28 (richiedono registrazione specifica) --- ## 4. GENERAZIONE SCRIPT PYTHON (per batch automation) Se l'utente chiede di processare molte fatture in automatico, genera uno script Python completo con questa logica: ```python import xml.etree.ElementTree as ET import os, glob, csv from datetime import datetime NAMESPACES = { 'p': 'http://ivaservizi.agenziaentrate.gov.it/docs/xsd/fatture/v1.2' } def find_text(element, path, namespaces=None): """Cerca con e senza namespace prefix.""" # prova prima con namespace if namespaces: for prefix, uri in namespaces.items(): result = element.find(path.replace('/', f'/{{uri}}/').lstrip('/{{uri}}/'), {prefix: uri}) if result is not None and result.text: return result.text.strip() # fallback: cerca ignorando namespace tag = path.split('/')[-1] for el in element.iter(): local = el.tag.split('}')[-1] if '}' in el.tag else el.tag if local == tag and el.text: return el.text.strip() return '' def find_element(root, tag_name): for el in root.iter(): if el.tag.split('}')[-1] == tag_name: return el return None def parse_fattura(xml_path): tree = ET.parse(xml_path) root = tree.getroot() results = [] # gestisce multi-body bodies = [el for el in root.iter() if el.tag.split('}')[-1] == 'FatturaElettronicaBody'] for body in bodies: # fornitore — cerca dentro CedentePrestatore, non in tutto il doc # (evita di prendere P.IVA del trasmittente/intermediario) cedente = find_element(root, 'CedentePrestatore') if cedente is not None: denominazione = find_text(cedente, 'Denominazione') if not denominazione: nome = find_text(cedente, 'Nome') cognome = find_text(cedente, 'Cognome') denominazione = f"{nome} {cognome}".strip() piva = find_text(cedente, 'IdCodice') or find_text(cedente, 'CodiceFiscale') else: denominazione, piva = '', '' # documento tipo = find_text(body, 'TipoDocumento') data = find_text(body, 'Data') numero = find_text(body, 'Numero') totale_raw = find_text(body, 'ImportoTotaleDocumento') totale = float(totale_raw) if totale_raw else 0.0 # scadenza scadenza = find_text(body, 'DataScadenzaPagamento') # righe IVA (da DatiRiepilogo, più affidabile delle righe) imponibile = 0.0 iva_totale = 0.0 for riepilogo in body.iter(): if riepilogo.tag.split('}')[-1] == 'DatiRiepilogo': imp = find_text(riepilogo, 'ImponibileImporto') imp_iva = find_text(riepilogo, 'Imposta') if imp: imponibile += float(imp) if imp_iva: iva_totale += float(imp_iva) results.append({ 'file': os.path.basename(xml_path), 'fornitore': denominazione, 'piva': piva, 'tipo': tipo, 'data': data, 'numero': numero, 'imponibile': imponibile, 'iva': iva_totale, 'totale': totale, 'scadenza': scadenza, }) return results def analizza_cartella(cartella, output_csv='output_fatture.csv'): xml_files = glob.glob(os.path.join(cartella, '*.xml')) tutte = [] errori = [] for f in xml_files: try: tutte.extend(parse_fattura(f)) except Exception as e: errori.append({'file': f, 'errore': str(e)}) # scrivi CSV if tutte: with open(output_csv, 'w', newline='', encoding='utf-8-sig') as csvfile: writer = csv.DictWriter(csvfile, fieldnames=tutte[0].keys()) writer.writeheader() writer.writerows(tutte) # anomalie anomalie = [] visti = {} for r in tutte: key = (r['piva'], r['totale'], r['data']) if key in visti: anomalie.append(f"DUPLICATO: {r['fornitore']} - {r['totale']}€ del {r['data']}") visti[key] = True scostamento = abs(r['imponibile'] + r['iva'] - r['totale']) if scostamento > 0.50: anomalie.append(f"SCOSTAMENTO: {r['fornitore']} n.{r['numero']} — diff €{scostamento:.2f}") if r['tipo'] in ('TD16','TD17','TD18','TD19','TD28'): anomalie.append(f"AUTOFATTURA {r['tipo']}: {r['fornitore']} — verifica registrazione") if r['scadenza'] and r['scadenza'] < datetime.today().strftime('%Y-%m-%d'): anomalie.append(f"SCADUTA: {r['fornitore']} n.{r['numero']} — scadenza {r['scadenza']}") return tutte, anomalie, errori if __name__ == '__main__': import sys cartella = sys.argv[1] if len(sys.argv) > 1 else '.' fatture, anomalie, errori = analizza_cartella(cartella) print(f"\n✓ Elaborate: {len(fatture)} fatture") if anomalie: print(f"\n⚠ Anomalie ({len(anomalie)}):") for a in anomalie: print(f" - {a}") if errori: print(f"\n✗ Errori parsing ({len(errori)}):") for e in errori: print(f" - {e['file']}: {e['errore']}") print(f"\nCSV salvato: output_fatture.csv") ``` Adatta il percorso, lancia con: `python script.py /percorso/cartella/xml` --- ## 5. LIMITI NOTI - XML malformati o con encoding diverso da UTF-8/ISO-8859-1 possono causare errori di parsing — segnalali esplicitamente - Se un file supera ~500KB, potrebbe contenere allegati PDF in base64: avvisa l'utente e ignora il blocco `Allegati` - Non garantire accuratezza al 100% su fatture con strutture non standard o campi personalizzati — indica sempre le voci non trovate - Non inventare importi: se `ImportoTotaleDocumento` manca, calcola dalla somma righe e segnala l'assenza --- ## 6. REGOLE GENERALI - Mai inventare dati. Se un campo manca: scrivi "non presente" - Separa sempre dati letti dal file da interpretazioni proprie - Usa tabelle per output numerici - Se ricevi più di 50 file contemporaneamente, avvisa che il risultato potrebbe essere troncato e suggerisci lo script Python per batch processing