Fattura Elettronica per le aziende e la Pubblica Amministrazione Italiana
Clone or download

README.md

Fattura Elettronica per piattaforme .NET Build status

Caratteristiche

  • Lettura e scrittura nel formato aderente alle specifiche tecniche (Allegato A, v1.1 del 22 Giugno 2018).
  • Supporta sia fatture elettroniche tra privati che con la Pubblica Amministrazione.
  • Convalida in osservanza delle specifiche tecniche ufficiali.
  • Supporto per la serializzazione in formato JSON

Utilizzo

using FatturaElettronica;
using FatturaElettronica.Validators;
using FatturaElettronica.Impostazioni;
using FatturaElettronica.FatturaElettronicaHeader.CedentePrestatore;

using System.Xml;
using FatturaElettronica.Common;
using System;

namespace DemoApp
{
    class Program
    {
        static void Main(string[] args)
        {

            // Usare il factory method CreateInstance() per ottenere una istanza di Fattura.
            var fattura = Fattura.CreateInstance(Instance.PubblicaAmministrazione);

            // Lettura da file XML
            using (var r = XmlReader.Create("IT01234567890_FPA01.xml", new XmlReaderSettings { IgnoreWhitespace = true, IgnoreComments = true }))
            {
                fattura.ReadXml(r);
            }

            // Ogni file di fattura contiene un array di elementi FatturaElettronicaBody.
            Console.WriteLine($"Numero di documenti: {fattura.Body.Count}.");
            Console.WriteLine("Documenti inclusi nel file FatturaPA:");
            foreach(var doc in fattura.Body)
            {
                Console.WriteLine($"Numero: {doc.DatiGenerali.DatiGeneraliDocumento.Numero}");
                Console.WriteLine($"Data: {doc.DatiGenerali.DatiGeneraliDocumento.Data.ToShortDateString()}");
                Console.WriteLine($"Totale documento: {doc.DatiGenerali.DatiGeneraliDocumento.ImportoTotaleDocumento}");
                Console.WriteLine();

            }

            // Convalida del documento.
            var validator = new FatturaValidator();
            var result = validator.Validate(fattura);
            Console.WriteLine(result.IsValid);

            // Introspezione errori di convalida.
            foreach (var error in result.Errors)
            {
                Console.WriteLine(error.PropertyName);
                Console.WriteLine(error.ErrorMessage);
                // Nei casi di errore 2xx e 4xx ErrorCode conterrà il codice errore (es: "00423").
                Console.WriteLine(error.ErrorCode);
            }

            // Per brevità è possibile usare un extension method.
            result = fattura.Validate();
            Console.WriteLine(result.IsValid);

            // Sono disponibili validatori per ogni classe esposta da FatturaElettronica.
            var anagrafica = new DatiAnagraficiCedentePrestatore();
            var anagraficaValidator = new DatiAnagraficiCedentePrestatoreValidator();
            Console.WriteLine(anagraficaValidator.Validate(anagrafica).IsValid);
            // Oppure come già visto:
            Console.WriteLine(anagrafica.Validate().IsValid);

            // Modifica proprietà Header.
            fattura.Header.CedentePrestatore.DatiAnagrafici.Anagrafica.Denominazione = "Bianchi Srl";
            //  Modifica proprietà Body
            fattura.Body[0].DatiGenerali.DatiGeneraliDocumento.Numero = "12345";

            // Serializzazione XML
            using (var w = XmlWriter.Create("IT01234567890_FPA01.xml", new XmlWriterSettings { Indent = true }))
            {
                fattura.WriteXml(w);
            }

            // Serializzazione JSON.
            var json = fattura.ToJson(JsonOptions.Indented);
            Console.WriteLine(json);
        }
    }
}

Limitazioni

In convalida non sono supportati gli errori di tipo 3xx in quanto risultato dei riscontri fatti da PA sui propri server.

Portabilità

FatturaElettronica supporta .NET Standard v1.1, cosa che le permette di supportare un ampio numero di piattaforme.

Installazione

FatturaElettronica è su NuGet quindi tutto quel che serve è eseguire:

    PM> Install-Package FatturaElettronica

dalla Package Console, oppure usare il comando equivalente in Visual Studio.

Licenza

FatturaElettronica è un progetto open source di Nicola Iarocci e Gestionale Amica rilasciato sotto licenza BSD.