Aller au contenu
Marie DadomoApplications métier sur mesure
Existant

Relier une application à votre logiciel existant : API, fichier ou ressaisie

Par
Marie Dadomo
Le
Lecture
10 minutes
En résumé
Commencer par ce que l’éditeur permet

Pour relier une application à un logiciel que vous utilisez déjà, trois voies existent : l’API, qui fait dialoguer les deux logiciels en direct, l’échange de fichiers, qui passe à heures fixes, et la ressaisie à la main. Le bon choix dépend de la fréquence de l’échange, du coût d’une erreur et de ce que l’éditeur ouvre dans votre formule. La première question à lui poser n’est pas technique : l’API existe-t-elle, et vous y donne-t-elle droit ?

Une nouvelle application ne vit jamais seule. Elle a besoin des clients de votre logiciel de gestion ou des références de votre ERP, ou elle doit lui renvoyer des heures, des commandes, des factures. Tant que cette liaison n’est pas décidée, le devis est incomplet.

Trois voies pour relier deux logiciels

Elles se distinguent par la fréquence de l’échange et par le coût d’une erreur, pas par leur élégance technique.

  • La ressaisie. Quelqu’un retape l’information dans le second outil. Elle ne coûte rien à installer et convient quand les volumes sont faibles et qu’une erreur coûte peu. Exemple fictif : dix fiches par semaine, cinq minutes chacune, font plus de quarante heures par an. Ce n’est pas toujours trop, mais une référence mal recopiée finit sur un bon de commande.
  • L’échange de fichiers. Le premier logiciel exporte un fichier (CSV, Excel), l’application le lit, ou l’inverse, à heures fixes ou à la demande. C’est adapté à un échange périodique, d’un format stable, où quelques heures de décalage ne gênent personne.
  • L’API. C’est la porte que l’éditeur ouvre pour que d’autres programmes lisent et écrivent dans son logiciel, avec des règles : qui a le droit, quelles données, combien d’appels. Elle s’impose quand l’information doit être à jour au moment où on la consulte, un stock ou un statut, ou quand un échange déclenche une action.
  • La base de données directe. Lire ou écrire dans la base d’un logiciel contourne ses contrôles. Je l’évite, sauf pour une lecture seule, sur un logiciel que vous hébergez, avec l’accord de l’éditeur.

Un outil d’automatisation du marché repose en général sur ces mêmes API : il en déplace la maintenance, il ne la supprime pas.

Quatre questions pour choisir

  • À quelle fréquence l’information doit-elle passer ? À la seconde, une fois par nuit, une fois par semaine.
  • Que se passe-t-il si elle arrive avec un jour de retard ? Si la réponse est « rien », un fichier suffit.
  • Que se passe-t-il si elle arrive fausse ? Une fiche client approximative se corrige ; un prix ou une quantité faux se paient.
  • Que propose le logiciel ? C’est la seule question dont la réponse ne vous appartient pas, et c’est le sujet de la section suivante.

Ce que l’éditeur décide à votre place

Avant de dessiner la moindre connexion, il faut savoir ce que le logiciel autorise. Deux exemples publics montrent la diversité des situations. Chez HubSpot, le nombre d’appels qu’une application peut faire dépend de l’abonnement du compte où elle est installée. Chez Shopify, une nouvelle version de l’API sort tous les trois mois et chaque version stable est prise en charge au moins douze mois ; si une application vise une version devenue inaccessible, Shopify répond avec la plus ancienne version accessible, donc avec des données qui peuvent ne plus avoir la forme attendue.

Les questions à poser à l’éditeur, ou à l’intégrateur qui a installé votre logiciel :

  • L’API existe-t-elle, dans quelle formule et pour quelle version de votre logiciel ? Un logiciel ancien n’en a parfois aucune.
  • Y a-t-il une documentation publique et un environnement d’essai, séparé de vos vraies données ? Sans lui, on teste en production.
  • Que peut-on lire, que peut-on écrire ? Lire est souvent plus simple que créer ou modifier.
  • Quelles limites d’appels par minute ou par jour, et que se passe-t-il quand on les atteint ?
  • Comment êtes-vous prévenu d’un changement, et combien de temps une version reste-t-elle disponible ?
  • Qui ouvre l’accès, l’éditeur ou l’intégrateur, et à quelles conditions ?

