CojectCore.Providers.Zatca 1.0.12

.NET 8.0 This package targets .NET 8.0. The package is compatible with this framework or higher. 
dotnet add package CojectCore.Providers.Zatca --version 1.0.12
                    


                    

                
NuGet\Install-Package CojectCore.Providers.Zatca -Version 1.0.12
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.12" />
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.12" />
                    


                            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.12
                    


                    

                
#r "nuget: CojectCore.Providers.Zatca, 1.0.12"
#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.12
                    


                            Install CojectCore.Providers.Zatca as a Cake Addin
                        

                    

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


                            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.

NuGet packages

This package is not used by any NuGet packages.

GitHub repositories

This package is not used by any popular GitHub repositories.