JSPM

n8n-nodes-asaas-pagamentos-gc

1.0.2
  • ESM via JSPM
  • ES Module Entrypoint
  • Export Map
  • Keywords
  • License
  • Repository URL
  • TypeScript Types
  • README
  • Created
  • Published
  • Downloads 21
  • Score
    100M100P100Q63392F
  • License MIT

Nó customizado do N8N para integração com a API do Asaas - plataforma de pagamentos brasileira

Package Exports

  • n8n-nodes-asaas-pagamentos-gc
  • n8n-nodes-asaas-pagamentos-gc/index.js

This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (n8n-nodes-asaas-pagamentos-gc) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.

Readme

n8n-nodes-asaas

npm npm GitHub

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": "joao@exemplo.com",
          "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

🤝 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

🏷️ Tags

n8n asaas pagamentos pix boleto cartao brasil cobrancas api webhook automation

Desenvolvido com ❤️ pela Comunidade N8N Brasil