KO | EN

GitLite

Minimalist Open Source Repository Search Engine

gitlite — search

#dsh #dsh-plugin #developer-tools #ai-agent #claude-code #codex #typescript #ai-agents #deepseek-harness #mcp #cli #rust

ksa_compliance

★ 84 Open GitHub ↗

KSA Compliance App for KSA E-invoice

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# KSA Compliance

A free and open-source Frappe application for KSA Compliance (ZATCA Integration), offering support for both Phase 1 and Phase 2.

## Main Features

1.  ZATCA Phase 1 - compliance
2.  ZATCA Phase 2 - compliance
3.  Simplified invoice
4.  Standard Invoice
5.  Wizard onboarding
6.  Automatic ZATCA CLI setup
7.  Tax exemption reasons
8.  ZATCA dashboard
9.  Embedded Invoice QR without impacting storage
10. Embedded Invoice XML without impacting storage
11. ZATCA phase 1 print format
12. ZATCA phase 2 print format
13. Resend process
14. Rejection process
15. ZATCA Integration Live and Batch modes
16. Multi-company support
17. Multi-device setup
18. Embedded compliance checks log
19. System XML validation
20. Support ZATCA Sandbox

## How to Install

-   **Frappe Cloud:**\
    One-click installing available if you are hosting on Frappe Cloud
-   **Self Hosting:**

```
bench get-app --branch master https://github.com/lavaloon-eg/ksa_compliance.git
```

```
bench setup requirements
```

```
bench  --site [your.site.name] install-app ksa_compliance
```

```
bench  --site [your.site.name] migrate
```

```
bench restart
```

## Support

### Frappe Cloud:

- If you are hosting on FC premium support is available

### Self Hosting:

- If you need premium support please email: Info@lavaloon.com

### Community Support:

- Available in GitHub discussions <https://github.com/lavaloon-eg/ksa_compliance/discussions>

### New Features and Bug report:

- Please Create Github Issue <https://github.com/lavaloon-eg/ksa_compliance/issues> after checking the existing issues
  - Please include bench information (i.e. output of `bench version`)
  - For invoice rejections, please attach or paste the generated invoice XML (from `Sales Invoice Additional Fields`), any validation warnings/errors, and screenshots of the `Sales Invoice` document
- For paid features, you can email us: <info@lavaloon.com>

## **Contributing**

### Issues

[**Issue Guidelines**](https://github.com/frappe/erpnext/wiki/Issue-Guidelines "https://github.com/frappe/erpnext/wiki/issue-guidelines")

### Development Setup (PRs)

This project is configured to run `ruff lint` and `run format` before commits, but you have to set it up locally as
follows. Setup development dependencies:

```bash
bench setup requirements --dev
```

Activate the bench environment:

```bash
source env/bin/activate
```

Install the pre-commit hook:

```bash
pre-commit install
```

This will generate a git hook at `.git/hooks/pre-commit`. This hook will run before committing and will fail if:
* There are errors that can't be automatically fixed. In this case, fix them manually and commit
* If formatting changes were applied. In this case, simply try to commit again and it should go through

You can run either manually from bench after activating the environment using:

```bash
ruff lint
ruff format
```
You can also add them as "External Tools" in PyCharm to be able to run them from the `Tools -> External Tools` menu
(or assign them shortcuts from the action search menu)

## License

ksa_compliance

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README