Blog Gäbig · Conseils pratiques

API ou CSV : quelle connexion pour vos données de stock ?

Choisissez API ou CSV selon la fréquence des données et les conséquences d’une erreur. Avec un test contre les traitements en double.

env. 3 min de lectureMis à jour:
Deux personnes emballent des commandes sur une table avec un ordinateur portable
Photo d’illustration. Photo: Kampus Production / Pexels.

Un fichier CSV peut suffire pour importer les articles au démarrage. Pour les commandes quotidiennes, ce même échange peut devenir trop lent. Décidez par type de données : quel délai est acceptable et que se passe-t-il si une modification manque ou est traitée deux fois ?

Quand le CSV convient

Le CSV est utile pour un ensemble limité à contrôler avant import : stock initial, nouveaux articles ou liste fournisseurs corrigée. Son contenu peut être relu et archivé. Prévoyez un modèle stable avec colonnes, encodage, unités et règles d’importation explicites.

Définissez si une cellule vide signifie « ne rien changer » ou « supprimer ». Conservez les références commençant par zéro au format texte. Testez séparateurs décimaux et caractères accentués. Un tableur peut modifier des valeurs à l’ouverture sans que cela saute aux yeux.

Un import CSV planifié est bien une automatisation, mais il fonctionne par intervalles. Cela peut convenir aux données rarement modifiées. Pour la dernière unité vendue sur plusieurs canaux, le délai peut être excessif.

Quand une API apporte davantage

Une API permet de transmettre des changements ciblés, comme une commande ou une correction de stock. Elle devient pertinente lorsque mouvements fréquents, nombreux canaux ou délais courts rendent le rapprochement manuel peu pratique. Sa présence ne garantit toutefois ni traitement immédiat ni intégration complète.

Désignez une source de référence pour chaque champ : article, prix, stock et statut d’expédition. Deux systèmes qui écrasent chacun la valeur de l’autre produisent des données peu fiables, même avec une connexion rapide. Un nom commun ne remplace pas une correspondance unique des variantes.

Le test décisif : recevoir deux fois le même message

Exemple fictif : une commande réserve trois pièces. Après une expiration du délai de réponse, le message est renvoyé. Le résultat doit rester trois pièces réservées, pas six. Il faut une référence unique et un traitement qui évite cette double exécution.

Shopify documente les livraisons répétées de webhooks. Demandez comment le prestataire détecte doublons, messages manquants et données anciennes. Un rapprochement global périodique reste utile.

Une grille de décision simple

  • Import initial : CSV avec aperçu, rapport de contrôle et sauvegarde.
  • Données fournisseurs mensuelles : CSV possible avec une personne responsable.
  • Commandes courantes : connexion automatisée, protection contre les doublons et erreurs visibles.
  • Stocks faibles sur plusieurs canaux : mesure du délai réel et prise en compte des réservations.
  • Corrections sensibles : validation et historique, quel que soit le moyen de transmission.

Valider avec quelques articles

Testez cinq cas : article ordinaire, variante, référence commençant par zéro, conditionnement et stock bloqué. Enregistrez réception, commande, annulation et correction. Comparez valeurs, unités et dates dans les deux systèmes. Précisez qui résout une erreur et comment annuler un import.

Le guide de synchronisation boutique-entrepôt complète ce test. Vérifiez l’intégration Shopify ou l’intégration bexio concernée. CSV au démarrage et API au quotidien peuvent se compléter s’ils appliquent les mêmes règles de données.

Découvrir d’autres articles