AnafIntegration 1.0.5

AnafIntegration

.NET 7 class library for integrating with the ANAF e-Factura API (RO e-Factura). Handles OAuth 2.0 authentication, invoice conversion from C# objects to UBL 2.1 XML (CIUS-RO), and all e-Factura API operations.

Designed to be referenced from a Blazor WASM Server application.

Installation

Add a project reference from your Blazor Server project:

<ProjectReference Include="..\AnafIntegration\AnafIntegration.csproj" />

NuGet dependencies (restored automatically):

• UblSharp 1.1.1
• Microsoft.Extensions.Http 7.0.0
• Microsoft.Extensions.DependencyInjection.Abstractions 7.0.0
• Microsoft.Extensions.Options 7.0.0

Setup

1. Register services in Program.cs

using AnafIntegration;
using AnafIntegration.Extensions;

builder.Services.AddAnafIntegration(options =>
{
    options.ClientId = "your-client-id";
    options.ClientSecret = "your-client-secret";
    options.RedirectUri = "https://yourapp.com/anaf-callback";
    options.Environment = AnafEnvironment.Test; // or AnafEnvironment.Production
});

This registers all services: AnafOAuthService, AnafApiClient, InMemoryTokenStore, and InvoiceToUblMapper.

2. ANAF prerequisites

Before using the API you must:

1. Register as a developer at anaf.ro > Servicii Online > Inregistrare utilizatori > Dezvoltatori Aplicatii.
2. Authenticate and go to "Editare profil Oauth".
3. Register your application (name + e-Factura service) to receive your Client ID and Client Secret.
4. Users of your app must be registered in SPV with a qualified digital certificate and SPV PJ rights.

OAuth 2.0 Authentication

The library implements the full OAuth 2.0 Authorization Code flow with JWT tokens.

Step 1 -- Redirect the user to ANAF login

@inject AnafOAuthService OAuthService

var authUrl = OAuthService.GetAuthorizationUrl(state: "optional-csrf-token");
NavigationManager.NavigateTo(authUrl, forceLoad: true);

The user authenticates with their qualified digital certificate on logincert.anaf.ro, then ANAF redirects back to your RedirectUri with a ?code= query parameter.

Step 2 -- Exchange the code for tokens

In your callback page/endpoint:

@inject AnafOAuthService OAuthService
@inject InMemoryTokenStore TokenStore

// Extract the authorization code from the callback URL
var code = NavigationManager.Uri.Split("code=")[1].Split("&")[0];

// Exchange for tokens
var tokenInfo = await OAuthService.ExchangeCodeForTokenAsync(code);

// Store the token so AnafApiClient can use it
await TokenStore.SetTokenAsync(tokenInfo);

Step 3 -- Refresh tokens when needed

Access tokens are valid for 90 days, refresh tokens for 365 days.

var currentToken = await TokenStore.GetTokenAsync();
if (currentToken != null && currentToken.IsExpired)
{
    var newToken = await OAuthService.RefreshTokenAsync(currentToken.RefreshToken);
    await TokenStore.SetTokenAsync(newToken);
}

Persisting tokens across restarts

InMemoryTokenStore holds tokens in memory. Subscribe to OnTokenChanged to persist them to your own storage:

// In Program.cs or a startup service
var tokenStore = app.Services.GetRequiredService<InMemoryTokenStore>();
tokenStore.OnTokenChanged += token =>
{
    if (token != null)
    {
        // Save to database, file, etc.
        MyDatabase.SaveToken(token.AccessToken, token.RefreshToken, token.ExpiresAt);
    }
};

// On app startup, restore previously saved tokens
var saved = MyDatabase.LoadToken();
if (saved != null)
{
    await tokenStore.SetTokenAsync(new TokenInfo
    {
        AccessToken = saved.AccessToken,
        RefreshToken = saved.RefreshToken,
        ExpiresAt = saved.ExpiresAt
    });
}

Sending an Invoice

Full workflow example

@inject InvoiceToUblMapper Mapper
@inject AnafApiClient ApiClient

