Comment convertir un catalogue en YML

YML est un format de flux de produits basé sur XML. Le format d’entrée n’a pas d’importance : Eofferix peut utiliser comme source un fichier XML, YML, JSON, CSV, XLS ou XLSX, un fichier accessible par URL ou FTP/SFTP, une pièce jointe reçue par e-mail, une archive ou un export préparé par un autre service. Après avoir choisi YML, Eofferix crée un snapshot XML de travail dans lequel vous configurez la structure finale et les règles de transformation. Si vous choisissez un scénario spécialisé, le panneau latéral aide également à vérifier les exigences de la plateforme sélectionnée.

Procédure de configuration de l’export YML

1. Ouvrez « Interpréteur » et cliquez sur « Nouveau profil ».

   

2. Sélectionnez la source de données : importez un nouveau fichier ou choisissez une source existante.

   

3. Choisissez YML comme format d’export.

   

4. Si vous avez besoin d’un fichier spécialisé, choisissez une plateforme ou un scénario. YML universel est sélectionné par défaut.

   

5. Faites défiler le profil jusqu’en bas et cliquez sur Continuer. Le service enregistre le profil et ouvre le snapshot XML avec les nœuds de la source et la structure YML générée. Le symbole ! indique les nœuds obligatoires pour la plateforme sélectionnée.

   

6. Cliquez sur les suggestions du panneau pour appliquer les renommages détectés ou créer les nœuds manquants. Les règles complexes doivent être configurées manuellement.
7. Enregistrez le modèle et lancez l’export.

Comment mettre à jour YML automatiquement

Pour un flux régulier, il n’est pas nécessaire de charger le fichier source et de lancer la conversion manuellement à chaque fois. Connectez une source qu’Eofferix peut vérifier automatiquement : une URL directe, FTP/FTPS, une pièce jointe reçue par email, Google Sheets ou Yandex Tables, ou un stockage cloud. Pour créer et tester le profil, consultez Premier lancement du profil ; pour recevoir les nouvelles versions de la source, consultez Planification du chargement de la source.

1. La source reçoit une liste de prix ou un catalogue actualisé selon sa propre planification.
2. Après une mise à jour réussie, le profil se lance sur l’événement et applique les correspondances, les transformations et le preset YML enregistrés.
3. Le fichier final est publié à une URL permanente que vous pouvez transmettre à la plateforme. Chaque lancement réussi met à jour le fichier à la même URL.

Configurez la séquence « mettre à jour la source → générer YML » comme décrit dans Planificateur des profils et des sources. L’URL permanente et la livraison du résultat sont décrites dans Livraison du résultat après transformation.

Comment utiliser le panneau d’aide

L’éditeur vérifie le modèle actuel selon les exigences de la plateforme sélectionnée et affiche le résultat à droite. Les exigences sont regroupées en structure, propriétés obligatoires, conditionnelles, recommandées, non prises en charge et traitées. Une coche verte indique que le point est satisfait ; ! demande votre attention ; l’icône d’information explique une recommandation sans rien modifier à elle seule.

Le panneau n’applique jamais une correction en silence. Les boutons d’action ne fonctionnent qu’après un clic. Survolez une icône pour afficher son aide.

Que faire des propriétés non prises en charge par la plateforme

Cette section regroupe les propriétés du catalogue source qui ne font pas partie des exigences de la plateforme sélectionnée. Pour chaque propriété simple, vous pouvez :

• Supprimer — ne pas l’inclure dans l’export ;
• Convertir — la transformer en <param name="nom_de_la_propriété">valeur</param>. L’icône apparaît uniquement si le format de la plateforme accepte param.

Après suppression ou conversion, la ligne quitte la liste qui demande votre attention et rejoint la section repliée « Champs traités ». Chaque propriété traitée possède sa propre icône Annuler : vous pouvez revenir sur une action sans réinitialiser les autres réglages.

Gérer les catégories

Toutes les plateformes n’exigent pas de catégories. Si le scénario sélectionné ne les utilise pas, vous pouvez ignorer leur configuration. Dans le cas contraire, l’éditeur prend en charge plusieurs structures de source :

