1. Centre d'aide
  2. Intégrez votre Commerce
  3. Intégration par module ou application
  4. VTEX IO

Synchronisation du catalogue XML de VTEX avec Connectif

Création
Mise à jour
S’abonner

L’intégration du catalogue XML de VTEX vous permet de synchroniser le catalogue de produits de votre boutique VTEX avec Connectif, en générant un flux XML personnalisé. Cette intégration permet d’importer vos produits dans Connectif et de les synchroniser facilement en masse. 

Dans cet article, vous apprendrez comment générer votre flux XML pour VTEX et comment le synchroniser avec Connectif.

 
Temps de mise en œuvre : 20 min.
Difficulté : Faible.
Quand l’utiliser ? : À l’ouverture de votre compte Connectif.

 

Avant de commencer : prérequis

Pour pouvoir intégrer votre catalogue XML de VTEX avec Connectif, vous aurez besoin de :

  • Accès à l’Admin de VTEX.

  • Droits administratifs pour créer et gérer des modèles XML.

  • Une Collection dans VTEX incluant tous les produits que vous souhaitez exporter vers le flux XML (voir la documentation de VTEX pour la configurer).

 

ÉTAPE 1. Configuration du XML dans VTEX

1.1. Création du modèle XML dans VTEX

1. Accédez au panneau d’administration de VTEX, allez à "Paramètres de la boutique > Canaux" et cliquez sur Intégration XML.


2. Cliquez sur Nouveau XML.


3. Dans Type de XML, choisissez l’option Open XML (par défaut).

4. Attribuez un Nom de fichier pour l’identifier.

5. Complétez les champs :

  • Dans Type d’encodage, choisissez l’option UTF-8 (par défaut).

  • Dans Collection, choisissez la collection de produits qui seront listés.

  • Dans Format des prix, choisissez l’option Par défaut.

  • Dans Séparateur de catégories, choisissez l’option Google Shopping.

6. Cochez la case Afficher le produit avec SKU standard.


 

1.2. Définition des champs du produit dans VTEX

7. Dans la zone relative à la Balise racine, complétez les informations comme indiqué dans l’image ci-dessous ou comme expliqué dans la documentation officielle de VTEX.


8. Configurez le modèle XML pour inclure les informations produit, comme indiqué dans le tableau suivant :

Champ dans Connectif Champ VTEX Champ dans XML
ID externe du produit ID produit id
Nom Nom du SKU title
Prix unitaire Prix actuel du SKU + Taxes sale_price_with_tax
Prix unitaire d’origine Prix actuel du SKU + Taxes sale_price_with_tax
Prix unitaire hors taxes Prix actuel du SKU sale_price
URL de détail Lien link
Catégories Département + Catégorie g:product_type
URL de l’image Image image_link
Description Description du produit description
Disponibilité Disponibilité Google Shopping g:availability
Marque Marque brand

 

Ce tableau fournit les références pour compléter les informations dans VTEX :
- Champ dans Connectif : nom du champ tel qu’il apparaît dans la Fiche Produit de Connectif. 
- Champ dans VTEX : nom du champ tel qu’il apparaît dans l’interface VTEX à titre de référence. 
- Champ dans XML : information à inclure dans l’input de VTEX. 
Par exemple, pour associer le champ ID externe du produit de Connectif, vous devrez saisir "id" dans la zone ID produit ; pour associer le champ Nom de Connectif, vous devrez saisir "title" dans la zone Nom du SKU.

9. Cliquez sur Enregistrer.

 

10. Une fois terminé, le XML aura l'apparence suivante :

<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. Génération de l’URL du flux XML

11. Une fois le modèle enregistré, VTEX générera le flux XML et l’URL publique sera disponible dans la colonne URL, avec un format similaire à celui-ci :

https://{ton-workspace}.vtexcommercestable.com.br/XMLData/{nom-de-ton-modèle}.xml

12. Accédez à cette URL depuis un navigateur et vérifiez que le XML se génère correctement.

 

ÉTAPE 2. Synchronisation du flux XML avec Connectif

13. Accédez à votre Boutique Connectif, allez dans "Ecommerce > Catalogue" et cliquez sur Synchronisation des produits.

 

14. Allez à l’onglet Flux de produits et cliquez sur Configurer.

 

15. Dans la zone Ajouter un flux de produits, ajoutez l’URL du flux de produits que vous venez de créer.

 

16. Associez les paramètres de votre flux XML à ceux de la Fiche Produit de Connectif.

 

Pour plus d'informations sur la manière de synchroniser votre flux avec Connectif, consultez cet article.

17. Une fois la configuration de la synchronisation définie, cliquez sur Activer pour programmer la synchronisation, ou sur Activer et synchroniser immédiatement pour exécuter une synchronisation et programmer la suivante selon la période définie.

 

 
 

 Succès !
Vous avez synchronisé votre Catalogue XML VTEX avec Connectif.

 

Continuez à apprendre !

Pour tirer le meilleur parti de votre compte Connectif, nous vous recommandons de poursuivre avec les articles suivants :