dian-colombia

n8n node for DIAN Colombia integration - Electronic invoicing, NIT validation, TRM, UVT

Package Information

Released: 9 mo ago
Downloads: 9 weeklyΒ /Β 23 monthly
Latest Version: 0.2.1
Author: Manuel Reyes Bravo

Documentation

n8n-nodes-dian-colombia πŸ‡¨πŸ‡΄

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

DIAN Colombia
n8n
License

✨ 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

Siigo

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

Discussion