Relier ses logiciels entre eux : API, webhooks et connecteurs.
Publié le
Site, caisse, stock, comptabilité, CRM, paiement : comment faire circuler les données entre vos logiciels sans ressaisie, en sécurité, même sans API.
Une commande arrive sur le site, puis quelqu'un la ressaisit dans la caisse, corrige le stock à la main et recopie la facture dans la comptabilité. Chaque ressaisie prend du temps et crée des erreurs. La réponse courte : la plupart des logiciels récents savent échanger leurs données par une API, et quand un logiciel n'en a pas, un échange de fichiers programmé fait souvent l'affaire. Le travail consiste à choisir le bon mode de liaison pour chaque flux, à le sécuriser, puis à le surveiller dans la durée.
API, webhook, connecteur : de quoi parle-t-on ?
- Une API (interface de programmation) est une porte d'entrée qu'un logiciel ouvre aux autres programmes : lire les commandes, créer un client, mettre à jour un stock, selon des règles publiées par l'éditeur.
- Un webhook fonctionne dans l'autre sens : le logiciel prévient lui-même un autre programme quand un événement se produit, par exemple un paiement accepté. Inutile de l'interroger toutes les cinq minutes.
- Un connecteur est une liaison toute faite entre deux logiciels courants : un module pour votre boutique, une intégration proposée par l'éditeur, ou une plateforme d'automatisation comme Zapier, Make ou n8n.
- L'échange de fichiers, souvent au format CSV, prend le relais quand un logiciel n'a pas d'API : un fichier produit à heure fixe, qu'un programme lit et intègre ailleurs.
Des exemples concrets
- Boutique en ligne et caisse. Le stock devient commun : une vente en magasin retire l'article du site, une commande en ligne le retire de la caisse. Sans liaison, on finit par vendre en ligne un produit épuisé.
- Ventes et comptabilité. Factures et encaissements partent vers le logiciel comptable avec le bon compte et le bon taux de TGC, au lieu d'être ressaisis en fin de mois.
- Site et CRM. Une demande de devis remplie sur le site crée la fiche du prospect dans votre outil de relation client et prévient le bon commercial.
- Paiement en ligne. En Nouvelle-Calédonie, Stripe n'accepte pas les entreprises locales : on passe par EpayNC, la passerelle de la CSB proposée par les banques du territoire, ou par Mobupay, dont l'éditeur est agent d'eZyness, filiale de La Banque Postale. Mobupay publie une API documentée, des webhooks signés et un environnement de test. Dans tous les cas, la confirmation du paiement doit mettre à jour la commande sans intervention. Le guide paiement en ligne en Nouvelle-Calédonie compare les deux.
Quand il n'y a pas d'API
Certains logiciels de caisse, de paie ou de gestion installés sur un poste n'ont pas d'API, ou la réservent à une offre supérieure. Il reste plusieurs solutions :
- L'export programmé : le logiciel dépose chaque nuit un fichier dans un dossier partagé, qu'un programme lit et intègre.
- L'import : à l'inverse, un fichier préparé au bon format est chargé dans le logiciel qui l'accepte.
- La lecture de la base de données, avec l'accord de l'éditeur, quand elle est accessible.
Un fichier CSV paraît simple, mais il réserve des pièges. Excel en français l'enregistre souvent avec des points-virgules, la virgule servant aux décimales ; les accents s'affichent mal quand les deux logiciels n'utilisent pas le même encodage ; les montants en francs CFP doivent rester entiers. Un test avec de vrais fichiers, accents et gros montants compris, évite les mauvaises surprises.
Sécuriser les liaisons
- Des clés bien gardées. Une clé d'API ouvre vos données comme un mot de passe. Elle se range côté serveur, jamais dans le code d'une page web ou d'une application mobile, ni dans un e-mail.
- Le minimum de droits. Une liaison qui lit les commandes n'a pas besoin de supprimer des clients. Une clé par usage, avec les seuls droits nécessaires, se révoque sans tout couper.
- Des webhooks vérifiés. Quand l'éditeur signe ses notifications, vérifiez la signature : sinon, n'importe qui peut envoyer un faux « paiement accepté ».
- Des données contrôlées. Le référentiel de l'OWASP, une fondation de référence en sécurité des applications, sur les risques des API (édition 2023) range parmi les dix principaux risques la confiance excessive dans les données reçues d'une API tierce : elles se vérifient comme une saisie.
- Des données personnelles encadrées. Chaque logiciel qui reçoit des données de vos clients les traite pour votre compte. La loi Informatique et Libertés, applicable en Nouvelle-Calédonie, demande d'encadrer ce traitement par un contrat avec l'éditeur.
Maintenir les intégrations dans la durée
Une liaison n'est jamais terminée : les éditeurs font évoluer leurs API et retirent les anciennes versions. Shopify, par exemple, publie une nouvelle version de son API chaque trimestre et assure le support de chacune pendant au moins douze mois : au-delà, elle peut être retirée. Une intégration qui n'est pas suivie finit par casser, parfois sans bruit.
- Abonnez-vous aux annonces techniques de chaque éditeur et notez les dates de fin de version.
- Faites surveiller chaque flux : une alerte quand une synchronisation échoue, ou quand aucune commande n'est passée depuis un délai anormal.
- Gardez une trace de chaque échange et prévoyez la reprise : une commande non transmise doit pouvoir repartir sans être créée en double.
- Documentez les liaisons : quels logiciels, quelles données, quelles clés, qui contacter. Le guide sur la maintenance détaille le reste de l'entretien.
ERIS développe ces intégrations et ces API, avec Laravel et Next.js, entre sites, applications, logiciels du marché et systèmes d'information : cartographie des flux, développement par cycles courts, mise en service, puis surveillance et évolutions.
Notre accompagnement
Vous avez un projet sur ce sujet ?
Questions fréquentes.
Qu'est-ce qu'une API ?
C'est une porte d'entrée qu'un logiciel ouvre aux autres programmes, selon des règles publiées par son éditeur. Elle permet par exemple de lire les commandes d'une boutique ou de créer une facture dans la comptabilité, sans ressaisie.
Quelle différence entre une API et un webhook ?
Avec une API, votre programme va chercher l'information. Avec un webhook, c'est le logiciel qui prévient votre programme dès qu'un événement se produit, comme un paiement accepté. Les deux se complètent souvent.
Comment relier un logiciel qui n'a pas d'API ?
Par un export programmé, souvent un fichier CSV qu'un programme lit et intègre ailleurs, ou par un import dans l'autre sens. Testez-le avec de vrais fichiers : séparateurs, accents et montants en francs CFP entiers sont les pièges habituels.
Comment sécuriser une intégration entre logiciels ?
Rangez les clés d'API côté serveur, donnez à chaque liaison les seuls droits nécessaires, et vérifiez la signature des webhooks quand l'éditeur en fournit une. Contrôlez aussi les données reçues d'un autre logiciel comme une saisie.
Que se passe-t-il quand un éditeur change son API ?
Les anciennes versions finissent par être retirées : Shopify, par exemple, publie une version chaque trimestre et assure le support de chacune pendant au moins douze mois. Une intégration doit donc être surveillée et mise à jour, comme le reste d'un site ou d'une application.
Un projet en tête ?
Passons de la lecture à l'action.
Vous préparez un site, une refonte ou une stratégie digitale en Nouvelle-Calédonie ? Parlons-en : nous transformons ces conseils en résultats concrets pour votre activité.
Discutons de votre projet