Qu'est-ce qu'une intégration XML ? XML produit, import et export, correspondance des champs, fréquence de mise à jour du stock et des prix, gestion des erreurs, calculateur du coût du retard de mise à jour et checklist XML

Saisir à la main des centaines de produits de votre fournisseur, fermer chaque ligne une par une quand le stock est épuisé et charger le même produit séparément sur les plateformes publicitaires finit par ralentir l'entreprise. Pour que les autres systèmes se mettent à jour automatiquement quand une donnée produit change à un endroit, ils doivent parler le même langage. Dans le e-commerce, le plus répandu de ces langages communs est le XML.

Ce guide traite l'intégration XML de bout en bout : ce qu'est le XML, à quoi ressemble un XML de produits, la différence entre l'import et l'export de données, comment s'effectue la correspondance des champs, à quelle fréquence les mises à jour de stock et de prix doivent s'exécuter et les erreurs les plus courantes. Il comprend aussi un outil qui calcule ce que vous coûtent les retards de mise à jour et une liste de contrôle pour auditer votre propre source XML et votre sortie. Sans répéter l'article Qu'est-ce qu'un fournisseur XML ?, qui traite du côté fournisseur, ni l'article Qu'est-ce qu'un revendeur XML et comment démarrer ?, qui traite du modèle économique de la méthode, nous nous concentrons ici sur la connexion elle-même, c'est-à-dire sur la technique et l'exploitation.

Qu'est-ce qu'une intégration XML ?

Une intégration XML est le transfert automatique de données (produits, stock, prix ou commandes) entre deux systèmes à l'aide d'un format de fichier structuré appelé XML. Un côté publie les données en XML ; l'autre lit ce fichier à intervalles réguliers et l'intègre à ses propres enregistrements.

La force de la méthode tient au fait que les deux systèmes n'ont pas besoin de se connaître. Le système source met les données à disposition sur un lien que chacun peut lire ; le système lecteur se rend sur ce lien et place le contenu dans ses propres champs. Selon le sens du transfert, il existe deux usages principaux :

Une même boutique utilise souvent les deux sens à la fois : elle reçoit les produits de son fournisseur et transmet aussi ses propres produits aux plateformes publicitaires. La logique est la même dans les deux cas ; la différence tient à qui est l'éditeur et qui est le lecteur.

À lire aussiQu'est-ce qu'un fournisseur XML ?

Qu'est-ce que le XML et à quoi ressemble un XML produit ?

Le XML est un langage de balisage dans lequel les données sont décrites par des balises ; chaque information se trouve entre une balise ouvrante et une balise fermante, et les balises s'imbriquent pour former un arbre. Un XML produit décrit un produit sur chaque branche de cet arbre.

L'exemple ci-dessous présente un produit représentatif ; les noms de balises varient d'une source à l'autre et chaque source définit sa propre structure.

<?xml version="1.0" encoding="UTF-8"?>
<urunler>
  <urun>
    <stok_kodu>ORN-1001</stok_kodu>
    <barkod>8690000000012</barkod>
    <ad>Örnek Keten Gömlek</ad>
    <fiyat>1250.00</fiyat>
    <stok>14</stok>
    <kategori>Giyim &gt; Gömlek</kategori>
    <resim>https://www.ornek.com/img/gomlek-1.jpg</resim>
  </urun>
</urunler>

Le XML est si répandu parce que les humains comme les machines peuvent le lire. Vous pouvez ouvrir un fichier dans un navigateur, regarder à l'intérieur et voir à l'œil nu pourquoi quelque chose a mal tourné. Cela facilite le débogage par rapport à d'autres modes de transfert. Pour les grandes listes comme les données produits, le glossaire explique aussi la notion de flux XML.

Comment fonctionne une intégration XML ?

Une intégration XML fonctionne ainsi : le système lecteur se rend sur le lien de la source à intervalles réguliers, télécharge le fichier, analyse le contenu, fait correspondre les champs avec les siens et inscrit les modifications dans ses enregistrements. Le processus suit le même ordre à chaque tour.

