Comment convertir un catalogue en YML

YML est un format de flux produit base sur XML. Dans Eofferix, l entree peut etre n importe quelle source prise en charge : XML, YML, JSON, CSV, XLS, XLSX, URL, FTP/SFTP, email, archive ou export prepare depuis un autre service. Avant de configurer le resultat, le service prepare un snapshot XML de travail ; le parametrage se fait donc dans un arbre de noeuds et des regles de transformation.

Cet article decrit le scenario general de conversion en YML. Le format d entree n est pas important : apres le choix de YML, vous configurez la structure finale dans le snapshot XML, et le panneau lateral aide a verifier les exigences de la plateforme choisie.

Quand choisir YML

• la plateforme cible accepte une liste de prix ou un flux produit en YML ;
• vous devez publier une URL de catalogue mise a jour automatiquement ;
• la source fournisseur n est pas YML, mais contient produits, prix, categories, images et descriptions ;
• vous avez besoin de variantes separees : YML generique, Yandex Produits, Direct, Yandex Business, 2GIS ou Ozon prix et stock.

Fonctionnement de la preparation

1. Creez un profil et selectionnez la source de donnees.
2. Choisissez YML comme format d export.
3. Si un fichier specialise est necessaire, choisissez une plateforme ou un scenario. YML generique est selectionne par defaut.
4. Ouvrez le snapshot XML. Il affiche les noeuds source et la structure YML generee.
5. Cliquez sur les suggestions du panneau pour appliquer les renommages detectes ou creer les noeuds manquants. Les regles structurelles complexes restent manuelles.
6. Enregistrez le modele et lancez un export de test. Verifiez ensuite le fichier YML final et l outil d import de la plateforme.

Role du panneau lateral

Quand un scenario specialise est choisi, le snapshot XML affiche un panneau de preparation YML. Il verifie la structure du flux, les champs obligatoires de offer, les champs conditionnels, recommandes et autres parametres. Le panneau ne modifie pas les reglages en silence : une action est appliquee uniquement apres un clic sur une suggestion ou un bouton.

La marque ! pres dun noeud ou attribut indique que l element compte pour le scenario choisi. Au survol, le nom du scenario apparait. Les couts techniques des ajouts sont masques par defaut et peuvent etre affiches depuis les outils de l editeur.

Categories et categoryId

YML relie les categories par des identifiants numeriques. Un noeud categories/category doit avoir lattribut id, et offer/categoryId doit contenir la meme valeur numerique. Si la source contient des categories texte ou des chemins, utilisez l outil de generation de categories : il cree un dictionnaire, attribue des IDs numeriques et remplace les categories des produits par ces IDs via des regles de transformation.

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 generique

Utilisez YML generique 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 ;
• categoryId est numerique et reference 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.