Gestor de arquivos XML Fast

“XML é a sigla para eXtensible Markup Language, um tipo de linguagem que define regras para codificar diferentes documentos, ou seja, transforma informações em um padrão de linguagem para integrá-las.”

O Gestor XML Fast é o módulo da Wake Commerce responsável pelo gerenciamento de feeds XML, arquivos estruturados que permitem integrar o catálogo de produtos da loja com comparadores de preços e sistemas de anúncios, como Google Shopping, Pinterest e outros canais de venda.

O novo fluxo do Gestor XML Fast representa uma evolução na gestão dos arquivos XML, com uma experiência focada na operação diária: listagem com filtros avançados, busca por arquivo, controle de status de ativação e fluxos simplificados de cadastro e edição de arquivos.

A funcionalidade é indicada para:

• Lojistas e operadores que gerenciam múltiplos feeds XML para integração com canais de venda (Google Shopping, Pinterest, Meta).

• Equipes de marketing e performance que precisam controlar quais arquivos XML estão ativos, pausados ou com erro.

• Analistas de catálogo que precisam localizar rapidamente um XML específico entre vários cadastrados na loja, habilitando ou desabilitando feeds de forma ágil.

1. Benefícios

• Localização rápida de arquivos: Busca e filtros por status permitem encontrar um XML específico em segundos, mesmo em lojas com muitos feeds cadastrados.

• Controle de status simplificado: Ative ou desative um feed XML diretamente na listagem, sem precisar abrir o arquivo para edição.

• Cadastro e edição mais intuitivos: Fluxo de criação e edição de arquivos XML com campos organizados e validações em tempo real.

• Visibilidade de grupos de produtos: Permite associar um feed a grupos específicos de produtos cadastrados na plataforma.

2. Como funciona

O Gestor XML Fast opera como um gerenciador centralizado de feeds. Cada arquivo XML cadastrado representa um conjunto de produtos e configurações que será exportado para um canal de venda específico. O fluxo de gestão eficiente segue em duas frentes:

Listagem com filtros e busca

A tela principal apresenta todos os arquivos XML cadastrados na loja, com suporte a filtros por status (ativo, inativo) e campo de busca por nome ou identificador do arquivo. A listagem também exibe informações essenciais diretamente na tela, como status de ativação, mídia UTM e o link do arquivo.

Cadastro e edição de XMLs

O fluxo de cadastro e edição permite configurar todos os parâmetros do feed, incluindo o nome, o tipo de informação exportada e os grupos de produtos vinculados. 

3. Como configurar

Confira o passo a passo para ativar o Gestor XML Fast

1.No menu do painel admin acesse o módulo via Extensões e Integrações > Gestor XML Fast.

2.A tela de listagem exibe todos os feeds cadastrados com os campos: Data, Nome, Link, Mídia UTM, Status e Ações.

Na opção “Ações” é possível editar, excluir, copiar link e fazer o download do arquivo XML.

Criando um novo arquivo XML

3.Na tela de listagem, clique no botão "Novo XML”.

4.Preencha as configurações do arquivo, iniciando pelos dados básicos com nome, tipo de informação e status.

5.Em seguida, defina as regras e exibição de valores, sendo elas: 
- Preço com Desconto na Forma de Pagamento: que exibe o preço conforme a forma de pagamento com maior desconto.
- Usar Fator Multiplicador na Precificação: que habilita o cálculo do preço da variante com base em uma medida variável (m², etc.).
Para saber mais detalhes do Fator Multiplicador de Preço, confira o artigo.

6.Configure os parâmetros de rastreamento adicionando as tags de origem, mídia e campanha para facilitar o monitoramento da performance do XML em canais externos.

7.Na seção “Modelo de Estrutura” selecione entre opções de “Modelos Predefinidos” ou “Personalizar Estrutura” para definir quais dados serão estruturados e enviados para o seu feed de produtos.

Modelos Predefinidos

Cada um dos modelos de estrutura contém dados predefinidos para envio das tags com informações de produtos. Ao selecionar uma das opções, é possível visualizar previamente a estrutura de dados que será integrada no quadro à direita, facilitando a conferência do modelo mais adequado. Sendo eles:

