Un client commande sur votre site. Quelqu'un ouvre la commande, la recopie dans le logiciel de gestion, met à jour le stock, puis prépare la facture. Le soir, le stock affiché sur le site ne correspond déjà plus à la réalité. Ce scénario est courant, et il a une solution : faire dialoguer les deux logiciels grâce à une API.
Une API, c'est quoi exactement ?
Une API (interface de programmation) est une porte d'entrée qu'un logiciel ouvre à d'autres logiciels. Au lieu qu'une personne clique dans l'interface, un programme envoie un message normalisé : « crée cette commande », « donne-moi le stock de cet article ». Le logiciel répond par un autre message, que le programme sait lire.
La plupart des API modernes passent par le web, comme une page que l'on consulte, avec les mêmes règles du protocole HTTP. On parle souvent d'API « REST ».
Deux façons de se parler
Interroger régulièrement
Le site demande toutes les quinze minutes au logiciel de gestion : « quels stocks ont changé ? ». C'est simple à mettre en place, mais il y a toujours un petit décalage, et beaucoup de requêtes pour rien.
Être prévenu en temps réel
Le logiciel de gestion prévient le site dès qu'un stock change, grâce à un webhook : un message envoyé automatiquement à une adresse convenue. C'est plus réactif, mais tous les logiciels ne le proposent pas.
Ce qu'on synchronise le plus souvent
| Donnée | Sens | Point d'attention |
|---|---|---|
| Commandes | Site → gestion | Ne jamais créer deux fois la même commande |
| Stocks | Gestion → site | Délai acceptable entre deux mises à jour |
| Prix | Gestion → site | Promotions et prix par type de client |
| Clients | Dans les deux sens | Doublons, adresses e-mail différentes pour un même client |
| Factures | Gestion → client | Numérotation légale gérée par un seul logiciel |
Les questions à poser avant de se lancer
- Le logiciel de gestion a-t-il une API ? Demandez la documentation à l'éditeur. Sans API, il reste parfois l'export de fichiers, moins fiable.
- Quel logiciel fait foi ? Pour chaque donnée, un seul logiciel doit être la référence. Sinon, les deux s'écrasent mutuellement.
- Que se passe-t-il si l'un des deux est indisponible ? Les commandes doivent être mises en attente, pas perdues.
- Qui est prévenu en cas d'erreur ? Une synchronisation qui échoue en silence est pire qu'une saisie manuelle.
- Comment est protégé l'accès ? Une clé d'API est un mot de passe : elle ne doit jamais apparaître dans le code d'une page web.
Beaucoup de logiciels de gestion installés localement, sur un poste de l'entreprise, n'ont pas d'API accessible depuis Internet. Dans ce cas, il faut un petit programme intermédiaire sur place, ou envisager une solution en ligne.
Outil d'automatisation ou développement ?
Pour une synchronisation simple entre deux services en ligne, un outil comme ceux comparés dans n8n, Make ou Zapier : quel outil pour automatiser une PME ? peut suffire. Dès qu'il y a des règles métier (prix par client, gestion des retours, plusieurs entrepôts), un développement sur mesure est généralement plus fiable et plus facile à faire évoluer.
Et si la vraie difficulté est que vos données vivent encore dans des fichiers Excel, commencez par là : Fichiers Excel partagés : quand passer à une application métier ?.
Questions fréquentes
Mon logiciel de gestion n'a pas d'API : que faire ?
Demandez d'abord à l'éditeur s'il existe un module ou une version en ligne. À défaut, des exports et imports de fichiers planifiés peuvent servir de solution transitoire, avec plus de contrôles.
Une synchronisation en temps réel est-elle nécessaire ?
Pas toujours. Pour des stocks qui bougent peu, une mise à jour toutes les quinze minutes suffit. Le temps réel se justifie quand les ruptures de stock coûtent cher.
Qui est responsable si une commande se perd entre les deux logiciels ?
La synchronisation doit garder une trace de chaque échange et prévenir en cas d'échec. C'est ce journal qui permet de retrouver et de rejouer une commande.
