Configurar XML

Integração XML

XML é uma linguagem de marcação que permite a comunicação entre computadores e aplicações. Sua principal característica é a estrutura hierarquicamente organizada para a criação de textos, banco de dados ou desenhos vetoriais.

A linguagem XML pode ser combinada com diferentes padrões, o que possibilita que um XML criado a partir do banco de dados A possa ser lido pelo banco de dados B.

A funcionalidade de configuração do XML na VTEX se utiliza dessa característica de poder combinar diferentes padrões para possibilitar que outros bancos de dados leiam as estruturas criadas pelo banco de dados da VTEX.

Isso quer dizer que, ao preencher os nomes da tag no campo Id do Produto, por exemplo, com Product_Id, o banco de dados da VTEX entenderá que ali deverá preencher essa informação, tornando possível a compreensão do lado dos sistemas do Google, Facebook, Buscapé, entre outros, que lerão a estrutura.

Veja a seguir alguns exemplos de parceiros que integram com o XML da VTEX:

Afilio
Buscapé
Criteo
Facebook
Google
MSN
Sociomantic
UOL
UOL Dynad
Zanox

Alterações no XML levam em média duas horas para serem atualizadas.

Novo XML

Antes de realizar o cadastro de um novo XML, é importante ter acesso à estrutura do sistema para o qual pretende exportar seu catálogo. Ou seja, você precisará saber os nomes das tags que são utilizadas pelo XML deles e quais informações eles exigem para que essa estrutura seja montada, por exemplo ID do produto, nome do produto, ID do SKU, nome do SKU, preço, entre outras.

Com isso em mãos, siga os passos abaixo para configurar o seu XML:

No Admin VTEX, acesse Configurações da loja, ou digite Configurações da loja na barra de busca no topo da página.
Em Canais, clique em Integração XML.
Em seguida, clique no botão Novo XML. Você será redirecionado(a) para um formulário.
Selecione o Tipo de XML.
Preencha o nome do arquivo, para identificá-lo na lista de XMLs.
Escolha o Tipo de codificação.
Defina qual coleção terá seus produtos listados.
Selecione o símbolo de moeda nos preços.
Escolha a formatação dos preços (com ou sem separador de milhar).
Selecione entre usar o separador de categorias padrão ou do Google Shopping (leia mais sobre configurações para XML do Google Shopping no artigo Padrão de valor para Atributo de Especificações de Produto - GoogleShopping).
Escolha se exibirá no site do marketplace os SKUs indisponíveis ou não, ou seja, se o produto será exibido para compra, ainda que não esteja disponível para pronta entrega.
Selecione se quer que o produto seja exibido com as informações do SKU padrão.
A partir daqui, preencha as tags conforme definido pelo sistema para o qual enviará o XML. Marque a caixa de seleção da coluna Mostrar conteúdo, nas tags que tiver preenchido o nome. As tags que já estiverem com essa opção marcada e cuja seleção não for possível desfazer são de preenchimento obrigatório.
A URL usada para acessar o XML é gerada automaticamente, conforme o domínio cadastrado no dicionário do Web Site, no CMS.

Se a política comercial possuir restrição de acesso, o XML não será gerado.

Conectores nativos: uma alternativa ao XML para integrar com marketplaces

Ao invés de integrar por XML, existe a possibilidade de integrar com marketplaces usando conectores nativos desenvolvidos pela VTEX. A escolha por conector nativo é a recomendação padrão e representa mais eficiência. Os conectores nativos disponíveis são: