Comment créer un fichier XML pour Rozetka.ua (sockets)
Pour répertorier les marchandises sur Rozetka.ua, vous devez préparer une liste de prix avec des offres au format XML (YML). Pendant que le magasin est en cours d'exécution, l'adresse du lien xml doit être statique et ne pas changer.
Exigences relatives aux fichiers XML (YML)
- la norme XML (YML) n'autorise pas l'utilisation de caractères non imprimables avec des codes ASCII de 0 à 31 (à l'exception des caractères avec les codes 9, 10, 13 - tabulation, saut de ligne, retour chariot).
- les caractères ", &, >, <, ' doivent être remplacés par des codes équivalents. L'exigence s'applique uniquement au texte et n'affecte pas l'écriture des balises ;
- il est interdit de changer l'identifiant des produits et des catégories après l'ajout sur le site ROZETKA.
Symbole dans le texte | Code pour le fichier XML |
---|---|
" | |
& | |
> | |
< | |
' |
- L'adresse URL d'une offre de produit sur le site du magasin doit être encodée conformément à la norme RFC-1738.
- encodage de fichier XML (YML) valide : UTF-8.
Exemple de fichier XML
Descriptif des éléments
Élément | La description |
---|---|
yml_catalog Élément requis | L'élément racine du format YML. L'attribut date spécifie la date et l'heure auxquelles le XML (YML) a été généré ou modifié. La date doit être au format AAAA-MM-JJ hh:mm. |
magasin Élément requis | Contient une description du magasin et de ses offres de produits. |
Nom Élément facultatif | Nom abrégé du magasin. Non publié, utilisé pour l'identification interne. Le nombre maximum de caractères est ━ 255. |
la société Élément facultatif | Le nom complet de la société propriétaire du magasin. Non publié, utilisé pour l'identification interne. Le nombre maximum de caractères est ━ 255. |
URL Élément facultatif | URL de la page principale d'une boutique existante. Le nombre maximum de caractères est ━ 255. |
Plate-forme Élément facultatif | Le système de gestion de contenu sur lequel le magasin fonctionne (CMS). |
devises Élément requis | Liste des taux de change en magasin. Chacune des devises est décrite par un élément monétaire distinct. Exemple: Les prix sur le site sont affichés uniquement en UAH. Seule la hryvnia a rate="1". YML utilise un point ou une virgule pour séparer les parties entières et fractionnaires de n'importe quel nombre, indépendamment des paramètres régionaux. La valeur de l'attribut currency id=". . . " est spécifiée conformément à la norme ISO 4217 sous la forme d'un code de devise alphabétique à trois lettres (alfa-3). |
catégories Élément requis | Liste des catégories de magasins. Chaque catégorie se voit attribuer un numéro unique, la numérotation est à la discrétion du magasin.
Exemple: Угловые диваны Смарт-часы Детские игровые комплексы Угловые диваны Смарт-часы Детские игровые комплексы Угловые диваны Смарт-часы Детские игровые комплексы Le nombre maximum de caractères est ━ 255. |
rz_id Élément facultatif | Fournit une liaison automatique de la catégorie de la liste de prix avec la catégorie ROZETKA. Il est indiqué uniquement dans la liste des catégories, votre identifiant de catégorie est indiqué dans la fiche produit. Exemple: Джемы и начинки id="12345" ━ votre identifiant de catégorie ; La priorité de rz_id est supérieure à celle du nom de la catégorie. Par exemple, si le nom de la catégorie dans le fichier xml est "T-shirt", et que l'id de la catégorie "Chaussettes" sur le site ROZETKA est indiqué dans la balise rz_id, alors il y aura automatiquement une connexion avec le " Catégorie Chaussettes". |
des offres Élément requis | Liste des offres de la boutique. S'ouvre une fois, après l'étiquette. Se ferme à la fin du document, avant la balise Exemple: Платья Куртки . . . . . . . . . Платья Куртки . . . . . . . . . Платья Куртки . . . . . . . . . Veuillez noter que l'étiquette ne doit pas être répétée dans la liste de prix. |
offre Élément requis | Produit de carte. Fermé avec étiquette.
Pour chaque type de produit: couleur, taille, volume, configuration, etc. — une offre unique distincte doit être créée. Sur notre site, les produits seront regroupés en 1 offre avec un choix de couleur, taille, volume, etc. Exemple: . . . |
quantité en stock (la quantité en dépôt) Élément requis | Le reste de la marchandise. Le produit sera en stock sur le site tant que ce paramètre sera supérieur à 0. Veuillez noter que lors de l'utilisation de l'étiquette, il est obligatoire de l'indiquer dans tous les produits de la liste de prix, sinon les produits sans cette étiquette se verront attribuer le statut « En rupture de stock ». Assurez-vous également de suivre la valeur dans la balise available=". . . " si stock_quantity > 0 ━ true, si stock_quantity < 0 ━ false. Exemple: 10 |
url (dans l'offre) Élément facultatif | Lien vers le produit sur votre site. Exemple: https://elbuz.com/catalog/muzhskaya_odezhda/kurtki/kurtkabx. html Le nombre maximum de caractères est ━ 500. |
le prix Élément requis | Le prix du produit. Spécifiez uniquement un nombre entier, les kopecks sont arrondis sur le site. Exemple: 4499 YML utilise un point ou une virgule pour séparer les parties entières et fractionnaires de n'importe quel nombre. Le prix indiqué en kopecks sera arrondi sur le site. |
prix_ancien (ancien prix) Élément facultatif | L'ancien prix de la marchandise sera barré sur le site. Spécifiez après la balise Exemple: 3999 4499 или 3999 4499 3999 4499 или 3999 4499 3999 4499 или 3999 4499 3999 4499 или 3999 4499 3999 4499 или 3999 4499 Lire la suite: Remise sur les produits |
price_promo (prix_promo) Élément facultatif | Prix du code promotionnel. Doit avoir une étiquette Exemple: 820 620 или 820 620 или 820 620 или
Lire la suite: Participation aux mailings promotionnels |
identifiant de devise Élément requis | Devise dans laquelle le prix des marchandises est indiqué: UAH, EUR, EUR, RUR. Exemple: UAH EUR EUR RUR UAH EUR EUR RUR UAH EUR EUR RUR UAH EUR EUR RUR |
identifiant de catégorie Élément requis | ID de la catégorie à laquelle ce produit est associé. Exemple: 391 |
image Élément requis | Lien vers la photo du produit. La première photo de la liste sera la principale de la fiche produit. Le lien ne doit pas contenir de cyrillique ni d'espaces, le nombre maximum de caractères est ━ 1999. Le nombre minimum de photos est ━ 1, le maximum est 15. Exemple: Si votre serveur a une restriction sur le téléchargement de photos, vous devez ajouter les sous-réseaux suivants aux exceptions : 89. 184. 81. 192/27 |
vendeur Élément requis | Marque du fabricant. Devrait répondre à nos exigences . Exemple: Abc clothes |
Nom (maquette) Élément requis | Nom du produit. Veuillez respecter nos exigences et recommandations lors de la spécification.
La balise de modèle peut être utilisée comme titre au lieu de la balise de nom. Exemple: Куртка Abc clothes Scoperandom-HH XL Черная (1323280942900) или Куртка Abc clothes Scoperandom-HH XL Черная (1323280942900) Куртка Abc clothes Scoperandom-HH XL Черная (1323280942900) или Куртка Abc clothes Scoperandom-HH XL Черная (1323280942900) Куртка Abc clothes Scoperandom-HH XL Черная (1323280942900) или Куртка Abc clothes Scoperandom-HH XL Черная (1323280942900) Le nombre maximum de caractères est ━ 255. |
la description Élément requis | Description du produit.
Exemple: Одежда <b>Abc clothes</b> способствует развитию… Producteur: Estonie. ]]> |
Etat Élément facultatif | État du produit. Utilisé dans le cas de biens d'occasion et remis à neuf Si la balise d'état n'est pas spécifiée, les produits reçoivent par défaut le nouveau statut. Exemple: used |
. . . Élément requis | Caractéristiques (paramètres) des marchandises. Le nom ou la valeur de la caractéristique (paramètre) doit être renseigné, les balises vides ne sont pas autorisées. Le nombre minimum de caractéristiques requises pour un produit = 3.
Exemple: Черный Dans un paramètre multivalué, les valeurs sont listées séparées par des virgules et fermées dans CDATA. Le nombre maximum de caractères est ━ 255. |
paramid=". . . " Élément facultatif | id de la caractéristique (paramètre) sur le site Web ROZETKA, est prescrit pour la liaison automatique du paramètre et l'accélération du processus de modération. Si le type de paramètre (caractéristiques) est: ComboBox, List Values, List, Checkbox, CheckBoxGroup, CheckBoxGroupValues ━ une balise valueid=". . . " supplémentaire est requise Exemple: 2 |
valeurid=". . . " Élément facultatif | id de la valeur de la caractéristique (paramètre) sur le site Web ROZETKA, est prescrit pour lier automatiquement la valeur et accélérer le processus de modération. Exemple: Осенняя, Весенняя, Летняя Le nombre maximum de caractères est ━ 255. |
Pour décharger en XML, utilisez des substitutions de macro
{Attribut : identifiant Rozetka}
{Attribut : nom Rozetka}