n8n-nodes-sefaz-brasil 🇧🇷

Brazil Electronic Invoice for n8n - CPF/CNPJ validation, Dollar, SELIC, IPCA.

✨ Features

• ✅ Issue NFe/NFCe/NFSe to SEFAZ
• ✅ CPF/CNPJ Validation - Verify, format, clean
• ✅ Dollar Rate - PTAX from Central Bank (live data)
• ✅ SELIC Rate - Base interest rate
• ✅ IPCA - Inflation index
• ✅ CDI - Interbank rate
• ✅ Supports NFe.io, Enotas, Tecnospeed

🚀 Installation

n8n Cloud / Desktop

1. Settings → Community Nodes
2. Search n8n-nodes-sefaz-brasil
3. Install

Self-hosted

npm install n8n-nodes-sefaz-brasil

⚙️ Configuration

To issue invoices you need:

| Provider | Free Plan | Link | |----------|-----------|------| | NFe.io | Yes (testing) | nfe.io | | Enotas | Yes (limited) | enotas.com.br | | Tecnospeed | Yes (demo) | tecnospeed.com.br |

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

For local functions (CPF/CNPJ, Indicators):

No credentials needed - works without configuration.

📖 Usage

Validate CPF

// Input: "123.456.789-09"
// Output:
{
  "valid": true,
  "cpf": "12345678909",
  "tipo": "CPF - Individual",
  "message": "Valid CPF"
}

Validate CNPJ

// Input: "11.222.333/0001-81"
// Output:
{
  "valid": true,
  "cnpj": "11222333000181",
  "tipo": "CNPJ - Company (Headquarters)",
  "message": "Valid CNPJ"
}

Get Dollar Rate

// Output:
{
  "indicator": "Dollar PTAX Rate",
  "buy": 4.98,
  "sell": 5.02,
  "date": "2024-01-15",
  "source": "Brazil Central Bank"
}

🔧 Available Operations

🔢 CPF/CNPJ

• Validate CPF
• Validate CNPJ
• Format CPF
• Format CNPJ
• Clean document

💰 Indicators (live data)

• Dollar Rate (PTAX)
• SELIC Rate
• IPCA (Inflation)
• CDI

📄 Issue Invoice

• NFe (Electronic Invoice)
• NFCe (Consumer Invoice)
• NFSe (Services Invoice)

🌐 Supported Providers

NFe.io

• Modern REST API
• Easy integration
• Documentation

Enotas

• Popular in Brazil
• Good support
• Documentation

Tecnospeed

• Complete solution
• Multiple products
• Documentation

💡 Use Cases

• E-commerce: Automatically issue NFe
• Services: Generate NFSe automatically
• Validation: Verify customer CPF/CNPJ in forms
• Accounting: Get live economic indicators
• Finance: Track SELIC and CDI rates

📄 License

MIT License - see LICENSE

👨‍💻 Author

Manu - LatamFlows

Automation for LATAM 🚀