Par fichiers : les pièges des gestes simples

Un échange de fichiers paraît rustique, et il tient souvent mieux qu’on ne croit, à condition d’en écrire les règles comme un contrat entre les deux logiciels :

  • Le format, au caractère près. Séparateur de colonnes, encodage, format des dates, séparateur décimal. Microsoft documente que le séparateur de liste utilisé par Excel se règle dans les paramètres régionaux de Windows : un même fichier peut s’ouvrir en une colonne sur un poste et en dix sur un autre. Un « é » qui devient « Ã© » trahit un mauvais encodage.
  • Les limites d’Excel, si quelqu’un l’ouvre. Une feuille s’arrête à 1 048 576 lignes et Excel garde une précision de 15 chiffres, selon les spécifications de Microsoft : un identifiant de plus de 15 chiffres n’y est plus fiable.
  • Le dépôt. Où le fichier arrive-t-il, à quelle heure, déposé par qui ? Que se passe-t-il s’il manque, ou s’il arrive deux fois ? Chaque ligne doit porter un identifiant unique, pour qu’un second import ne crée pas de doublons.
  • Les lignes refusées. Sur un fichier de 500 lignes dont trois sont fausses, l’import accepte les bonnes, met les trois de côté dans un fichier de rejets lisible par un humain, et prévient quelqu’un. Tout refuser bloque le travail ; tout accepter abîme les données.

Par API : ce qu’on décide avant de coder

L’appel de l’API est la partie courte. Ce qui prend du temps tient dans des décisions :

  • Qui fait foi. Pour chaque donnée, client, article, prix, stock, facture, un seul logiciel est la source ; l’autre la lit. Deux outils qui écrivent la même fiche finissent par se contredire.
  • Le sens et le rythme. Lecture seule ou écriture ; en direct ou chaque nuit ; l’application interroge le logiciel à intervalles réguliers, ou c’est lui qui la prévient quand quelque chose change (une notification, souvent appelée webhook).
  • Le rapprochement. Comment saura-t-on que « Dupont SARL » ici est « DUPONT S.A.R.L. » là ? Un identifiant commun, numéro de client ou SIREN, se décide au départ ; sinon viennent les doublons.
  • Les pannes. L’éditeur est indisponible, la limite d’appels est atteinte, une donnée est refusée : l’application garde la demande, réessaie, affiche l’état (« 3 envois en attente »), liste les échecs dans un écran lisible et prévient une personne nommée.
  • Le journal. Ce qui a été envoyé, quand, avec quelle réponse. C’est lui qui répond, trois mois plus tard, à la question « pourquoi cette commande n’est-elle pas arrivée ? ».
  • Les droits. Un compte technique dédié, limité à ce que l’application doit lire et écrire.

Le contrôle des droits mérite d’être regardé de près. L’OWASP place en tête de sa liste 2023 des dix principaux risques des API le contrôle d’accès défaillant au niveau des objets, puis l’authentification défaillante. Le premier, expliquent ses auteurs, consiste à manipuler l’identifiant d’un objet envoyé dans la requête : chaque appel doit donc vérifier que celui qui le fait a le droit de voir cette fiche-là.

Une application Angular s’exécute dans le navigateur, et n’importe quel utilisateur peut lire le code qui s’y exécute. Je n’y mets donc jamais la clé d’accès à votre logiciel : un petit service côté serveur la garde et relaie les appels. Ce service fait partie du devis, avec la question de savoir qui l’héberge.

Ce que cela coûte, et ce qui continue de coûter

La connexion se chiffre à part, et pas avant d’avoir lu la documentation. Axopen écrit qu’un connecteur entre un ERP et une application peut parfois prendre 2 jours de développement, et parfois 20. Ce qui fait varier ce chiffre : la qualité de la documentation, un environnement d’essai ou non, le nombre de cas particuliers, ce que l’éditeur laisse écrire. Chez moi, ce sera une ligne du devis, sur une base de 450 € par jour, avec les hypothèses écrites en face.

