Synchronization of the VTEX XML catalog with Connectif

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.

 
Implementation time: 20 min.
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

     

 

In this table you have the references to complete the information in VTEX: 
- Field in Connectif: this is the field name as it appears in the Connectif Product Sheet. 
- Field in VTEX: this is the name as it appears in the VTEX interface as a reference. 
- Field in XML: this is the information you must include in the VTEX input. 
For example, to associate the External product ID field in Connectif, in VTEX you must enter "id" in the Product ID area; to associate the Name field in Connectif, in VTEX you must enter "title" in the SKU Name area.

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}.xml

12. 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.

 

If you need more information on how to synchronize your feed with Connectif, check this article.

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.

 

 
 

 Success!
You have synchronized your VTEX XML Catalog with Connectif.

 


Keep learning!

To make the most of your Connectif account, we recommend continuing with the following articles: