DEV Community: Nicola Iarocci

Come inviare fatture a SDI FatturaPA in C#

Nicola Iarocci — Wed, 01 Oct 2025 08:40:33 +0000

In questo tutorial creiamo una semplice applicazione C# per spedire fatture a SDI FatturaPA. L'app si connette e autentica con Invoicetronic API, quindi invia le fatture ai loro destinatari.

Prerequisiti

Presupponiamo che questi prerequisiti siano soddisfatti:

Il .NET SDK è stato scaricato e installato
Hai ottenuto una Chiave API attiva
Ti sei registrato presso l'Agenzia delle Entrate (necessario per l'ambiente di produzione)

Utilizziamo lo strumento dotnet e VS Code in quanto sono disponibili sulla maggior parte dei sistemi, ma puoi seguire con il tuo IDE preferito (Visual Studio, Rider, ecc.) se preferisci.

Per un'esperienza C# ottimale in VS Code, assicurati che l'estensione C# Dev Kit sia installata e abilitata. Per ulteriori informazioni, consulta Iniziare con C# in VS Code.

Crea l'app

Il primo passo è creare l'applicazione:

dotnet new console -n send

Il comando ha creato un nuovo progetto C# chiamato "quickstart" in una directory con lo stesso nome. Entra in quella directory:

cd send

Installa l'SDK

Una volta nella directory quickstart, installa l'SDK C#:

 dotnet add package Invoicetronic.Sdk

Una volta fatto, apri VS Code nella directory corrente:

code .

Clicca sul file Program.cs per vedere il suo contenuto nel pannello destro di VS Code.

Configura l'SDK

Sostituisci il contenuto predefinito di Program.cs con il seguente:

using Invoicetronic.Sdk.Api;
using Invoicetronic.Sdk.Client;
using Invoicetronic.Sdk.Model;

// Configura l'SDK.
var config = new Configuration
{
    BasePath = "https://api.invoicetronic.com/v1",
    Username = "LA TUA CHIAVE API DI TEST (inizia con ik_test_)"
};

Come puoi vedere, inizializziamo un'istanza di Configuration impostando il percorso base dell'API e la tua chiave API di test (non quella live). Nota come utilizziamo la proprietà Username per impostare la chiave API.

Quando crei il tuo account, ottieni una coppia di chiavi API. Una è la chiave di test per la Sandbox API, e l'altra è quella live dell'API. Puoi distinguerle perché la prima inizia con ik_test_, mentre la seconda inizia con ik_live_. In questo tutorial, usa sempre la chiave di test.

Invia una fattura

Siamo pronti per effettuare una richiesta. Vogliamo inviare una fattura allo SDI. Aggiungi il seguente codice:


// Invia una fattura
var filePath = "/qualche/percorso/file/nomefile.xml";

var metaData = new Dictionary<string, string>
{
    { "internal_id", "123" },
    { "created_with", "myapp" },
    { "some_other_custom_data", "value" },
};

var sendApi = new SendApi(config);

try
{
    var sentInvoice = await sendApi.SendPostAsync(new Send()
    {
        FileName = Path.GetFileName(filePath),
        Payload = File.ReadAllText(filePath),
        MetaData = metaData
    });

    Console.WriteLine($"La fattura è stata inviata con successo, ora ha l'Id univoco {sentInvoice.Id}.");
}
catch (ApiException e)
{
    Console.WriteLine($"{e.Message} - {e.ErrorCode}");
}

Passa al terminale poi digita:

dotnet run

Dovresti ottenere un output simile a questo:

La fattura nomefile.xml è stata inviata con successo, ora ha l'Id univoco 123.

Cosa abbiamo imparato

In questo esempio, abbiamo imparato diverse cose.

Dobbiamo configurare l'SDK impostando sia la proprietà BasePath che Username, quest'ultima inizializzata con la chiave API.
Dobbiamo istanziare una classe che rappresenta l'endpoint con cui vogliamo lavorare. In questo caso, sfruttiamo SendApi per inviare fatture. Le classi endpoint come SendApi offrono metodi per interagire con la loro entità target. Chiamiamo InvoiceV1SendPosttAsync per inviare una fattura.
La classe Send espone proprietà preziose come FileName, MetaData e Payload. Quest'ultima contiene il contenuto della fattura, mentre MetaData è opzionale e associa dati personalizzati al documento.