// 1. Build the invoice
var invoice = new InvoiceData
{
    InvoiceNumber = "FV-2024-001",
    IssueDate = new DateTime(2024, 3, 15),
    DueDate = new DateTime(2024, 4, 15),
    CurrencyCode = "RON",
    Supplier = new PartyInfo
    {
        Name = "Firma Mea SRL",
        VatNumber = "RO12345678",
        Cif = "12345678",
        RegistrationNumber = "J40/1234/2020",
        StreetAddress = "Str. Exemplu nr. 1",
        City = "Bucuresti",
        County = "RO-B",
        PostalCode = "010101",
        CountryCode = "RO",
        Email = "contact@firmamea.ro",
        Phone = "+40212345678"
    },
    Customer = new PartyInfo
    {
        Name = "Client SRL",
        VatNumber = "RO87654321",
        Cif = "87654321",
        RegistrationNumber = "J40/5678/2019",
        StreetAddress = "Bd. Clientului nr. 10",
        City = "Cluj-Napoca",
        County = "RO-CJ",
        PostalCode = "400001",
        CountryCode = "RO"
    },
    Lines = new List<InvoiceLine>
    {
        new InvoiceLine
        {
            Description = "Servicii consultanta IT",
            Quantity = 10,
            UnitCode = "HUR",       // hours
            UnitPrice = 150.00m,
            VatPercent = 19,
            VatCategoryCode = "S"
        },
        new InvoiceLine
        {
            Description = "Licenta software",
            Quantity = 1,
            UnitCode = "C62",       // piece
            UnitPrice = 500.00m,
            VatPercent = 19,
            VatCategoryCode = "S",
            ItemId = "SW-LIC-001"
        }
    },
    Payment = new PaymentInfo
    {
        Iban = "RO49AAAA1B31007593840000",
        BankName = "Banca Exemplu",
        PaymentMeansCode = "30",    // bank transfer
        PaymentTerms = "30 zile de la data facturii"
    }
};

// 2. Convert to UBL 2.1 XML (CIUS-RO)
var xml = Mapper.MapToXml(invoice);

// 3. Validate (free, no authentication required)
var validationResult = await ApiClient.ValidateInvoiceAsync(xml, "FACT1");

// 4. Upload to ANAF
var uploadResult = await ApiClient.UploadInvoiceAsync(xml, "UBL", invoice.Supplier.Cif);

if (uploadResult.IsSuccess)
{
    Console.WriteLine($"Uploaded successfully. Index: {uploadResult.UploadIndex}");
}

// 5. Check processing status
var status = await ApiClient.GetMessageStatusAsync(uploadResult.UploadIndex!.Value);
// status.Stare: "ok", "nok", "in prelucrare"

// 6. Download the signed response when ready
if (status.IsOk && status.IdDescarcare.HasValue)
{
    byte[] zip = await ApiClient.DownloadResponseAsync(status.IdDescarcare.Value);
    File.WriteAllBytes("response.zip", zip);
    // ZIP contains: original invoice XML + Ministry of Finance digital signature XML
}

API Reference

All authenticated methods require a valid token stored via InMemoryTokenStore.SetTokenAsync().

AnafApiClient

Upload standards

Upload flags

Use UploadFlags for special cases:

// Foreign buyer (no Romanian CUI/NIF)
await ApiClient.UploadInvoiceAsync(xml, "UBL", cif, new UploadFlags { Extern = true });

// Self-billing (buyer issues invoice on behalf of supplier)
await ApiClient.UploadInvoiceAsync(xml, "UBL", cif, new UploadFlags { AutoFactura = true });

Validation standards

Message list filters

Invoice Model Reference

InvoiceData

PartyInfo

InvoiceLine

PaymentInfo

Project Structure

AnafIntegration/
  AnafEnvironment.cs              URL constants (Test / Production)
  Auth/
    AnafOAuthOptions.cs           ClientId, ClientSecret, RedirectUri, Environment
    AnafOAuthService.cs           OAuth flow: authorization URL, code exchange, token refresh
    TokenInfo.cs                  AccessToken, RefreshToken, ExpiresAt, IsExpired
  Storage/
    InMemoryTokenStore.cs         Thread-safe token store with OnTokenChanged event
  Api/
    AnafApiClient.cs              All e-Factura API endpoints
    Models/
      UploadResponse.cs           Upload result (upload_index, errors)
      MessageStatus.cs            Processing status (ok, nok, in prelucrare)
      MessageListResponse.cs      Message list with pagination
      UploadFlags.cs              Extern, AutoFactura, Executare flags
  Invoice/
    InvoiceModel.cs               POCO models: InvoiceData, PartyInfo, InvoiceLine, PaymentInfo
    InvoiceToUblMapper.cs         Converts InvoiceData to UBL 2.1 XML (CIUS-RO)
  Extensions/
    ServiceCollectionExtensions.cs    AddAnafIntegration() DI registration

ANAF API Limits

HTTP Status Codes

Environment URLs