DEV Community

Nicola Iarocci
Nicola Iarocci

Posted on • Originally published at invoicetronic.com

Come scaricare fatture da SDI FatturaPA in C#

#programming #tutorials #dotnet #csharp

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:

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
Enter fullscreen mode Exit fullscreen mode

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

cd receive
Enter fullscreen mode Exit fullscreen mode

Installa l'SDK

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

 dotnet add package Invoicetronic.Sdk
Enter fullscreen mode Exit fullscreen mode

Una volta fatto, apri VS Code nella directory corrente:

code .
Enter fullscreen mode Exit fullscreen mode

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_)"
};
Enter fullscreen mode Exit fullscreen mode

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.

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}");
}
Enter fullscreen mode Exit fullscreen mode

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
Enter fullscreen mode Exit fullscreen mode

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
Enter fullscreen mode Exit fullscreen mode

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

Cosa abbiamo imparato

In questo esempio, abbiamo imparato diverse cose.

  1. Dobbiamo configurare l'SDK impostando sia la proprietà BasePath che Username, quest'ultima inizializzata con la chiave API.

  2. Dobbiamo istanziare una classe che rappresenta l'endpoint con cui vogliamo lavorare. In questo caso, sfruttiamo ReceiveApi per scaricare le fatture in arrivo.

  3. 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).

  4. 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.

Top comments (0)