RoeFactura 1.1.2

RoEFactura - Romanian ANAF eInvoicing Integration

👁 NuGet Version
👁 .NET

RoEFactura is a .NET library for integrating with the Romanian ANAF eFactura system. It supports certificate-based authentication for desktop/server scenarios and OAuth 2.0 redirect flow for web apps. It also provides local UBL 2.1 processing with RO_CIUS validation.

Features

• Dual authentication: certificate-based and OAuth redirect flow
• ANAF API coverage: list, download, validate, upload e-invoices
• Local UBL 2.1 processing and RO_CIUS validation
• Invoice analysis extension methods
• Processing statistics and logging integration

Requirements

• .NET 9.0 or .NET 10 (net9.0 or net10.0)
• Romanian digital certificate installed in CurrentUser/Personal (for certificate-based flow)

Installation

NuGet Package Manager

Install-Package RoEFactura

.NET CLI

dotnet add package RoEFactura

PackageReference

<PackageReference Include="RoEFactura" Version="1.1.1" />

Quick Start

Certificate-based (desktop/server)

using Microsoft.Extensions.DependencyInjection;
using RoEFactura;
using RoEFactura.Services.Api;
using RoEFactura.Services.Authentication;

var services = new ServiceCollection();
services.AddRoEFactura();

var provider = services.BuildServiceProvider();
var auth = provider.GetRequiredService<IAnafOAuthClient>();
var invoices = provider.GetRequiredService<IAnafEInvoiceClient>();

var token = await auth.GetAccessTokenAsync(
 clientId: "your_client_id",
 clientSecret: "your_client_secret",
 callbackUrl: "https://yourapp.com/callback");

var items = await invoices.ListEInvoicesAsync(
 token.AccessToken, days: 30, cui: "RO12345678");

OAuth redirect flow (web apps)

// Program.cs
builder.Services.AddRoEFacturaWithOAuth(builder.Configuration, "AnafOAuth");

// appsettings.json
{
 "AnafOAuth": {
 "ClientId": "your_client_id",
 "ClientSecret": "your_client_secret",
 "RedirectUri": "https://yourapp.com/api/oauth/callback"
 }
}

// Controller example
[HttpPost("oauth/initiate")]
public IActionResult Initiate()
{
 var state = GenerateState();
 var authUrl = _anafClient.GenerateAuthorizationUrl(_options, state);
 return Ok(new { authorizationUrl = authUrl, state });
}

[HttpGet("oauth/callback")]
public async Task<IActionResult> Callback(string code, string state)
{
 ValidateState(state);
 var token = await _anafClient.ExchangeAuthorizationCodeAsync(code, _options);
 await StoreTokenAsync(token);
 return Redirect("/dashboard?authorized=true");
}

Configuration

You can configure OAuth options via configuration or direct options:

services.AddRoEFacturaWithOAuth(new AnafOAuthOptions
{
 ClientId = "your_client_id",
 ClientSecret = "your_client_secret",
 RedirectUri = "https://yourapp.com/oauth/callback",
 AuthorizeUrl = "https://logincert.anaf.ro/anaf-oauth2/v1/authorize",
 TokenUrl = "https://logincert.anaf.ro/anaf-oauth2/v1/token",
 IncludeTokenContentType = true
});

Basic Usage

List invoices (non-paged)

var items = await invoiceClient.ListEInvoicesAsync(token.AccessToken, 30, "RO12345678", filter: null);

List invoices (paged)

long start = DateTimeOffset.UtcNow.AddDays(-30).ToUnixTimeMilliseconds();
long end = DateTimeOffset.UtcNow.ToUnixTimeMilliseconds();

var page = await invoiceClient.ListPagedEInvoicesAsync(
 token.AccessToken, start, end, "RO12345678", filter: null, page: 1);

Download and process invoice

var result = await invoiceClient.ProcessDownloadedInvoiceAsync(token.AccessToken, "download_id");
if (result.IsSuccess)
{
 var invoice = result.Data;
 var totalDue = invoice.GetTotalAmountDue();
}

