@corlabs-holding/n8n-nodes-bankerize/README.md

N8n community nodes para integração completa com API Bankerize - 4 nodes especializados: FGTS, E-Consignado, Gerenciamento de Propostas e Administração

# N8n Nodes - Bankerize (Suite Completa)

Este pacote contém **4 nodes especializados** para integração completa com a API da Bankerize, cobrindo todas as operações financeiras disponíveis.

## 📦 Instalação

No seu ambiente n8n, instale via `npm` ou `pnpm`:

```bash
npm install @corlabs-holding/n8n-nodes-bankerize
```

## 🔧 Configuração de Credenciais

1. No painel do n8n, vá para **Credentials** e clique em **Add credential**.
2. Procure por **"Bankerize API"** e selecione.
3. Preencha os seguintes campos:
   - **Ambiente**: `Desenvolvimento` ou `Produção`.
   - **Client ID**: Sua chave de cliente fornecida pela Bankerize.
   - **Client Secret**: Sua chave secreta fornecida pela Bankerize.

## 🎯 Nodes Disponíveis

### 1. 🏦 Bankerize - FGTS

Especializado em operações de antecipação do Saque-Aniversário FGTS.

**Operações:**
- **Simulate** - Simular proposta FGTS básica
- **Simulate by Installments** - Simular manipulando parcelas específicas
- **Create Proposal** - Criar proposta FGTS
- **Get Proposal** - Consultar proposta FGTS

### 2. 💰 Bankerize - E-Consignado

Especializado em operações de consignado privado.

**Operações:**
- **Get Employment Relationships** - Buscar vínculos empregatícios
- **Get Employment Details** - Detalhar vínculo específico
- **Simulate** - Simular proposta E-Consignado
- **Create Proposal** - Criar proposta E-Consignado

### 3. 📋 Bankerize - Gerenciamento de Propostas

Gerenciamento completo de propostas existentes.

**Operações:**
- **Cancel Proposal** - Cancelar proposta
- **Get Proposal** - Consultar dados da proposta
- **Send to Disburse** - Enviar para desembolso
- **Renew Signature Link** - Renovar link de assinatura
- **Update Payment Account** - Atualizar dados bancários
- **Get Proposal Details** - Detalhamento completo
- **Update Antifraud Status** - Alterar status do antifraude

### 4. 👥 Bankerize - Admin

Operações administrativas do sistema.

**Operações:**
- **Create User** - Cadastrar novo usuário
- **Create Partner** - Cadastrar parceiro (PF ou PJ)
- **List Profiles** - Listar perfis disponíveis

## ✨ Principais Características

### 🤖 Compatibilidade Total com LLMs
Todos os nodes estão configurados com `usableAsTool: true`, permitindo uso automático por agentes de IA e LLMs dentro do n8n.

### 🛡️ Validações Robustas
- CPF/CNPJ com validação de dígitos
- Email e telefone com formatos corretos
- CEP com 8 dígitos exatos
- Datas no formato ISO (YYYY-MM-DD)
- Valores monetários com limites apropriados

### 🔍 Tratamento Inteligente de Erros
Mensagens específicas para cada tipo de erro HTTP:
- **400**: Dados inválidos com orientações claras
- **401**: Problemas de autenticação
- **404**: Recursos não encontrados
- **409**: Conflitos (duplicatas, status inadequado)
- **422**: Falhas de validação detalhadas
- **500**: Erros do servidor

### 📝 Interface Amigável
- Campos organizados em seções lógicas
- Exemplos JSON pré-preenchidos
- Descrições claras e placeholder informativos
- Campos dinâmicos baseados nas seleções

## 🔄 Fluxo de Trabalho Típico

### FGTS:
1. **Simular** → 2. **Criar Proposta** → 3. **Gerenciar** (via node Propostas)

### E-Consignado:
1. **Buscar Vínculos** → 2. **Detalhar Vínculo** → 3. **Simular** → 4. **Criar Proposta**

### Administração:
1. **Listar Perfis** → 2. **Criar Parceiro** → 3. **Criar Usuário**

## 📄 Licença

MIT License

---

Desenvolvido por [Roberto Goes](https://github.com/robertogoes-codero) para simplificar a integração com a Bankerize em workflows n8n.