The VTEX XML catalog integration allows you to synchronize your VTEX store’s product catalog with Connectif, generating a personalized XML feed. This integration enables you to easily import your products into Connectif and synchronize them in bulk.
In this article, you’ll learn how to generate your XML feed for VTEX and how to synchronize it with Connectif.
Difficulty: Low.
When to use it?: When opening your account in Connectif.
Before you start: prerequisites
To integrate your VTEX XML catalog with Connectif, you’ll need:
Access to the VTEX Admin.
Administrative permissions to create and manage XML templates.
A Collection in VTEX that includes all the products you want to export to the XML feed (see VTEX documentation to configure it).
STEP 1. XML configuration in VTEX
1.1. Creating the XML template in VTEX
1. Go to the VTEX admin panel, navigate to "Store Settings > Channels" and click on XML Integration.
2. Click on New XML.
3. In XML Type, select the option Open XML (default).
4. Assign a File Name to identify it.
5. Complete the fields:
In Encoding Type, select the option UTF-8 (default).
In Collection, select the product collection to be listed.
In Price format, select the option Default.
In Category separator, select the option Google Shopping.
6. Check the box Show product with standard SKU.
1.2. Defining the product fields in VTEX
7. In the Root Tag area, complete the information as shown in the image below or as indicated in the official VTEX documentation.
8. Configure the XML template to include the product information, as indicated in the following table:
| Field in Connectif | VTEX Field | Field in XML |
|---|---|---|
External product ID |
Product ID |
id |
Name |
SKU Name |
title |
Unit price |
Current SKU Price + Taxes |
sale_price_with_tax |
Original unit price |
Current SKU Price + Taxes |
sale_price_with_tax |
Unit price without taxes |
Current SKU Price |
sale_price |
Detail URL |
Link |
link |
Categories |
Department + Category |
g:product_type |
Image URL |
Image |
image_link |
Description |
Product description |
description |
Availability |
Google Shopping availability |
g:availability |
Brand |
Brand |
brand |
9. Click Save.
10. With everything ready, the XML would look like this:
<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. Generating the XML Feed URL
11. Once the template is saved, VTEX will generate the XML feed and, in the URL column, the public URL will be available, which will look similar to the following:
https://{your-workspace}.vtexcommercestable.com.br/XMLData/{your-template-name}.xml12. Access that URL from a browser and check that the XML is being generated correctly.
STEP 2. Synchronizing the XML feed with Connectif
13. Access your Connectif Store, go to "Ecommerce > Catalog" and click on Product synchronization.
14. Go to the Product feed tab and click Configure.
15. In the Add product feed area, add the URL of the product feed you just created.
16. Map the parameters of your XML Feed with those in the Connectif Product Sheet.
17. Once the synchronization settings are defined, click Activate to schedule the synchronization, or Activate and synchronize immediately to run a synchronization and schedule the next one within the established period.
Keep learning!
To make the most of your Connectif account, we recommend continuing with the following articles:
Custom integration to send data, to send data from Connectif to external systems or applications.
Detect and react to web links created outside Connectif, to detect and react to clicks on any link on your website.
Integration with Facebook and Instagram, to connect your Facebook Ads account with Connectif and start managing your audiences.
Embedded forms, to integrate existing forms from your website into Connectif.