API de gestion des stocks
Chaque entreprise utilise un système que Qoblex ne remplacera jamais, et le synchroniser avec votre stock revient généralement à quelqu’un qui exporte un fichier chaque matin. Cette API de gestion des stocks met fin à cette corvée : le même moteur que celui de l’application, accessible en HTTP, qui prévient vos systèmes quand quelque chose change au lieu d’attendre qu’on le lui demande. Consultez la référence de l’API pour voir tous les endpoints.
Si une personne peut le faire, l’API aussi
La couverture est quasi totale. Pas une partie du système, ni un export en lecture seule : les mêmes commandes clients, stocks, commandes fournisseurs, expéditions, factures, clients et fournisseurs que votre équipe manipule toute la journée. Si quelqu’un peut le faire à l’écran, votre code aussi.
La référence présente chaque endpoint avec un exemple fonctionnel, et l’ensemble se télécharge sous forme de fichier OpenAPI à brancher sur vos propres outils.
Pour la partie de votre activité que Qoblex ne gère pas
Chaque entreprise a un système que personne ne remplacera. L’API permet que ce système ne soit plus synchronisé à la main par quelqu’un, tableur ouvert, à neuf heures du matin.
Connectez le système que personne ne remplacera
Nos intégrations couvrent les canaux de vente et les logiciels comptables qu’utilisent la plupart des entreprises. L’API sert pour celui que vous avez et qu’elles ne couvrent pas : un outil interne, le portail de commande d’un client, un transporteur, une marketplace que nous n’avons pas intégrée.
Soyez prévenu quand quelque chose se passe
Les webhooks envoient un événement à votre endpoint quand un enregistrement change : votre système réagit à une expédition ou à un mouvement de stock au moment où il se produit. L’alternative, c’est d’interroger l’API toutes les quelques minutes et d’avoir tort entre deux passages, et c’est toute la différence entre une intégration et une tâche planifiée.
Rien d’exotique à apprendre
REST, URL orientées ressources, JSON en entrée et en sortie, verbes HTTP et codes de statut standard. Filtres, tris et pagination fonctionnent de la même façon sur chaque liste, et les réponses extensibles permettent à une seule requête de renvoyer les enregistrements liés au lieu de cinq.
Une clé que vous générez vous-même
L’authentification tient en un en-tête `qoblex-x-api-key`. Générez la clé dans votre propre compte, limitez par des permissions ce à quoi elle a accès, et révoquez-la sans ouvrir de ticket. Chaque requête est limitée à votre organisation : vous ne lisez et n’écrivez jamais que vos propres données.
Des évolutions qui ne cassent pas votre code
Chaque endpoint se trouve sous `/v1`, et l’API évolue par ajouts : de nouveaux endpoints et de nouveaux champs peuvent apparaître à tout moment, alors concevez votre code pour ignorer ce qu’il ne reconnaît pas. Un changement incompatible reçoit une nouvelle version dans le chemin, pas une surprise un mardi.
Elle tourne là où tourne le reste de Qoblex
La plateforme et son API sont hébergées sur Microsoft Azure. Le trafic au sein de l’environnement Azure est chiffré, et le réseau bénéficie de la même protection contre les attaques par déni de service distribué que les grands services qui y tournent.
We needed to centralise our inventory as we simply could not keep up anymore. So glad we stumbled across Qoblex… After trailing the app it did exactly that and even opened up a pandora’s box of other features that we are now utilising and saving us even more time.
Questions fréquentes
Accès, authentification, webhooks et ce que vous pouvez construire dessus.
Qoblex a-t-il une API ?
Oui. Qoblex est un système de gestion des stocks doté d’une API REST complète, disponible sur toutes les formules : en option payante sur Starter et Business, incluse dans Scale. Elle couvre le stock, les produits, les commandes clients, les expéditions, les factures, les commandes fournisseurs, les réceptions de marchandises, les factures fournisseurs et les fournisseurs ; elle s’authentifie avec une clé API à portée limitée que vous générez vous-même, renvoie du JSON, est documentée dans un fichier OpenAPI 3.0.1 téléchargeable, et envoie des webhooks quand des enregistrements changent. Consultez nos tarifs.
Qu’est-ce qu’une API de gestion des stocks ?
C’est une interface qui permet à vos propres logiciels de lire et de modifier directement le stock, les commandes et les achats, au lieu qu’une personne exporte un fichier pour l’importer ailleurs. Une bonne API couvre toute l’activité, pas seulement les niveaux de stock, et vous prévient quand quelque chose change au lieu de vous obliger à demander. Celle-ci fait les deux : chaque ressource de l’application est accessible en HTTP, et les webhooks vous envoient les événements au moment où ils se produisent.
Comment obtenir une clé API ?
Générez-en une dans votre propre compte Qoblex et envoyez-la dans un en-tête `qoblex-x-api-key` à chaque requête. Aucune demande à déposer, aucun compte développeur séparé. Les permissions et les portées déterminent ce à quoi une clé a accès : une clé créée pour une intégration n’a pas à pouvoir tout faire.
À quoi l’API a-t-elle réellement accès ?
À toute l’activité, pas à un coin de celle-ci. Commandes clients, expéditions, factures et paiements, remboursements et retours, devis et clients ; commandes fournisseurs, bons de réception, factures fournisseurs et leurs règlements, acomptes, retours fournisseurs et fournisseurs ; et le catalogue produits sous-jacent. C’est le même moteur que celui de l’application : ce qu’une personne peut faire à l’écran, un système peut le faire en HTTP.
Y a-t-il des webhooks, ou dois-je interroger l’API ?
Il y a des webhooks. Votre endpoint est appelé quand un enregistrement change : votre système peut réagir à une expédition ou à un mouvement de stock au moment où il se produit, au lieu de le découvrir à l’interrogation suivante. L’interrogation reste possible si elle vous convient mieux.
Une mise à jour cassera-t-elle mon intégration ?
Elle ne devrait pas. Tout se trouve sous `/v1` et l’API évolue par ajouts : de nouveaux endpoints et de nouveaux champs de réponse peuvent apparaître à tout moment, alors concevez votre intégration pour ignorer les champs qu’elle ne reconnaît pas. Tout changement réellement incompatible reçoit une nouvelle version dans le chemin.
J’ai développé sur l’ancienne API. Qu’est-ce qui change ?
L’ancienne API sur `api.stockandbuy.com` reste très proche de celle-ci, et l’essentiel de ce que vous intégrez déjà se reprend avec peu ou pas de changements. Les deux différences qui comptent : l’authentification passe de HTTP Basic à l’en-tête `qoblex-x-api-key`, et un petit nombre d’endpoints et de payloads ont changé pour fournir des données plus riches. La référence comporte une section de migration qui couvre les deux.
Quel est le niveau de sécurité ?
La plateforme et son API tournent sur Microsoft Azure, où le trafic au sein de l’environnement est chiffré en transit et où le réseau bénéficie d’une protection automatique contre les attaques par déni de service distribué. Les requêtes sont limitées à votre propre organisation, et une clé peut être révoquée ou voir sa portée modifiée à tout moment.
Pouvez-vous développer une intégration sur mesure pour nous ?
Non. Nous ne prenons pas en charge de travaux d’intégration, car cela nous rendrait responsables d’un code que nous n’exécutons pas. Nous aiderons vos développeurs à la construire et nous répondons sérieusement à leurs questions pendant ce temps, ce qui fait généralement toute la différence sur la durée du projet.
Existe-t-il un connecteur Zapier ou Make ?
Pas encore. C’est sur la feuille de route. En attendant, une plateforme no-code peut appeler l’API directement avec son étape HTTP générique, et les webhooks lui fournissent de quoi se déclencher.
Combien coûte l’accès à l’API ?
C’est une option payante sur Starter et Business, incluse dans Scale. Consultez nos tarifs pour les conditions en vigueur.
Comment ça marche
Soyez opérationnel en bien moins de temps que vous ne l’imaginez.
- 1
Parlez à un expert
Nos experts ont accompagné des centaines d’entreprises comme la vôtre.
Voir une démo - 2
Faites appel à un spécialiste
Faites-vous accompagner pour la mise en route afin de vous simplifier la tâche.
Voir une démo - 3
Démarrez vite
Contrairement aux autres systèmes, nous vous rendons opérationnel en une semaine.