n8n-nodes-camposdealer

Community node n8n para o CRM Campos Dealer (https://camposdealer.app).

Recursos

Leitura

• Cliente — listar tags, tags ativas, dados do progress bar.
• Combo / Auxiliar — tipos de negócio, clientes, origens, segmentações, motivos, eventos, campanhas, instituições financeiras, departamentos, estados, grupos econômicos, status navbar, tags, templates de orçamento e notificações.
• Empresa do Grupo — listar.
• Etapa do Funil — listar etapas com contagem de negócios.
• Funil de Vendas — listar funis.
• Negociação — listar paginada, obter, tempo, produtos, máquinas usadas, tags, tooltips, verificar orçamento/pedido, campos customizáveis, listar condição de pagamento.
• Produto — listar marcas, grupos, modelos.
• Vendedor — listar vendedores.
• Ação — listar tipos/subtipos, listar grade de ações, criar ação vinculada ao cliente.

Escrita (confirmação obrigatória)

• Ação → Criar — POST /CRM_Acoes/SalvarAcao (ação vinculada ao cliente; visita, ligação, etc.).
• Cliente → Criar — POST /CRM_Cliente/SalvarClienteCRM (segmentação em CSV, endereço obrigatório).
• Negociação → Criar — POST /CRM_Negocio/SalvarNegocio (produtos, previsão de compra).
• Negociação → Mover Etapa — POST /CRM_FunilVendas/AtualizaStatusNegocio (ex.: 13103 Atendimento/Negociação).
• Negociação → Salvar Condição de Pagamento — POST /CRM_Negocio/CRM_SalvarNegociacaoOrcamento (necessário para avançar a Orçamento Apresentado).
• Negociação → Inativar Condição de Pagamento — POST /CRM_Negocio/CRM_InativarNegociacaoOrcamento.
• Requisição Customizada — qualquer endpoint GET/POST com confirmação para métodos não-GET.

Autenticação

Credencial Campos Dealer API com CNPJ, login, senha e base URL. O nó faz login a cada execução, mantém cookies de sessão e token anti-CSRF apenas em memória e renova o RVT automaticamente após login (necessário para POSTs autenticados).

Saída

Por padrão o nó devolve apenas o conteúdo do campo Objeto do envelope {Mensagem, Objeto, Erro, Codigo, PBV_RetornoValidacao}. Use a opção "Retornar Envelope Completo" para receber a resposta completa.

Instalação (n8n)

npm install n8n-nodes-camposdealer

Pacote publicado: [email protected]

Ferramentas para Agente de IA (v0.3.0+)

O pacote inclui 50 subnodes CD Tool: … (um por recurso/operação), prontos para conectar na porta Tools do nó AI Agent.

Requisitos:

• n8n 1.79.0+
• Variável de ambiente: N8N_COMMUNITY_PACKAGES_ALLOW_TOOL_USAGE=true

O system prompt do agente é configuração local do projeto (docs/agent-prompt-vendedor-campos-dealer.md) — não faz parte do pacote publicado no npm. Cole-o manualmente no nó AI Agent do seu workflow n8n.

Regenerar subnodes após alterar operações:

npm run generate:tools
npm run build

Build local

npm install
npm run build

Para registrar no n8n local, siga a documentação de community nodes do n8n e aponte para a pasta dist/.

Documentação da API

Veja ../docs/writes-confirmed.md para payloads validados ao vivo, regras de Playbook por etapa do funil e mapeamento de "Condição de Pagamento".