API fattura elettronica in C# / .NET

// .NET 6+ (HttpClient e System.Text.Json già inclusi) - Program.cs
using System.Net.Http.Headers;
using System.Net.Http.Json;
using System.Text.Json;

const string Api = "https://api.fattura-elettronica.cloud/api";
using var http = new HttpClient { Timeout = TimeSpan.FromSeconds(90) };
http.DefaultRequestHeaders.Accept.Add(new MediaTypeWithQualityHeaderValue("application/json"));

// 1. Login: il token vale a lungo, salvalo e rifai il login solo se ricevi 401
var login = await http.PostAsJsonAsync($"{Api}/login", new { email = "tua@email.it", password = "LaTuaPassword" });
var datiLogin = await login.Content.ReadFromJsonAsync<JsonElement>();
if (!datiLogin.TryGetProperty("access_token", out var token))
    throw new Exception("Login non riuscito");
http.DefaultRequestHeaders.Authorization = new AuthenticationHeaderValue("Bearer", token.GetString());

// 2. Invio della fattura XML allo SdI
var percorso = "IT01234567890_00001.xml";
using var form = new MultipartFormDataContent();
var file = new ByteArrayContent(await File.ReadAllBytesAsync(percorso));
file.Headers.ContentType = new MediaTypeHeaderValue("application/xml");
form.Add(file, "fileFattura", Path.GetFileName(percorso));

var risposta = await http.PostAsync($"{Api}/inoltro", form);
var esito = await risposta.Content.ReadFromJsonAsync<JsonElement>();

if (risposta.IsSuccessStatusCode && esito.GetProperty("esito").GetString() == "ok")
    Console.WriteLine($"Inviata, identificativo SdI: {esito.GetProperty("inoltro").GetProperty("id_sdi")}");
else
    Console.WriteLine($"Errore {(int)risposta.StatusCode}: {esito.GetProperty("messaggio").GetString()}");

// 3. Elenco delle fatture inviate (esito: 0 in attesa, 1 consegnata, 2 mancata consegna, 3 scartata, ...)
var elenco = await http.GetFromJsonAsync<JsonElement>($"{Api}/inoltro");
foreach (var inoltro in elenco.GetProperty("inoltri").EnumerateArray())
    Console.WriteLine($"{inoltro.GetProperty("id_sdi")} {inoltro.GetProperty("esito")}");

// ASP.NET Core 6+ (minimal API) - Program.cs - URL da indicare in "Endpoint ricezione fatture"
using System.Security.Cryptography;
using System.Text;
using System.Text.RegularExpressions;
using Microsoft.AspNetCore.WebUtilities;

var segreto = Environment.GetEnvironmentVariable("FE_SEGRETO") ?? ""; // pagina Integrazione; vuoto = senza firma
var app = WebApplication.CreateBuilder(args).Build();

app.MapPost("/ricevi-fatture", async (HttpRequest request) =>
{
    using var lettore = new StreamReader(request.Body, Encoding.UTF8);
    var corpo = await lettore.ReadToEndAsync(); // il corpo così com'è arrivato, serve per la firma
    if (!FirmaValida(request, corpo, segreto)) return Results.StatusCode(403);

    var dati = QueryHelpers.ParseQuery(corpo);
    var xmlFattura = Convert.FromBase64String(dati["strxml"].ToString()); // XML, già estratto dal .p7m
    var metadati = Encoding.UTF8.GetString(Convert.FromBase64String(dati["xmlM"].ToString()));
    var idSdi = Regex.Match(metadati, @"<IdentificativoSdI>(\d+)<").Groups[1].Value;
    if (idSdi == "" || xmlFattura.Length == 0) return Results.BadRequest("dati mancanti");

    // Stesso IdentificativoSdI = stessa fattura: se arriva di nuovo sovrascrivi, non duplicare
    Directory.CreateDirectory("fatture_ricevute");
    await File.WriteAllBytesAsync(Path.Combine("fatture_ricevute", $"{idSdi}.xml"), xmlFattura);

    return Results.Text("OK"); // esattamente OK: con qualsiasi altra risposta viene rimandata
});

app.Run();

// X-FE-Firma = HMAC-SHA256 di "timestamp\ncorpo" con il tuo segreto
static bool FirmaValida(HttpRequest req, string corpo, string segreto)
{
    if (segreto == "") return true;
    var ts = req.Headers["X-FE-Timestamp"].ToString();
    if (!long.TryParse(ts, out var t) || Math.Abs(DateTimeOffset.UtcNow.ToUnixTimeSeconds() - t) > 300) return false;
    using var hmac = new HMACSHA256(Encoding.UTF8.GetBytes(segreto));
    var attesa = Convert.ToHexString(hmac.ComputeHash(Encoding.UTF8.GetBytes(ts + "\n" + corpo))).ToLowerInvariant();
    return CryptographicOperations.FixedTimeEquals(Encoding.ASCII.GetBytes(attesa),
        Encoding.ASCII.GetBytes(req.Headers["X-FE-Firma"].ToString()));
}

// ASP.NET Core - nello stesso Program.cs dell'endpoint fatture (FirmaValida è quella)
// URL da indicare in "Endpoint ricezione notifiche"
var tipi = new Dictionary<string, string> { ["1"] = "RC", ["2"] = "MC", ["3"] = "NS", ["4"] = "NE", ["5"] = "DT", ["6"] = "AT" };
var stati = new Dictionary<string, string>
{
    ["RC"] = "consegnata",
    ["MC"] = "mancata consegna",     // disponibile nel cassetto fiscale del cliente
    ["NS"] = "scartata",             // i motivi sono in ListaErrori
    ["NE"] = "esito committente",    // solo PA: EsitoCommittente.Esito = EC01 accettata, EC02 rifiutata
    ["DT"] = "decorrenza termini",   // solo PA: nessuna risposta entro 15 giorni
    ["AT"] = "attestazione trasmissione",
};

app.MapPost("/ricevi-notifiche", async (HttpRequest request) =>
{
    using var lettore = new StreamReader(request.Body, Encoding.UTF8);
    var corpo = await lettore.ReadToEndAsync();
    if (!FirmaValida(request, corpo, segreto)) return Results.StatusCode(403);

    var dati = QueryHelpers.ParseQuery(corpo);
    if (!tipi.TryGetValue(dati["tipoNotifica"].ToString(), out var tipo)) return Results.BadRequest("dati mancanti");
    using var notifica = JsonDocument.Parse(dati["esitojson"].ToString()); // la notifica SdI in JSON
    var idSdi = notifica.RootElement.GetProperty("IdentificativoSdI").ToString();

    // IdentificativoSdI è lo stesso restituito dall'API all'invio (inoltro.id_sdi).
    // La stessa notifica può arrivare due volte: l'aggiornamento deve poter essere ripetuto.
    await AggiornaFattura(idSdi, stati[tipo], dati["esitojson"].ToString());

    return Results.Text("OK"); // esattamente OK: con qualsiasi altra risposta viene rimandata
});