Download the PHP package saleh7/php-zatca-xml without Composer

Please feel free to contribute if you are missing features or tags
View Examples · Report a bug · Request a feature · Ask questions

📖 Introduction

PHP-ZATCA-XML is an unofficial PHP library for generating ZATCA Fatoora e-invoices. It simplifies the process of creating compliant e-invoices, generating QR codes, handling certificates, and submitting invoices to ZATCA’s servers.

Designed for easy integration, this library provides developers with a customizable, robust, and efficient toolkit to automate the ZATCA e-invoicing process in PHP applications.

🚀 Planned Features

We are actively working on expanding the capabilities of this library. If you're a developer and would like to contribute, your help is highly appreciated! 💡

• [ ] XML to JSON Conversion – Support for converting invoices from XML to JSON format.
• [ ] JSON/Array to Invoice – Ability to generate invoices directly from JSON or array structures.
• [ ] Simplified Invoice Creation – Streamlined generation of Simplified Invoices, Debit, and Credit compliant with ZATCA simplified.
• [ ] Standard Invoice Creation – Streamlined generation Standard Invoices, Debit, and Credit compliant with ZATCA standards.
• [ ] Invoice to PDF Conversion – Generate PDF versions of invoices for easy sharing and record-keeping.

💡 Got an idea? Feel free to suggest it or contribute!
Let's build something great together! 🚀

✨ Features

• 🚀 ZATCA-Compliant – Easily generate valid e-invoices for ZATCA regulations
• 📜 Invoice Creation – Generate standard and simplified invoices in XML format
• 🔐 Digital Signing – Sign invoices securely to ensure compliance
• 🏷 QR Code Generation – Automatically generate QR codes for invoices
• 📡 Direct Submission to ZATCA – Send invoices directly to ZATCA’s servers
• ⚡ Lightweight & Fast – Optimized for performance and easy integration in PHP projects
• 🔄 Customizable & Extensible – Easily adapt the library to your needs

📌 Requirements

✅ PHP Version

• PHP 8.1 or higher

✅ Required PHP Extensions

Ensure the following PHP extensions are installed and enabled:

• ext-dom
• ext-libxml
• ext-openssl
• ext-hash
• ext-mbstring

🛠 Installation

🚀 Usage

This library simplifies the process of generating ZATCA-compliant e-invoices, handling certificates, signing invoices, and submitting them to ZATCA’s API. Below are the main usage examples:

📜 1. Generating a Compliance Certificate

First, generate a certificate signing request (CSR) and private key:

🔐 2. Requesting a Compliance Certificate from ZATCA

Once the CSR is generated, you need to request a compliance certificate from ZATCA's API.

🧾 3. Generating an Invoice XML

Now that we have the compliance certificate, we can generate a ZATCA-compliant e-invoice in XML format.

✍️ 4. Signing the Invoice XML

Before submitting the invoice to ZATCA, we need to digitally sign it using the compliance certificate obtained earlier.

📤 5. Submitting the Signed Invoice to ZATCA

Once the invoice is digitally signed, it can be submitted to ZATCA’s API for compliance validation and clearance.

Contributing

Pull requests are welcome. For major changes, please open an issue first to discuss what you would like to change.

Please make sure to update tests as appropriate.

👨‍💻 Contributors

_sevaske

Thank you all for your continuous support and contributions!

Special Credits

This project has also benefited from some code snippets and ideas from the SallaApp/ZATCA repository. We appreciate their contribution to the community.

License

This project is licensed under the MIT License.