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:

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:
     • Sandbox (Desenvolvimento): https://develop.api.bankerize.com.br
     • Produção: https://api.bankerize.com.br
   • 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 (com opções de ordenação)
• Simulate by Installments - Simular manipulando parcelas específicas
• Create Proposal - Criar proposta FGTS
• Get Proposal - Consultar proposta FGTS

🔥 Novas Funcionalidades:

Ordenação de Simulações:

• Maior Valor Líquido: Ordena pelo net_value (maior → menor)
• Maior TC: Ordena pelo tc_percentage (maior → menor)
• Menor Juros Bruto: Ordena pelo monthly_fee (menor → maior)
• Menor CET Anual: Ordena pelo annual_cet (menor → maior)

Filtro de Erros:

• Restringir Tabelas com Erro: Remove simulações com error: true
• Exibe apenas propostas válidas e utilizáveis
• Útil para workflows automatizados e LLMs

Formatação Brasileira:

• Datas: Formata para DD/MM/AAAA (ex: 2025-09-01 → 01/09/2025)
• Números: Formata para duas casas decimais (ex: 1234.567890 → 1234.57)
• Aplicação Automática: Formatação inteligente em todos os campos relevantes
• Compatível: Funciona com todas as operações (Simulate, Get Proposal, etc.)

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
• Request Query Authorization - Solicitar autorização de consulta

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
• Busca endereço pelo CEP - Consultar endereço completo via API ViaCEP

✨ 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 → 4. Buscar Endereços por CEP

📚 Documentação Adicional

• Ambientes da API: Guia completo sobre seleção de ambiente (Sandbox vs Produção)
• Endpoints da API: Documentação técnica completa dos endpoints
• Como Criar Node: Guia de desenvolvimento para novos nodes

📄 Licença

MIT License

---

Desenvolvido por Roberto Goes para simplificar a integração com a Bankerize em workflows n8n.