S’ajoutent parfois des coûts qui ne sont pas les miens : la formule de votre logiciel qui donne accès à l’API, ou le temps de son intégrateur pour l’ouvrir. Demandez-les à l’éditeur avant de demander un devis.

La connexion ne se termine pas à la livraison. Une API évolue : quand l’éditeur publie une version, quelqu’un doit lire l’annonce et relancer les tests. Désignez cette personne et écrivez-le dans le suivi, comme dans l’organisation du suivi d’une application Angular. Pour lire un devis, prix d’une application métier montre où la connexion à l’ERP se loge dans trois projets comptés en jours, et le cahier des charges a une rubrique pour la décrire.

Quand il vaut mieux ne rien développer

  • Le logiciel propose déjà un connecteur avec l’outil visé. Un connecteur maintenu par l’éditeur vaut mieux qu’un connecteur maintenu par moi.
  • Le volume est faible. Quelques saisies par semaine, sans enjeu : la ressaisie reste la solution la moins chère, et la plus facile à arrêter.
  • Un des deux logiciels va disparaître. Ne payez pas une connexion pour un outil que vous remplacez dans l’année ; décidez d’abord de la transition.
  • Le logiciel n’a ni API ni export. La bonne question n’est plus la connexion mais son remplacement, comme pour une application Access ou WinDev faite maison.

Relier une application à un logiciel fait partie de mon travail d’application web métier avec Angular et TypeScript. L’interface et son intégration aux services prévus sont mon cœur de métier ; le service côté serveur et l’hébergement se répartissent dans le devis, avec votre équipe ou un partenaire. Écrivez-moi le nom de votre logiciel, sa version et ce qui doit circuler dans quel sens : je réponds sous 48 heures, y compris pour vous dire qu’un fichier ou la ressaisie suffit.

Questions fréquentes

Qu’est-ce qu’une API, en clair ?

Une API est une porte que l’éditeur d’un logiciel ouvre pour que d’autres programmes lisent ou écrivent ses données, avec des règles : qui a le droit, quelles données, combien d’appels. Elle ne se déduit pas du logiciel : certaines n’existent pas, d’autres dépendent de la formule que vous avez souscrite.

Peut-on relier une application à un logiciel qui n’a pas d’API ?

Souvent oui, par fichiers : le logiciel exporte, l’application lit, et l’inverse pour les retours. Cela convient si l’échange est périodique et le format stable. Écrire directement dans la base du logiciel contourne ses contrôles : je ne le recommande pas, sauf en lecture seule et avec l’accord de l’éditeur.

Combien coûte la connexion à un ERP ou à un CRM ?

Elle se chiffre à part, après lecture de la documentation de l’API. Axopen écrit qu’un connecteur peut prendre 2 jours de développement, ou 20. S’ajoutent parfois la formule qui donne accès à l’API et le temps de l’intégrateur. Chez moi, c’est sur devis, sur une base de 450 € par jour.

Que se passe-t-il quand l’éditeur change son API ?

Le connecteur peut cesser de fonctionner, ou recevoir des données autrement structurées. Shopify, par exemple, publie une version tous les trois mois, en maintient chacune au moins douze mois, et répond avec la plus ancienne version accessible si l’on en vise une retirée. Désignez quelqu’un qui lit les annonces de l’éditeur et relance les tests.

La ressaisie est-elle toujours à éviter ?

Non. Pour quelques saisies par semaine dont une erreur coûte peu, elle reste la solution la moins chère et la plus facile à arrêter. Elle devient un problème quand le volume monte, ou quand une erreur de recopie a des conséquences : une commande, une facture, un stock.

Marie Dadomo

Développeuse indépendante à Angers. Huit ans de projets pour l’hôpital, les services de secours, l’aéronautique et l’assurance (CNP, Sodifrance), et trois applications publiées sur l’App Store et Google Play : VetSafe, Equio et Ellyo.

La prestation liée
À lire ensuite