> For the complete documentation index, see [llms.txt](https://help.hyperflow.global/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.hyperflow.global/docs/builder-hyperflow/gerenciamento-de-aplicativos/fluxos/integracao/requisicao-soap.md).

# Requisição SOAP

O módulo **Requisição SOAP** permite chamar um serviço web que usa o padrão **SOAP**, um formato de integração comum em sistemas corporativos e legados. É útil para integrar com sistemas externos que expõem esse tipo de serviço, em vez de um serviço REST tradicional.

{% hint style="info" %}
Para chamar um serviço REST tradicional, use o módulo **Requisição HTTP**. Para um serviço GraphQL, use o módulo **Requisição GraphQL**.
{% endhint %}

{% hint style="warning" %}
Na tela do Hyperflow Integrações, este módulo pode aparecer com o nome em inglês, **"Request SOAP"**, em vez de traduzido — isso é o mesmo módulo descrito nesta página.
{% endhint %}

<figure><img src="https://3829578295-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRWteFkm020DS5IbXoSgj%2Fuploads%2F1qPR0OzRuD2oijN4Ujiu%2F01-visao-geral-canvas.png?alt=media&amp;token=ccf42b9e-5f39-4fd7-b020-7d98fc9d6e26" alt=""><figcaption><p>Imagem 1 - Visão geral do módulo Requisição SOAP na área de trabalho do fluxo no Hyperflow Integrações.</p></figcaption></figure>

***

### 🧭 Como acessar

1. No menu lateral, clique em **Gerenciamento de aplicativos**.
2. Em seguida, clique em **Fluxos**.
3. Abra ou crie um fluxo e acesse a área de trabalho do fluxo.
4. No painel de módulos, localize a categoria **Integração** (identificada pela cor azul).
5. Arraste o módulo **Request SOAP** para a área de trabalho do fluxo.

<figure><img src="https://3829578295-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRWteFkm020DS5IbXoSgj%2Fuploads%2Fz80dTf8sd6i95nXfNY9j%2F02-lista-modulo-soap.png?alt=media&amp;token=3f5b33f9-ce6c-433e-a655-4f6e059c6e5e" alt=""><figcaption><p>Imagem 2 - Painel de módulos com a categoria Integração expandida e o módulo Requisição SOAP visível.</p></figcaption></figure>

***

### 🔍 Conhecendo o módulo

Ao clicar duas vezes no módulo na área de trabalho do fluxo, um painel de configuração é aberto na lateral da tela.

<figure><img src="https://3829578295-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRWteFkm020DS5IbXoSgj%2Fuploads%2FiM3DyaTMuoz5SkM6aTOb%2F03-painel-aberto.png?alt=media&amp;token=86d31d1d-268a-4d98-b43e-bbc253579d3c" alt=""><figcaption><p>Imagem 3 - Painel de configuração do módulo Requisição SOAP aberto.</p></figcaption></figure>

***

#### 🔗 WSDL e Método

| Campo      | O que preencher                                                      |
| ---------- | -------------------------------------------------------------------- |
| **WSDL**   | Endereço do arquivo WSDL do serviço SOAP (aceita variáveis do fluxo) |
| **Método** | Nome do método/operação a ser chamado, conforme definido no WSDL     |

<figure><img src="https://3829578295-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRWteFkm020DS5IbXoSgj%2Fuploads%2FsumqcxyZvslwtpK8Emig%2F05-metodo-preenchido.png?alt=media&amp;token=6e2daec3-e92c-4bb5-8713-b7d0e3cb42c4" alt=""><figcaption><p>Imagem 4 - Campos WSDL e Método preenchidos.</p></figcaption></figure>

***

#### 🔐 Autenticação

Se o serviço exigir autenticação, ative uma das opções (elas são mutuamente exclusivas):

* **WS Security** — autenticação no padrão WS-Security, com **Usuário** e **Senha**.
* **Autenticação básica** — login simples com usuário e senha, com os campos **Usuário** e **Senha**.

{% hint style="warning" %}
Sempre preencha o **Usuário** e a **Senha** de verdade ao ativar uma dessas opções. Deixar os campos com o valor padrão da tela faz o módulo tentar se autenticar com credenciais inválidas, sem nenhum aviso no momento de salvar.
{% endhint %}

<figure><img src="https://3829578295-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRWteFkm020DS5IbXoSgj%2Fuploads%2FyFXYaJrpg06RTdMoZZ2p%2F05b-ws-security.png?alt=media&amp;token=f086090e-1f34-4170-857b-d2c2e53f450b" alt=""><figcaption><p>Imagem 5 - Seção de autenticação com WS Security ativado e campos preenchidos.</p></figcaption></figure>

***

#### 📋 Opções do WSDL e Cabeçalhos

* **Opções do WSDL** — configurações avançadas (formato JSON) usadas ao carregar o WSDL.
* **Cabeçalhos** — informações adicionais enviadas junto da chamada SOAP, em formato JSON.

<figure><img src="https://3829578295-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRWteFkm020DS5IbXoSgj%2Fuploads%2FNt18Ngpcv3DVbEMkKuOu%2F06-opcoes-cabecalhos.png?alt=media&amp;token=5222a8e2-5bce-4d08-aedd-47002377a435" alt=""><figcaption><p>Imagem 6 - Campos Opções do WSDL e Cabeçalhos preenchidos.</p></figcaption></figure>

***

#### 📝 Body

Escreva, em formato JSON, os dados a serem enviados ao método SOAP — o módulo converte automaticamente para o formato XML esperado.

Se preferir montar o XML manualmente, ative **Enviar XML sem converter** e escreva o XML completo diretamente.

<figure><img src="https://3829578295-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRWteFkm020DS5IbXoSgj%2Fuploads%2FjIihfqC6JbrwQGnNsl0O%2F07-corpo-exemplo.png?alt=media&amp;token=f0ffe008-25ce-4fa3-b9ec-db133dcd9126" alt=""><figcaption><p>Imagem 7 - Campo Body preenchido, com a opção Enviar XML sem converter visível.</p></figcaption></figure>

***

#### 🔀 Saídas do módulo

O módulo tem duas saídas:

* **Sucesso** — a chamada foi concluída, com o resultado disponível na variável `response` para os próximos módulos do fluxo.
* **Erro** — não foi possível concluir a chamada (por exemplo, WSDL inválido, método não encontrado, falha de conexão, ou um erro retornado pelo próprio serviço SOAP).

<figure><img src="https://3829578295-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRWteFkm020DS5IbXoSgj%2Fuploads%2FoA17ViDf39nL5MrvCXn8%2F08-saidas-conectadas.png?alt=media&amp;token=823fda9d-2166-4e3a-a676-d521ac99c326" alt=""><figcaption><p>Imagem 8 - Módulo na área de trabalho do fluxo mostrando as saídas Sucesso e Erro.</p></figcaption></figure>

***

### 💡 Caso de uso

**Cenário:** uma empresa precisa consultar dados de um sistema legado que expõe um serviço SOAP para verificar o status de um contrato.

**Configuração:**

1. Adicione o módulo **Requisição SOAP** ao fluxo.
2. No campo **WSDL**, informe o endereço do serviço.
3. No campo **Método**, informe o nome da operação de consulta.
4. No campo **Body**, monte o JSON com os dados exigidos pela operação, usando variáveis do fluxo.
5. Conecte a saída **Sucesso** a um módulo que use o resultado (`response`) na conversa.

**Resultado:** o fluxo consulta automaticamente o sistema legado e usa a resposta na conversa com o cliente.

***

### 📌 Dicas úteis

* Consulte a documentação do WSDL do serviço para saber o nome exato do método e os dados exigidos por ele.
* Sempre conecte a saída **Erro** a algum tratamento, já que chamadas a serviços SOAP podem falhar por diversos motivos.
* Ao ativar autenticação, sempre confira se o usuário e a senha foram realmente preenchidos com valores válidos.
* Use **Enviar XML sem converter** apenas se precisar de um controle total sobre o formato exato do envelope XML enviado.

***

### 📝 Resumo

* O módulo **Requisição SOAP** chama um serviço web no padrão SOAP, enviando e recebendo dados no fluxo.
* Os campos principais são **WSDL**, **Método**, **Cabeçalhos** e **Body**.
* Suporta autenticação via **WS Security** ou **Autenticação básica**.
* A saída **Sucesso** disponibiliza o resultado na variável `response`; a saída **Erro** cobre falhas de conexão, WSDL, método ou erros retornados pelo próprio serviço.