@devanthonymax/n8n-nodes-bankerizy

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 @devanthonymax/n8n-nodes-bankerizy

🔧 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 Anthony Max para simplificar a integração com a Bankerize em workflows n8n.