1. Se rend sur le lien : Le lecteur envoie une requête à l'adresse XML fournie par la source. Parfois, la source n'autorise que les requêtes provenant de certaines adresses.
2. Télécharge le fichier : Une grande liste de produits peut être divisée en plusieurs parties ; le lecteur récupère les parties à tour de rôle.
3. L'analyse : Les balises sont lues et chaque produit est isolé comme un enregistrement. Une balise défectueuse provoque une erreur à cette étape.
4. Fait la correspondance : Les champs de la source sont associés à ceux de la boutique : code stock avec code stock, prix avec prix.
5. Compare : Les nouvelles données sont comparées à l'enregistrement existant ; seuls les produits modifiés sont mis à jour, les nouveaux produits sont ajoutés et ceux qui ont disparu de la source sont signalés.
6. Écrit et enregistre : Les modifications sont appliquées à la boutique ; le nombre de produits ajoutés, mis à jour et en erreur est consigné dans le journal.
7. Attend : Le système se met en pause jusqu'au prochain tour ; c'est le réglage qui détermine la fréquence.

Dans le sens de l'exportation, l'ordre s'inverse : la boutique convertit ses propres produits en XML et les publie sur un lien ; la plateforme publicitaire ou d'achat lit ce lien selon son propre calendrier. C'est vous qui gardez le contrôle, car vous décidez quels produits sont publiés, à quel prix et dans quelle langue.

Comment importer les produits d'un fournisseur ?

Pour importer les produits d'un fournisseur, vous déclarez le lien XML du fournisseur dans la boutique, faites la correspondance des champs et définissez la fréquence de mise à jour. La configuration se fait une seule fois ; ensuite, le catalogue et le stock restent à jour automatiquement.

Que vérifier avant l'importation ?

La qualité du fichier source détermine la qualité de l'intégration. Répondez à ces questions avant de connecter le lien :

• Fréquence de mise à jour : À quelle fréquence la source actualise-t-elle ses données ? Même si vous lisez chaque minute, vous n'obtiendrez pas de données fraîches si la source n'est actualisée qu'une fois par jour.
• Complétude des champs : Chaque produit a-t-il un code stock, un prix, un stock et une image ? Des champs vides donnent des pages vides.
• Identifiant unique : Existe-t-il un champ unique (code stock ou code-barres) qui distingue les produits les uns des autres ? Ce champ est la clé de la correspondance.
• Variantes : Les options comme la taille et la couleur arrivent-elles au sein d'un même produit ou sous forme d'enregistrements distincts ?
• Fiabilité de la source : La connexion est-elle souvent coupée, la taille du fichier est-elle trop importante ?

Vous trouverez comment choisir la source comme fournisseur et établir la relation commerciale dans l'article Qu'est-ce qu'un fournisseur XML ? ; pour la logique générale du modèle sans stock, l'article Qu'est-ce que l'e-commerce sans stock ? Comment vendre sans stock est utile.

La première importation et les mises à jour ne sont pas la même chose

Le premier transfert construit le catalogue : tous les produits, images et descriptions arrivent dans la boutique. Les tours suivants ne transportent que les changements : le stock et le prix changent souvent, la description et les images rarement. Cette distinction est importante, car tout réécrire à chaque tour est lent et peut écraser les corrections faites à la main. Déterminez dès le départ quels champs viendront en permanence de la source et lesquels seulement la première fois.

Comment exporter les produits vers les plateformes publicitaires et d'achat ?

Exporter, c'est publier les produits de la boutique sous forme de lien XML dans le format exigé par les plateformes publicitaires et d'achat. La plateforme lit ce lien à intervalles réguliers et affiche vos produits dans sa propre vitrine et dans ses publicités.

Chaque plateforme attend des noms de champs et des informations obligatoires différents. C'est pourquoi l'exportation se fait souvent avec un modèle : le modèle détermine comment les champs de la boutique sont convertis en balises attendues par la plateforme. Points d'attention :

