n8n-nodes-aeat-spain

Nodo n8n para integración con AEAT España (Agencia Estatal de Administración Tributaria).

🚀 Funcionalidades

NIF/CIF/NIE (Identificación Fiscal)

• ✅ Validar NIF - Personas físicas españolas
• ✅ Validar CIF - Personas jurídicas
• ✅ Validar NIE - Extranjeros residentes
• ✅ Formatear - Limpia y normaliza
• ✅ Detectar tipo - Identifica NIF/CIF/NIE automáticamente

Indicadores Económicos

• 💶 Tipo de Cambio EUR - Cotización BCE
• 📊 IPREM - Indicador Público de Renta
• 📊 SMI - Salario Mínimo Interprofesional
• 🔄 Convertir IPREM ↔ Euros

Emisión Factura Electrónica (requiere proveedor)

• 📄 Factura Ordinaria
• 📄 Factura Rectificativa
• 📄 Factura Simplificada

📦 Instalación

En n8n (recomendado)

1. Ve a Settings → Community Nodes
2. Clic en Install
3. Escribe: n8n-nodes-aeat-spain
4. Clic en Install

Via npm

npm install n8n-nodes-aeat-spain

⚙️ Configuración

Sin credenciales (funciones locales)

Las siguientes funciones NO requieren credenciales:

• Validar/formatear NIF/CIF/NIE
• Tipo de cambio EUR (API pública BCE)
• IPREM y SMI
• Conversiones

Con credenciales (emisión facturas)

Para emitir facturas electrónicas necesitas:

• Holded - https://holded.com
• Billin - https://billin.net
• FacturaE - Formato estándar español

📋 Ejemplos de Uso

Validar NIF

Recurso: NIF/CIF/NIE
Operación: Validar NIF
NIF: 12345678Z

Validar CIF

Recurso: NIF/CIF/NIE
Operación: Validar CIF
CIF: B12345678

Obtener IPREM

Recurso: Indicadores
Operación: IPREM

📊 Tipos de Documento

| Tipo | Formato | Ejemplo | |------|---------|---------| | NIF | 8 dígitos + letra | 12345678Z | | CIF | Letra + 7 dígitos + control | B12345678 | | NIE | X/Y/Z + 7 dígitos + letra | X1234567L |

🔗 APIs Utilizadas

• BCE - Tipo de cambio oficial
• BOE - IPREM y SMI (valores oficiales)
• Holded / Billin - Emisión facturas (requiere cuenta)

🤝 Contribuir

Las contribuciones son bienvenidas. Por favor abre un issue o pull request.

📄 Licencia

MIT © Manuel Reyes Bravo