sunat-peru

n8n node for SUNAT Peru integration - Electronic invoicing, RUC/DNI validation, exchange rate, UIT

Package Information

Released: 8 mo ago
Downloads: 2 weeklyΒ /Β 31 monthly
Latest Version: 2.0.0
Author: Manuel Reyes Bravo

Documentation

n8n-nodes-sunat-peru πŸ‡΅πŸ‡ͺ

Peru Electronic Invoicing for n8n - RUC/DNI validation, exchange rate, UIT.

SUNAT Peru
n8n
License

✨ 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

  1. Settings β†’ Community Nodes
  2. Search n8n-nodes-sunat-peru
  3. 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
  1. Create an account with one of the providers
  2. Get your API Key
  3. 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

Efact

πŸ’‘ 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 πŸš€

Discussion