• Ne fournissez que des produits vendables : Si un produit sans image ni stock est diffusé en publicité, vous obtenez soit une erreur, soit une dépense publicitaire pour un produit épuisé.
• Ajustez le prix selon la plateforme : Une politique tarifaire différente peut s'appliquer sur certaines plateformes ; c'est pourquoi il est important de pouvoir augmenter ou réduire le prix dans la sortie, d'un montant ou d'un pourcentage.
• Choisissez la langue et la devise : Pour une publicité destinée à un marché étranger, le produit doit être diffusé dans la langue et la devise concernées.
• Protégez le lien : Si l'adresse de sortie est publique, vos concurrents peuvent aussi lire votre liste de produits et de prix ; dans la mesure du possible, n'autorisez l'accès que depuis des adresses précises.
• Fractionnez le fichier : Pour de très grands catalogues, plusieurs parties sont lues de façon plus sûre et plus rapide qu'un seul fichier.

Les données structurées qui permettent aux moteurs de recherche de comprendre les pages produits constituent un autre sujet ; vous pouvez en lire plus dans l'article Qu'est-ce que les données structurées (Schema) ?.

À lire aussiComment faire une mise à jour de produits en masse ?

Comment faire la correspondance des champs en XML ?

La correspondance des champs consiste à déterminer dans quel champ de la boutique chaque balise du XML source sera écrite. Si la correspondance est erronée, les données circulent, mais au mauvais endroit : le prix peut être écrit dans le champ stock, le code-barres dans le code stock.

Gérer correctement le code stock est le fondement de la correspondance ; l'article Qu'est-ce qu'un SKU ? Comment créer un code stock (SKU) explique comment construire les codes stock. Si l'arborescence de catégories de la source diffère de la vôtre, associer une fois chaque catégorie source à votre propre catégorie vous évitera du travail lors des tours suivants.

À quelle fréquence mettre à jour le XML ?

La fréquence de mise à jour dépend de la vitesse à laquelle les données changent et de ce que ce retard vous coûte. Le stock et le prix sont mis à jour souvent, la description et les images rarement ; plus les mises à jour sont fréquentes, plus le risque de ventes erronées diminue.

Deux retards distincts se mélangent ici. Le premier est l'intervalle de lecture : toutes les combien de minutes votre système lit-il le XML ? Le second est l'intervalle d'actualisation propre à la source : à quelle fréquence le fournisseur met-il son fichier à jour ? L'âge moyen des données dépend de la somme de ces deux retards. Quelle que soit la fréquence de vos lectures, si la source n'est actualisée qu'une fois par jour, le stock reste aussi ancien.

Dans la gestion XML de Faprika, les intervalles de mise à jour et de nombreux champs sont gérés par le client ; les mises à jour peuvent s'exécuter en quelques minutes plutôt qu'une fois par jour. La présentation du module complémentaire Gestion XML dynamique indique aussi que le délai de mise à jour, qui est en moyenne d'une journée chez d'autres, est laissé au client chez Faprika et peut être ramené à quelques minutes. Pour la synchronisation des stocks avec les places de marché, consultez le guide Comment synchroniser les stocks avec les places de marché ?.

À lire aussiComment synchroniser les stocks avec les places de marché ?

Comment calculer le coût d'un retard de mise à jour ?

Le coût du retard naît du fait qu'une partie des commandes reçues pendant que les données sont périmées porte sur des produits sans stock : la commande est annulée, le client est perdu et, sur certains canaux, il y a pénalités ou perte de points. L'outil ci-dessous l'estime à partir d'un modèle approximatif.

Le modèle fonctionne ainsi : le nombre de mises à jour quotidiennes donne l'intervalle entre les tours ; l'âge moyen des données est la moitié de cet intervalle plus le retard ; la part de la journée couverte par cet âge indique la part des commandes prises avec des données périmées ; multipliée par le taux d'écart de stock, cette part donne le nombre estimé de commandes erronées. Les valeurs sont des hypothèses ; remplacez-les par vos propres données.

