Introduction
Le format TXT personnalisé offre une flexibilité maximale pour exporter vos données de produits vers des plateformes tierces. Contrairement aux formats standardisés, un flux TXT personnalisé vous permet de définir la structure exacte de vos fichiers, les délimiteurs utilisés et l'ordre des colonnes. Cette approche convient particulièrement aux intégrations sur mesure, aux systèmes hérités ou aux partenaires commerciaux ayant des exigences spécifiques en matière de format de données.
Structure et format du fichier TXT personnalisé
Un flux TXT personnalisé se compose d'une série de lignes texte, chaque ligne représentant un produit ou un enregistrement de données. La structure dépend entièrement de votre configuration.
Délimiteurs et séparateurs
Les flux TXT personnalisés acceptent plusieurs types de délimiteurs pour séparer les champs :
| Délimiteur | Description | Cas d'usage |
|---|---|---|
| Virgule (,) | Séparation par virgule | Format CSV standard, compatible avec la plupart des outils |
| Point-virgule (;) | Séparation par point-virgule | Régions utilisant la virgule comme séparateur décimal |
| Tabulation | Caractère de tabulation | Fichiers de données structurés, importation dans des tableurs |
| Pipe (|) | Caractère barre verticale | Données contenant des virgules ou points-virgules |
| Délimiteur personnalisé | Tout caractère spécifié | Intégrations très spécialisées |
Encodage de caractères
Votre flux TXT doit utiliser un encodage de caractères compatible avec votre système cible. L'encodage UTF-8 est recommandé pour supporter les caractères accentués et les symboles internationaux. Vérifiez les exigences de votre plateforme partenaire avant de générer le flux.
Configuration des champs
La configuration d'un flux TXT personnalisé repose sur le mappage explicite entre vos champs de produits internes et les colonnes du fichier exporté.
Champs disponibles pour le mappage
Les champs suivants peuvent être inclus dans votre flux personnalisé :
| Champ | Type | Description | Obligatoire |
|---|---|---|---|
| id | Texte | Identifiant unique du produit | Oui |
| title | Texte | Nom ou titre du produit | Oui |
| description | Texte | Description détaillée du produit | Non |
| price | Nombre | Prix de vente en devise locale | Oui |
| brand | Texte | Marque ou fabricant | Non |
| link | URL | Lien vers la page produit | Oui |
| image_link | URL | Lien vers l'image principale | Non |
| availability | Texte | Statut de disponibilité (in stock, out of stock, preorder) | Non |
| condition | Texte | État du produit (new, refurbished, used) | Non |
| gtin | Texte | Code EAN, UPC ou ISBN | Non |
| mpn | Texte | Numéro de pièce du fabricant | Non |
| product_type | Texte | Catégorie ou type de produit | Non |
| google_product_category | Texte | Catégorie Google Merchant Center | Non |
| item_group_id | Texte | Identifiant de groupe pour variantes | Non |
Ordre des colonnes
L'ordre des colonnes dans votre fichier TXT doit correspondre exactement à l'ordre défini dans votre configuration. Si votre système cible attend un ordre spécifique, respectez-le scrupuleusement. Une mauvaise correspondance entre l'ordre des colonnes et la configuration entraînera des erreurs d'importation ou des données mal mappées.
Configuration étape par étape
- Accédez à la section de gestion des flux de votre plateforme.
- Sélectionnez l'option pour créer un nouveau flux personnalisé au format TXT.
- Donnez un nom explicite à votre flux (par exemple, "Flux TXT - Partenaire XYZ").
- Choisissez le délimiteur approprié parmi les options disponibles ou spécifiez un délimiteur personnalisé.
- Définissez l'encodage de caractères (UTF-8 recommandé).
- Mappez chaque colonne de votre fichier à un champ de produit correspondant.
- Indiquez si la première ligne du fichier doit contenir les en-têtes de colonne.
- Configurez la fréquence de génération du flux (quotidienne, hebdomadaire, ou à la demande).
- Testez le flux avec un petit ensemble de produits avant de l'activer en production.
- Validez le fichier généré auprès de votre partenaire avant de mettre en place l'intégration complète.
En-têtes de colonne
Vous pouvez choisir d'inclure ou d'exclure une ligne d'en-tête dans votre fichier TXT. Si vous incluez des en-têtes, la première ligne du fichier contiendra les noms des colonnes. Cela facilite la lecture manuelle du fichier et aide les systèmes d'importation à identifier les champs correctement.
Exemple avec en-têtes :
id,title,price,availability
12345,Produit A,29.99,in stock
12346,Produit B,49.99,out of stock
Exemple sans en-têtes :
12345,Produit A,29.99,in stock
12346,Produit B,49.99,out of stock
Gestion des caractères spéciaux
Lorsque vos données contiennent des caractères spéciaux, des virgules, des guillemets ou des sauts de ligne, appliquez l'une des stratégies suivantes :
- Échappement : utilisez un caractère d'échappement (généralement l'antislash ou le guillemet double) pour préfixer les caractères problématiques.
- Guillemets : entourez les champs contenant des caractères spéciaux de guillemets doubles.
- Remplacement : remplacez les caractères problématiques par des alternatives sûres (par exemple, remplacer les sauts de ligne par des espaces).
Consultez votre système cible pour connaître la stratégie d'échappement attendue.
Optimisation des performances et de la qualité
Taille et volume du fichier
Les fichiers TXT personnalisés peuvent atteindre plusieurs mégaoctets sans problème. Cependant, les fichiers très volumineux (plus de 100 Mo) peuvent ralentir le traitement. Si vous avez un très grand nombre de produits, envisagez de diviser le flux en plusieurs fichiers ou d'utiliser une approche par lots.
Validation des données
Avant de générer votre flux, validez que :
- Tous les champs obligatoires contiennent des données valides.
- Les URL (link, image_link) sont correctement formatées et accessibles.
- Les prix utilisent le format numérique correct pour votre devise.
- Les codes (gtin, mpn) respectent les normes applicables.
- Les énumérations (availability, condition) utilisent les valeurs autorisées.
Mise à jour et fréquence
Configurer la fréquence de génération du flux en fonction de la vitesse de changement de vos données. Un flux quotidien convient à la plupart des commerces en ligne. Un flux hebdomadaire suffit si vos inventaires changent lentement. Un flux à la demande permet de déclencher manuellement une mise à jour en cas de besoin urgent.
Intégration avec les partenaires
Une fois votre flux TXT personnalisé configuré, communiquez les détails suivants à votre partenaire ou système cible :
- L'URL d'accès au fichier flux.
- Le délimiteur utilisé.
- L'encodage de caractères.
- La présence ou l'absence d'en-têtes de colonne.
- L'ordre exact des colonnes.
- La fréquence de mise à jour.
- Les stratégies d'échappement pour les caractères spéciaux.
Fournissez également un exemple de quelques lignes du fichier généré pour permettre au partenaire de valider son système d'importation.
Dépannage courant
Erreurs d'encodage
Si votre partenaire signale des caractères corrompus ou illisibles, vérifiez que l'encodage UTF-8 est activé. Certains systèmes hérités peuvent exiger ISO-8859-1 ou un autre encodage. Testez différents encodages si le problème persiste.
Colonnes mal alignées
Si les données apparaissent dans les mauvaises colonnes chez votre partenaire, vérifiez que le délimiteur configuré correspond exactement à celui attendu. Un délimiteur mal configuré entraîne un décalage de toutes les colonnes suivantes.
Fichier vide ou incomplet
Si le flux généré est vide ou contient moins de produits que prévu, vérifiez que vos filtres de produits sont correctement configurés. Assurez-vous également que les produits contiennent des valeurs pour tous les champs obligatoires.
Résumé et bonnes pratiques
Les flux TXT personnalisés offrent une solution flexible pour exporter vos données de produits selon des formats très spécifiques. Définissez clairement votre structure de délimiteurs, mappez précisément vos champs et testez votre configuration avant de la déployer en production. Validez régulièrement que vos données arrivent correctement chez votre partenaire et ajustez votre configuration si les exigences changent. Une documentation claire et une communication avec vos partenaires d'intégration réduisent considérablement les problèmes d'importation et garantissent la qualité de vos données distribuées.