n8n-nodes-asaas

Nó customizado do N8N para integração com a API do Asaas, a principal plataforma brasileira de pagamentos que oferece soluções completas para cobranças via PIX, boleto bancário, cartão de crédito e outras formas de pagamento.

🚀 Instalação

Via npm (Recomendado)

npm install n8n-nodes-asaas

Via n8n Community Nodes

1. Acesse seu N8N
2. Vá em Settings → Community Nodes
3. Clique em Install a community node
4. Digite: n8n-nodes-asaas
5. Clique em Install

📋 Pré-requisitos

• N8N versão 0.190.0 ou superior
• Node.js 20.15 ou superior
• Conta ativa no Asaas com API Key

⚙️ Configuração

1. Obter API Key do Asaas

1. Acesse sua conta no Asaas
2. Vá em Configurações → Integrações → API Key
3. Gere uma nova chave de API
4. Copie a chave gerada

2. Configurar Credenciais no N8N

1. No N8N, vá em Credentials → Add Credential
2. Procure por "Asaas API"
3. Preencha os campos:
   • API Key: Cole sua chave de API do Asaas
   • Ambiente: Escolha "Sandbox" para testes ou "Produção" para uso real
4. Teste a conexão e salve

🎯 Funcionalidades

🏢 Gestão de Clientes

• Criar Cliente: Cadastrar novos clientes com dados pessoais e de endereço
• Obter Cliente: Buscar informações de um cliente específico
• Listar Clientes: Listar todos os clientes com filtros opcionais
• Atualizar Cliente: Modificar dados de clientes existentes
• Excluir Cliente: Remover clientes do sistema

💰 Gestão de Cobranças

• Criar Cobrança: Gerar cobranças com diferentes formas de pagamento
• Obter Cobrança: Consultar detalhes de uma cobrança específica
• Listar Cobranças: Listar todas as cobranças com filtros por cliente e status
• Atualizar Cobrança: Modificar cobranças existentes
• Excluir Cobrança: Cancelar cobranças

💳 Formas de Pagamento Suportadas

• PIX: Pagamento instantâneo brasileiro
• Boleto Bancário: Boleto tradicional com código de barras
• Cartão de Crédito: Pagamento com cartão (tokenização segura)
• Transferência Bancária/TED: Transferência entre contas
• Depósito em Conta: Depósito direto na conta
• Indefinido: Cliente escolhe a forma de pagamento

📖 Exemplos de Uso

Exemplo 1: Criar Cliente e Cobrança PIX

{
  "workflow": {
    "nodes": [
      {
        "name": "Criar Cliente",
        "type": "n8n-nodes-asaas.asaas",
        "parameters": {
          "resource": "customer",
          "operation": "create",
          "name": "João Silva",
          "cpfCnpj": "12345678901",
          "email": "[email protected]",
          "mobilePhone": "11999999999"
        }
      },
      {
        "name": "Criar Cobrança PIX",
        "type": "n8n-nodes-asaas.asaas",
        "parameters": {
          "resource": "payment",
          "operation": "create",
          "customer": "{{ $node['Criar Cliente'].json.id }}",
          "billingType": "PIX",
          "value": 100.50,
          "dueDate": "2024-12-31",
          "description": "Pagamento de serviços"
        }
      }
    ]
  }
}

Exemplo 2: Listar Cobranças Pendentes

{
  "workflow": {
    "nodes": [
      {
        "name": "Listar Cobranças Pendentes",
        "type": "n8n-nodes-asaas.asaas",
        "parameters": {
          "resource": "payment",
          "operation": "getAll",
          "limit": 50,
          "statusFilter": "PENDING"
        }
      }
    ]
  }
}

🔧 Desenvolvimento

Clonar e Instalar

git clone https://github.com/georgevan80/n8n-nos-asaas.git
cd n8n-nos-asaas
npm install

Compilar

npm run build

Desenvolvimento com Watch

npm run dev

Linting e Formatação

npm run lint
npm run format

🌐 Ambientes

Sandbox (Testes)

• URL Base: https://sandbox.asaas.com/api/v3
• Documentação: Sandbox Asaas

Produção

• URL Base: https://www.asaas.com/api/v3
• Documentação: API Asaas

📚 Documentação

• Documentação Oficial do Asaas
• N8N Community Nodes
• Criar Nós Customizados

🤝 Contribuição

Contribuições são bem-vindas! Por favor:

1. Faça um fork do projeto
2. Crie uma branch para sua feature (git checkout -b feature/AmazingFeature)
3. Commit suas mudanças (git commit -m 'Add some AmazingFeature')
4. Push para a branch (git push origin feature/AmazingFeature)
5. Abra um Pull Request

Para mais detalhes, consulte o repositório no GitHub.

📄 Licença

Este projeto está licenciado sob a Licença MIT - veja o arquivo LICENSE.md para detalhes.

🆘 Suporte

• Issues: GitHub Issues
• Discussões: GitHub Discussions
• Email: [email protected]

🏷️ Tags

n8n asaas pagamentos pix boleto cartao brasil cobrancas api webhook automation

Desenvolvido com ❤️ pela Comunidade N8N Brasil