n8n-nodes-aeat-spain

n8n node for AEAT Spain (State Tax Administration Agency) integration.

🚀 Features

NIF/CIF/NIE (Tax Identification)

• ✅ Validate NIF - Spanish individuals
• ✅ Validate CIF - Legal entities
• ✅ Validate NIE - Foreign residents
• ✅ Format - Clean and normalize
• ✅ Detect type - Auto-identify NIF/CIF/NIE

Economic Indicators

• 💶 EUR Exchange Rate - ECB quotation
• 📊 IPREM - Public Income Indicator
• 📊 SMI - Minimum Interprofessional Salary
• 🔄 Convert IPREM ↔ Euros

Electronic Invoice Issuing (requires provider)

• 📄 Standard Invoice
• 📄 Corrective Invoice
• 📄 Simplified Invoice

📦 Installation

In n8n (recommended)

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

Via npm

npm install n8n-nodes-aeat-spain

⚙️ Configuration

Without credentials (local functions)

The following functions do NOT require credentials:

• Validate/format NIF/CIF/NIE
• EUR exchange rate (ECB public API)
• IPREM and SMI
• Conversions

With credentials (invoice issuing)

To issue electronic invoices you need:

• Holded - https://holded.com
• Billin - https://billin.net
• FacturaE - Spanish standard format

📋 Usage Examples

Validate NIF

Resource: NIF/CIF/NIE
Operation: Validate NIF
NIF: 12345678Z

Validate CIF

Resource: NIF/CIF/NIE
Operation: Validate CIF
CIF: B12345678

Get IPREM

Resource: Indicators
Operation: IPREM

📊 Document Types

| Type | Format | Example | |------|--------|---------| | NIF | 8 digits + letter | 12345678Z | | CIF | Letter + 7 digits + control | B12345678 | | NIE | X/Y/Z + 7 digits + letter | X1234567L |

🔗 APIs Used

• ECB - Official exchange rate
• BOE - IPREM and SMI (official values)
• Holded / Billin - Invoice issuing (requires account)

🤝 Contributing

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

📄 License

MIT © Manuel Reyes Bravo