suhai

Node n8n para a API SOAP da Suhai Seguradora (consulta FIPE + cotação de seguro auto/moto). Fork de @luizeduos/n8n-nodes-suhai com utilizacaoDut/tipoUtilizacao fixos em 1.

Package Information

Released: 3 mo ago
Downloads: 400 weekly / 400 monthly
Latest Version: 0.3.1
Author: bortoliniangelo

Available Nodes

Suhai icon
Suhai
Integração com a API SOAP da Suhai Seguradora

Documentation

@bortoliniangelo/n8n-nodes-suhai (node-suhai-n8n)

Node community do n8n para a API SOAP da Suhai Seguradora.

Fork de @luizeduos/n8n-nodes-suhai v0.2.0 com uma alteração:

<utilizacaoDut> e <tipoUtilizacao> são enviados sempre com o valor fixo 1 (antes eram calculados a partir dos campos de texto "Guarda no Trabalho" / "Guarda na Faculdade/Colégio", podendo resultar em 3).

Em uma única operação, consulta o veículo pela tabela FIPE e gera a cotação de seguro auto/moto.

O que inclui

  • Credencial Suhai API — guarda de forma segura login e senha e centraliza a configuração de negócio (tabela de comissão, código de cobertura, desconto, valores de danos, classe de bônus) e as URLs dos serviços SOAP.
  • Node Suhai — recurso Cotação › operação Realizar Cotação (tudo-em-um):
    1. ConsultaVeiculos (SOAP) a partir do código FIPE + categoria → obtém marca, modelo e código FIPE.
    2. IncluirCotacaoSuhai (SOAP) com todos os dados → gera a cotação.
  • O node recebe respostas em texto livre (sexo, estado civil, garagem/uso) e converte automaticamente para os códigos numéricos esperados pela Suhai.

Instalação

n8n self-hosted (Community Nodes)

Settings → Community Nodes → Install e informe:

@bortoliniangelo/n8n-nodes-suhai

Teste local (pasta custom)

npm install
npm run build      # tsc + cópia dos ícones (gera dist/)
npm pack           # gera o .tgz na raiz do projeto
# na pasta de custom nodes do n8n (ex.: ~/.n8n/custom):
npm install /caminho/para/bortoliniangelo-n8n-nodes-suhai-x.y.z.tgz

Reinicie o n8n após instalar.

Configuração da credencial

Crie uma credencial Suhai API. Campos:

Campo Obrigatório Padrão Descrição
Login sim — Login do corretor na Suhai (ex.: 15246638839)
Senha sim — Senha do corretor
URL ConsultaVeiculos (FIPE) sim https://suhaiseguradoracotacao.com.br:5156/veiculosfipe.svc?wsdl Endpoint SOAP de consulta FIPE
URL IncluirCotacaoSuhai sim https://suhaiseguradoracotacao.com.br:5156/MultiCalculos.svc Endpoint SOAP da cotação
Tabela De Comissão não tab 36 Tabela de comissão
Código De Cobertura (cdCobertura) não 10091 Código da cobertura
Valor De Desconto (%) não 6 Desconto aplicado
Valor Danos Materiais não 100000.00 Cobertura de danos materiais
Valor Danos Corporais não 100000.00 Cobertura de danos corporais
Valor Danos Morais não 10000.00 Cobertura de danos morais
Classe De Bônus não 0 Classe de bônus do segurado

A credencial não tem botão Test — uma chamada de teste exigiria uma cotação real. Valide executando o node com dados de exemplo.

Uso do node

  1. Adicione o node Suhai e selecione a credencial Suhai API.
  2. Preencha os campos da cotação:
Campo Exemplo Observação
Código FIPE 004445-0 Código FIPE do veículo
Categoria do Veículo Carro Carro / Moto / Caminhão / Van
Ano do Modelo 2020
Ano de Fabricação 2019
Veículo Zero Km false
CPF/CNPJ 12345678900
Nome João da Silva
Data de Nascimento 09051989 Formato DDMMAAAA (só dígitos)
CEP 01001000 Completado com zeros à esquerda se vier com menos de 8 dígitos
Sexo Masculino Masculino / Feminino / Pessoa Jurídica
Estado Civil Solteiro(a) Solteiro(a) / Casado(a) / Divorciado(a)
Garagem na Residência texto livre Mapeado para pergunta1
Guarda no Trabalho texto livre Mapeado para pergunta2
Guarda na Faculdade/Colégio texto livre Mapeado para pergunta3
Guarda Quando Não Em Serviço Sim/Não Mapeado para pergunta4 (usado em caminhão/van)
Possui Outro Veículo 1
  1. Execute. O node faz as duas chamadas SOAP em sequência e retorna o resultado.

Saída (resposta)

O node retorna 100% do XML cru devolvido pela Suhai nas duas chamadas, sem nenhum parse de saída — nada é descartado.

{
  "consultaVeiculosXml": "<s:Envelope ...>...</s:Envelope>",
  "cotacaoXml": "<s:Envelope ...>...IncluirCotacaoSuhaiResult...</s:Envelope>"
}

Como a saída é string XML (e não JSON estruturado), para extrair campos específicos use o node XML do n8n ou uma expressão logo após o node Suhai.

Licença

MIT

Discussion