Deux points sont à garder à l'esprit à la lecture du résultat. Premièrement, doubler le nombre de mises à jour ne réduit pas l'âge des données de moitié, car le délai reste constant. Deuxièmement, le calcul ne montre que la perte directe ; la perte de confiance du client envers la boutique après une commande annulée est difficile à chiffrer, mais elle est bien réelle. Le moyen le plus efficace de réduire le délai est souvent non pas la fréquence, mais le raccourcissement de l'attente entre la lecture et l'écriture.

Comment gérer les erreurs dans une intégration XML ?

La gestion des erreurs dans une intégration XML consiste à prévenir les erreurs, à les repérer rapidement quand elles surviennent et à savoir qui corrige quoi. Une intégration qui tourne en silence n'est pas forcément saine ; le journal de transfert doit être consulté régulièrement.

Trois couches fonctionnent ensemble : les règles qui contrôlent le fichier source (un champ obligatoire est-il vide, un prix est-il à zéro), le journal de transfert (combien de produits ont été ajoutés, mis à jour ou ont généré une erreur) et l'alerte (un mécanisme qui vous prévient lorsque le taux d'erreur dépasse un seuil). Le tableau ci-dessous résume les situations les plus fréquentes.

Le cas du fichier vide est particulièrement dangereux : si la source publie un XML vide lors d'une panne, l'intégration peut l'interpréter comme « tous les produits sont en rupture de stock » et fermer tout le catalogue. Pour l'éviter, utilisez un seuil qui n'applique pas la mise à jour lorsque le nombre d'enregistrements reçus a fortement diminué par rapport au cycle précédent. Le stock de sécurité, lui, amortit les surventes dues au retard en conservant en réserve dans la boutique une certaine quantité du stock affiché à la source.

Erreurs fréquentes dans l'intégration XML

Les erreurs de configuration XML relèvent le plus souvent de la planification, pas de la technique. Les plus courantes sont :

• Ne pas s'informer de l'intervalle de mise à jour de la source : même si vous lisez souvent, le retard est inévitable si la source se rafraîchit rarement.
• Tout écrire à chaque cycle : les textes et images que vous avez modifiés manuellement sont sans cesse écrasés.
• Appliquer le mappage à tout le catalogue sans l'avoir testé sur un produit : une mauvaise correspondance peut corrompre des milliers d'enregistrements.
• Ne pas prévoir de protection contre un fichier vide : une seule panne peut désactiver tout le catalogue.
• Ne pas conserver de stock de sécurité : vendre jusqu'à ce que le stock atteigne zéro revient, en cas de retard, à vendre des produits que vous ne pouvez pas livrer.
• Laisser des produits sans stock et sans image dans le flux exporté : les publicités mènent à des produits épuisés ou des erreurs surviennent.
• Laisser l'adresse de sortie accessible à tous : votre liste de produits et de prix peut être copiée facilement.
• Ne pas lire le journal : les erreurs s'accumulent longtemps sans être remarquées.

Nous vous recommandons de lireQue faire d'une page produit en rupture de stock ?

Comment mettre en place l'intégration XML avec Faprika ?

La gestion XML dans Faprika comprend deux volets : la gestion XML dynamique, utilisée pour le transfert des produits et la mise à jour des stocks, et le flux produits obtenu depuis le panneau. Dans les deux cas, l'objectif est le même : vous gérez vous-même les intervalles de mise à jour et les champs.

Le module complémentaire Gestion XML dynamique vous permet de gérer le transfert des produits, la mise à jour des stocks et l'export des rapports de ventes grâce à des structures XML personnalisables. Des champs personnalisables vous permettent de vous adapter à la structure de la source et de définir vos propres préférences. Le module est conçu pour rendre le processus automatique et continu.

Comment obtenir un XML produits depuis le panneau ?

