A integração do catálogo XML da VTEX permite sincronizar o catálogo de produtos da sua loja VTEX com Connectif, gerando um feed XML personalizado. Essa integração permite importar seus produtos para o Connectif e sincronizá-los em massa com facilidade.
Neste artigo, você aprenderá como gerar seu feed XML para VTEX e como sincronizá-lo com o Connectif.
Dificuldade: Baixa.
Quando usar: Ao abrir sua conta no Connectif.
Antes de começar: requisitos prévios
Para integrar seu catálogo XML da VTEX com o Connectif, você precisará de:
Acesso ao Admin da VTEX.
Permissões administrativas para criar e gerenciar templates XML.
Uma Coleção na VTEX que inclua todos os produtos que você deseja exportar para o feed XML (consulte a documentação da VTEX para configurá-la).
ETAPA 1. Configuração do XML na VTEX
1.1. Criação do template XML na VTEX
1. Acesse o painel de administração da VTEX, vá para "Configuração da Loja > Canais" e clique em Integração XML.
2. Clique em Novo XML.
3. Em Tipo de XML, escolha a opção Open XML (padrão).
4. Atribua um Nome de Arquivo para identificá-lo.
5. Preencha os campos:
Em Tipo de Codificação, escolha a opção UTF-8 (padrão).
Em Coleção, selecione a coleção de produtos que serão listados.
Em Formato de preços, escolha a opção Padrão.
Em Separador de categorias, escolha a opção Google Shopping.
6. Marque a caixa Exibir produto com SKU padrão.
1.2. Definição dos campos do produto na VTEX
7. Na área referente à Tag raiz, preencha as informações conforme mostrado na imagem a seguir ou conforme indicado na documentação oficial da VTEX.
8. Configure o template XML para incluir as informações do produto, conforme indicado na tabela a seguir:
| Campo no Connectif | Campo na VTEX | Campo no XML |
|---|---|---|
ID externo do produto |
ID do produto |
id |
Nome |
Nome do SKU |
title |
Preço unitário |
Preço atual do SKU + Taxas |
sale_price_with_tax |
Preço unitário original |
Preço atual do SKU + Taxas |
sale_price_with_tax |
Preço unitário sem impostos |
Preço atual do SKU |
sale_price |
URL de detalhes |
Link |
link |
Categorias |
Departamento + Categoria |
g:product_type |
URL da imagem |
Imagem |
image_link |
Descrição |
Descrição do produto |
description |
Disponibilidade |
Disponibilidade Google Shopping |
g:availability |
Marca |
Marca |
brand |
Nesta tabela você encontra as referências para completar as informações na VTEX:
- Campo no Connectif: é o nome do campo conforme aparece na Ficha de Produto do Connectif.
- Campo na VTEX: é o nome conforme aparece na interface da VTEX como referência.
- Campo no XML: é a informação que você deve incluir no input da VTEX.
Por exemplo, para associar o campo ID externa do produto do Connectif, na VTEX você deve inserir "id" na área ID do produto; para associar o campo Nome do Connectif, na VTEX você deve inserir "title" na área Nome do SKU.
9. Clique em Salvar.
10. Com tudo pronto, o XML terá a seguinte aparência:
<rss xmlns:g="http://base.google.com/ns/1.0" version="2.0">
<rss xmlns:g="http://base.google.com/ns/1.0" version="2.0">
<channel>
<item>
<id><![CDATA[ 1 ]]></id>
<title><![CDATA[ Product ]]></title>
<description><![CDATA[ Lorem ipsum dolor sit amet, consectetur adipiscing elit. Morbi sollicitudin orci et dolor lobortis, nec elementum metus mattis. Vestibulum et commodo ante. ]]></description>
<g:product_type><![CDATA[ Level 1 > Level 2 > Level 3 > Level 4 ]]></g:product_type>
<brand><![CDATA[ Brand ]]></brand>
<link><![CDATA[ https://connectif.vtexcommercestable.com.br/product/p?idsku=13 ]]></link>
<image_link><![CDATA[ https://connectif.vteximg.com.br/arquivos/ids/155403_2 ]]></image_link>
<sale_price><![CDATA[ 6,00 ]]></sale_price>
<sale_price_with_tax><![CDATA[ 7,00 ]]></sale_price_with_tax>
<g:availability><![CDATA[ in stock ]]></g:availability>
</item>
</channel>
</rss>
1.3. Geração da URL do Feed XML
11. Uma vez salva a configuração, a VTEX gerará o feed XML e, na coluna URL, estará disponível a URL pública do mesmo, que terá um formato semelhante ao seguinte:
https://{seu-workspace}.vtexcommercestable.com.br/XMLData/{nome-do-seu-modelo}.xml12. Acesse essa URL em um navegador e verifique se o XML está sendo gerado corretamente.
PASSO 2. Sincronização do feed XML com o Connectif
13. Acesse sua Loja do Connectif, vá para "Ecommerce > Catálogo" e clique em Sincronização de produtos.
14. Vá para a aba Feed de produtos e clique em Configurar.
15. Na área Adicionar feed de produtos, adicione a URL do feed de produtos que você acabou de criar.
16. Relacione os parâmetros do seu Feed XML com os da Ficha de Produto do Connectif.
Se você precisar de mais informações sobre como sincronizar seu feed com o Connectif, consulte este artigo.
17. Após definir a configuração da sincronização, clique em Ativar para programar a sincronização, ou em Ativar e sincronizar imediatamente para executar uma sincronização e agendar a próxima dentro do período estabelecido.
Sucesso!
Você sincronizou seu Catálogo XML da VTEX com o Connectif.
Continue aprendendo!
Para aproveitar todo o potencial da sua conta no Connectif, recomendamos continuar com os seguintes artigos:
Integração personalizada para envio de dados, para enviar dados do Connectif para sistemas ou aplicativos externos.
Detectar e reagir a links web criados fora do Connectif, para detectar e reagir a cliques em qualquer link do seu site.
Integração com Facebook e Instagram, para conectar sua conta do Facebook Ads com o Connectif e começar a gerenciar suas audiências.
Formulários integrados, para integrar ao Connectif formulários já existentes no seu site.