Regira.Invoicing 6.1.2

Regira Invoicing

Regira Invoicing covers electronic invoice creation, UBL/Peppol conversion, and document transmission via an AP gateway.

Projects

Installation

<PackageReference Include="Regira.Invoicing.Billit"       Version="6.*" />
<PackageReference Include="Regira.Invoicing.UblSharp"     Version="6.*" />
<PackageReference Include="Regira.Invoicing.ViaAdValvas"  Version="6.*" />

Billit

BillitConfig

DI Registration

services.AddBillit(sp => new BillitConfig
{
    PartyId = configuration["Billit:PartyId"],
    Api     = new() { BaseUrl = configuration["Billit:Api:Url"], Key = configuration["Billit:Api:Key"] }
});
// Registers: IInvoiceManager, IFileManager, IPartyManager, IPeppolManager

IInvoiceManager

Task<ICreateInvoiceResult> Create(IInvoice item);
Task<ISendInvoiceResult>   Send(params string[] ids);    // send by IDs
Task<ISendInvoiceResult>   Send(IInvoice input);          // send by invoice object

UblSharp — UBL Conversion

IUblConverter

XDocument Convert(UblDocumentInput input);

Produces a UBL 2.1 Invoice document.

IInvoice invoice = new Invoice { /* lines, parties, tax, etc. */ };

var converter = new UblConverter();
XDocument ubl = converter.Convert(new UblDocumentInput
{
    Invoice = invoice   // required
});

Supporting constants

• UblConstants — Customization ID and Profile ID for Peppol BIS Billing 3.0
• InvoiceTypeCode — e.g. 380 (Commercial), 383 (DebitNote); credit notes have no type code — they are distinguished by the UBL root element name
• PaymentMeansCode — 1 (NotDefined), 42 (BankAccount), ZZZ (MutuallyDefined)
• TaxCategoryCode — S (standard), Z (zero-rated), E (exempt), AE (reverse charge)

ViaAdValvas — Peppol Transmission

GatewaySettings

PeppolService

var service = new PeppolService(gatewaySettings, jsonSerializer);

UblDocumentResponse result = await service.Send(ublDocument);

if (result.Success)
    Console.WriteLine($"Sent. Reference: {result.Reference}");

Requests are sealed with SealUtility.Generate() — an MD5 digest over the token, sender ID, reference ID, date, and the secret key.

Typical end-to-end flow

// 1. Build the invoice domain model
IInvoice invoice = BuildInvoice(order);

// 2. Convert to UBL XML
XDocument ubl = new UblConverter().Convert(new UblDocumentInput { Invoice = invoice });

// 3. Transmit via Peppol
var result = await peppolService.Send(ubl);

// 4. (Optional) also create in Billit for accounting
await invoiceManager.Create(invoice);
await invoiceManager.Send(invoice);

License

Apache License 2.0 — this package contains no license validation and no runtime limits. See LICENSE. A few companion packages are commercially licensed with a free tier; see the licensing overview.