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.

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.

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

🧭 Como acessar

No menu lateral, clique em Gerenciamento de aplicativos.
Em seguida, clique em Fluxos.
Abra ou crie um fluxo e acesse a área de trabalho do fluxo.
No painel de módulos, localize a categoria Integração (identificada pela cor azul).
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.

No modo JSON → XML, preencha sempre o campo com um JSON válido. Um JSON mal formatado pode impedir a publicação do fluxo.

📷 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:

Após receber a resposta em XML de um módulo de integração, adicione o módulo XML para JSON.
Selecione o método XML → JSON.
No campo XML, use a variável com o conteúdo recebido.
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.