Le flux produits destiné aux plateformes publicitaires et de shopping se crée en quelques étapes depuis le panneau. Dans le panneau d'administration, suivez Catalogue, Transfert, Exporter les produits. Pour une explication détaillée, consultez le guide d'exportation des produits.

Vous filtrez d'abord les produits à exporter : produits avec images, type de produit, produits actifs, quantité de stock initiale et catégorie. Si vous laissez le filtre vide, tous les produits sont envoyés. Vous renseignez ensuite les paramètres de sortie :

Après avoir coché la case Actif et enregistré, accédez aux liens de sortie et utilisez le lien XML qui s'affiche. Le filtrage n'est pas obligatoire ; toutefois, veiller à ce que les produits à promouvoir aient des images et du stock vous évite des erreurs et empêche de diffuser des publicités pour des produits en rupture.

Comment les mises à jour sont-elles gérées dans Faprika ?

Faprika laisse au client le soin de définir les intervalles et les champs des mises à jour XML. Cela a deux conséquences pratiques : vous pouvez augmenter la fréquence pendant une campagne ou une période de forte activité et la réduire en période calme, et vous pouvez faire correspondre les champs de la source à la structure de votre boutique. L'offre qui inclut le module complémentaire et les autres solutions varie ; consultez la comparaison des offres e-commerce pour les détails.

Liste de contrôle de l'intégration XML

Parcourez la liste ci-dessous avant de connecter une source XML ou de publier une sortie. Lorsque chaque point est validé par « oui », votre flux repose sur des bases solides.

Questions fréquentes

Qu'est-ce que l'intégration XML ?

L'intégration XML est le transfert automatique de données comme les produits, le stock et les prix entre deux systèmes au moyen d'un fichier XML. Un système publie les données sur un lien XML, l'autre les lit à intervalles réguliers et les applique à ses propres enregistrements.

Quelle est la différence entre importer et exporter des produits avec XML ?

L'import lit les données produits et de stock d'une source externe vers votre boutique ; il sert à constituer un catalogue à partir d'un fournisseur. L'export publie les produits de votre boutique sous forme de lien XML, que les plateformes publicitaires et de shopping lisent.

À quelle fréquence faut-il mettre à jour le XML ?

Le stock et les prix sont mis à jour le plus souvent, les descriptions et les images rarement. À mesure que le volume de commandes augmente et que la source est actualisée plus souvent, la fréquence doit augmenter. Dans Faprika, les intervalles de mise à jour sont gérés par le client et peuvent être réglés en minutes plutôt qu'au quotidien.

Pourquoi l'appariement des champs est-il important en XML ?

L'appariement garantit que chaque information de la source est écrite dans le bon champ de la boutique. En cas de mauvais appariement, le prix peut atterrir dans le champ du stock ou le code-barres dans le code de stock. Il faut donc d'abord l'essayer sur un seul produit, puis l'appliquer à tout le catalogue.

Quelle est l'erreur la plus fréquente en intégration XML ?

Un encodage de caractères corrompu, des codes de stock non uniques, un mauvais appariement des champs, une source qui publie un fichier vide et des retards de mise à jour sont les erreurs les plus courantes. Lire régulièrement le journal de transfert et ajouter une protection contre les fichiers vides évite la plupart d'entre elles.

Comment obtenir mes produits en XML pour les plateformes publicitaires dans Faprika ?

Dans le panneau d'administration, filtrez vos produits via Catalogue, Transfert, Exporter les produits ; définissez le nom de sortie, le type de fichier, le modèle, la langue, la devise et l'écart de prix, puis, après l'enregistrement, utilisez l'adresse XML du lien de sortie. Veiller à ce que les produits à promouvoir aient une image et du stock vous évite des erreurs.

Articles qui peuvent vous intéresser

• Qu'est-ce qu'un fournisseur XML ?
• Comment mettre à jour des produits en masse ?
• Comment synchroniser le stock des places de marché ?
• Qu'est-ce que le suivi des stocks ? Comment le réaliser ?