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
cheUsername
, 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 comeSendApi
offrono metodi per interagire con la loro entità target. ChiamiamoInvoiceV1SendPosttAsync
per inviare una fattura.La classe
Send
espone proprietà preziose comeFileName
,MetaData
ePayload
. Quest'ultima contiene il contenuto della fattura, mentreMetaData
è opzionale e associa dati personalizzati al documento.
Top comments (0)