• Categoria Google Fixa - Gênero Feminino: A categoria Google possui valor fixo 166 em g:google_product_category · O product_type recebe a hierarquia completa da categoria · Gênero fixo feminino · Faixa etária adulto · Descarta imagens de estampa · Sem GTIN, SKU pai, grupo/subgrupo e estoque por variante · Preço promocional sempre enviado. 

• Autor e GTIN - Faixa Etária do Produto: O product_type recebe o Autor do produto · GTIN, SKU pai e grupo/subgrupo · Categoria Google valor fixo 166 em g:google_category e também a categoria da variante em g:google_product_category · item_group_id enviado sem o namespace g: · Exclui a marca 6200 do feed · Gênero e faixa etária vêm do produto · Mantém imagens de estampa · Preço promocional sempre enviado. 

• Autor e GTIN - Adulto: O product_type recebe o Autor do produto · GTIN, SKU pai e grupo/subgrupo · Categoria Google fixa 166 em g:google_category, mais a categoria da variante em g:google_product_category · item_group_id enviado sem o namespace g: · Exclui a marca 6200 do feed · Faixa etária fixa adulto · Gênero vem do produto · Mantém imagens de estampa · Preço promocional sempre enviado. 

• Autor, GTIN e Estoque por Variante - Adulto: O product_type recebe o Autor do produto · GTIN, SKU pai, grupo/subgrupo e estoque por variante · Categoria Google fixa 166 em g:google_category, mais a hieraquira de categorias da variante em g:google_product_category · Faixa etária fixa adulto · Gênero vem do produto · Mantém imagens de estampa · Preço promocional sempre enviado.

• Autor, GTIN e Estoque por Variante - Faixa Etária do Produto: O product_type recebe o Autor do produto · GTIN, SKU pai, grupo/subgrupo e estoque por variante · Categoria Google fixa 166 em g:google_category, mais a hierarquia de categorias da variante em g:google_product_category · Gênero e faixa etária vêm do produto · Mantém imagens de estampa · Preço promocional sempre enviado.

• Categoria Google Fixa - Gênero do Produto: A Categoria Google fixa 166 em g:google_product_category · product_type recebe a hierarquia completa da categoria · Gênero vem do produto · Faixa etária adulto · Descarta imagens de estampa · Sem GTIN, SKU pai, grupo/subgrupo e estoque por variante · Preço promocional enviado somente quando há desconto real.     

Além disso, você pode selecionar o Modelo Padrão da plataforma, que é o modelo universal para feeds em canais como Google Shopping, por exemplo. Basta acessar a opção “Personalizar estrutura”, selecionar o modelo padrão e concluir a escolha do modelo.

• Google Shopping Modelo Padrão: Emite a estrutura RSS com namespace g: incluindo preço, preço promocional, imagens (principal e adicionais), parcelamento, GTIN, marca, cor, MPN, categorias (Google e hotsite) e grupo de produtos, cobrindo todos os camps namespace g:.

Personalizar Estrutura

Ao optar por personalizar a estrutura, você pode montar a hierarquia de tags, atributos e variáveis do seu feed de acordo com a melhor estratégia de integração do seu negócio com os canais externos.

Para uma operação assertiva e com autonomia, que permita desde o usuário heavy user até o iniciante criar o arquivo, é possível começar do zero e definir cada propriedade manualmente, ou então, alterar o modelo padrão da plataforma, que já possui a estrutura base de envio para canais como Google e Meta, por exemplo, com tags específicas de seu catálogo.

Para isso, selecione “Personalizar Estrutura” e defina se iniciará uma “Nova Estrutura (Em branco)” ou se fará alterações no “Modelo Padrão (Sistema)”.

Nova estrutura

Siga em “Criar Estrutura” para iniciar a personalização manual do arquivo. Informe o nome e descrição do modelo e então, edite as propriedades. 

Use “Objeto” para agrupar tags dentro de outras e “Lista” para repetir um bloco por imagem, variante ou categoria do produto.

