MAES.Fiskal 1.1.1

MAES.Fiskal

MAES.Fiskal is a fiscalization tool for invoices developed in C# using .NET 8. It enables automatic generation and submission of fiscal data according to current regulations.

Features

• ZKI Generation
• Invoice fiscalization
• Tip fiscalization
• Free and open source

Installation

Nuget: https://www.nuget.org/packages/MAES.Fiskal

or

git clone https://github.com/MAES-Software/MAES.Fiskal.git

Prerequirements

Load X509Certificate2

1. From file (You can use relative path eg. "./cert.p12")

   var certificate = new X509Certificate2("filename");
   

2. From some data stream with byte[] bytes

   var certificate = new X509Certificate2(bytes);
   

You must also supply password for given certificate if it has one (by default certificates given from goverment are locked but they can be repackaged)

var certificate = new X509Certificate2("filename", "password");

Usage Example

Define using MAES.Fiskal to get all classes for fiscalization

using MAES.Fiskal;

Create an invoice

var invoice = new RacunType
{
    // Fill invoice properties here
};

Create an invoiceTipType from invoiceType

RacunNapojnicaType invoiceTip = invoice.ToInvoiceTipAsnyc(new ()
{
    // Fill tip properties here
});

Send invoice

Fiscalization.SendInvoiceAsync(invoice, certificate);

Send invoiceTip

Fiscalization.SendInvoiceAsync(invoiceTip, certificate);

Generate ZKI

string zki = invoice.ZKI(certificate);

Both invoice and invoiceTip have .ZKI(certificate) methods

Disabling SSL Certificate Validation (Not Recommended)

If you encounter issues with SSL certificate validation, you can disable certificate checks as follows:

Fiscalization.SslCertificateAuthentication = new()
{
    CertificateValidationMode = X509CertificateValidationMode.None,
    RevocationMode = X509RevocationMode.NoCheck
};

Warning: Disabling SSL certificate validation is not recommended for production environments, as it reduces security and exposes your application to potential risks. Use this option only for testing or troubleshooting purposes.

License

<a href="https://github.com/MAES-Software/MAES.Fiskal">MAES.Fiskal</a> © 2025 by <a href="https://github.com/ImaJosBuggova">Roko Tomović</a> is licensed under <a href="https://creativecommons.org/licenses/by-sa/4.0/">Creative Commons Attribution-ShareAlike 4.0 International</a><img src="https://mirrors.creativecommons.org/presskit/icons/cc.svg" alt="" style="max-width: 1em;max-height:1em;margin-left: .2em;"><img src="https://mirrors.creativecommons.org/presskit/icons/by.svg" alt="" style="max-width: 1em;max-height:1em;margin-left: .2em;"><img src="https://mirrors.creativecommons.org/presskit/icons/sa.svg" alt="" style="max-width: 1em;max-height:1em;margin-left: .2em;">