CojectCore.Providers.Zatca 1.0.0

.NET 8.0 This package targets .NET 8.0. The package is compatible with this framework or higher.
There is a newer version of this package available.
See the version list below for details. 
dotnet add package CojectCore.Providers.Zatca --version 1.0.0
                    


                    

                
NuGet\Install-Package CojectCore.Providers.Zatca -Version 1.0.0
This command is intended to be used within the Package Manager Console in Visual Studio, as it uses the NuGet module's version of Install-Package. 
<PackageReference Include="CojectCore.Providers.Zatca" Version="1.0.0" />
For projects that support PackageReference, copy this XML node into the project file to reference the package. 
<PackageVersion Include="CojectCore.Providers.Zatca" Version="1.0.0" />
                    


                            Directory.Packages.props
                        

                    

                
<PackageReference Include="CojectCore.Providers.Zatca" />
                    


                            Project file
For projects that support Central Package Management (CPM), copy this XML node into the solution Directory.Packages.props file to version the package. 
paket add CojectCore.Providers.Zatca --version 1.0.0
                    


                    

                
#r "nuget: CojectCore.Providers.Zatca, 1.0.0"
#r directive can be used in F# Interactive and Polyglot Notebooks. Copy this into the interactive tool or source code of the script to reference the package. 
#addin nuget:?package=CojectCore.Providers.Zatca&version=1.0.0
                    


                            Install CojectCore.Providers.Zatca as a Cake Addin
                        

                    

                
#tool nuget:?package=CojectCore.Providers.Zatca&version=1.0.0
                    


                            Install CojectCore.Providers.Zatca as a Cake Tool

CojectCore.Providers.Zatca

A comprehensive .NET library for generating ZATCA-compliant invoices and e-invoicing solutions for Saudi Arabia's Zakat, Tax and Customs Authority requirements.

NuGet Version License .NET

🚀 Features

  • ZATCA Phase 1 & Phase 2 Compliance - Full support for simplified and standard tax invoices
  • QR Code Generation - Automatic QR code generation for invoice validation
  • Digital Signatures - XML digital signing for authenticated invoices
  • Invoice Validation - Built-in validation against ZATCA business rules
  • Multiple Formats - Support for XML, PDF, and JSON invoice formats
  • Arabic/English Support - Bilingual invoice generation
  • Tax Calculation - Automatic VAT and tax calculations
  • B2B & B2C Support - Handle both business and consumer transactions

📦 Installation

Package Manager

Install-Package CojectCore.Providers.Zatca

.NET CLI

dotnet add package CojectCore.Providers.Zatca

PackageReference

<PackageReference Include="CojectCore.Providers.Zatca" Version="1.0.0" />

🏗️ Architecture

The library is built on a modular architecture:

  • Core Engine - Invoice processing and validation logic
  • Formatters - XML, JSON, PDF output formatters
  • Validators - ZATCA business rule validators
  • Cryptography - Digital signing and QR code generation
  • Providers - Extensible provider pattern for different invoice types

📋 ZATCA Compliance

This library implements the following ZATCA requirements:

  • ✅ Invoice Structure - Compliant XML structure per ZATCA specifications
  • ✅ Business Rules - All mandatory business validation rules
  • ✅ QR Code - TLV format QR codes with required fields
  • ✅ Digital Signatures - XML-DSig compliant signing
  • ✅ Tax Calculations - Accurate VAT and tax computations
  • ✅ Localization - Arabic and English language support

🛠️ Configuration Options

Option Description Default
Environment ZATCA environment (Sandbox/Production) Sandbox
Language Invoice language support ArabicEnglish
ValidationLevel Validation strictness level Strict
QrCodeSize QR code dimensions 200x200
DateFormat Date formatting pattern yyyy-MM-dd

🔍 Error Handling

📖 Documentation

🤝 Contributing

We welcome contributions! Please see our Contributing Guide for details.

  1. Fork the repository
  2. Create a feature branch
  3. Make your changes
  4. Add tests
  5. Submit a pull request

📋 Requirements

  • .NET 6.0 or higher
  • Valid ZATCA certificate for production use
  • Saudi Arabia business registration

🐛 Issues and Support

📄 License

This project is licensed under the ZATCA Provider License - see the LICENSE.txt file for details.

⚠️ Disclaimer

This software is provided as-is and users are responsible for ensuring compliance with current ZATCA regulations. Always verify your implementation against the latest ZATCA guidelines and requirements.

🏷️ Tags

zatca saudi-arabia e-invoicing tax vat invoice xml qr-code digital-signature compliance

Built with ❤️ for the Saudi Arabia business community

Product Compatible and additional computed target framework versions.
.NET net8.0 is compatible.  net8.0-android was computed.  net8.0-browser was computed.  net8.0-ios was computed.  net8.0-maccatalyst was computed.  net8.0-macos was computed.  net8.0-tvos was computed.  net8.0-windows was computed.  net9.0 was computed.  net9.0-android was computed.  net9.0-browser was computed.  net9.0-ios was computed.  net9.0-maccatalyst was computed.  net9.0-macos was computed.  net9.0-tvos was computed.  net9.0-windows was computed.  net10.0 was computed.  net10.0-android was computed.  net10.0-browser was computed.  net10.0-ios was computed.  net10.0-maccatalyst was computed.  net10.0-macos was computed.  net10.0-tvos was computed.  net10.0-windows was computed. 
Compatible target framework(s)
Included target framework(s) (in package)
Learn more about Target Frameworks and .NET Standard.

  • net8.0

    • No dependencies.

NuGet packages

This package is not used by any NuGet packages.

GitHub repositories

This package is not used by any popular GitHub repositories.