• le catalogue contient déjà des ID de catégorie et un dictionnaire séparé — conservez la relation entre categories/category/@id et offer/categoryId, puis le panneau la vérifiera ;
• chaque produit contient seulement un nom ou un chemin de catégorie — sélectionnez cette propriété dans « Catégories de produits » ; Eofferix générera des ID numériques, construira categories et remplira automatiquement categoryId ;
• les catégories sont stockées ailleurs, imbriquées autrement ou la plateforme attend une autre structure — créez, déplacez ou sélectionnez manuellement les nœuds nécessaires.

Dans la source, une catégorie peut se trouver dans chaque produit ou séparément. Les exigences de la plateforme sélectionnée déterminent la structure de sortie.

La vérification complète ne se lance pas après chaque modification. Cliquez sur « Vérifier tous les produits » lorsque la configuration est prête. Après un changement, utilisez « Revérifier » ; si une longue vérification a été interrompue, utilisez « Continuer la vérification ». Même un très grand catalogue n’est donc pas revérifié après chaque action.

Presets YML

Un preset ne remplace pas les regles officielles de la plateforme. Il fournit une structure de depart et met en evidence ce qui manque dans le profil courant. Verifiez toujours la liste actuelle des parametres dans la documentation du service qui recevra le flux.

Preparation YML pour Yandex Market

Scenario pour le cabinet vendeur de Market. Le panneau controle yml_catalog, la date, shop, les devises, categories, offers et le noeud produit offer. L obligation des champs depend du but du fichier : fiches produits, prix, stock ou gestion du placement. Dans Eofferix, url n est pas obligatoire sans condition pour ce preset ; il est affiche comme champ conditionnellement important. Voir documentation YML de Yandex Market.

Preparation YML pour Yandex Produits / Recherche

Scenario pour un flux produit destine aux surfaces liees a la recherche Yandex. Le panneau exige id, name, url, price, currencyId, categoryId, picture et description dans chaque offer. Voir documentation du flux Yandex Produits.

Preparation YML pour Yandex Direct

Scenario pour les flux publicitaires. L URL produit, le prix, la devise, la categorie et l image sont importants. Si vous utilisez lattribut available, transmettez true ou false, pas un nombre. Pour les offres vendor.model, vendor et model sont aussi controles. Voir exigences du flux YML Yandex Direct.

Preparation YML pour les produits et services Yandex Business

Scenario pour la liste de prix dune entreprise dans Yandex Business : produits et services peuvent apparaitre dans la fiche de l entreprise. Dans ce preset, shop/url n est pas requis comme lien de fiche produit ; section, nom, prix, devise, categorie et donnees fournisseur ou marque sont plus importants si votre liste en a besoin. Voir documentation de liste de prix Yandex Business.

Preparation YML pour 2GIS

2GIS accepte les produits et services depuis un fichier ou une URL au format YML/CSV. Le preset construit une structure YML typique avec produits, prix, devise et categories, et recommande URL, image et description. Laide publique 2GIS explique la methode de chargement ; verifiez le modele exact dans le cabinet 2GIS. Voir aide 2GIS sur les produits et les prix.

Preparation YML pour Ozon : prix et stock

Ce scenario ne remplace pas la Seller API Ozon. Utilisez-le quand il faut fournir un fichier pour mettre a jour prix et stock par identifiant produit. Les categories ne sont pas obligatoires ici ; id, price, currencyId et stock sont les plus importants. Voir article Ozon sur la mise a jour par flux.

YML universel

Utilisez YML universel quand le destinataire demande simplement un fichier YML sans jeu dexigences propre. Dans ce mode, le panneau specialise nest pas affiche : vous definissez vous-meme la structure, les noms de noeuds, les attributs et les regles de transformation.

Points a verifier avant lancement

• la racine sappelle yml_catalog si le destinataire lattend ;
• la date du catalogue est en RFC 3339 avec fuseau horaire si le scenario lexige ;
• shop, currencies, categories, offers et offer sont aux bons niveaux dimbrication ;
• offer/@id est unique et non vide ;
• price est numerique et currencyId correspond a la devise dans currencies ;
• si le destinataire exige des catégories, categoryId doit être numérique et référencer un categories/category/@id existant ;
• url et picture sont accessibles de lexterieur si la plateforme les exige ;
• available vaut true ou false sil est utilise ;
• le fichier de test passe loutil dimport du service cible sans erreurs critiques.