@luizeduos/n8n-nodes-pier

Node n8n para a API da Pier Seguros (geração automática de token OAuth + criação de cotação de seguro auto).


Keywords
n8n-community-node-package, n8n, pier, seguro, cotacao
License
MIT
Install
npm install @luizeduos/n8n-nodes-pier@0.1.1

Documentation

@luizeduos/n8n-nodes-pier

Node community do n8n para a API da Pier Seguros. Gera o token OAuth automaticamente (via credencial) e cria cotações de seguro auto, substituindo os nodes HTTP Request com token/credenciais hardcoded.

O que inclui

  • Credencial Pier API — guarda de forma segura os dados OAuth (client_id, client_secret, CNPJ, senha, scope) + broker_identification e seller_identification. O token é gerado automaticamente (password grant) e renovado em caso de 401.
  • Node Pier — recurso Cotação › operação Criar Cotação (POST /v2/quote). Aceita CPF, CEP, telefone e placa com ou sem máscara (formata automaticamente, pois a API valida valores mascarados).

Escopo: apenas a API da Pier. As etapas de Busca CPF, Busca FIPE/placa e Identifica Gênero continuam como nodes separados no seu workflow e alimentam os campos do node Pier (ex.: fipe_code, model_year).

Logo

O ícone atual (nodes/Pier/pier.svg) é um placeholder. Para usar o logo oficial, substitua esse arquivo (mantendo o nome pier.svg, ou troque para pier.png e ajuste icon: 'file:pier.png' em Pier.node.ts) e rode o build novamente.

Build

cd pier-node
npm install
npm run build

Isso gera a pasta dist/ com os .js e copia o ícone.

Instalação (n8n self-hosted)

  1. No diretório do pacote:
    npm link
  2. Na pasta de extensões custom do n8n (por padrão ~/.n8n/custom, crie se não existir):
    cd ~/.n8n/custom
    npm link @luizeduos/n8n-nodes-pier
    Alternativa: setar a variável de ambiente N8N_CUSTOM_EXTENSIONS apontando para a pasta que contém o pacote.
  3. Reinicie o n8n. O node Pier aparecerá no editor.

Uso

  1. Crie uma credencial Pier API com os dados OAuth do corretor.
  2. Adicione o node Pier, escolha a credencial e preencha os campos da cotação (CPF, nome, gênero, data de nascimento, FIPE, ano, placa, CEP, etc.).
  3. As coberturas têm os padrões da Pier; ajuste no campo Coberturas se necessário.
  4. A resposta da API (201) com os planos é retornada como JSON.

Licença

MIT