n8n-nodes-negativardevedores

Este é um community node para o n8n. Ele permite integrar seus workflows n8n com a API de Negativação da RedeCredAuto (negativardevedores.com.br), automatizando a inclusão, consulta, listagem e exclusão de dívidas negativadas.

⚠️ É necessário ter um contrato ativo com a RedeCredAuto para utilizar este node. O token de autenticação Bearer (produção e homologação) é fornecido pela RedeCredAuto após a contratação. Sem contrato, os endpoints não retornam dados.

Instalação
Operações
Credenciais
Ambientes
Compatibilidade
Uso
Recursos

Instalação

Siga o guia de instalação de community nodes da documentação do n8n.

Via interface do n8n (self-hosted):

1. Vá em Settings > Community Nodes.
2. Clique em Install.
3. Informe n8n-nodes-negativardevedores em npm package name.
4. Aceite os riscos de usar código de terceiros e clique em Install.

Via npm (manual):

npm install n8n-nodes-negativardevedores

Operações

O node expõe dois recursos:

Negativação

Autenticação

Trigger (Webhook)

O pacote também inclui o node RedeCredAuto Trigger, que expõe uma URL de webhook para receber as notificações de mudança de status enviadas pela API.

1. Adicione o node RedeCredAuto Trigger ao workflow.
2. Copie a Production URL exibida no node.
3. Use essa URL no campo webhook_url da operação Inclusão (ou informe-a no cadastro junto à RedeCredAuto).
4. A cada atualização de status, a API faz um POST na URL e o workflow é disparado com o corpo recebido.

Opções do Trigger:

• Filtrar por Situação — dispara o workflow apenas para as situações selecionadas (pendente, processando, processado, inconsistencia, erro, desconhecido). Vazio = todas.
• Token de Verificação — se preenchido, o node só aceita requisições que enviem o mesmo valor no header X-Webhook-Token (ou na query token); caso contrário responde 401.

Credenciais

Para usar o node é preciso configurar a credencial RedeCredAuto API:

1. Pré-requisito: possuir contrato com a RedeCredAuto e ter recebido o token Bearer.
2. No n8n, crie uma credencial do tipo RedeCredAuto API.
3. Preencha:
   • Ambiente — Produção ou Homologação (UAT).
   • Token — o token Bearer fornecido pela RedeCredAuto para o ambiente escolhido.
4. Clique em Test para validar (chama /auth-test; retorna Token válido e o código do cliente).

A autenticação é feita via header Authorization: Bearer <token>.

Ambientes

A credencial define o prefixo da URL automaticamente:

No ambiente de homologação, use combinações fixas de contrato/documento para simular os retornos:

Para a operação de Exclusão em homologação, use id = 1001 para obter o retorno de sucesso.

Compatibilidade

• Requer n8n com n8nNodesApiVersion: 1.
• Testado com n8n >= 1.x.
• Node.js >= 18.10.

Uso

Exemplo — Inclusão de dívida

1. Adicione o node RedeCredAuto.
2. Recurso: Negativação · Operação: Inclusão.
3. Preencha os campos obrigatórios: Data de Vencimento, Data de Término, Valor, Contrato, Natureza, Nome e Documento do devedor.
4. (Opcional) Expanda Endereço, Dados Bancários e Campos Adicionais (email, celular, área informante, webhook URL).
5. Execute. A resposta inclui status, mensagem e id_protocolo.

Natureza "DC" (Desconto de Cheques): os Dados Bancários passam a ser obrigatórios. O node valida isso e retorna erro antes de chamar a API.

Exemplo — Consulta por protocolo

• Recurso Negativação · Operação Consulta · informe o Protocolo.
• Retorna a operação, situação (pendente, processado, inconsistencia, processando, desconhecido), inconsistências e logs.

Códigos de status retornados pela API

Use a opção Continue On Fail do node para tratar respostas de erro dentro do próprio workflow.

Recursos

• Documentação de community nodes do n8n
• API RedeCredAuto
• Suporte: suporte@redecredauto.com.br

Licença

MIT