Come scaricare fatture da SDI FatturaPA in C#

Nicola Iarocci — Wed, 01 Oct 2025 08:40:11 +0000

In questo tutorial creiamo una semplice applicazione C# per scaricare (download) fatture da SDI FatturaPA. L'app si connette e autentica con Invoicetronic API, quindi scarica le nuove fatture di acquisto.

Prerequisiti

Presupponiamo che questi prerequisiti siano soddisfatti:

Il .NET SDK è stato scaricato e installato
Hai ottenuto una Chiave API attiva
Ti sei registrato presso l'Agenzia delle Entrate (necessario per l'ambiente di produzione)

Utilizziamo lo strumento dotnet e VS Code in quanto sono disponibili sulla maggior parte dei sistemi, ma puoi seguire con il tuo IDE preferito (Visual Studio, Rider, ecc.) se preferisci.

Per un'esperienza C# ottimale in VS Code, assicurati che l'estensione C# Dev Kit sia installata e abilitata. Per ulteriori informazioni, consulta Iniziare con C# in VS Code.

Crea l'app

Il primo passo è creare l'applicazione:

dotnet new console -n receive

Il comando ha creato un nuovo progetto C# chiamato "receive" in una directory con lo stesso nome. Entra in quella directory:

cd receive

Installa l'SDK

Una volta nella directory receive, installa l'SDK C#:

 dotnet add package Invoicetronic.Sdk

Una volta fatto, apri VS Code nella directory corrente:

code .

Clicca sul file Program.cs per vedere il suo contenuto nel pannello destro di VS Code.

Configura l'SDK

Sostituisci il contenuto predefinito di Program.cs con il seguente:

using Invoicetronic.Sdk.Api;
using Invoicetronic.Sdk.Client;
using static Invoicetronic.Sdk.Model.Receive;

// Configura l'SDK.
var config = new Configuration
{
    BasePath = "https://api.invoicetronic.com/v1",
    Username = "LA TUA CHIAVE API DI TEST (inizia con ik_test_)"
};

Scarica le fatture

Siamo pronti per effettuare una richiesta. Vogliamo scaricare nuove fatture dei fornitori che potrebbero essere disponibili dallo SDI. Aggiungi queste righe:


// Scarica le fatture non lette.
var receiveApi = new ReceiveApi(config);

try
{
    var inboundInvoices = await receiveApi.ReceiveGetAsync(unread:true, includePayload:true);
    Console.WriteLine($"Ricevute {inboundInvoices.Count} fatture");

    foreach (var invoice in inboundInvoices)
    {
        switch (invoice.Encoding)
        {
            case EncodingEnum.Xml:
                File.WriteAllText(invoice.FileName, invoice.Payload);
                break;
            case EncodingEnum.Base64:
                File.WriteAllBytes(invoice.FileName, Convert.FromBase64String(invoice.Payload));
                break;
        }

        Console.WriteLine($"Scaricato {invoice.FileName} da un fornitore con Partita IVA {invoice.Prestatore}");
    }
}
catch (ApiException e)
{
    Console.WriteLine($"{e.Message} - {e.ErrorCode}");
}

Impostiamo includePayload: true per recuperare il contenuto effettivo della fattura nella proprietà Payload. Senza questo parametro, il campo Payload sarebbe null per impostazione predefinita, il che aumenta le prestazioni e riduce le dimensioni della risposta quando hai bisogno solo dei metadati.

Passa al terminale poi digita:

dotnet run

Dovresti ottenere un output simile a questo:

Ricevute 3 fatture
Scaricato file1.xml da un fornitore con Partita IVA IT06157670966
Scaricato file2.xml.p7m da un fornitore con Partita IVA IT01280270057
Scaricato file3.xml.p7m da un fornitore con Partita IVA IT01280270057

I file sono nella directory corrente, pronti per essere ispezionati.

Cosa abbiamo imparato

In questo esempio, abbiamo imparato diverse cose.