Validate XML locally (RO_CIUS)

var localResult = await invoiceClient.ValidateInvoiceXmlAsync(xmlContent);
if (!localResult.IsSuccess)
{
 foreach (var error in localResult.Errors)
 {
 Console.WriteLine($"{error.ErrorCode}: {error.ErrorMessage}");
 }
}

Validate/Upload XML via ANAF API

string validateResponse = await invoiceClient.ValidateXmlContentAsync(token.AccessToken, xmlContent);
string uploadResponse = await invoiceClient.UploadXmlContentAsync(token.AccessToken, xmlContent);

Notes:

• filter is passed as ANAF query parameter filtru. Accepted values are defined by ANAF.
• Local validation uses RO_CIUS rules and does not call ANAF.

Common Workflows

1) List and download all invoices for a period

Steps:

1. Authenticate.
2. List invoices (paged or non-paged).
3. Download and process each invoice id.

var list = await invoiceClient.ListEInvoicesAsync(token.AccessToken, 30, "RO12345678");
foreach (var item in list)
{
 var processed = await invoiceClient.ProcessDownloadedInvoiceAsync(token.AccessToken, item.Id);
 if (processed.IsSuccess)
 {
 Console.WriteLine(processed.Data?.ID?.Value);
 }
}

2) Upload new invoice with validation

Steps:

1. Validate locally.
2. Validate with ANAF (optional).
3. Upload to ANAF.

var local = await invoiceClient.ValidateInvoiceXmlAsync(xmlContent);
if (!local.IsSuccess)
{
 return; // handle errors
}

await invoiceClient.ValidateXmlContentAsync(token.AccessToken, xmlContent);
await invoiceClient.UploadXmlContentAsync(token.AccessToken, xmlContent);

3) Handle token expiration gracefully

var expiresAt = DateTime.UtcNow.AddSeconds(token.ExpiresIn);
if (expiresAt <= DateTime.UtcNow.AddMinutes(5))
{
 token = await auth.GetAccessTokenAsync(clientId, clientSecret, callbackUrl);
}

4) Extract data from a processed invoice

var result = await invoiceClient.ProcessDownloadedInvoiceAsync(token.AccessToken, "download_id");
if (result.IsSuccess && result.Data != null)
{
 var invoice = result.Data;
 var sellerVat = invoice.GetSellerVatId();
 var totalWithVat = invoice.GetTotalWithVat();
 var summary = invoice.GetValidationSummary();
}

5) Validate XML before upload

var local = await invoiceClient.ValidateInvoiceXmlAsync(xmlContent);
if (!local.IsSuccess)
{
 // local RO_CIUS errors
}

var anafResponse = await invoiceClient.ValidateXmlContentAsync(token.AccessToken, xmlContent);

Extension Methods Quick Reference

Romanian Constants Reference

Architecture Overview

flowchart TB
 subgraph Authentication [Authentication Layer]
 cert[Certificate Auth]
 oauth[OAuth Web Flow]
 end

 subgraph API [API Layer]
 client[AnafEInvoiceClient]
 end

 subgraph Processing [Processing Layer]
 ubl[UblProcessingService]
 valid[RoCiusUblValidator]
 end

 cert --> client
 oauth --> client
 client --> ubl
 ubl --> valid

Additional Documentation

• API reference:
• Validation rules:
• Troubleshooting:
• Examples:
• Changelog:

Notes

• ANAF endpoints are currently configured to production URLs in AnafEInvoiceClient.
• Local validation uses RO_CIUS rules and does not call ANAF.

Contributing

Contributions are welcome. Please open an issue with details and a minimal reproduction. Pull requests should include documentation updates where relevant.

License

MIT License. See .

Quick Reference

dotnet add package RoEFactura

services.AddRoEFactura();
var token = await anafOAuthClient.GetAccessTokenAsync(clientId, clientSecret, callbackUrl);
var invoices = await anafEInvoiceClient.ListEInvoicesAsync(token.AccessToken, 30, "RO12345678");