n8n-nodes-sunat-peru
v2.0.0
Published
n8n node for SUNAT Peru integration - Electronic invoicing, RUC/DNI validation, exchange rate, UIT
Maintainers
Readme
n8n-nodes-sunat-peru 🇵🇪
Peru Electronic Invoicing for n8n - RUC/DNI validation, exchange rate, UIT.
✨ Features
- ✅ Issue Invoices to SUNAT (Invoice, Sales Receipt, Credit Note)
- ✅ RUC/DNI Validation - Verify, format, query SUNAT
- ✅ Exchange Rate - Dollar buy/sell from SBS (live data)
- ✅ UIT Value - Tax Unit
- ✅ UIT ↔ Soles Conversion automatic
- ✅ Supports Nubefact and Efact
🚀 Installation
n8n Cloud / Desktop
- Settings → Community Nodes
- Search
n8n-nodes-sunat-peru - Install
Self-hosted
npm install n8n-nodes-sunat-peru⚙️ Configuration
To issue invoices you need:
| Provider | Free Plan | Link | |----------|-----------|------| | Nubefact | Yes (demo) | nubefact.com | | Efact | Yes (testing) | efact.pe |
- Create an account with one of the providers
- Get your API Key
- Configure credentials in n8n
For local functions (RUC, Indicators):
No credentials needed - works without configuration.
📖 Usage
Validate RUC
// Input: "20123456789"
// Output:
{
"valid": true,
"ruc": "20123456789",
"tipo": "Company",
"message": "Valid RUC"
}Get Exchange Rate
// Output:
{
"indicator": "Exchange Rate",
"buy": 3.73,
"sell": 3.77,
"date": "2024-01-15",
"source": "SUNAT/SBS"
}Get UIT Value
// Output:
{
"indicator": "UIT",
"value": 5350,
"year": 2025,
"source": "SUNAT"
}🔧 Available Operations
🔢 RUC/DNI
- Validate RUC
- Validate DNI
- Format RUC
- Query RUC (from SUNAT)
💰 Indicators (live data)
- Exchange Rate (Dollar)
- UIT Value
- Convert UIT to Soles
- Convert Soles to UIT
📄 Issue Invoice
- Invoice (Type 01)
- Sales Receipt (Type 03)
- Credit Note (Type 07)
🌐 Supported Providers
Nubefact
- Popular in Peru
- Easy to use API
- Documentation
Efact
- Low cost plans
- Full SUNAT compliance
- Documentation
💡 Use Cases
- E-commerce: Automatically issue invoices
- SaaS: Generate automatic monthly invoices
- Validation: Verify customer RUC in forms
- Accounting: Get live exchange rates
- Tax: Calculate UIT amounts
📄 License
MIT License - see LICENSE
👨💻 Author
Manu - LatamFlows
Automation for LATAM 🚀