Dobbiamo configurare l'SDK impostando sia la proprietà BasePath che Username, quest'ultima inizializzata con la chiave API.
Dobbiamo istanziare una classe che rappresenta l'endpoint con cui vogliamo lavorare. In questo caso, sfruttiamo ReceiveApi per scaricare le fatture in arrivo.
Le classi endpoint come ReceiveApi offrono metodi per interagire con la loro entità target. Chiamiamo ReceiveGetAsync per recuperare le fatture. Poiché vogliamo solo fatture nuove e non lette, passiamo unread: true. Passiamo anche includePayload: true per recuperare il contenuto effettivo della fattura (se esegui l'esempio una seconda volta, probabilmente non riceverai alcuna fattura a meno che non ne sia arrivata qualcuna).
La classe Receive espone proprietà preziose come Encoding, FileName e Payload. Quest'ultima contiene il contenuto della fattura, come testo normale o codificato in Base64, come descritto da Encoding.

How to upload SDI FatturaPA invoices with C#

Nicola Iarocci — Wed, 01 Oct 2025 08:39:13 +0000

In this tutorial we build a simple C# console application that connects and authenticates with the Invoicetronic API and uploads outbound invoices to SDI FatturaPA.

Before continuing, make sure all the prerequisites below are met.

Prerequisites

We assume that these prerequisites are met:

The .NET SDK has been downloaded and installed
You obtained an active API Key
You registered with the Italian Revenue Service (needed for the live environment)

We use the dotnet tool and VS Code as they are available on most systems, but you can follow along with your favourite IDE (Visual Studio, Rider, etc.) if you prefer.

For an optimal C# experience in VS Code, you want to ensure that the C# Dev Kit extension is installed and enabled. For more information, see Getting Started with C# in VS Code.

Create the app

The first step is to create the application:

dotnet new console -n send

The command created a new C# project named "quickstart" in a directory with the same name. Step into that directory:

cd send

Install the SDK

Once in the quickstart directory, install the C# SDK:

 dotnet add package Invoicetronic.Sdk

Once that's done, open VS Code in the current directory:

code .

Click on the Program.cs file to see its contents in VS Code right pane.

Configure the SDK

Replace Program.cs default content with the following:

using Invoicetronic.Sdk.Api;
using Invoicetronic.Sdk.Client;
using Invoicetronic.Sdk.Model;

// Configure the SDK.
var config = new Configuration
{
    BasePath = "https://api.invoicetronic.com/v1",
    Username = "YOUR TEST API KEY (starts with ik_test_)"
};

As you can see, we initialize a Configuration instance by setting the API's base path and your test API Key (not the live one). Notice how we use the Username property to set the API Key.

When you create your account, you obtain a pair of API Keys. One is the test key for the API Sandbox, and the other is the live API's. You can tell the difference because the former starts with ik_test_, while the latter begins with ik_live_. In this tutorial, always use the test key.

Send an invoice

We are ready to make a request. We want to send an invoice to the SDI. Add the following code:


// Send an invoice
var filePath = "/some/file/path/filename.xml";

var metaData = new Dictionary<string, string>
{
    { "internal_id", "123" },
    { "created_with", "myapp" },
    { "some_other_custom_data", "value" },
};

var sendApi = new SendApi(config);

try
{
    var sentInvoice = await sendApi.SendPostAsync(new Send()
    {
        FileName = Path.GetFileName(filePath),
        Payload = File.ReadAllText(filePath),
        MetaData = metaData
    });

    Console.WriteLine($"The invoice was sent successfully, it now has the unique Id of {sentInvoice.Id}.");
}
catch (ApiException e)
{
    Console.WriteLine($"{e.Message} - {e.ErrorCode}");
}

Switch to the terminal and type:

dotnet run

You should obtain an output similar to this one:

The invoice filename.xml was sent successfully, it now has the unique Id of 123.

What we learned

In this example, we learned several things.

We must configure the SDK by setting both the BasePath and Username properties, the latter initialized with the API key.
We must instantiate a class representing the endpoint we want to work with. In this case, we leverage SendApi to send invoices. Endpoint classes like SendApi offer methods for interacting with their target entity. We call InvoiceV1SendPosttAsync to send an invoice.
The Send class exposes valuable properties such as FileName, MetaData, and Payload. The last one contains the invoice content, while MetaData is optional and binds custom data to the document.

How to download SDI FatturaPA invoices with C#

Nicola Iarocci — Wed, 01 Oct 2025 08:38:27 +0000

In this tutorial we build a simple C# console application that connects and authenticates with the Invoicetronic API and downloads incoming invoices from SDI FatturaPA.