O que é o XML e para que serve?

O XML (Extensible Markup Language) é um formato utilizado para organizar e compartilhar dados entre sistemas.

No e-commerce, ele funciona como um feed de produtos, ou seja, um arquivo que reúne informações da sua loja, como:

• nome do produto;
• preço;
• estoque;
• categoria;
• link da página.

Esse arquivo é utilizado por canais de venda (como marketplaces e Google Shopping) para ler e exibir seus produtos automaticamente.

Como o XML funciona na prática

O XML é estruturado em blocos de informação (tags), onde cada produto possui seus próprios dados organizados. Exemplo simples:

<produto>
  <nome>Camiseta Básica</nome>
  <preco>59.90</preco>
  <estoque>10</estoque>
</produto>

Na prática:

• cada produto vira um “registro” dentro do XML;
• os canais acessam esse arquivo periodicamente;
• apenas produtos válidos são exibidos.

Como funciona o XML na plataforma

Na plataforma, o XML é gerado automaticamente e já segue padrões utilizados pelos canais de venda.

Porém, existe um ponto importante: nem todos os produtos da loja aparecem no XML.

Isso acontece porque o sistema aplica uma série de validações antes de incluir o produto no feed.

Como configurar o XML por canal de vendas

Quando você trabalha com canais de venda, o XML passa a considerar regras específicas para cada canal.

Onde configurar

Acesse: Configurações > XML. Aqui você pode:

• criar um novo XML;
• editar um XML existente;
• definir o canal de vendas;
• configurar filtros (categoria, marca, etc.).

Regras para o produto aparecer no XML por canal

Para que um produto seja exibido corretamente no XML de um canal, ele precisa atender todas as condições abaixo.

1. Produto vinculado ao canal de vendas

• O produto precisa estar associado ao canal.

Sem esse vínculo → não aparece no XML.

2. Categoria vinculada ao canal

• A categoria do produto também precisa estar liberada para o canal.

Caso contrário → produto não será considerado.

3. Hierarquia completa de categorias

• O produto deve estar vinculado até o último nível da categoria.

Categorias incompletas podem impedir a exibição.

4. Marca vinculada ao canal

• A marca do produto precisa estar vinculada ao mesmo canal.

Sem isso → o produto não entra no XML.

5. Produto liberado para venda

• O produto precisa estar com venda habilitada

Caso contrário → não será exibido

6. Produto ativo e configurado corretamente

Além das regras de canal, o produto também precisa:

• estar ativo;
• estar com a opção “Exibir no XML” habilitada;
• ter uma URL configurada.

Filtros do próprio XML

Dentro da configuração do XML, você também pode limitar os produtos por:

• categoria;
• marca;
• exclusão de produtos.

Esses filtros impactam diretamente no que será exibido.

Regras de estoque

Dependendo da configuração:

• se não permitir produtos sem estoque → só entram produtos disponíveis;
• se permitir → produtos sem estoque também aparecem.

Atualização do XML

O XML não atualiza em tempo real. Ele passa por:

• processamento em fila;
• atualizações automáticas periódicas.

Após alterações, aguarde a atualização para validar no arquivo.

Por que o XML pode retornar poucos produtos?

Os principais motivos são:

• produto não vinculado ao canal;
• categoria ou marca não vinculadas;
• produto sem estoque;
• produto não liberado para venda;
• filtros do XML muito restritivos;
• XML ainda não atualizado.

Como validar se está tudo correto

Pelo painel

• Acesse: Configurações → XML;
• Abra o XML;
• Verifique status e link do arquivo.

Pelo arquivo XML

• Abra a URL do XML;
• Busque pelo produto (nome, SKU ou ID).

Checklist rápido: como validar se o XML está correto

Após configurar o XML e os produtos, utilize este checklist para garantir que tudo está funcionando corretamente.

Produto

1. Está ativo;
2. Está liberado para venda;
3. Está com a opção “Exibir no XML” habilitada;
4. Possui URL configurada;
5. Está vinculado a uma categoria completa (hierarquia correta).

Canal de vendas

1. Produto está vinculado ao canal;
2. Categoria está vinculada ao canal;
3. Marca está vinculada ao canal.

Configuração do XML

1. O XML está vinculado ao canal correto;
2. Não há filtros restritivos indevidos (categoria, marca ou exclusões).

Estoque

• O produto possui estoque disponível
  ou
• O XML está configurado para permitir produtos sem estoque.

Atualização

1. O XML já foi atualizado após as alterações;
2. O arquivo XML já reflete as mudanças feitas.

Validação final

• O produto pode ser encontrado no XML (buscando por nome, SKU ou ID).

Se todos os pontos acima estiverem corretos, o produto deve estar sendo retornado normalmente no XML.

Dúvidas?

Acesse nosso Help Center para mais conteúdos sobre a plataforma Uappi!