Connecter un autre logiciel
Menu : Configuration → Clés API
Nécessite l’option API & connecteurs IA — voir Mes applications.
Vous voulez afficher votre chiffre d’affaires dans Power BI, alimenter votre site de vente en ligne, ou laisser votre expert-comptable récupérer vos écritures ? Créez une clé d’accès et donnez-la au logiciel concerné. Il lira vos données OMAG tout seul, sans que personne ait à exporter quoi que ce soit à la main.
Ce qu’une clé permet — et ne permet pas
Section intitulée « Ce qu’une clé permet — et ne permet pas »Une clé donne un accès en lecture uniquement. Le logiciel qui la détient peut consulter vos données ; il ne peut rien créer, rien modifier, rien supprimer dans OMAG.
Chaque clé est attachée à une seule société. Si vous gérez plusieurs dossiers, créez une clé par société.
Créer une clé
Section intitulée « Créer une clé »- Ouvrez Configuration → Clés API, puis Nouvelle clé.
- Libellé : à quoi elle sert. C’est ce que vous relirez le jour où vous vous demanderez s’il faut la supprimer — écrivez « Power BI direction » plutôt que « test ».
- Portée : cochez uniquement ce dont le logiciel a besoin.
- Quota : le nombre d’interrogations autorisées par minute. 60 convient à la plupart des usages.
- Adresses IP autorisées : si le logiciel appelle toujours depuis la même adresse, indiquez-la. C’est le réglage le plus efficace de l’écran — il rend la clé inutilisable ailleurs.
Choisir la portée
Section intitulée « Choisir la portée »| Portée | Ce que le logiciel pourra lire |
|---|---|
| Articles | Votre catalogue, avec les prix de vente et les prix de revient |
| Stock | Les quantités disponibles par dépôt |
| Clients et fournisseurs | Coordonnées et conditions commerciales |
| Documents | Devis, commandes, bons de livraison, factures, avoirs |
| Règlements | Les encaissements clients |
| Comptabilité | Écritures comptables et balance |
Seuls les documents validés sortent. Un devis en cours de saisie n’est jamais visible de l’extérieur.
Suivre ce qui se passe
Section intitulée « Suivre ce qui se passe »Le bouton Activité d’une clé montre, jour par jour, le nombre d’interrogations et le nombre d’erreurs, ainsi que les dernières erreurs rencontrées avec leur heure et leur origine.
C’est le premier endroit à regarder quand un prestataire vous dit « votre API ne répond pas » : vous verrez s’il a appelé, quand, et ce qu’il a reçu.
Supprimer une clé
Section intitulée « Supprimer une clé »Le bouton Révoquer coupe l’accès immédiatement. Le logiciel qui l’utilisait cesse de fonctionner dans la minute.
La clé reste visible dans la liste, marquée « Révoquée » : son historique de consommation est conservé, et savoir qu’elle a existé fait partie de votre traçabilité.
Révoquez sans hésiter dès qu’un prestataire termine sa mission, qu’un logiciel est remplacé, ou qu’un doute existe sur la confidentialité d’une clé.
Qui peut gérer les clés
Section intitulée « Qui peut gérer les clés »Les mêmes personnes que celles qui gèrent les utilisateurs et droits : créer une clé, c’est distribuer un accès à vos données, exactement comme créer un compte.
Et le logiciel, comment il s’en sert ?
Section intitulée « Et le logiciel, comment il s’en sert ? »Vous transmettez la clé au prestataire ou au développeur, et c’est tout. De votre côté, rien à installer, rien à ouvrir sur votre réseau.
Tout ce dont il a besoin est publié : la documentation de l’API décrit comment appeler, quelles données sont disponibles, et donne des recettes prêtes à l’emploi pour Power BI, Excel et Postman. Envoyez-lui simplement le lien — il n’aura pas à vous solliciter.
Questions fréquentes
Section intitulée « Questions fréquentes »Un logiciel extérieur peut-il modifier mes données via une clé ?
Non. L'accès est en lecture seule : aucune clé ne permet de créer, modifier ou supprimer quoi que ce soit dans OMAG.
J'ai perdu ma clé, comment la retrouver ?
Elle est irrécupérable : OMAG n'en garde pas de copie. Révoquez-la et créez-en une nouvelle, puis transmettez la nouvelle au logiciel concerné.
Est-ce que je peux voir ce qu'un prestataire a consulté ?
Le bouton Activité affiche le volume d'interrogations jour par jour et les dernières erreurs, avec l'heure et l'adresse d'origine.
Puis-je limiter une clé à un seul dépôt ou à une seule agence ?
Non. Une clé voit tout le périmètre de sa société. Pour cloisonner, utilisez des sociétés distinctes.
Que se passe-t-il si le logiciel interroge trop souvent ?
Il reçoit un refus temporaire jusqu'à la minute suivante. Le quota se règle clé par clé dans l'écran.