CSV ou API : choisir comment synchroniser votre catalogue produit
Un fichier CSV convient à un échange par lots que l’équipe peut contrôler. Une API devient pertinente lorsque les changements doivent circuler plus fréquemment ou dans plusieurs sens. Le bon choix dépend surtout des erreurs à reprendre, des identifiants et de la source qui fait autorité.
Décrire le rythme réel des mises à jour
Un catalogue annuel de quelques références n’a pas les mêmes besoins qu’un stock partagé entre boutique et magasin. Écrivez d’abord ce qui change, qui décide et quand l’information doit être disponible.
| Besoin | CSV à examiner | API à examiner |
|---|---|---|
| Mise à jour ponctuelle validée | Adapté à un lot contrôlé | Pas toujours nécessaire |
| Stock fréquemment modifié | Risque de décalage entre fichiers | Synchronisation possible à organiser |
| Corrections manuelles nombreuses | Lecture facile par l’équipe | Interface de suivi à prévoir |
| Reprise après erreur | Ligne et fichier identifiables | Journal et mécanisme de rejeu nécessaires |
Stabiliser les identifiants avant le transport
Exemple fictif : « produit bleu » devient « modèle azur ». Si le rapprochement utilise le titre, l’import peut créer un nouvel article au lieu de modifier le bon. Définissez une référence stable pour le produit, la variante et l’emplacement de stock.
Précisez aussi le traitement des suppressions : champ vide, colonne absente, variante archivée et article retiré ne signifient pas la même chose. Les imports CSV Shopify documentent des effets différents selon les colonnes et options d’écrasement.
Préparer la reprise, quel que soit le format
Le CSV n’est pas automatiquement sûr et l’API n’est pas automatiquement instantanée. Une API peut être limitée, indisponible ou recevoir deux fois un événement. Un fichier peut être partiellement importé ou modifié après validation.
Conservez l’identifiant du lot, les lignes acceptées, les erreurs et la version source. Testez une correction rejouée : elle ne doit pas créer un doublon ni remettre un ancien prix par erreur.
Choisir une solution que l’équipe peut exploiter
Demandez une démonstration comprenant ajout, modification, donnée invalide et reprise. Vérifiez qui reçoit l’alerte et qui peut corriger sans accéder à tous les outils techniques.
Le guide sur la source de vérité entre Shopify et ERP précède cette décision. Le format transporte l’information ; il ne tranche pas qui décide du stock ou du prix. Choisissez l’architecture après avoir clarifié ces règles, puis évaluez son coût de maintenance réel.
Questions fréquentes
Quand un fichier CSV suffit-il pour synchroniser un catalogue ?
Il peut convenir à des échanges ponctuels ou réguliers dont les délais restent acceptables. Définissez les identifiants, les champs et les erreurs à reprendre avant de choisir le format.
Une API garantit-elle des données à jour en permanence ?
Non. Les échecs, délais et limites de traitement restent à gérer. L’architecture doit prévoir la surveillance, la reprise et la résolution des conflits entre sources.
Que faut-il vérifier lors d’un import de catalogue ?
Contrôlez un ensemble représentatif de produits, les variantes, les prix et les stocks. Une réponse technique réussie ne prouve pas que les données finales correspondent à l’offre attendue.
Sources
Documentation consultée le 23 octobre 2026.