@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 | |

3. 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