n8n-nodes-dian-colombia 🇨🇴

Colombia Electronic Invoicing for n8n - NIT validation, TRM, UVT.

✨ Features

• ✅ Issue Invoices to DIAN (Sales Invoice, Credit/Debit Notes)
• ✅ NIT Validation - Verify, format, calculate check digit
• ✅ TRM - Representative Market Rate (live data)
• ✅ UVT Value - Tax Value Unit
• ✅ UVT ↔ Pesos Conversion automatic
• ✅ Supports Alegra and Siigo

🚀 Installation

n8n Cloud / Desktop

1. Settings → Community Nodes
2. Search n8n-nodes-dian-colombia
3. Install

Self-hosted

npm install n8n-nodes-dian-colombia

⚙️ Configuration

To issue invoices you need:

| Provider | Free Plan | Link | |----------|-----------|------| | Alegra | Yes (limited) | alegra.com | | Siigo | Yes (trial) | siigo.com |

1. Create an account with one of the providers
2. Get your API Key
3. Configure credentials in n8n

For local functions (NIT, Indicators):

No credentials needed - works without configuration.

📖 Usage

Validate NIT

// Input: "900.123.456-7"
// Output:
{
  "valid": true,
  "nit": "9001234567",
  "tipo": "Company",
  "message": "Valid NIT",
  "digitoVerificacion": 7
}

Get TRM

// Output:
{
  "indicator": "TRM",
  "value": 4200,
  "date": "2024-01-15",
  "source": "Banco de la República"
}

Get UVT Value

// Output:
{
  "indicator": "UVT",
  "value": 49799,
  "year": 2025,
  "source": "DIAN"
}

🔧 Available Operations

🔢 NIT

• Validate
• Format (XXX.XXX.XXX-X)
• Clean
• Calculate Check Digit

💰 Indicators (live data)

• TRM Dollar
• UVT Value
• Convert UVT to Pesos
• Convert Pesos to UVT

📄 Issue Invoice

• Sales Invoice (FV)
• Credit Note (NC)
• Debit Note (ND)

🌐 Supported Providers

Alegra

• Modern REST API
• Multi-country support
• Documentation

Siigo

• Popular in Colombia
• Complete ERP features
• Documentation

💡 Use Cases

• E-commerce: Automatically issue invoices
• SaaS: Generate automatic monthly invoices
• Validation: Verify customer NIT in forms
• Accounting: Get live TRM rates
• Tax Calculation: Convert UVT amounts

📄 License

MIT License - see LICENSE

👨‍💻 Author

Manu - LatamFlows

Automation for LATAM 🚀