Skip to main content
O nó SOAP permite conectar seu fluxo a serviços web SOAP, um protocolo comum em sistemas legados e corporativos. É um nó de execução real: faz a requisição e expõe saídas de sucesso e erro para continuar o fluxo, assim como o nó API.
O nó SOAP compartilha a infraestrutura de credenciais e execução com o nó API — se você já conhece esse nó, essa configuração vai parecer familiar.

​
Configuração básica

  • URL — o endereço do serviço SOAP.
  • Operation Name — o nome da operação SOAP que você quer invocar (texto livre; não é validado contra um WSDL).
Tanto a URL quanto o Operation Name são obrigatórios — o nó é marcado como inválido se algum deles ficar vazio.
O método HTTP é sempre POST.

​
Namespaces

Defina os namespaces do envelope SOAP em uma tabela reordenável (arraste para mudar a ordem): Você pode usar variáveis do workflow ao definir a URI.

​
Headers

Adicione headers personalizados como pares chave-valor.
O header Content-Type é gerenciado automaticamente de acordo com a versão de SOAP escolhida em Settings, e não pode ser editado manualmente.

​
Body

O corpo da requisição é editado em um editor de código livre (JSON ou XML). O nó não constrói visualmente o envelope SOAP — a montagem final do envelope é resolvida pelo motor de execução.

​
Autenticação

Três opções disponíveis:

​
Settings

  • Versão do SOAP — 1.1 ou 1.2. Alterá-la reescreve automaticamente o header Content-Type.
  • Timeout — em milissegundos, padrão de 30000 (30s).
  • Transformação de resposta — extraia apenas a parte da resposta que você precisa definindo um extractPath (por exemplo, GetUserResponse.Data).

​
Salvar a resposta

Ative “Salvar resposta” e defina um nome de variável para armazenar a resposta do serviço SOAP.

​
Acessar a resposta a partir de um nó Código

Você também pode ler a requisição original com $context.getSoapRequest('minhaVariavel'). Ambos os acessores suportam .headers() e .json(); getSoapResponse também inclui .status().

​
Testar a requisição

O botão “Send” executa a requisição e mostra o resultado: código de status, e abas Body e Headers da resposta, com opção de copiar para a área de transferência.

​
Tratamento de erros

O nó expõe duas saídas: sucesso e erro. Conecte a saída de erro à próxima etapa que deve tratar a falha, sem interromper o restante do fluxo.