Este artigo explica como criar um XML de produtos na VTEX no padrão aceito pela Dito, permitindo a integração correta do catálogo para uso em campanhas, análises e ativações de marketing. O principal benefício é garantir que os dados de produtos, preços e variações sejam consumidos corretamente, sem erros de formatação.

Para quem é este artigo?

• Nível de Acesso: Administrador, Editor.

Nesse artigo você vai encontrar:

Visão geral do XML VTEX

Um panorama rápido sobre o que é o XML VTEX e como ele funciona na prática.

Regras de progressão e finalização

Entenda os critérios que determinam o avanço e a conclusão dos processos.

Passo a Passo

Instruções claras e objetivas para executar cada etapa corretamente.

Próximos Passos

O que fazer após a conclusão para garantir continuidade e boas práticas.

FAQ – Perguntas Frequentes sobre XML VTEX

Visão geral do XML VTEX

O XML é um feed no formato RSS 2.0, gerado diretamente pelo Admin VTEX, contendo informações de produtos, SKUs, preços, estoque e atributos como cor, tamanho e gênero, seguindo o padrão do Google Merchant, utilizado pela Dito.

Regras de progressão e finalização

• O XML deve conter apenas produtos disponíveis em estoque

• Os preços devem ser enviados sem símbolo de moeda

• A formatação de preço deve seguir o padrão 1999,99

• Todas as variações de SKU devem estar habilitadas

Passo a Passo

A seguir, veja como criar e configurar corretamente o XML no Admin VTEX.

Passo 1 – Acessar a configuração de XML

1. Acesse o Admin VTEX
2. Vá em Configurações da Loja
3. No menu Canais, clique em Integração XML

Passo 2 – Criar um novo XML

1. Clique em Novo XML

2. Em Tipo de XML, selecione Feed: RSS 2.0

3. No campo Coleção, selecione a coleção de produtos que deseja compartilhar

Passo 3 – Configurar preços e exibição de produtos

1. Em Símbolo de moeda nos preços, deixe o campo vazio

2. Em Formatação dos preços, selecione:
   Without thousands separator (e.g.: 1999,99)

3. Desmarque a opção Exibir SKUs indisponíveis

4. Desmarque a opção Exibir produto com SKU padrão

Passo 4 – Configurar as tags obrigatórias do XML

A partir da linha Tag do subraiz, edite, habilite e preencha as tags conforme abaixo:

Estrutura principal

• Tag subraiz: channel

• Tag do item: item

Identificação

• ID do produto: g:item_group_id

• ID do SKU: g:id

• Código de referência do SKU: g:mpn

• EAN: g:gtin

Informações do produto

• Nome do produto + SKU: g:title

• Descrição: g:description

• Departamento + Categoria: g:product_type

• Marca: g:brand

Links e imagens

• Link do produto: g:link

• Imagem (Tipo 2): g:image_link

Preços

• Preço original do SKU: g:price

• Preço atual do SKU: g:sale_price

Parcelamento

• Parcelamento Google Shopping: g:installment

• Número de parcelas: g:months

• Valor da parcela: g:amount

Disponibilidade e atributos

• Disponibilidade: g:availability

• Cor: g:color

• Tamanho: g:size

• Gênero: g:gender

Tag livre

• Tag livre 1: g:condition

• Conteúdo da tag: new

Passo 5 – Finalizar e gerar o XML

1. Revise todas as configurações

2. Clique em Salvar

3. O link do XML será gerado automaticamente

Obs: Caso queira adicionar mais informações ao XML, as tags e valores devem seguir o padrão aceito pelo Google Merchant: https://support.google.com/merchants/answer/7052112?hl=pt-BR

Próximos Passos

Após finalizar a criação do XML:

1. Preencha o formulário enviado pela Dito

2. Informe seu CS ou time de atendimento

3. Nosso time realizará as validações do arquivo

4. Com tudo validado, seguimos com a integração do catálogo

Neste artigo, você aprendeu como criar e configurar um XML na VTEX no padrão exigido pela Dito, garantindo que os dados do seu catálogo sejam integrados corretamente, sem erros de preço, estoque ou variações de produto.

Ficou com alguma dúvida ou identificou algum problema? Acione nosso time pelo chat disponível no app dito. (Horário de Atendimento de Segunda a Sexta das 9hrs as 18hrs) 

Gostou, mas acha que algo pode melhorar?

Sua opinião é muito importante para nós! Se você tem alguma sugestão ou sentiu falta de algo neste módulo, queremos ouvir você.

Compartilhe suas ideias diretamente com nosso time de Produto através do link abaixo.

➡️ Acesse aqui o Portal de Ideias

FAQ – Perguntas Frequentes sobre XML VTEX

1. Posso adicionar mais campos no XML?
R:Sim, desde que sigam o padrão aceito pelo Google Merchant.

2. O XML pode conter produtos sem estoque?
R:Não. É obrigatório desmarcar a opção de exibir SKUs indisponíveis.

3. O preço pode conter símbolo de moeda?
R:Não. O valor deve ser enviado apenas em número, sem símbolo.

4. As variações de tamanho e cor são obrigatórias?
R:Sim, para garantir a correta identificação dos SKUs no catálogo.