> 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/xml-para-json.md).

# XML para JSON

O módulo **XML para JSON** converte um conteúdo entre os formatos **XML** e **JSON**, nos dois sentidos. É útil para integrar com sistemas que trabalham em um formato diferente do usado no restante do seu fluxo.

{% hint style="info" %}
Este módulo é diferente do módulo **XML** (categoria Resposta), que monta uma resposta HTTP em formato XML. Aqui o objetivo é converter um conteúdo já existente entre os dois formatos.
{% endhint %}

**📷 Inserir print:** visão geral do módulo XML para JSON na área de trabalho do fluxo

***

## 🧭 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 **XML para JSON** para a área de trabalho do fluxo.

**📷 Inserir print:** painel de módulos com a categoria Integração expandida e o módulo XML para JSON visível

***

## 🔍 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.

**📷 Inserir print:** painel de configuração do módulo XML para JSON aberto

***

### 🧩 Método

Escolha a direção da conversão:

* **XML → JSON** — converte um conteúdo XML em JSON.
* **JSON → XML** — converte um conteúdo JSON em XML.

**📷 Inserir print:** campo Método com as duas direções disponíveis

***

### 📝 Conteúdo

Dependendo da direção escolhida, preencha o campo correspondente (**XML** ou **JSON**) com o conteúdo a ser convertido. Você pode usar variáveis do fluxo.

{% hint style="warning" %}
No modo **JSON → XML**, preencha sempre o campo com um JSON válido. Um JSON mal formatado pode impedir a publicação do fluxo.
{% endhint %}

**📷 Inserir print:** campo de conteúdo preenchido conforme a direção escolhida

***

### 🔀 Saídas do módulo

O módulo tem duas saídas:

* **Sucesso** — a conversão foi concluída, com o resultado disponível para os próximos módulos do fluxo.
* **Erro** — o conteúdo informado não pôde ser convertido (por exemplo, XML ou JSON mal formatado).

**📷 Inserir print:** módulo na área de trabalho do fluxo mostrando as saídas Sucesso e Erro

***

## 💡 Caso de uso

**Cenário:** um sistema externo retorna dados em XML, mas o restante do fluxo trabalha melhor com JSON.

**Configuração:**

1. Após receber a resposta em XML de um módulo de integração, adicione o módulo **XML para JSON**.
2. Selecione o método **XML → JSON**.
3. No campo **XML**, use a variável com o conteúdo recebido.
4. Conecte a saída **Sucesso** para usar o resultado já em JSON no restante do fluxo.

**Resultado:** o fluxo consegue trabalhar com os dados no formato mais conveniente, sem depender do formato original do sistema externo.

***

## 📌 Dicas úteis

* Ao converter de XML para JSON, atributos das tags XML (como `<produto id="123">`) não são incluídos no resultado — apenas o conteúdo e a estrutura das tags são convertidos.
* Valores numéricos e de verdadeiro/falso escritos como texto dentro do XML são convertidos automaticamente para número ou booleano no JSON resultante.
* Sempre conecte a saída **Erro** a algum tratamento, já que conteúdos mal formatados podem falhar na conversão.
* No modo **JSON → XML**, valide o JSON antes de publicar o fluxo, para evitar problemas de publicação.

***

## 📝 Resumo

* O módulo **XML para JSON** converte conteúdo entre os formatos XML e JSON, nas duas direções.
* O campo de conteúdo muda conforme a direção escolhida no campo **Método**.
* Atributos XML são descartados na conversão para JSON; valores numéricos e booleanos são convertidos automaticamente.
* O módulo tem uma saída de **Sucesso** e uma de **Erro**.