Cada tag e valor selecionado nos campos à esquerda, são visualizados em tempo real na prévia gerada à direita, facilitando a validação das informações durante todo o processo. 
 

Observação: os valores entre chaves são substituídos pelas informações dos produtos na geração do arquivo.

Modelo Padrão

Para alterações específicas você pode utilizar o “Modelo Padrão” da plataforma, que é a estrutura universal para integração de feeds com canais como Google Shopping, por exemplo. Dessa forma, sua operação é otimizada e ganha mais agilidade ao utilizar o modelo de mercado com atualizações pontuais. 

Para isso, clique em “Duplicar” e informe o nome e descrição da nova estrutura. Com isso, a cópia é gerada automaticamente para alterações nas tags e atributos. 

Para garantir que as alterações realizadas nas propriedades dos produtos foram aplicadas, você pode conferir a prévia gerada em tempo real e certifique-se de clicar em “Salvar Estrutura”. 

8.Em seguida, escolha o melhor “Método de Seleção” para vincular os produtos ao seu arquivo, sendo elas: Todos os Produtos, Grupo de Produtos ou Lista Rápida.

9.Pronto! Basta salvar o XML e você será redirecionado para a tela de listagem. Após o arquivo ser gerado é exibido o link.
 

Para facilitar a operação, no Histórico é possível visualizar quais alterações foram realizadas no arquivo XML, com data, hora, usuário e tipo de mudança. Já na aba do histórico de sincronização, além das informações básicas, também o status de processamento das sincronizações automáticas e manuais, garantindo visibilidade total e controle sobre quando o arquivo é atualizado. 

4. Casos de uso detalhados

Caso 1: Pausar um feed antes de uma campanha

Uma loja de moda possui cinco feeds XML ativos, cada um integrado a um canal diferente. Antes de uma campanha relâmpago, o time de marketing precisa pausar o feed do Google Shopping temporariamente para ajustar os preços. Com o toggle na listagem, o operador localiza o arquivo usando o filtro de canal, clica no toggle e inativa o feed em segundos — sem precisar entrar no fluxo de edição completo.

Caso 2: Localizar um XML entre dezenas de arquivos

Uma loja com mais de 30 feeds XML cadastrados precisa localizar rapidamente o arquivo de integração com a Meta para verificar o grupo de produtos configurado. Com a busca na tela de listagem, o operador digita o nome do arquivo e o encontra imediatamente, sem rolar por toda a lista.

Caso 3: Cadastrar um novo feed para um canal de venda

O time de expansão de canais precisa criar um novo arquivo XML para integrar com um canal parceiro, associando apenas os produtos do grupo "Linha Premium". No novo fluxo de cadastro, o analista preenche o formulário, seleciona o grupo de produtos desejado e salva - processo realizado em uma única tela, com confirmação imediata.

Caso 4: Identificar feeds inativos para revisão

O gestor de e-commerce deseja revisar todos os XMLs que estão pausados para decidir quais reativar. Usando a aba de status "Inativos" na listagem, obtém uma visão consolidada de todos os feeds inativos, com informações de tipo e link para facilitar a decisão.

ATENÇÃO!

Geração do arquivo XML: A sincronização e geração dos arquivos ocorre a cada hora fechada como 10h, 11h, 12h, 13h em diante. Ou seja, se você criou o XML às 15:45, a sincronização ocorrerá às 16h e o link do arquivo será gerado automaticamente.

Sincronização manual de arquivos: Em casos de problemas na atualização de informações, esta ação força o reenvio da base completa de produtos para processamento, considerando todas as recentes atualizações. Importante: É possível forçar a sincronização dos arquivos apenas 3 vezes no período de 24 horas.    

Sincronização com canais externos: Após desativar ou reativar um feed, o canal de destino (Google Shopping, Meta etc.) pode levar algum tempo para refletir a mudança, dependendo do intervalo de leitura do canal.

Múltiplos feeds para o mesmo canal: É possível ter mais de um XML ativo para o mesmo canal. Atenção ao gerenciar feeds simultâneos para evitar conflitos de catálogo.
 

FAQ

Acesse a documentação aqui.