n8n-nodes-zatca-saudi

n8n node for ZATCA Saudi Arabia (Zakat, Tax and Customs Authority) - Fatoora E-Invoicing.

🚀 Features

VAT/CR Number Validation

• ✅ Validate VAT Number - 15 digits (starts with 3, ends with 3)
• ✅ Validate CR Number - Commercial Registration (10 digits)
• ✅ Format/Clean - Remove spaces and dashes

Economic Indicators

• 💵 SAR Exchange Rate - Saudi Riyal vs USD/EUR
• 📊 VAT Rate - Current 15%

E-Invoice Fatoora (requires provider)

• 📄 Standard Invoice - B2B
• 📄 Simplified Invoice - B2C
• 📄 Credit Note
• 📄 Debit Note

📦 Installation

In n8n (recommended)

1. Go to Settings → Community Nodes
2. Click Install
3. Type: n8n-nodes-zatca-saudi
4. Click Install

Via npm

npm install n8n-nodes-zatca-saudi

⚙️ Configuration

Without credentials (local functions)

The following functions do NOT require credentials:

• Validate/format VAT/CR numbers
• SAR exchange rate (public API)
• VAT rate info

With credentials (invoice issuance)

For e-invoicing you need:

• Cleartax - https://cleartax.com/sa
• ZATCA SDK - Direct integration

📋 Usage Examples

Validate VAT Number

Resource: VAT/CR
Operation: Validate VAT
VAT Number: 300000000000003

Get SAR Exchange Rate

Resource: Indicators
Operation: SAR Exchange Rate

📊 Invoice Types (ZATCA)

| Code | Type | Description | |------|------|-------------| | 388 | Standard | B2B Tax Invoice | | 381 | Credit Note | Correction | | 383 | Debit Note | Additional charge | | 389 | Simplified | B2C Invoice |

🔗 APIs Used

• SAMA - Saudi Central Bank rates (public)
• Cleartax - E-invoice issuance (requires account)

🤝 Contributing

Contributions are welcome. Please open an issue or pull request.

📄 License

MIT © Manuel Reyes Bravo